Consultez la liste des connecteurs compatibles avec Application Integration.

Tâche JavaScript

La tâche JavaScript vous permet d'écrire des extraits de code JavaScript personnalisés pour votre intégration.

L'éditeur JavaScript vous permet de coder des logiques complexes de mappage de données pour votre intégration, d'effectuer des attributions de variables et d'ajouter ou de modifier des variables d'intégration.

L'éditeur JavaScript est compatible avec les fonctionnalités suivantes :

• Mini-carte affichant un aperçu général du code du script et permettant de naviguer rapidement dans celui-ci.
• Mise en surbrillance de la syntaxe/du code, définition de retraits et numérotation des lignes, facilitant la lecture du code et l'identification de sa structure.
• Mise en surbrillance des erreurs, permettant un débogage aisé du code.
• Repliage permettant de développer et de réduire des portions de code du script.
• Option "Cliquer pour copier" permettant de copier le code du script dans le presse-papiers.

Configurer la tâche JavaScript

Procédez comme suit pour ajouter une tâche JavaScript à votre intégration :

1. Dans la console Google Cloud, accédez à la page Application Integration.

   Accéder à Application Integration

2. Dans le menu de navigation, cliquez sur Integrations (Intégrations).

   La page Intégrations s'affiche. Elle liste toutes les intégrations disponibles dans le projet Google Cloud.

3. Sélectionnez une intégration existante ou cliquez sur Créer une intégration pour en créer une.

   Si vous créez une intégration:

   1. Saisissez un nom et une description dans le volet Créer une intégration.
   2. Sélectionnez une région pour l'intégration.
      Remarque : Le menu déroulant Régions ne répertorie que les régions provisionnées dans votre projet Google Cloud. Pour provisionner une nouvelle région, cliquez sur Activer la région. Pour en savoir plus, consultez la section Activer une nouvelle région.
   3. Sélectionnez un compte de service pour l'intégration. Vous pouvez modifier ou mettre à jour les détails du compte de service d'une intégration à tout moment depuis le volet Résumé de l'intégration de dans la barre d'outils d'intégration.
      Remarque:L'option permettant de sélectionner un compte de service ne s'affiche que si vous avez activé la gouvernance de l'intégration pour la région sélectionnée.
   4. Cliquez sur Créer.

   La page de l'éditeur d'intégration s'affiche.

4. Dans la barre de navigation de l'éditeur d'intégration, cliquez sur Tasks (Tâches) pour afficher la liste des tâches disponibles.
5. Cliquez sur l'élément JavaScript et placez-le dans l'éditeur d'intégrations.
6. Cliquez sur l'élément JavaScript dans le concepteur pour afficher le volet de configuration de la tâche JavaScript.
7. Cliquez sur Ouvrir l'éditeur de script pour afficher l'éditeur JavaScript et modifier le script.
8. Écrivez votre code JavaScript dans la fonction executesScript(event) qui est créée automatiquement dans l'éditeur JavaScript. Toutes les modifications sont enregistrées automatiquement lorsque vous fermez l'éditeur.
   Avertissement : Ne supprimez pas la fonction executesScript(event). Celle-ci est appelée lors de l'exécution de la tâche JavaScript.

   Pour en savoir plus sur l'accès aux variables d'intégration et sur les fonctions compatibles, consultez la page Utiliser l'éditeur JavaScript.

   Pour en savoir plus sur l'affichage des journaux d'exécution générés, consultez la page Journaux d'exécution.

L'image suivante présente un exemple de mise en page de l'éditeur JavaScript :

Utiliser l'éditeur JavaScript

Pour afficher l'éditeur JavaScript et modifier le script, accédez au volet de configuration de la tâche JavaScript, puis cliquez sur Ouvrir l'éditeur de script. Par défaut, l'éditeur JavaScript contient une fonction nommée executesScript(event).

Où :

• executesScript() est la fonction appelée lorsqu'Application Integration exécute la tâche JavaScript lors de l'exécution d'une intégration.
• event est l'objet en mémoire d'Application Integration.

  Pour en savoir plus sur les méthodes acceptées pour l'objet event, consultez la section Accéder aux variables d'intégration.

Avertissement : Ne supprimez pas la fonction executesScript(event). Celle-ci est appelée lors de l'exécution de la tâche JavaScript.

Le moteur d'exécution JavaScript utilisé par Application Integration est basé sur Rhino 1.7.14, qui n'est pas compatible avec toutes les syntaxes ES6. Seule la saisie semi-automatique de la syntaxe ES5 est acceptée. Pour découvrir toute la syntaxe ES6 acceptée, consultez la page Compatibilité avec Rhino ES2015.

Accéder aux variables d'intégration

Vous pouvez accéder aux variables définies dans votre intégration depuis l'éditeur JavaScript à l'aide de l'objet d'événement en mémoire Application Integration.

Les méthodes suivantes permettent d'accéder aux variables d'intégration à partir de l'éditeur JavaScript :

1. getEventExecutionInfoId
2. getGoogleCloudProjectId
3. getIntegrationName
4. getParameter
5. getRegion
6. log
7. setParameter

Nom de la fonction	Description	Utilisation
getEventExecutionInfoId	Renvoie l'ID d'exécution de l'intégration. Type renvoyé : chaîne	Syntaxe : event.getEventExecutionInfoId() Exemple : function executeScript(event) { event.getEventExecutionInfoId(); }
getGoogleCloudProjectId	Renvoie l'ID de projet Google Cloud. Type renvoyé : chaîne	Syntaxe : event.getGoogleCloudProjectId() Exemple : function executeScript(event) { event.getGcpProjectId(); }
getIntegrationName	Renvoie le nom actuel de l'intégration. Type renvoyé : chaîne	Syntaxe : event.getIntegrationName Exemple : function executeScript(event) { event.getIntegrationName(); }
getParameter	Renvoie la valeur de la variable d'intégration fournie. Type renvoyé : type de données de la variable d'intégration	Syntaxe : event.getParameter("value") Paramètre d'entrée : nom de la variable d'intégration. Exemple : function executeScript(event) { event.getParameter("var1"); }
getRegion	Renvoie le nom de la région de l'intégration. Type renvoyé : chaîne	Syntaxe : event.getRegion() Exemple : function executeScript(event) { event.getRegion(); }
log	Écrit la valeur spécifiée dans les journaux d'exécution. Pour en savoir plus sur l'affichage des journaux d'exécution générés, consultez la page Journaux d'exécution.	Syntaxe : event.log(value) Paramètre d'entrée : toute variable ou fonction utilisée dans le script. Exemple 1 : function executeScript(event) { event.log(event.getParameter("var1")); } Exemple 2 : function executeScript(event) { event.log("Lorem ipsum"); }
setParameter	Définit ou met à jour la valeur d'une variable d'intégration.	Syntaxe : event.setParameter(value, value) Paramètre d'entrée : cette fonction utilise les arguments suivants : Premier argument : nom de la variable. Deuxième argument : valeur. Exemple : function executeScript(event) { event.setParameter("var1", "NewStringValue"); }

Stratégie de traitement des erreurs

Une stratégie de traitement des erreurs d'une tâche spécifie l'action à effectuer si celle-ci échoue en raison d'une erreur temporaire. Pour en savoir plus sur l'utilisation et les différents types de stratégies de traitement des erreurs, consultez la page Stratégies de traitement des erreurs.