Integra AppSheet con Google SecOps

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

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 durante la connessione al server AppSheet.

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

Se necessario, puoi 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 Supporto di più istanze.

Azioni

Per saperne di più sulle azioni, consulta Rispondi alle azioni in attesa dalla scrivania di lavoro ed Esegui un'azione manuale nel tuo caso.

Aggiungi record

Aggiungi 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 del 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 avere esito negativo né interrompere l'esecuzione di un playbook:

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

L'azione dovrebbe 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". Reason: {0}''.format(error.Stacktrace)

Se non sono presenti 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 "Message" nella risposta è: "Error executing action "Add Record". Reason: {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 del record JSON Sì Specifica l'oggetto JSON del record da eliminare. Devi solo fornire la chiave dell'identificatore univoco 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 avere esito negativo né interrompere l'esecuzione di un playbook:

Se i dati sono disponibili (is_success = true): "Eliminazione del record nella tabella "{table}" in AppSheet riuscita.

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

L'azione dovrebbe 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". Reason: {0}''.format(error.Stacktrace)

Se non sono presenti 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 "Message" nella risposta è: "Error executing action "Delete Record". Reason: {0}''.format(Message)

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

 Generale

Elenca tabelle

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 è selezionata l'opzione "Uguale", l'azione tenterà di trovare la corrispondenza esatta tra gli elementi, mentre se è selezionata l'opzione "Contiene", l'azione tenterà di trovare gli elementi che contengono la 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 avere esito negativo né interrompere l'esecuzione di un playbook:

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

Se non vengono trovati risultati (is_success = true): "Non sono state trovate tabelle per i criteri forniti in AppSheet.

L'azione dovrebbe 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". Reason: {0}''.format(error.Stacktrace)

 Generale
Tabella della bacheca casi

Nome: Tabelle 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 avere esito negativo né interrompere l'esecuzione di un playbook:

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

L'azione dovrebbe 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 dati

Cerca i 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 di 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 avere esito negativo né interrompere l'esecuzione di un playbook:

Se i dati sono disponibili (is_success = true): "Recupero dei record in base ai criteri forniti dalla tabella "{table}" in AppSheet riuscito.

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 dovrebbe 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". Reason: {0}''.format(error.Stacktrace)

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

 Generale
Tabella della bacheca casi Nome: Records 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 del 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 avere esito negativo 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 dovrebbe non riuscire e interrompere l'esecuzione di un playbook:

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

Se non sono presenti 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 "Message" nella risposta è: "Error executing action "Update Record". Reason: {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.