Récupération de données avec une procédure d'intégration dans un Omniscript

Depuis un Omniscript, appelez une Procédure d'intégration pour récupérer des données Salesforce et des données externes. Vous pouvez exécuter plusieurs actions en tant que service headless (sans interface utilisateur) via JavaScript ou Apex Service.

Avant de commencer, créez une Procédure d'intégration pour gérer les données Omniscript.

Remarque Lorsque vous ajoutez la même action Procédure d'intégration à deux Omniscripts ou plus qui ont une relation parent-enfant, définissez les valeurs dans l'Omniscript parent, même si la valeur est destinée à être utilisée dans l'Omniscript enfant.

1. Après avoir ajouté un élément Procédure d'intégration, dans les propriétés distantes, activez les paramètres Chaînable en file d'attente de la procédure d'intégration :

   Propriété	Valeur
   Méthode future Utiliser Future (dans le concepteur d'un package géré)	Spécifie que la Procédure d'intégration est exécutée de façon asynchrone, en tant que méthode Salesforce future, qui ne peut renvoyer aucune donnée à l'Omniscript appelant.
   Chaînable	Active les paramètres Chaînable de la procédure d'intégration subordonnée.
   Utilisation de Continuation	Active une Procédure d'intégration subordonnée qui appelle des actions longues pour utiliser des continuations Apex.
   Queueable	Active les étapes enchaînables dans la procédure d'intégration subordonnée pour démarrer les tâches en file d'attente.
   Chaîne Queueable	Active les paramètres Chaînable en file d'attente de la procédure d'intégration.

2. Dans Options distantes, ajoutez cette paire clé-valeur :

   Clé	Valeur
   useQueueableApexRemoting	True (vrai)

3. Utilisez la propriété Charge utile supplémentaire pour envoyer des paires clé-valeur supplémentaires à la Procédure d'intégration en tant que données d'entrée.
4. Spécifiez les propriétés Action de procédure d'intégration supplémentaires dont vous avez besoin.
5. Utilisez les propriétés Transformations Envoyer/Répondre pour spécifier l'entrée et rogner ou renommer le JSON de sortie.

   • Envoyer un chemin JSON : spécifie le nœud JSON qui contient l'entrée pour la procédure d'intégration. Il correspond généralement au nom d'un élément précédent dans l'Omniscript.

   • Envoyer un nœud JSON : renomme le nœud JSON qui contient l'entrée de la procédure d'intégration. Il correspond généralement au nom de l'un des paramètres d'entrée de la procédure d'intégration.

   • Chemin JSON de réponse : spécifie le nœud JSON qui contient la sortie à renvoyer à l'Omniscript. Par défaut, toutes les données de la procédure d'intégration sont renvoyées.

   • Nœud JSON Response : renomme le nœud JSON qui contient la sortie pour revenir à l'Omniscript. Il correspond généralement au nom d'un élément suivant dans l'Omniscript.

   Consultez Manipulation du JSON avec les propriétés des transformations Envoyer/Répondre.

6. Sélectionnez le comportement de réponse de l'action en sélectionnant un mode Invoquer.

   • Par défaut : bloque l'interface utilisateur avec une toupie de chargement.

   • Non bloquant : exécuté de façon asynchrone et la réponse est appliquée à l'interface utilisateur. Les transformations Pré et Post Omnistudio Data Mapper et les pièces jointes volumineuses ne sont pas prises en charge. Lorsque le Mode invoque est défini sur non bloquant, les éléments qui utilisent des valeurs par défaut ne reçoivent pas la réponse, car l'élément est chargé avant le retour de la réponse. Pour mapper la réponse avec un élément, vous devez définir Nœud JSON Réponse sur VlocityNoRootNode et Chemin JSON Réponse sur le nom de l'élément.

   • Feu et oubli : exécuté de façon asynchrone sans rappel à l'interface utilisateur. Les transformations Mappeur de données avant et après, et les pièces jointes volumineuses, ne sont pas prises en charge. Une réponse reste affichée dans la console de débogage, mais n'est pas appliquée au JSON de données.

7. Lorsque le Mode invoque est défini sur non bloquant, les éléments qui utilisent des valeurs par défaut ne reçoivent pas la réponse, car l'élément est chargé avant le retour de la réponse. Vous devez configurer les propriétés suivantes pour mapper la réponse avec un élément :

   Propriété	Valeur
   Nœud JSON Réponse	VlocityNoRootNode
   Parcours JSON de réponse	Le nom de l'élément Omniscript qui reçoit la valeur.

   Consultez Manipulation du JSON avec les propriétés des transformations Envoyer/Répondre.

Remarque Lorsqu'un Omniscript invoque une Procédure d'intégration de façon asynchrone, la Procédure d'intégration continue d'être exécutée si l'utilisateur passe à l'étape suivante, mais pas s'il quitte l'Omniscript.