Integrar o AppSheet ao Google SecOps

Este documento explica como integrar o AppSheet ao Google Security Operations (Google SecOps).

Versão da integração: 3.0

Casos de uso

Realizar ações de CRUD.

Parâmetros de integração

Use os seguintes parâmetros para configurar a integração:

Nome do parâmetro Tipo Valor padrão É obrigatório Descrição
Raiz da API String https://api.appsheet.com Sim Raiz da API da instância do AppSheet.
ID do aplicativo String N/A Sim ID do aplicativo do AppSheet.
Token de acesso Senha N/A Sim Token de acesso do aplicativo AppSheet.
Verificar SSL Caixa de seleção Selecionado Sim Se selecionada, a integração valida o certificado SSL ao se conectar ao servidor do AppSheet.

Para instruções sobre como configurar uma integração no Google SecOps, consulte Configurar integrações.

É possível fazer mudanças mais tarde, se necessário. Depois de configurar uma instância de integração, você pode usá-la em playbooks. Para mais informações sobre como configurar e oferecer suporte a várias instâncias, consulte Suporte a várias instâncias.

Ações

Para mais informações sobre ações, consulte Responder a ações pendentes da sua mesa de trabalho e Realizar uma ação manual.

Adicionar registro

Adicione um registro a uma tabela no AppSheet.

Parâmetros

Nome do parâmetro Tipo Valor padrão É obrigatório Descrição
Nome da tabela String N/A Sim Especifique o nome da tabela a que você quer adicionar um novo registro.
Objeto JSON de registro JSON Sim Especifique o objeto JSON do registro que precisa ser adicionado.

Data de execução

Essa ação não é executada em entidades.

Resultados da ação

Resultado do script
Nome do resultado do script Opções de valor Exemplo
is_success Verdadeiro/Falso is_success=False
Painel de casos
Tipo de resultado Descrição Tipo
Mensagem de saída*

A ação não pode falhar nem interromper a execução de um playbook:

Se os dados estiverem disponíveis (is_success = true): "O novo registro foi adicionado à tabela "{table}" no AppSheet.

A ação precisa falhar e interromper a execução de um playbook:

Se um erro fatal, como credenciais incorretas, falta de conexão com o servidor ou outro problema for informado: "Erro ao executar a ação "Adicionar registro". Motivo: {0}''.format(error.Stacktrace)

Se não houver dados na resposta: "Erro ao executar a ação "Adicionar registro". Motivo: um payload inválido foi fornecido. Verifique a ortografia de "Nome da tabela" e a estrutura do objeto JSON do registro."

Se a resposta for "Mensagem": "Erro ao executar a ação "Adicionar registro". Motivo: {0}''.format(Message)

Objeto JSON inválido:erro ao executar a ação "Adicionar registro". Motivo: objeto JSON inválido fornecido. Verifique a estrutura.

 Geral

Excluir registro

Excluir um registro em uma tabela no AppSheet.

Parâmetros

Nome do parâmetro Tipo Valor padrão É obrigatório Descrição
Nome da tabela String N/A Sim Especifique o nome da tabela em que você quer excluir um registro.
Objeto JSON de registro JSON Sim Especifique o objeto JSON do registro que precisa ser excluído. Você só precisa fornecer a chave de identificador exclusivo do registro.

Data de execução

Essa ação não é executada em entidades.

Resultados da ação

Resultado do script
Nome do resultado do script Opções de valor Exemplo
is_success Verdadeiro/Falso is_success=False
Painel de casos
Tipo de resultado Descrição Tipo
Mensagem de saída*

A ação não pode falhar nem interromper a execução de um playbook:

Se os dados estiverem disponíveis (is_success = true): "O registro foi excluído da tabela "{table}" no AppSheet.

Se o código de status for 200, mas rowNumber for nulo (is_success=true): o registro fornecido não existia na tabela "{table}" no AppSheet.

A ação precisa falhar e interromper a execução de um playbook:

Se um erro fatal, como credenciais incorretas, falta de conexão com o servidor ou outro problema for informado: "Erro ao executar a ação "Excluir registro". Motivo: {0}''.format(error.Stacktrace)

Se não houver dados na resposta: "Erro ao executar a ação "Excluir registro". Motivo: um payload inválido foi fornecido. Verifique a ortografia de "Nome da tabela" e a estrutura do objeto JSON do registro."

Se "Message" estiver na resposta: "Erro ao executar a ação "Excluir registro". Motivo: {0}''.format(Message)

Erro ao executar a ação "Excluir registro". Motivo: objeto JSON inválido fornecido. Verifique a estrutura.

 Geral

Listar tabelas

Listar as tabelas disponíveis em um app no AppSheet.

Parâmetros

Nome do parâmetro Tipo Valor padrão É obrigatório Descrição
Lógica de filtro DDL

Igual

Valores possíveis:

  • Igual
  • Contém
 Não Especifique qual lógica de filtro deve ser aplicada.
Valor do filtro String N/A Não Especifique o valor que será usado no filtro. Se "Igual" estiver selecionado, a ação vai tentar encontrar a correspondência exata entre os itens. Se "Contém" estiver selecionado, a ação vai tentar encontrar itens que contenham essa substring. Se nada for fornecido nesse parâmetro, o filtro não será aplicado.
Número máximo de tabelas a serem retornadas Número inteiro 50 Não Especifique quantas tabelas serão retornadas. Padrão: 50.

Data de execução

Essa ação não é executada em entidades.

Resultados da ação

Resultado do script
Nome do resultado do script Opções de valor Exemplo
is_success Verdadeiro/Falso is_success=False
Resultado JSON
{
    "Tables": [
        {
            "name": "Hash identificiation",
            "id": "Hash identificiation"
        }
    ]
}
Painel de casos
Tipo de resultado Descrição Tipo
Mensagem de saída*

A ação não pode falhar nem interromper a execução de um playbook:

Se os resultados forem encontrados (is_success = true): "As tabelas foram encontradas com sucesso para os critérios fornecidos no AppSheet.

Se não houver resultados (is_success = true): "Nenhuma tabela foi encontrada para os critérios fornecidos no AppSheet.

A ação precisa falhar e interromper a execução de um playbook:

Se um erro fatal, como credenciais incorretas, falta de conexão com o servidor ou outro problema for informado: "Erro ao executar a ação "Listar tabelas". Motivo: {0}''.format(error.Stacktrace)

 Geral
Tabela do painel de casos

Nome:tabelas disponíveis

Colunas:

  • ID
  • Nome
 Geral

Ping

Teste a conectividade com o AppSheet.

Parâmetros

Nenhuma.

Data de execução

Essa ação não é executada em entidades.

Resultados da ação

Resultado do script
Nome do resultado do script Opções de valor Exemplo
is_success Verdadeiro/Falso is_success=False
Painel de casos
Tipo de resultado Descrição Tipo
Mensagem de saída*

A ação não pode falhar nem interromper a execução de um playbook:

Se tudo der certo: "Conexão com o servidor do AppSheet estabelecida com os parâmetros fornecidos"

A ação precisa falhar e interromper a execução de um playbook:

Se não der certo: "Não foi possível se conectar ao servidor do AppSheet! O erro é {0}".format(exception.stacktrace)

 Geral

Pesquisar registros

Pesquisar registros em uma tabela no AppSheet.

Parâmetros

Nome do parâmetro Tipo Valor padrão É obrigatório Descrição
Nome da tabela String N/A Sim Especifique o nome da tabela para a qual você quer recuperar detalhes.
Consulta de seletor String N/A Não Especifique a consulta de seletor, que será usada para limitar os resultados. Se nada for fornecido, a ação vai retornar todos os registros.

Data de execução

Essa ação não é executada em entidades.

Resultados da ação

Resultado do script
Nome do resultado do script Opções de valor Exemplo
is_success Verdadeiro/Falso is_success=False
Painel de casos
Tipo de resultado Descrição Tipo
Mensagem de saída*

A ação não pode falhar nem interromper a execução de um playbook:

Se os dados estiverem disponíveis (is_success = true): "Recuperamos os registros com base nos critérios fornecidos da tabela "{table}" no AppSheet.

Se não houver dados disponíveis (is_success=false): nenhum registro foi encontrado com base nos critérios fornecidos na tabela "{table}" no AppSheet.

A ação precisa falhar e interromper a execução de um playbook:

Se um erro fatal, como credenciais incorretas, falta de conexão com o servidor ou outro, for informado: "Erro ao executar a ação "Pesquisar registros". Motivo: {0}''.format(error.Stacktrace)

Se "Message" estiver na resposta: "Erro ao executar a ação "Search Records". Motivo: {0}''.format(Message)

 Geral
Tabela do painel de casos Nome:registros Geral

Atualizar registro

Atualize um registro em uma tabela no AppSheet.

Parâmetros

Nome do parâmetro Tipo Valor padrão É obrigatório Descrição
Nome da tabela String N/A Sim Especifique o nome da tabela em que você quer atualizar um registro.
Objeto JSON de registro JSON Sim Especifique o objeto JSON do registro que precisa ser atualizado. Você precisa fornecer a chave de identificador exclusivo e os campos que quer atualizar.

Data de execução

Essa ação não é executada em entidades.

Resultados da ação

Resultado do script
Nome do resultado do script Opções de valor Exemplo
is_success Verdadeiro/Falso is_success=False
Painel de casos
Tipo de resultado Descrição Tipo
Mensagem de saída*

A ação não pode falhar nem interromper a execução de um playbook:

Se os dados estiverem disponíveis (is_success = true): "O registro na tabela "{table}" foi atualizado no AppSheet.

A ação precisa falhar e interromper a execução de um playbook:

Se o erro for fatal, como credenciais incorretas, sem conexão com o servidor, outro: "Erro ao executar a ação "Atualizar registro". Motivo: {0}''.format(error.Stacktrace)

Se não houver dados na resposta: "Erro ao executar a ação "Atualizar registro". Motivo: um payload inválido foi fornecido. Verifique a ortografia de "Nome da tabela" e a estrutura do objeto JSON do registro."

Se "Message" estiver na resposta: "Error executing action "Update Record". Motivo: {0}''.format(Message)

Erro ao executar a ação "Atualizar registro". Motivo: objeto JSON inválido fornecido. Verifique a estrutura.

 Geral

Precisa de mais ajuda? Receba respostas de membros da comunidade e profissionais do Google SecOps.