AppSheet in Google SecOps einbinden

In diesem Dokument wird beschrieben, wie Sie AppSheet in Google Security Operations (Google SecOps) einbinden.

Integrationsversion: 3.0

Anwendungsbereiche

CRUD-Vorgänge ausführen

Integrationsparameter

Verwenden Sie die folgenden Parameter, um die Integration zu konfigurieren:

Parametername Typ Standardwert Ist obligatorisch Beschreibung
API-Stamm String https://api.appsheet.com Ja API-Stammverzeichnis der AppSheet-Instanz.
App-ID String – Ja ID der AppSheet-Anwendung.
Access Token (Zugriffstoken) Passwort – Ja Zugriffstoken der AppSheet-Anwendung.
SSL überprüfen Kästchen Aktiviert Ja Wenn diese Option ausgewählt ist, wird das SSL-Zertifikat bei der Verbindung zum AppSheet-Server validiert.

Eine Anleitung zum Konfigurieren einer Integration in Google SecOps finden Sie unter Integrationen konfigurieren.

Bei Bedarf können Sie später Änderungen vornehmen. Nachdem Sie eine Integrationsinstanz konfiguriert haben, können Sie sie in Playbooks verwenden. Weitere Informationen zum Konfigurieren und Unterstützen mehrerer Instanzen finden Sie unter Mehrere Instanzen unterstützen.

Aktionen

Weitere Informationen zu Aktionen finden Sie unter Ausstehende Aktionen über „Mein Arbeitsbereich“ bearbeiten und Manuelle Aktion ausführen.

Eintrag hinzufügen

Einer Tabelle in AppSheet einen Datensatz hinzufügen

Parameter

Parametername Typ Standardwert Ist obligatorisch Beschreibung
Tabellenname String – Ja Geben Sie den Namen der Tabelle an, der Sie einen neuen Datensatz hinzufügen möchten.
JSON-Objekt für Datensatz JSON Ja Geben Sie das JSON-Objekt des Datensatzes an, der hinzugefügt werden muss.

Ausführen am

Diese Aktion wird nicht für Elemente ausgeführt.

Aktionsergebnisse

Scriptergebnis
Name des Scriptergebnisses Wertoptionen Beispiel
is_success Wahr/falsch is_success=False
Fall-Repository
Ergebnistyp Beschreibung Typ
Ausgabemeldung*

Die Aktion darf nicht fehlschlagen und darf die Ausführung eines Playbooks nicht stoppen.

Wenn Daten verfügbar sind (is_success = true): „Successfully added new record in table {table} in AppSheet.“ (Es wurde ein neuer Datensatz in der Tabelle „{table}“ in AppSheet hinzugefügt.)

Die Aktion sollte fehlschlagen und die Playbook-Ausführung beenden:

Wenn ein schwerwiegender Fehler gemeldet wird, z. B. falsche Anmeldedaten, keine Verbindung zum Server oder „Sonstiges“: „Fehler beim Ausführen der Aktion ‚Eintrag hinzufügen‘. Grund: {0}''.format(error.Stacktrace)

Wenn keine Daten in der Antwort enthalten sind: „Fehler beim Ausführen der Aktion ‚Datensatz hinzufügen‘. Grund: Es wurde eine ungültige Nutzlast angegeben. Prüfen Sie die Schreibweise des Tabellennamens und die Struktur des JSON-Objekts des Datensatzes.“

Wenn „Message“ in der Antwort: „Error executing action ‚Add Record‘.“ Grund: {0}''.format(Message)

Ungültiges JSON-Objekt:Fehler beim Ausführen der Aktion „Datensatz hinzufügen“. Grund: Es wurde ein ungültiges JSON-Objekt angegeben. Bitte überprüfen Sie die Struktur.

 Allgemein

Eintrag löschen

Einen Datensatz in einer Tabelle in AppSheet löschen

Parameter

Parametername Typ Standardwert Ist obligatorisch Beschreibung
Tabellenname String – Ja Geben Sie den Namen der Tabelle an, in der Sie einen Datensatz löschen möchten.
JSON-Objekt für Datensatz JSON Ja Geben Sie das JSON-Objekt des Datensatzes an, der gelöscht werden soll. Sie müssen nur den Schlüssel der eindeutigen Kennung des Datensatzes angeben.

Ausführen am

Diese Aktion wird nicht für Elemente ausgeführt.

Aktionsergebnisse

Scriptergebnis
Name des Scriptergebnisses Wertoptionen Beispiel
is_success Wahr/falsch is_success=False
Fall-Repository
Ergebnistyp Beschreibung Typ
Ausgabemeldung*

Die Aktion darf nicht fehlschlagen und darf die Ausführung eines Playbooks nicht stoppen.

Wenn Daten verfügbar sind (is_success = true): „Der Datensatz in der Tabelle ‚{table}‘ in AppSheet wurde erfolgreich gelöscht.

Statuscode 200, aber „rowNumber“ ist null („is_success“=true): Der angegebene Datensatz war in der Tabelle „{table}“ in AppSheet nicht vorhanden.

Die Aktion sollte fehlschlagen und die Playbook-Ausführung beenden:

Wenn ein schwerwiegender Fehler gemeldet wird, z. B. falsche Anmeldedaten, keine Verbindung zum Server oder ein anderer Fehler: „Fehler beim Ausführen der Aktion ‚Datensatz löschen‘. Grund: {0}''.format(error.Stacktrace)

Wenn keine Daten in der Antwort enthalten sind: „Fehler beim Ausführen der Aktion ‚Datensatz löschen‘. Grund: Es wurde eine ungültige Nutzlast angegeben. Prüfen Sie die Schreibweise des Tabellennamens und die Struktur des JSON-Objekts des Datensatzes.“

Wenn „Message“ in der Antwort enthalten ist: „Error executing action ‚Delete Record‘. Grund: {0}''.format(Message)

Fehler beim Ausführen der Aktion „Datensatz löschen“. Grund: Es wurde ein ungültiges JSON-Objekt angegeben. Bitte überprüfen Sie die Struktur.

 Allgemein

Tabellen auflisten

Verfügbare Tabellen in einer App in AppSheet auflisten

Parameter

Parametername Typ Standardwert Ist obligatorisch Beschreibung
Filterlogik DDL

Gleich

Mögliche Werte:

  • Gleich
  • Enthält
 Nein Geben Sie an, welche Filterlogik angewendet werden soll.
Filterwert String – Nein Geben Sie an, welcher Wert im Filter verwendet werden soll. Wenn „Gleich“ ausgewählt ist, wird versucht, eine genaue Übereinstimmung unter den Elementen zu finden. Wenn „Enthält“ ausgewählt ist, wird versucht, Elemente zu finden, die diese Teilzeichenfolge enthalten. Wenn für diesen Parameter nichts angegeben wird, wird der Filter nicht angewendet.
Maximale Anzahl zurückzugebender Tabellen Ganzzahl 50 Nein Geben Sie an, wie viele Tabellen zurückgegeben werden sollen. Standard: 50.

Ausführen am

Diese Aktion wird nicht für Elemente ausgeführt.

Aktionsergebnisse

Scriptergebnis
Name des Scriptergebnisses Wertoptionen Beispiel
is_success Wahr/falsch is_success=False
JSON-Ergebnis
{
    "Tables": [
        {
            "name": "Hash identificiation",
            "id": "Hash identificiation"
        }
    ]
}
Fall-Repository
Ergebnistyp Beschreibung Typ
Ausgabemeldung*

Die Aktion darf nicht fehlschlagen und darf die Ausführung eines Playbooks nicht stoppen.

Wenn Ergebnisse gefunden wurden (is_success = true): „Es wurden Tabellen gefunden, die den angegebenen Kriterien in AppSheet entsprechen.

Wenn keine Ergebnisse gefunden wurden (is_success = true): „Für die angegebenen Kriterien wurden in AppSheet keine Tabellen gefunden.

Die Aktion sollte fehlschlagen und die Playbook-Ausführung beenden:

Wenn ein schwerwiegender Fehler gemeldet wird, z. B. falsche Anmeldedaten, keine Verbindung zum Server oder „Sonstiges“: „Fehler beim Ausführen der Aktion ‚Tabellen auflisten‘. Grund: {0}''.format(error.Stacktrace)

 Allgemein
Tabelle „Fall-Repository“

Name:Available Tables (Verfügbare Tabellen)

Spalten:

  • ID
  • Name
 Allgemein

Ping

Testen Sie die Verbindung zu AppSheet.

Parameter

Keine.

Ausführen am

Diese Aktion wird nicht für Elemente ausgeführt.

Aktionsergebnisse

Scriptergebnis
Name des Scriptergebnisses Wertoptionen Beispiel
is_success Wahr/falsch is_success=False
Fall-Repository
Ergebnistyp Beschreibung Typ
Ausgabemeldung*

Die Aktion darf nicht fehlschlagen und darf die Ausführung eines Playbooks nicht stoppen.

Bei Erfolg: „Successfully connected to the AppSheet server with the provided connection parameters!“ (Die Verbindung zum AppSheet-Server mit den angegebenen Verbindungsparametern wurde erfolgreich hergestellt.)

Die Aktion sollte fehlschlagen und die Playbook-Ausführung beenden:

Wenn das nicht funktioniert: „Failed to connect to the AppSheet server! Fehler: {0}".format(exception.stacktrace)

 Allgemein

Datensätze durchsuchen

In AppSheet nach Datensätzen in einer Tabelle suchen

Parameter

Parametername Typ Standardwert Ist obligatorisch Beschreibung
Tabellenname String – Ja Geben Sie den Namen der Tabelle an, für die Sie Details abrufen möchten.
Selektorabfrage String – Nein Geben Sie die Auswahlabfrage an, mit der die Ergebnisse eingeschränkt werden. Wenn nichts angegeben ist, werden alle Datensätze zurückgegeben.

Ausführen am

Diese Aktion wird nicht für Elemente ausgeführt.

Aktionsergebnisse

Scriptergebnis
Name des Scriptergebnisses Wertoptionen Beispiel
is_success Wahr/falsch is_success=False
Fall-Repository
Ergebnistyp Beschreibung Typ
Ausgabemeldung*

Die Aktion darf nicht fehlschlagen und darf die Ausführung eines Playbooks nicht stoppen.

Wenn Daten verfügbar sind (is_success = true): „Datensätze basierend auf den angegebenen Kriterien aus der Tabelle ‚{table}‘ in AppSheet abgerufen.

Wenn keine Daten verfügbar sind (is_success=false): In der Tabelle „{table}“ in AppSheet wurden anhand der angegebenen Kriterien keine Datensätze gefunden.

Die Aktion sollte fehlschlagen und die Playbook-Ausführung beenden:

Wenn ein schwerwiegender Fehler gemeldet wird, z. B. falsche Anmeldedaten, keine Verbindung zum Server oder „Sonstiges“: „Fehler beim Ausführen der Aktion ‚Datensätze durchsuchen‘. Grund: {0}''.format(error.Stacktrace)

Wenn „Message“ in der Antwort: „Error executing action ‚Search Records‘. Grund: {0}''.format(Message)

 Allgemein
Tabelle „Fall-Repository“ Name:Einträge Allgemein

Datensatz aktualisieren

Einen Datensatz in einer Tabelle in AppSheet aktualisieren

Parameter

Parametername Typ Standardwert Ist obligatorisch Beschreibung
Tabellenname String – Ja Geben Sie den Namen der Tabelle an, in der Sie einen Datensatz aktualisieren möchten.
JSON-Objekt für Datensatz JSON Ja Geben Sie das JSON-Objekt des Datensatzes an, der aktualisiert werden muss. Sie müssen den eindeutigen Kennungsschlüssel und die Felder angeben, die Sie aktualisieren möchten.

Ausführen am

Diese Aktion wird nicht für Elemente ausgeführt.

Aktionsergebnisse

Scriptergebnis
Name des Scriptergebnisses Wertoptionen Beispiel
is_success Wahr/falsch is_success=False
Fall-Repository
Ergebnistyp Beschreibung Typ
Ausgabemeldung*

Die Aktion darf nicht fehlschlagen und darf die Ausführung eines Playbooks nicht stoppen.

Wenn Daten verfügbar sind (is_success = true): „Der Datensatz in der Tabelle ‚{table}‘ in AppSheet wurde aktualisiert.

Die Aktion sollte fehlschlagen und die Playbook-Ausführung beenden:

Bei schwerwiegendem Fehler, z. B. falsche Anmeldedaten, keine Verbindung zum Server, Sonstiges: „Fehler beim Ausführen der Aktion ‚Datensatz aktualisieren‘. Grund: {0}''.format(error.Stacktrace)

Keine Daten in der Antwort: „Error executing action ‚Update Record‘.“ Grund: Es wurde eine ungültige Nutzlast angegeben. Prüfen Sie die Schreibweise des Tabellennamens und die Struktur des JSON-Objekts des Datensatzes.“

Wenn „Message“ in der Antwort enthalten ist: „Error executing action ‚Update Record‘.“ (Fehler beim Ausführen der Aktion „Datensatz aktualisieren“.) Grund: {0}''.format(Message)

Fehler beim Ausführen der Aktion „Datensatz aktualisieren“. Grund: Es wurde ein ungültiges JSON-Objekt angegeben. Bitte überprüfen Sie die Struktur.

 Allgemein

Benötigen Sie weitere Hilfe? Antworten von Community-Mitgliedern und Google SecOps-Experten erhalten