Integra AppSheet en Google SecOps

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

Casos de uso

Realizar acciones 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í	Es el 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, la integración valida el certificado SSL cuando se conecta al servidor de AppSheet.

Para obtener instrucciones sobre cómo configurar una integración en Google SecOps, consulta Configura integraciones.

Si es necesario, puedes realizar 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 Cómo admitir varias instancias.

Acciones

Para obtener más información sobre las acciones, consulta Responde a las acciones pendientes desde tu escritorio y Ejecuta una acción manual en tu caso.

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 o falso	is_success=False

Muro de casos

Tipo de resultado	Descripción	Tipo
Mensaje de salida*	La acción no debería fallar ni detener la ejecución de una guía: Si hay datos disponibles (is_success = true): "Se agregó correctamente un registro nuevo en la tabla "{table}" de AppSheet. La acción debería fallar y detener la ejecución de una guía: Si se informa un error grave, como credenciales incorrectas, falta de conexión con el servidor, entre otros: "Error al ejecutar la acción "Agregar registro". Reason: {0}''.format(error.Stacktrace) Si no hay datos en la respuesta: "Error executing action "Add Record". 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 el "Mensaje" en la respuesta es: "Error executing action "Add Record". Reason: {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

Borrar un registro de 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 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 de 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 o falso	is_success=False

Muro de casos

Tipo de resultado	Descripción	Tipo
Mensaje de salida*	La acción no debería fallar ni detener la ejecución de una guía: Si hay datos disponibles (is_success = true): "Successfully deleted record in table "{table}" in 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 una guía: Si se informa un error grave, como credenciales incorrectas, falta de conexión con el servidor, etc.: "Error al ejecutar la acción "Borrar registro". Reason: {0}''.format(error.Stacktrace) Si no hay datos en la respuesta: "Error executing action "Delete Record". 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 el "Mensaje" en la respuesta es: "Error executing action "Delete Record". Reason: {0}''.format(Message) Se produjo un error cuando se ejecutaba la acción "Borrar registro". Motivo: Se proporcionó un objeto JSON no válido. Verifica la estructura.	General

Enumera tablas

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 filtrado	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", la acción intentará encontrar la coincidencia exacta entre los elementos y, 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 mostrarán	Número entero	50	No	Especifica cuántas tablas se deben mostrar. Valor predeterminado: 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 o 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 debería fallar ni detener la ejecución de una guía: Si se encontraron resultados (is_success = true): "Successfully found tables for the provided criteria in AppSheet. Si no se encuentran resultados (is_success = true): "No tables were found for the provided criteria in AppSheet. La acción debería fallar y detener la ejecución de una guía: Si se informa un error fatal, como credenciales incorrectas, falta de conexión al servidor, entre otros: "Error al ejecutar la acción "List Tables". Reason: {0}''.format(error.Stacktrace)	General
Tabla del muro de casos	Nombre: Tablas 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 o falso	is_success=False

Muro de casos

Tipo de resultado	Descripción	Tipo
Mensaje de salida*	La acción no debería fallar ni detener la ejecución de una guía: Si se realiza correctamente: "Se estableció la conexión con el servidor de AppSheet con los parámetros de conexión proporcionados". La acción debería fallar y detener la ejecución de una guía: Si no se realiza correctamente: "Failed to connect to the AppSheet server! Error is {0}".format(exception.stacktrace)	General

Registros de búsqueda

Buscar registros en 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 de la que deseas recuperar los detalles.
Selector Query	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 o falso	is_success=False

Muro de casos

Tipo de resultado	Descripción	Tipo
Mensaje de salida*	La acción no debería fallar ni detener la ejecución de una guía: Si hay datos disponibles (is_success = true): "Successfully retrieved records based on the provided criteria from table "{table}" in AppSheet. Si no hay datos disponibles (is_success=false): No se encontraron registros según los criterios proporcionados en la tabla "{table}" de AppSheet. La acción debería fallar y detener la ejecución de una guía: Si se informa un error fatal, como credenciales incorrectas, falta de conexión con el servidor, entre otros: "Error executing action "Search Records". Reason: {0}''.format(error.Stacktrace) Si el "Mensaje" en la respuesta es: "Error executing action "Search Records". Reason: {0}''.format(Message)	General
Tabla del muro de casos	Nombre: Registros	General

Actualizar registro

Actualizar 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 de 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 o falso	is_success=False

Muro de casos

Tipo de resultado	Descripción	Tipo
Mensaje de salida*	La acción no debería 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 una guía: Si se produce un error grave, como credenciales incorrectas, falta de conexión con el servidor, entre otros: "Error al ejecutar la acción "Actualizar registro". Reason: {0}''.format(error.Stacktrace) Si no hay datos en la respuesta: "Error executing action "Update Record". 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 el mensaje en la respuesta es: "Error executing action "Update Record". Reason: {0}''.format(Message) Se produjo un error cuando se ejecutaba la acción "Actualizar registro". 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.