Integra AppSheet con Google SecOps

En este documento, se explica cómo integrar AppSheet en Google Security Operations (Google SecOps).

Versión de la integración: 3.0

Casos de uso

Realizar acciones de CRUD

Parámetros de integración

Usa los siguientes parámetros para configurar la integración:

Nombre del parámetro Tipo Valor predeterminado Es obligatorio. Descripción
Raíz de la API String https://api.appsheet.com Sí Es la raíz de la API de la instancia de AppSheet.
ID de la aplicación String N/A Sí ID de la aplicación de AppSheet.
Token de acceso Contraseña N/A Sí Es el token de acceso de la aplicación de AppSheet.
Verificar SSL Casilla de verificación Marcado Sí Si se selecciona esta opción, la integración valida el certificado SSL cuando se conecta al servidor de AppSheet.

Si quieres obtener instrucciones para configurar una integración en Google SecOps, consulta Configura integraciones.

Si es necesario, puedes hacer cambios más adelante. Después de configurar una instancia de integración, puedes usarla en las guías. Para obtener más información sobre cómo configurar y admitir varias instancias, consulta Compatibilidad con varias instancias.

Acciones

Para obtener más información sobre las acciones, consulta Cómo responder a las acciones pendientes desde Tu escritorio y Cómo realizar una acción manual.

Agregar registro

Agrega un registro a una tabla en AppSheet.

Parámetros

Nombre del parámetro Tipo Valor predeterminado Es obligatorio. Descripción
Nombre de la tabla String N/A Sí Especifica el nombre de la tabla a la que deseas agregar un registro nuevo.
Objeto JSON de registro JSON Sí Especifica el objeto JSON del registro que se debe agregar.

Fecha de ejecución

Esta acción no se ejecuta en entidades.

Resultados de la acción

Resultado de secuencia de comandos
Nombre del resultado de la secuencia de comandos Opciones de valor Ejemplo
is_success Verdadero/Falso is_success=False
Muro de casos
Tipo de resultado Descripción Tipo
Mensaje de salida*

La acción no debe fallar ni detener la ejecución de una guía:

Si hay datos disponibles (is_success = true): "Se agregó correctamente un nuevo registro en la tabla "{table}" en AppSheet.

La acción debería fallar y detener la ejecución de la guía:

Si se informa un error no recuperable, como credenciales incorrectas, falta de conexión con el servidor o algún otro problema, se mostrará el mensaje "Error al ejecutar la acción "Agregar registro"". Reason: {0}''.format(error.Stacktrace)

Si no hay datos en la respuesta: "Error al ejecutar la acción "Agregar registro". Motivo: Se proporcionó una carga útil no válida. Verifica la ortografía del nombre de la tabla y la estructura del objeto JSON del registro".

Si en la respuesta aparece "Message", se mostrará el mensaje "Error executing action "Add Record"". Motivo: {0}''.format(Message)

Objeto JSON no válido: Se produjo un error al ejecutar la acción "Agregar registro". Motivo: Se proporcionó un objeto JSON no válido. Verifica la estructura.

 General

Borrar registro

Borra un registro en una tabla de AppSheet.

Parámetros

Nombre del parámetro Tipo Valor predeterminado Es obligatorio. Descripción
Nombre de la tabla String N/A Sí Especifica el nombre de la tabla en la que deseas borrar un registro.
Objeto JSON de registro JSON Sí Especifica el objeto JSON del registro que se debe borrar. Solo debes proporcionar la clave del identificador único del registro.

Fecha de ejecución

Esta acción no se ejecuta en entidades.

Resultados de la acción

Resultado de secuencia de comandos
Nombre del resultado de la secuencia de comandos Opciones de valor Ejemplo
is_success Verdadero/Falso is_success=False
Muro de casos
Tipo de resultado Descripción Tipo
Mensaje de salida*

La acción no debe fallar ni detener la ejecución de una guía:

Si hay datos disponibles (is_success = true): "Se borró correctamente el registro de la tabla "{table}" en AppSheet.

Si el código de estado es 200, pero rowNumber es nulo (is_success=true): El registro proporcionado no existía en la tabla "{table}" de AppSheet.

La acción debería fallar y detener la ejecución de la guía:

Si se informa un error fatal, como credenciales incorrectas, falta de conexión con el servidor o algún otro problema, se mostrará el mensaje "Error al ejecutar la acción "Borrar registro". Reason: {0}''.format(error.Stacktrace)

Si no hay datos en la respuesta: "Error al ejecutar la acción "Borrar registro". Motivo: Se proporcionó una carga útil no válida. Verifica la ortografía del nombre de la tabla y la estructura del objeto JSON del registro".

Si la respuesta incluye el mensaje "Message", se mostrará el siguiente mensaje: "Error al ejecutar la acción "Borrar registro". Motivo: {0}''.format(Message)

Se produjo un error al ejecutar la acción "Borrar registro". Motivo: Se proporcionó un objeto JSON no válido. Verifica la estructura.

 General

List Tables

Enumera las tablas disponibles en una app de AppSheet.

Parámetros

Nombre del parámetro Tipo Valor predeterminado Es obligatorio. Descripción
Lógica de filtro DDL

Igual

Valores posibles:

  • Igual
  • Contiene
 No Especifica qué lógica de filtro se debe aplicar.
Valor del filtro String N/A No Especifica qué valor se debe usar en el filtro. Si se selecciona "Igual a", la acción intentará encontrar la coincidencia exacta entre los elementos. Si se selecciona "Contiene", la acción intentará encontrar los elementos que contengan esa subcadena. Si no se proporciona nada en este parámetro, no se aplicará el filtro.
Cantidad máxima de tablas que se devolverán Número entero 50 No Especifica cuántas tablas se devolverán. El valor predeterminado es 50.

Fecha de ejecución

Esta acción no se ejecuta en entidades.

Resultados de la acción

Resultado de secuencia de comandos
Nombre del resultado de la secuencia de comandos Opciones de valor Ejemplo
is_success Verdadero/Falso is_success=False
Resultado de JSON
{
    "Tables": [
        {
            "name": "Hash identificiation",
            "id": "Hash identificiation"
        }
    ]
}
Muro de casos
Tipo de resultado Descripción Tipo
Mensaje de salida*

La acción no debe fallar ni detener la ejecución de una guía:

Si se encontraron resultados (is_success = true): "Se encontraron correctamente tablas para los criterios proporcionados en AppSheet.

Si no se encontraron resultados (is_success = true): "No se encontraron tablas para los criterios proporcionados en AppSheet.

La acción debería fallar y detener la ejecución de la guía:

Si se informa un error fatal, como credenciales incorrectas, falta de conexión con el servidor o algún otro problema: "Error al ejecutar la acción "List Tables". Reason: {0}''.format(error.Stacktrace)

 General
Tabla del muro de casos

Nombre: Mesas disponibles

Columnas:

  • ID
  • Nombre
 General

Ping

Prueba la conectividad con AppSheet.

Parámetros

Ninguno

Fecha de ejecución

Esta acción no se ejecuta en entidades.

Resultados de la acción

Resultado de secuencia de comandos
Nombre del resultado de la secuencia de comandos Opciones de valor Ejemplo
is_success Verdadero/Falso is_success=False
Muro de casos
Tipo de resultado Descripción Tipo
Mensaje de salida*

La acción no debe fallar ni detener la ejecución de una guía:

Si la conexión se realiza correctamente: "Successfully connected to the AppSheet server with the provided connection parameters!"

La acción debería fallar y detener la ejecución de la guía:

Si no se realiza correctamente: "No se pudo conectar al servidor de AppSheet. Error is {0}".format(exception.stacktrace)

 General

Registros de búsqueda

Buscar registros en una tabla de AppSheet

Parámetros

Nombre del parámetro Tipo Valor predeterminado Es obligatorio. Descripción
Nombre de la tabla String N/A Sí Especifica el nombre de la tabla para la que deseas recuperar detalles.
Consulta del selector String N/A No Especifica la consulta del selector, que se usará para limitar los resultados. Si no se proporciona nada, la acción devolverá todos los registros.

Fecha de ejecución

Esta acción no se ejecuta en entidades.

Resultados de la acción

Resultado de secuencia de comandos
Nombre del resultado de la secuencia de comandos Opciones de valor Ejemplo
is_success Verdadero/Falso is_success=False
Muro de casos
Tipo de resultado Descripción Tipo
Mensaje de salida*

La acción no debe fallar ni detener la ejecución de una guía:

Si hay datos disponibles (is_success = true): "Se recuperaron correctamente los registros según los criterios proporcionados de la tabla "{table}" en AppSheet.

Si no hay datos disponibles (is_success=false): No se encontraron registros según los criterios proporcionados en la tabla "{table}" en AppSheet.

La acción debería fallar y detener la ejecución de la guía:

Si se informa un error fatal, como credenciales incorrectas, falta de conexión con el servidor o algún otro problema, se mostrará el mensaje "Error al ejecutar la acción "Search Records". Reason: {0}''.format(error.Stacktrace)

Si aparece "Message" en la respuesta: "Error al ejecutar la acción "Search Records". Motivo: {0}''.format(Message)

 General
Tabla del muro de casos Nombre: Registros General

Actualizar registro

Actualiza un registro en una tabla de AppSheet.

Parámetros

Nombre del parámetro Tipo Valor predeterminado Es obligatorio. Descripción
Nombre de la tabla String N/A Sí Especifica el nombre de la tabla en la que deseas actualizar un registro.
Objeto JSON de registro JSON Sí Especifica el objeto JSON del registro que se debe actualizar. Debes proporcionar la clave del identificador único y los campos que deseas actualizar.

Fecha de ejecución

Esta acción no se ejecuta en entidades.

Resultados de la acción

Resultado de secuencia de comandos
Nombre del resultado de la secuencia de comandos Opciones de valor Ejemplo
is_success Verdadero/Falso is_success=False
Muro de casos
Tipo de resultado Descripción Tipo
Mensaje de salida*

La acción no debe fallar ni detener la ejecución de una guía:

Si hay datos disponibles (is_success = true):"Se actualizó correctamente el registro en la tabla "{table}" en AppSheet.

La acción debería fallar y detener la ejecución de la guía:

Si se produce un error fatal, como credenciales incorrectas, falta de conexión con el servidor o algún otro problema, se mostrará el mensaje "Error al ejecutar la acción "Actualizar registro". Reason: {0}''.format(error.Stacktrace)

Si no hay datos en la respuesta: "Error al ejecutar la acción "Actualizar registro". Motivo: Se proporcionó una carga útil no válida. Verifica la ortografía del nombre de la tabla y la estructura del objeto JSON del registro".

Si aparece "Message" en la respuesta: "Error executing action "Update Record". Motivo: {0}''.format(Message)

Se produjo un error al ejecutar la acción "Update Record". Motivo: Se proporcionó un objeto JSON no válido. Verifica la estructura.

 General

¿Necesitas más ayuda? Obtén respuestas de miembros de la comunidad y profesionales de Google SecOps.