Cette page a été traduite par l'API Cloud Translation.

Intégrer AppSheet à Google SecOps

Ce document explique comment intégrer AppSheet à Google Security Operations (Google SecOps).

Version de l'intégration : 3.0

Cas d'utilisation

Effectuer des actions CRUD

Paramètres d'intégration

Utilisez les paramètres suivants pour configurer l'intégration :

Nom du paramètre	Type	Valeur par défaut	Obligatoire	Description
Racine de l'API	Chaîne	https://api.appsheet.com	Oui	Racine de l'API de l'instance AppSheet.
ID de l'application	Chaîne	N/A	Oui	ID de l'application AppSheet.
Jeton d'accès	Mot de passe	N/A	Oui	Jeton d'accès de l'application AppSheet.
Vérifier le protocole SSL	Case à cocher	Cochée	Oui	Si cette option est sélectionnée, l'intégration valide le certificat SSL lors de la connexion au serveur AppSheet.

Pour obtenir des instructions sur la configuration d'une intégration dans Google SecOps, consultez Configurer des intégrations.

Vous pourrez apporter des modifications ultérieurement, si nécessaire. Une fois que vous avez configuré une instance d'intégration, vous pouvez l'utiliser dans des playbooks. Pour savoir comment configurer et prendre en charge plusieurs instances, consultez Prise en charge de plusieurs instances.

Actions

Pour en savoir plus sur les actions, consultez Répondre aux actions en attente depuis Votre bureau et Effectuer une action manuelle.

Ajouter un enregistrement

Ajoutez un enregistrement à un tableau dans AppSheet.

Paramètres

Nom du paramètre	Type	Valeur par défaut	Obligatoire	Description
Nom de la table	Chaîne	N/A	Oui	Spécifiez le nom de la table à laquelle vous souhaitez ajouter un enregistrement.
Objet JSON d'enregistrement	JSON		Oui	Spécifiez l'objet JSON de l'enregistrement à ajouter.

Date d'exécution

Cette action ne s'applique pas aux entités.

Résultats de l'action

Résultat du script

Nom du résultat du script	Options de valeur	Exemple
is_success	Vrai/Faux	is_success=False

Mur des cas

Type de résultat	Description	Type
Message de sortie*	L'action ne doit pas échouer ni arrêter l'exécution d'un playbook : Si des données sont disponibles (is_success = true) : "Nouvel enregistrement ajouté à la table "{table}" dans AppSheet. L'action doit échouer et arrêter l'exécution d'un playbook : Si une erreur fatale est signalée (par exemple, des identifiants incorrects, une absence de connexion au serveur ou une autre erreur) : "Erreur lors de l'exécution de l'action "Ajouter un enregistrement". Raison : {0}''.format(error.Stacktrace) Si aucune donnée n'est incluse dans la réponse : "Erreur lors de l'exécution de l'action "Ajouter un enregistrement". Motif : Une charge utile non valide a été fournie. Veuillez vérifier l'orthographe du nom de la table et la structure de l'objet JSON de l'enregistrement. Si la réponse contient "Message" : "Erreur lors de l'exécution de l'action "Ajouter un enregistrement". Motif : {0}''.format(Message) Objet JSON non valide : erreur lors de l'exécution de l'action "Ajouter un enregistrement". Motif : Objet JSON non valide fourni. Veuillez vérifier la structure.	Général

Type de résultat

Description

Type

Message de sortie*

L'action ne doit pas échouer ni arrêter l'exécution d'un playbook :

Si des données sont disponibles (is_success = true) : "Nouvel enregistrement ajouté à la table "{table}" dans AppSheet.

L'action doit échouer et arrêter l'exécution d'un playbook :

Si une erreur fatale est signalée (par exemple, des identifiants incorrects, une absence de connexion au serveur ou une autre erreur) : "Erreur lors de l'exécution de l'action "Ajouter un enregistrement". Raison : {0}''.format(error.Stacktrace)

Si aucune donnée n'est incluse dans la réponse : "Erreur lors de l'exécution de l'action "Ajouter un enregistrement". Motif : Une charge utile non valide a été fournie. Veuillez vérifier l'orthographe du nom de la table et la structure de l'objet JSON de l'enregistrement.

Si la réponse contient "Message" : "Erreur lors de l'exécution de l'action "Ajouter un enregistrement". Motif : {0}''.format(Message)

Objet JSON non valide : erreur lors de l'exécution de l'action "Ajouter un enregistrement". Motif : Objet JSON non valide fourni. Veuillez vérifier la structure.

Général

Supprimer l'enregistrement

Supprimez un enregistrement dans une table AppSheet.

Paramètres

Nom du paramètre	Type	Valeur par défaut	Obligatoire	Description
Nom de la table	Chaîne	N/A	Oui	Spécifiez le nom de la table dans laquelle vous souhaitez supprimer un enregistrement.
Objet JSON d'enregistrement	JSON		Oui	Spécifiez l'objet JSON de l'enregistrement à supprimer. Il vous suffit de fournir la clé d'identifiant unique de l'enregistrement.

Date d'exécution

Cette action ne s'applique pas aux entités.

Résultats de l'action

Résultat du script

Nom du résultat du script	Options de valeur	Exemple
is_success	Vrai/Faux	is_success=False

Mur des cas

Type de résultat	Description	Type
Message de sortie*	L'action ne doit pas échouer ni arrêter l'exécution d'un playbook : Si des données sont disponibles (is_success = true) : "L'enregistrement a bien été supprimé de la table "{table}" dans AppSheet. Si le code d'état est 200, mais que rowNumber est nul (is_success=true) : l'enregistrement fourni n'existait pas dans le tableau "{table}" dans AppSheet. L'action doit échouer et arrêter l'exécution d'un playbook : Si une erreur fatale est signalée (par exemple, des identifiants incorrects, une absence de connexion au serveur ou une autre erreur) : "Erreur lors de l'exécution de l'action "Supprimer l'enregistrement". Raison : {0}''.format(error.Stacktrace) Si aucune donnée n'est présente dans la réponse : "Erreur lors de l'exécution de l'action "Supprimer l'enregistrement". Motif : Une charge utile non valide a été fournie. Veuillez vérifier l'orthographe du nom de la table et la structure de l'objet JSON de l'enregistrement. Si la réponse contient le message suivant : "Erreur lors de l'exécution de l'action "Supprimer l'enregistrement". Motif : {0}''.format(Message) Erreur lors de l'exécution de l'action "Supprimer l'enregistrement". Motif : Objet JSON non valide fourni. Veuillez vérifier la structure.	Général

Type de résultat

Description

Type

Message de sortie*

L'action ne doit pas échouer ni arrêter l'exécution d'un playbook :

Si des données sont disponibles (is_success = true) : "L'enregistrement a bien été supprimé de la table "{table}" dans AppSheet.

Si le code d'état est 200, mais que rowNumber est nul (is_success=true) : l'enregistrement fourni n'existait pas dans le tableau "{table}" dans AppSheet.

L'action doit échouer et arrêter l'exécution d'un playbook :

Si une erreur fatale est signalée (par exemple, des identifiants incorrects, une absence de connexion au serveur ou une autre erreur) : "Erreur lors de l'exécution de l'action "Supprimer l'enregistrement". Raison : {0}''.format(error.Stacktrace)

Si aucune donnée n'est présente dans la réponse : "Erreur lors de l'exécution de l'action "Supprimer l'enregistrement". Motif : Une charge utile non valide a été fournie. Veuillez vérifier l'orthographe du nom de la table et la structure de l'objet JSON de l'enregistrement.

Si la réponse contient le message suivant : "Erreur lors de l'exécution de l'action "Supprimer l'enregistrement". Motif : {0}''.format(Message)

Erreur lors de l'exécution de l'action "Supprimer l'enregistrement". Motif : Objet JSON non valide fourni. Veuillez vérifier la structure.

Général

Lister les tables

Répertoriez les tables disponibles dans une application AppSheet.

Paramètres

Nom du paramètre	Type	Valeur par défaut	Obligatoire	Description
Logique de filtrage	LDD	Égal à Valeurs possibles : Égal à Contient	Non	Spécifiez la logique de filtrage à appliquer.
Valeur du filtre	Chaîne	N/A	Non	Spécifiez la valeur à utiliser dans le filtre. Si l'option "Égal à" est sélectionnée, l'action tentera de trouver la correspondance exacte parmi les éléments. Si l'option "Contient" est sélectionnée, l'action tentera de trouver les éléments contenant cette sous-chaîne. Si rien n'est fourni dans ce paramètre, le filtre ne sera pas appliqué.
Nombre maximal de tables à renvoyer	Integer	50	Non	Spécifiez le nombre de tables à renvoyer. Valeur par défaut : 50.

Nom du paramètre

Type

Valeur par défaut

Obligatoire

Description

Logique de filtrage

LDD

Égal à

Valeurs possibles :

Égal à
Contient

Non

Spécifiez la logique de filtrage à appliquer.

Valeur du filtre

Chaîne

N/A

Non

Spécifiez la valeur à utiliser dans le filtre. Si l'option "Égal à" est sélectionnée, l'action tentera de trouver la correspondance exacte parmi les éléments. Si l'option "Contient" est sélectionnée, l'action tentera de trouver les éléments contenant cette sous-chaîne. Si rien n'est fourni dans ce paramètre, le filtre ne sera pas appliqué.

Nombre maximal de tables à renvoyer

Integer

Non

Spécifiez le nombre de tables à renvoyer. Valeur par défaut : 50.

Date d'exécution

Cette action ne s'applique pas aux entités.

Résultats de l'action

Résultat du script

Nom du résultat du script	Options de valeur	Exemple
is_success	Vrai/Faux	is_success=False

Résultat JSON

{
    "Tables": [
        {
            "name": "Hash identificiation",
            "id": "Hash identificiation"
        }
    ]
}

Mur des cas

Type de résultat	Description	Type
Message de sortie*	L'action ne doit pas échouer ni arrêter l'exécution d'un playbook : Si des résultats sont trouvés (is_success = true) : "Les tables correspondant aux critères fournis ont été trouvées dans AppSheet. Si aucun résultat n'est trouvé (is_success = true) : "Aucun tableau n'a été trouvé pour les critères fournis dans AppSheet. L'action doit échouer et arrêter l'exécution d'un playbook : Si une erreur fatale est signalée (par exemple, des identifiants incorrects, une absence de connexion au serveur ou une autre erreur) : "Erreur lors de l'exécution de l'action "Lister les tables". Raison : {0}''.format(error.Stacktrace)	Général
Tableau du mur des cas	Nom : Tables disponibles Colonnes : ID Nom	Général

Type de résultat

Description

Type

Message de sortie*

L'action ne doit pas échouer ni arrêter l'exécution d'un playbook :

Si des résultats sont trouvés (is_success = true) : "Les tables correspondant aux critères fournis ont été trouvées dans AppSheet.

Si aucun résultat n'est trouvé (is_success = true) : "Aucun tableau n'a été trouvé pour les critères fournis dans AppSheet.

L'action doit échouer et arrêter l'exécution d'un playbook :

Si une erreur fatale est signalée (par exemple, des identifiants incorrects, une absence de connexion au serveur ou une autre erreur) : "Erreur lors de l'exécution de l'action "Lister les tables". Raison : {0}''.format(error.Stacktrace)

Général

Tableau du mur des cas

Nom : Tables disponibles

Colonnes :

Général

Ping

Testez la connectivité à AppSheet.

Paramètres

Aucun

Date d'exécution

Cette action ne s'applique pas aux entités.

Résultats de l'action

Résultat du script

Nom du résultat du script	Options de valeur	Exemple
is_success	Vrai/Faux	is_success=False

Mur des cas

Type de résultat	Description	Type
Message de sortie*	L'action ne doit pas échouer ni arrêter l'exécution d'un playbook : Si l'opération réussit : "La connexion au serveur AppSheet a bien été établie avec les paramètres de connexion fournis !" L'action doit échouer et arrêter l'exécution d'un playbook : Si l'opération échoue : "Échec de la connexion au serveur AppSheet ! Error is {0}".format(exception.stacktrace)	Général

Type de résultat

Description

Type

Message de sortie*

L'action ne doit pas échouer ni arrêter l'exécution d'un playbook :

Si l'opération réussit : "La connexion au serveur AppSheet a bien été établie avec les paramètres de connexion fournis !"

L'action doit échouer et arrêter l'exécution d'un playbook :

Si l'opération échoue : "Échec de la connexion au serveur AppSheet ! Error is {0}".format(exception.stacktrace)

Général

Rechercher des enregistrements

Recherchez des enregistrements dans un tableau AppSheet.

Paramètres

Nom du paramètre	Type	Valeur par défaut	Obligatoire	Description
Nom de la table	Chaîne	N/A	Oui	Spécifiez le nom de la table dont vous souhaitez récupérer les détails.
Requête de sélecteur	Chaîne	N/A	Non	Spécifiez la requête du sélecteur, qui sera utilisée pour limiter les résultats. Si aucune valeur n'est fournie, l'action renvoie tous les enregistrements.

Date d'exécution

Cette action ne s'applique pas aux entités.

Résultats de l'action

Résultat du script

Nom du résultat du script	Options de valeur	Exemple
is_success	Vrai/Faux	is_success=False

Mur des cas

Type de résultat	Description	Type
Message de sortie*	L'action ne doit pas échouer ni arrêter l'exécution d'un playbook : Si des données sont disponibles (is_success = true) : "Enregistrements récupérés avec succès en fonction des critères fournis dans le tableau "{table}" d'AppSheet. Si aucune donnée n'est disponible (is_success=false) : aucun enregistrement n'a été trouvé en fonction des critères fournis dans le tableau "{table}" dans AppSheet. L'action doit échouer et arrêter l'exécution d'un playbook : Si une erreur fatale est signalée (par exemple, des identifiants incorrects, l'absence de connexion au serveur ou une autre erreur) : "Erreur lors de l'exécution de l'action "Rechercher des enregistrements". Raison : {0}''.format(error.Stacktrace) Si la réponse contient "Message" : "Erreur lors de l'exécution de l'action "Rechercher des enregistrements". Motif : {0}''.format(Message)	Général
Tableau du mur des cas	Nom : enregistrements	Général

Type de résultat

Description

Type

Message de sortie*

L'action ne doit pas échouer ni arrêter l'exécution d'un playbook :

Si des données sont disponibles (is_success = true) : "Enregistrements récupérés avec succès en fonction des critères fournis dans le tableau "{table}" d'AppSheet.

Si aucune donnée n'est disponible (is_success=false) : aucun enregistrement n'a été trouvé en fonction des critères fournis dans le tableau "{table}" dans AppSheet.

L'action doit échouer et arrêter l'exécution d'un playbook :

Si une erreur fatale est signalée (par exemple, des identifiants incorrects, l'absence de connexion au serveur ou une autre erreur) : "Erreur lors de l'exécution de l'action "Rechercher des enregistrements". Raison : {0}''.format(error.Stacktrace)

Si la réponse contient "Message" : "Erreur lors de l'exécution de l'action "Rechercher des enregistrements". Motif : {0}''.format(Message)

Général

Tableau du mur des cas

Nom : enregistrements

Général

Mettre à jour l'enregistrement

Mettez à jour un enregistrement dans une table AppSheet.

Paramètres

Nom du paramètre	Type	Valeur par défaut	Obligatoire	Description
Nom de la table	Chaîne	N/A	Oui	Spécifiez le nom de la table dans laquelle vous souhaitez mettre à jour un enregistrement.
Objet JSON d'enregistrement	JSON		Oui	Spécifiez l'objet JSON de l'enregistrement à mettre à jour. Vous devez fournir la clé d'identifiant unique et les champs que vous souhaitez mettre à jour.

Date d'exécution

Cette action ne s'applique pas aux entités.

Résultats de l'action

Résultat du script

Nom du résultat du script	Options de valeur	Exemple
is_success	Vrai/Faux	is_success=False

Mur des cas

Type de résultat	Description	Type
Message de sortie*	L'action ne doit pas échouer ni arrêter l'exécution d'un playbook : Si des données sont disponibles (is_success = true) : "L'enregistrement a bien été mis à jour dans le tableau "{table}" dans AppSheet. L'action doit échouer et arrêter l'exécution d'un playbook : Si une erreur fatale se produit (par exemple, des identifiants incorrects, une absence de connexion au serveur, etc.) : "Erreur lors de l'exécution de l'action "Mettre à jour l'enregistrement". Raison : {0}''.format(error.Stacktrace) Si aucune donnée n'est présente dans la réponse : "Erreur lors de l'exécution de l'action "Mettre à jour l'enregistrement". Motif : Une charge utile non valide a été fournie. Veuillez vérifier l'orthographe du nom de la table et la structure de l'objet JSON de l'enregistrement. Si "Message" figure dans la réponse : "Erreur lors de l'exécution de l'action "Mettre à jour l'enregistrement". Motif : {0}''.format(Message) Erreur lors de l'exécution de l'action "Mettre à jour l'enregistrement". Motif : Objet JSON non valide fourni. Veuillez vérifier la structure.	Général

Type de résultat

Description

Type

Message de sortie*

L'action ne doit pas échouer ni arrêter l'exécution d'un playbook :

Si des données sont disponibles (is_success = true) : "L'enregistrement a bien été mis à jour dans le tableau "{table}" dans AppSheet.

L'action doit échouer et arrêter l'exécution d'un playbook :

Si une erreur fatale se produit (par exemple, des identifiants incorrects, une absence de connexion au serveur, etc.) : "Erreur lors de l'exécution de l'action "Mettre à jour l'enregistrement". Raison : {0}''.format(error.Stacktrace)

Si aucune donnée n'est présente dans la réponse : "Erreur lors de l'exécution de l'action "Mettre à jour l'enregistrement". Motif : Une charge utile non valide a été fournie. Veuillez vérifier l'orthographe du nom de la table et la structure de l'objet JSON de l'enregistrement.

Si "Message" figure dans la réponse : "Erreur lors de l'exécution de l'action "Mettre à jour l'enregistrement". Motif : {0}''.format(Message)

Erreur lors de l'exécution de l'action "Mettre à jour l'enregistrement". Motif : Objet JSON non valide fourni. Veuillez vérifier la structure.

Général

Vous avez encore besoin d'aide ? Obtenez des réponses de membres de la communauté et de professionnels Google SecOps.