Integrar o AppSheet ao Google SecOps

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

Casos de uso

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 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 do 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.

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

Ações

Para mais informações sobre ações, consulte Responder a ações pendentes na sua mesa de trabalho e Executar uma ação manual no seu caso.

Adicionar registro

Adicionar 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 em 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

Mural do caso

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 deve 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 relatado: "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: o payload fornecido é inválido. Verifique a ortografia do nome da tabela e a estrutura do objeto JSON do registro.' Se "Mensagem" na resposta: "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: o objeto JSON fornecido é inválido. 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 do 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

Mural do caso

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 excluído 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 deve 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 relatado: "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: o payload fornecido é inválido. Verifique a ortografia do nome da tabela e a estrutura do objeto JSON do registro.' Se "Mensagem" na resposta: "Erro ao executar a ação 'Excluir registro'. Motivo: {0}''.format(Message) Erro ao executar a ação "Excluir registro". Motivo: o objeto JSON fornecido é inválido. 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.
Filtrar por valor	String	N/A	Não	Especifique qual valor deve ser usado no filtro. Se "Igual" for selecionado, a ação vai tentar encontrar a correspondência exata entre os itens. Se "Contém" for 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	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"
        }
    ]
}

Mural do caso

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 para os critérios fornecidos foram encontradas no AppSheet. Se nenhum resultado for encontrado (is_success = true): "Nenhuma tabela foi encontrada para os critérios fornecidos no AppSheet. A ação deve 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 relatado: "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

Mural do caso

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 a conexão for bem-sucedida: "Conexão com o servidor do AppSheet estabelecida com os parâmetros fornecidos!" A ação deve falhar e interromper a execução de um playbook: Se não for bem-sucedida: "Falha ao 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 de que você quer recuperar os detalhes.
Consulta do seletor	String	N/A	Não	Especifique a consulta do 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

Mural do caso

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): "Os registros foram recuperados 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 deve 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 relatado: "Erro ao executar a ação 'Pesquisar registros'. Motivo: {0}''.format(error.Stacktrace) Se "Mensagem" na resposta: "Erro ao executar a ação 'Pesquisar registros'. Motivo: {0}''.format(Message)	Geral
Tabela do painel de casos	Nome: registros	Geral

Atualizar registro

Atualizar 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. É necessário fornecer a chave do identificador exclusivo e os campos que você 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

Mural do caso

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 deve falhar e interromper a execução de um playbook: Se houver um erro fatal, como credenciais incorretas, falta de conexão com o servidor, entre outros: "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: o payload fornecido é inválido. Verifique a ortografia do nome da tabela e a estrutura do objeto JSON do registro.' Se "Message" na resposta: "Error executing action "Update Record". Motivo: {0}''.format(Message) Erro ao executar a ação "Atualizar registro". Motivo: o objeto JSON fornecido é inválido. Verifique a estrutura.	Geral

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