Integrar AppSheet con Google SecOps

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

Versión de la integración: 3.0

Casos prácticos

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 Cadena https://api.appsheet.com Sí Raíz de la API de la instancia de AppSheet.
ID de aplicación Cadena N/A Sí ID de la aplicación de AppSheet.
Token de acceso Contraseña N/A Sí Token de acceso de la aplicación AppSheet.
Verificar SSL Casilla Marcada Sí Si se selecciona esta opción, la integración valida el certificado SSL al conectarse al servidor de AppSheet.

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

Si es necesario, puedes hacer cambios más adelante. Después de configurar una instancia de integración, puedes usarla en los cuadernos de estrategias. Para obtener más información sobre cómo configurar y admitir varias instancias, consulta Admitir varias instancias.

Acciones

Para obtener más información sobre las acciones, consulta Responder a acciones pendientes desde Tu espacio de trabajo y Realizar una acción manual.

Añadir registro

Añadir un registro a una tabla de AppSheet.

Parámetros

Nombre del parámetro Tipo Valor predeterminado Es obligatorio Descripción
Nombre de la tabla Cadena N/A Sí Especifica el nombre de la tabla a la que quieres añadir un nuevo registro.
Registrar objeto JSON JSON Sí Especifica el objeto JSON del registro que se debe añadir.

Fecha de ejecución

Esta acción no se ejecuta en entidades.

Resultados de la acción

Resultado de la secuencia de comandos
Nombre del resultado del script Opciones de valor Ejemplo
is_success Verdadero/Falso is_success=False
Panel 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 ha añadido correctamente un nuevo registro a la tabla "{table}" en AppSheet.

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

Si se informa de un error grave, como credenciales incorrectas, no hay conexión con el servidor u otro error: "Error al ejecutar la acción "Añadir registro". Motivo: {0}''.format(error.Stacktrace)

Si no hay datos en la respuesta: "Error al ejecutar la acción "Añadir registro". Motivo: se ha proporcionado una carga útil no válida. Comprueba la ortografía del nombre de la tabla y la estructura del objeto JSON del registro.

Si en la respuesta aparece "Message" (Mensaje): "Error al ejecutar la acción "Add Record" (Añadir registro). Motivo: {0}''.format(Message)

Objeto JSON no válido: error al ejecutar la acción "Añadir registro". Motivo: se ha proporcionado un objeto JSON no válido. Comprueba la estructura.

 General

Eliminar registro

Eliminar un registro de una tabla en AppSheet.

Parámetros

Nombre del parámetro Tipo Valor predeterminado Es obligatorio Descripción
Nombre de la tabla Cadena N/A Sí Especifica el nombre de la tabla en la que quieras eliminar un registro.
Registrar objeto JSON JSON Sí Especifica el objeto JSON del registro que se debe eliminar. Solo tienes que 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 la secuencia de comandos
Nombre del resultado del script Opciones de valor Ejemplo
is_success Verdadero/Falso is_success=False
Panel 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 ha eliminado correctamente el registro de la tabla "{table}" en AppSheet.

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

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

Si se informa de un error grave, como credenciales incorrectas, no hay conexión con el servidor u otro: "Error al ejecutar la acción "Eliminar registro". Motivo: {0}''.format(error.Stacktrace)

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

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

Error al ejecutar la acción "Eliminar registro". Motivo: se ha proporcionado un objeto JSON no válido. Comprueba la estructura.

 General

Lista de tablas

Lista las tablas disponibles en una aplicación de AppSheet.

Parámetros

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

Igual

Posibles valores:

  • Igual
  • Contiene
 No Especifica la lógica de filtro que se debe aplicar.
Valor de filtro Cadena N/A No Especifica el valor que se debe usar en el filtro. Si se selecciona "Igual", 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.
Número máximo de tablas que se devolverán Entero 50 No Especifica cuántas tablas quieres que se devuelvan. Valor predeterminado: 50.

Fecha de ejecución

Esta acción no se ejecuta en entidades.

Resultados de la acción

Resultado de la secuencia de comandos
Nombre del resultado del script Opciones de valor Ejemplo
is_success Verdadero/Falso is_success=False
Resultado de JSON
{
    "Tables": [
        {
            "name": "Hash identificiation",
            "id": "Hash identificiation"
        }
    ]
}
Panel 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 encuentran resultados (is_success = true): "Se han encontrado correctamente tablas que cumplen los criterios proporcionados en AppSheet.

Si no se encuentran resultados (is_success = true): "No se han encontrado tablas que coincidan con los criterios proporcionados en AppSheet.

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

Si se informa de un error grave, como credenciales incorrectas, no hay conexión con el servidor u otro error: "Error al ejecutar la acción "List Tables". Motivo: {0}''.format(error.Stacktrace)

 General
Tabla del panel 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 la secuencia de comandos
Nombre del resultado del script Opciones de valor Ejemplo
is_success Verdadero/Falso is_success=False
Panel 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 establece correctamente: "Successfully connected to the AppSheet server with the provided connection parameters!" ("Se ha conectado correctamente al servidor de AppSheet con los parámetros de conexión proporcionados").

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

Si no funciona: "No se ha podido conectar con el servidor de AppSheet. Error: {0}".format(exception.stacktrace)

 General

Buscar registros

Buscar registros en una tabla de AppSheet.

Parámetros

Nombre del parámetro Tipo Valor predeterminado Es obligatorio Descripción
Nombre de la tabla Cadena N/A Sí Especifica el nombre de la tabla de la que quieres obtener los detalles.
Selector Query Cadena 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 la secuencia de comandos
Nombre del resultado del script Opciones de valor Ejemplo
is_success Verdadero/Falso is_success=False
Panel 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 han recuperado correctamente los registros de la tabla "{table}" de AppSheet según los criterios proporcionados.

Si no hay datos disponibles (is_success=false): no se han encontrado registros basados en los criterios proporcionados en la tabla "{table}" de AppSheet.

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

Si se informa de un error grave, como credenciales incorrectas, no hay conexión con el servidor u otro: "Error al ejecutar la acción "Buscar registros". Motivo: {0}''.format(error.Stacktrace)

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

 General
Tabla del panel de casos Nombre: registros General

Actualizar registro

Actualizar un registro de una tabla en AppSheet.

Parámetros

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

Fecha de ejecución

Esta acción no se ejecuta en entidades.

Resultados de la acción

Resultado de la secuencia de comandos
Nombre del resultado del script Opciones de valor Ejemplo
is_success Verdadero/Falso is_success=False
Panel 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 ha actualizado correctamente el registro de 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 grave, como credenciales incorrectas, no hay conexión con el servidor u otro: "Error al ejecutar la acción "Actualizar registro". Motivo: {0}''.format(error.Stacktrace)

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

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

Error al ejecutar la acción "Update Record". Motivo: se ha proporcionado un objeto JSON no válido. Comprueba la estructura.

 General

¿Necesitas más ayuda? Recibe respuestas de los miembros de la comunidad y de los profesionales de Google SecOps.