Integrare AppSheet con Google SecOps

Questo documento spiega come integrare AppSheet con Google Security Operations (Google SecOps).

Versione integrazione: 3.0

Casi d'uso

Eseguire azioni CRUD.

Parametri di integrazione

Utilizza i seguenti parametri per configurare l'integrazione:

Nome parametro Tipo Valore predefinito È obbligatorio Descrizione
Root API Stringa https://api.appsheet.com Sì Radice dell'API dell'istanza AppSheet.
ID app Stringa N/D Sì ID dell'applicazione AppSheet.
Token di accesso Password N/D Sì Token di accesso dell'applicazione AppSheet.
Verifica SSL Casella di controllo Selezionata Sì Se selezionata, l'integrazione convalida il certificato SSL quando si connette al server AppSheet.

Per istruzioni su come configurare un'integrazione in Google SecOps, consulta Configurare le integrazioni.

Se necessario, potrai apportare modifiche in un secondo momento. Dopo aver configurato un'istanza di integrazione, puoi utilizzarla nei playbook. Per saperne di più su come configurare e supportare più istanze, consulta Supportare più istanze.

Azioni

Per ulteriori informazioni sulle azioni, vedi Rispondere alle azioni in attesa dalla tua scrivania e Eseguire un'azione manuale.

Aggiungi record

Aggiungere un record a una tabella in AppSheet.

Parametri

Nome parametro Tipo Valore predefinito È obbligatorio Descrizione
Nome tabella Stringa N/D Sì Specifica il nome della tabella a cui vuoi aggiungere un nuovo record.
Oggetto JSON record JSON Sì Specifica l'oggetto JSON del record da aggiungere.

Pubblica su

Questa azione non viene eseguita sulle entità.

Risultati dell'azione

Risultato dello script
Nome del risultato dello script Opzioni del valore Esempio
is_success Vero/Falso is_success=False
Bacheca casi
Tipo di risultato Descrizione Tipo
Messaggio di output*

L'azione non deve non riuscire né interrompere l'esecuzione di un playbook:

Se i dati sono disponibili (is_success = true): "Successfully added new record in table "{table}" in AppSheet.

L'azione deve non riuscire e interrompere l'esecuzione di un playbook:

Se viene segnalato un errore irreversibile, ad esempio credenziali errate, nessuna connessione al server o altro: "Errore durante l'esecuzione dell'azione "Aggiungi record". Motivo: {0}''.format(error.Stacktrace)

Se non ci sono dati nella risposta: "Errore durante l'esecuzione dell'azione "Aggiungi record". Motivo: è stato fornito un payload non valido. Controlla l'ortografia del nome della tabella e la struttura dell'oggetto JSON del record.'

Se nella risposta è presente "Messaggio": "Errore durante l'esecuzione dell'azione "Aggiungi record". Motivo: {0}''.format(Message)

Oggetto JSON non valido: errore durante l'esecuzione dell'azione "Aggiungi record". Motivo: è stato fornito un oggetto JSON non valido. Controlla la struttura.

 Generale

Elimina record

Elimina un record in una tabella in AppSheet.

Parametri

Nome parametro Tipo Valore predefinito È obbligatorio Descrizione
Nome tabella Stringa N/D Sì Specifica il nome della tabella in cui vuoi eliminare un record.
Oggetto JSON record JSON Sì Specifica l'oggetto JSON del record da eliminare. Devi solo fornire la chiave identificatore univoca del record.

Pubblica su

Questa azione non viene eseguita sulle entità.

Risultati dell'azione

Risultato dello script
Nome del risultato dello script Opzioni del valore Esempio
is_success Vero/Falso is_success=False
Bacheca casi
Tipo di risultato Descrizione Tipo
Messaggio di output*

L'azione non deve non riuscire né interrompere l'esecuzione di un playbook:

Se i dati sono disponibili (is_success = true): "Record eliminato correttamente nella tabella "{table}" in AppSheet.

Se il codice di stato è 200, ma rowNumber è null (is_success=true): il record fornito non esisteva nella tabella "{table}" in AppSheet.

L'azione deve non riuscire e interrompere l'esecuzione di un playbook:

Se viene segnalato un errore irreversibile, ad esempio credenziali errate, nessuna connessione al server o altro: "Errore durante l'esecuzione dell'azione "Elimina record". Motivo: {0}''.format(error.Stacktrace)

Se non ci sono dati nella risposta: "Errore durante l'esecuzione dell'azione "Elimina record". Motivo: è stato fornito un payload non valido. Controlla l'ortografia del nome della tabella e la struttura dell'oggetto JSON del record.'

Se nella risposta è presente "Message": "Error executing action "Delete Record". Motivo: {0}''.format(Message)

Errore durante l'esecuzione dell'azione "Elimina record". Motivo: è stato fornito un oggetto JSON non valido. Controlla la struttura.

 Generale

List Tables

Elenca le tabelle disponibili in un'app in AppSheet.

Parametri

Nome parametro Tipo Valore predefinito È obbligatorio Descrizione
Logica di filtro DDL

Uguale

Valori possibili:

  • Uguale
  • Contiene
 No Specifica la logica di filtro da applicare.
Valore filtro Stringa N/D No Specifica il valore da utilizzare nel filtro. Se è selezionato "Uguale", l'azione tenterà di trovare la corrispondenza esatta tra gli elementi. Se è selezionato "Contiene", l'azione tenterà di trovare gli elementi che contengono quella sottostringa. Se non viene fornito alcun valore in questo parametro, il filtro non verrà applicato.
Numero massimo di tabelle da restituire Numero intero 50 No Specifica il numero di tabelle da restituire. Valore predefinito: 50.

Pubblica su

Questa azione non viene eseguita sulle entità.

Risultati dell'azione

Risultato dello script
Nome del risultato dello script Opzioni del valore Esempio
is_success Vero/Falso is_success=False
Risultato JSON
{
    "Tables": [
        {
            "name": "Hash identificiation",
            "id": "Hash identificiation"
        }
    ]
}
Bacheca casi
Tipo di risultato Descrizione Tipo
Messaggio di output*

L'azione non deve non riuscire né interrompere l'esecuzione di un playbook:

Se sono stati trovati risultati (is_success = true): "Sono state trovate correttamente le tabelle per i criteri forniti in AppSheet.

Se non sono stati trovati risultati (is_success = true): "Nessuna tabella trovata per i criteri forniti in AppSheet.

L'azione deve non riuscire e interrompere l'esecuzione di un playbook:

Se viene segnalato un errore irreversibile, ad esempio credenziali errate, nessuna connessione al server o altro: "Errore durante l'esecuzione dell'azione "Elenca tabelle". Motivo: {0}''.format(error.Stacktrace)

 Generale
Tabella Bacheca casi

Nome:Tavoli disponibili

Colonne:

  • ID
  • Nome
 Generale

Dindin

Testa la connettività ad AppSheet.

Parametri

Nessuno.

Pubblica su

Questa azione non viene eseguita sulle entità.

Risultati dell'azione

Risultato dello script
Nome del risultato dello script Opzioni del valore Esempio
is_success Vero/Falso is_success=False
Bacheca casi
Tipo di risultato Descrizione Tipo
Messaggio di output*

L'azione non deve non riuscire né interrompere l'esecuzione di un playbook:

Se l'operazione va a buon fine: "Connessione al server AppSheet riuscita con i parametri di connessione forniti."

L'azione deve non riuscire e interrompere l'esecuzione di un playbook:

Se l'operazione non va a buon fine: "Impossibile connettersi al server AppSheet. Error is {0}".format(exception.stacktrace)

 Generale

Cerca record

Cerca record in una tabella in AppSheet.

Parametri

Nome parametro Tipo Valore predefinito È obbligatorio Descrizione
Nome tabella Stringa N/D Sì Specifica il nome della tabella per cui vuoi recuperare i dettagli.
Query del selettore Stringa N/D No Specifica la query del selettore, che verrà utilizzata per limitare i risultati. Se non viene fornito alcun valore, l'azione restituirà tutti i record.

Pubblica su

Questa azione non viene eseguita sulle entità.

Risultati dell'azione

Risultato dello script
Nome del risultato dello script Opzioni del valore Esempio
is_success Vero/Falso is_success=False
Bacheca casi
Tipo di risultato Descrizione Tipo
Messaggio di output*

L'azione non deve non riuscire né interrompere l'esecuzione di un playbook:

Se i dati sono disponibili (is_success = true): "Record recuperati correttamente in base ai criteri forniti dalla tabella "{table}" in AppSheet.

Se non sono disponibili dati (is_success=false): non sono stati trovati record in base ai criteri forniti nella tabella "{table}" in AppSheet.

L'azione deve non riuscire e interrompere l'esecuzione di un playbook:

Se viene segnalato un errore irreversibile, ad esempio credenziali errate, nessuna connessione al server o altro: "Errore durante l'esecuzione dell'azione "Cerca record". Motivo: {0}''.format(error.Stacktrace)

Se nella risposta è presente "Message": "Error executing action "Search Records". Motivo: {0}''.format(Message)

 Generale
Tabella Bacheca casi Nome:record Generale

Aggiorna record

Aggiorna un record in una tabella in AppSheet.

Parametri

Nome parametro Tipo Valore predefinito È obbligatorio Descrizione
Nome tabella Stringa N/D Sì Specifica il nome della tabella in cui vuoi aggiornare un record.
Oggetto JSON record JSON Sì Specifica l'oggetto JSON del record da aggiornare. Devi fornire la chiave dell'identificatore univoco e i campi che vuoi aggiornare.

Pubblica su

Questa azione non viene eseguita sulle entità.

Risultati dell'azione

Risultato dello script
Nome del risultato dello script Opzioni del valore Esempio
is_success Vero/Falso is_success=False
Bacheca casi
Tipo di risultato Descrizione Tipo
Messaggio di output*

L'azione non deve non riuscire né interrompere l'esecuzione di un playbook:

Se i dati sono disponibili (is_success = true):"Record aggiornato correttamente nella tabella "{table}" in AppSheet.

L'azione deve non riuscire e interrompere l'esecuzione di un playbook:

Se si verifica un errore irreversibile, ad esempio credenziali errate, nessuna connessione al server, altro: "Errore durante l'esecuzione dell'azione "Aggiorna record". Motivo: {0}''.format(error.Stacktrace)

Se non ci sono dati nella risposta: "Errore durante l'esecuzione dell'azione "Aggiorna record". Motivo: è stato fornito un payload non valido. Controlla l'ortografia del nome della tabella e la struttura dell'oggetto JSON del record.'

Se nella risposta è presente "Message": "Error executing action "Update Record". Motivo: {0}''.format(Message)

Errore durante l'esecuzione dell'azione "Aggiorna record". Motivo: è stato fornito un oggetto JSON non valido. Controlla la struttura.

 Generale

Hai bisogno di ulteriore assistenza? Ricevi risposte dai membri della community e dai professionisti di Google SecOps.