Integre o AppSheet com o Google SecOps

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

Versão da integração: 3.0

Exemplos de utilização

Realizar ações CRUD.

Parâmetros de integração

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

Nome do parâmetro Tipo Valor predefinido É obrigatório Descrição
Raiz da API String https://api.appsheet.com Sim Raiz da API da instância do AppSheet.
ID da Aplicação String N/A Sim ID da aplicação AppSheet.
Token de acesso Palavra-passe N/A Sim Token de acesso da aplicação AppSheet.
Validar SSL Caixa de verificação Marcado Sim Se estiver selecionada, a integração valida o certificado SSL quando se liga ao servidor do AppSheet.

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

Se necessário, pode fazer alterações numa fase posterior. Depois de configurar uma instância de integração, pode usá-la em manuais de soluções. Para mais informações sobre como configurar e suportar várias instâncias, consulte o artigo Suporte de várias instâncias.

Ações

Para mais informações sobre ações, consulte os artigos Responda a ações pendentes da sua mesa de trabalho e Execute uma ação manual.

Adicionar registo

Adicione um registo a uma tabela no AppSheet.

Parâmetros

Nome do parâmetro Tipo Valor predefinido É obrigatório Descrição
Nome da tabela String N/A Sim Especifique o nome da tabela à qual quer adicionar um novo registo.
Objeto JSON de registo JSON Sim Especifique o objeto JSON do registo que tem de ser adicionado.

É apresentado em

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

Resultados da ação

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

A ação não deve falhar nem parar a execução de um guia interativo:

Se os dados estiverem disponíveis (is_success = true): "Novo registo adicionado com êxito na tabela "{table}" no AppSheet.

A ação deve falhar e parar a execução de um guia interativo:

Se for comunicado um erro fatal, como credenciais incorretas, nenhuma ligação ao servidor ou outro: "Erro ao executar a ação "Adicionar registo". Motivo: {0}''.format(error.Stacktrace)

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

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

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

 Geral

Eliminar registo

Elimine um registo numa tabela no AppSheet.

Parâmetros

Nome do parâmetro Tipo Valor predefinido É obrigatório Descrição
Nome da tabela String N/A Sim Especifique o nome da tabela na qual quer eliminar um registo.
Objeto JSON de registo JSON Sim Especifique o objeto JSON do registo que tem de ser eliminado. Só tem de fornecer a chave do identificador exclusivo do registo.

É apresentado em

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

Resultados da ação

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

A ação não deve falhar nem parar a execução de um guia interativo:

Se os dados estiverem disponíveis (is_success = true): "O registo na tabela "{table}" foi eliminado com êxito no AppSheet.

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

A ação deve falhar e parar a execução de um guia interativo:

Se for comunicado um erro fatal, como credenciais incorretas, sem ligação ao servidor ou outro: "Erro ao executar a ação "Eliminar registo". Motivo: {0}''.format(error.Stacktrace)

Se não existirem dados na resposta: "Erro ao executar a ação "Eliminar registo". Motivo: foi fornecido um payload inválido. Verifique a ortografia do nome da tabela e a estrutura do objeto JSON do registo."

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

Erro ao executar a ação "Eliminar registo". Motivo: foi fornecido um objeto JSON inválido. Verifique a estrutura.

 Geral

Apresentar tabelas

Liste as tabelas disponíveis numa app no AppSheet.

Parâmetros

Nome do parâmetro Tipo Valor predefinido É obrigatório Descrição
Lógica de filtragem LDD

Igual

Valores possíveis:

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

É apresentado em

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

Resultados da ação

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

A ação não deve falhar nem parar a execução de um guia interativo:

Se forem encontrados resultados (is_success = true): "Foram encontradas tabelas com êxito para os critérios fornecidos no AppSheet.

Se não forem encontrados resultados (is_success = true): "Não foram encontradas tabelas para os critérios fornecidos no AppSheet.

A ação deve falhar e parar a execução de um guia interativo:

Se for comunicado um erro fatal, como credenciais incorretas, sem ligação ao servidor ou outro: "Erro ao executar a ação "List Tables". Motivo: {0}''.format(error.Stacktrace)

 Geral
Tabela de parede da caixa

Nome: mesas disponíveis

Colunas:

  • ID
  • Nome
 Geral

Tchim-tchim

Teste a conetividade ao AppSheet.

Parâmetros

Nenhum.

É apresentado em

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

Resultados da ação

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

A ação não deve falhar nem parar a execução de um guia interativo:

Se tiver êxito: "Ligação ao servidor do AppSheet estabelecida com êxito com os parâmetros de ligação fornecidos!"

A ação deve falhar e parar a execução de um guia interativo:

Se não for bem-sucedido: "Não foi possível estabelecer ligação ao servidor do AppSheet! O erro é {0}".format(exception.stacktrace)

 Geral

Pesquise registos

Pesquise registos numa tabela no AppSheet.

Parâmetros

Nome do parâmetro Tipo Valor predefinido É obrigatório Descrição
Nome da tabela String N/A Sim Especifique o nome da tabela para a qual quer obter detalhes.
Consulta do seletor String N/A Não Especifique a consulta do seletor, que vai ser usada para limitar os resultados. Se não for fornecido nada, a ação devolve todos os registos.

É apresentado em

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

Resultados da ação

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

A ação não deve falhar nem parar a execução de um guia interativo:

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

Se não estiverem disponíveis dados (is_success=false): não foram encontrados registos com base nos critérios fornecidos na tabela "{table}" no AppSheet.

A ação deve falhar e parar a execução de um guia interativo:

Se for comunicado um erro fatal, como credenciais incorretas, sem ligação ao servidor, entre outros: "Erro ao executar a ação "Pesquisar registos". Motivo: {0}''.format(error.Stacktrace)

Se "Message" na resposta: "Error executing action "Search Records". Motivo: {0}''.format(Message)

 Geral
Tabela de parede da caixa Registos de nome: Geral

Atualize o registo

Atualize um registo numa tabela no AppSheet.

Parâmetros

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

É apresentado em

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

Resultados da ação

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

A ação não deve falhar nem parar a execução de um guia interativo:

Se os dados estiverem disponíveis (is_success = true):"Successfully updated record in table "{table}" in AppSheet.

A ação deve falhar e parar a execução de um guia interativo:

Se ocorrer um erro fatal, como credenciais incorretas, sem ligação ao servidor ou outro: "Erro ao executar a ação "Atualizar registo". Motivo: {0}''.format(error.Stacktrace)

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

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

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

 Geral

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