Consultez les 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, listant 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 Create Integration (Créer une intégration).
    2. Sélectionnez une région pour l'intégration.
    3. Sélectionnez un compte de service pour l'intégration. Vous pouvez modifier ou mettre à jour les informations du compte de service d'une intégration à tout moment dans le volet Récapitulatif de l'intégration de la barre d'outils d'intégration.
    4. Cliquez sur Créer.

    Cela entraîne son ouverture dans l'éditeur d'intégrations.

  4. Dans la barre de navigation de l'éditeur d'intégration, cliquez sur Tasks (Tâches) pour afficher la liste des tâches et des connecteurs 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.

    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 : image montrant l'éditeur JavaScript image montrant 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() : fonction appelée lorsque l'intégration d'applications exécute la tâche JavaScript lors de l'exécution d'une intégration.
  • event : objet en mémoire de l'intégration d'applications.

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

Moteur d'exécution JavaScript

Application Integration utilise le moteur d'exécution JavaScript basé sur Rhino 1.7.14, qui n'est pas compatible avec toute la syntaxe ES6. Par exemple, la déclaration de variable avec let n'est pas prise en charge. Seule la saisie semi-automatique de la syntaxe ES5 est acceptée. Pour connaître la syntaxe ES6 compatible, consultez la page Compatibilité avec Rhino ES2015.

Accéder aux variables d'intégration

Les variables définies dans votre intégration sont accessibles depuis l'éditeur JavaScript à l'aide de l'objet en mémoire event d'Application Integration.

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

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("variable_name")

Paramètre d'entrée : nom de la variable d'intégration. Si variable_name est une variable générée automatiquement, placez-la entre guillemets inversés (``). Par exemple, `responseBody`.

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("variable_name", "variable_value")

Paramètre d'entrée : cette fonction utilise les arguments suivants :

  • Premier argument : nom de la variable. Si variable_name est une variable générée automatiquement, placez-la entre guillemets inversés (``). Par exemple, `responseBody`.
  • Deuxième argument : valeur.

Exemple : 

function executeScript(event) {
  event.setParameter("`responseBody`", "NewStringValue");
  }

Définir les paramètres de la tâche

Si votre intégration comporte plusieurs paramètres volumineux qui ne sont pas utilisés par la tâche JavaScript, vous pouvez définir le champ TaskParameter de la tâche JavaScript pour améliorer les performances.

Pour définir le champ TaskParameter pour la tâche JavaScript, sélectionnez l'une des options suivantes :

Console

  1. Accédez à la page Application Integration.

    Accéder à Application Integration

  2. Sélectionnez une intégration. L'éditeur d'intégration s'ouvre.
  3. Cliquez sur Action > Télécharger l'intégration > Version de l'intégration. La version de l'intégration est téléchargée au format JSON.
  4. Ouvrez le fichier de version de l'intégration dans un éditeur, puis procédez comme suit :
    1. Recherchez le champ taskConfigs avec la tâche JavaScriptTask. Dans le champ parameters, recherchez le paramètre nommé script. 
      "taskConfigs": [{
  "task": "JavaScriptTask",
  "taskId": 1,
  "parameters": {
    "script": {
      "key": "script",
      "value": {
        "stringValue": "function that is called during the JavaScriptTask execution"
      }
  }"
}]
    2. Dans ce champ parameters, ajoutez les paramètres utilisés dans le champ JavaScriptTask à l'aide du modèle suivant : 
      "ParamName": {
  "key": "ParamName",
  "value": {
    "stringValue": "$ParamName$"
  }
}
  5. Enregistrez les modifications apportées au fichier de version de l'intégration.
  6. Importez le fichier de version de l'intégration dans l'intégration.

API

  1. Pour télécharger la version d'intégration, appelez la méthode projects.locations.integrations.versions.download avec filFormat défini sur JSON.
  2. Ouvrez le fichier de version de l'intégration dans un éditeur, puis procédez comme suit :
    1. Recherchez le champ taskConfigs avec la tâche JavaScriptTask. Dans le champ parameters, recherchez le paramètre nommé script. 
      "taskConfigs": [{
  "task": "JavaScriptTask",
  "taskId": 1,
  "parameters": {
    "script": {
      "key": "script",
      "value": {
        "stringValue": "function that is called during the JavaScriptTask execution"
      }
  }"
}]
    2. Dans ce champ parameters, ajoutez les paramètres utilisés dans le champ JavaScriptTask à l'aide du modèle suivant : 
      "ParamName": {
  "key": "ParamName",
  "value": {
    "stringValue": "$ParamName$"
  }
}
  3. Pour importer la version de l'intégration, appelez la méthode projects.locations.integrations.versions.upload avec le fichier de version de l'intégration mis à jour.

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.

Quotas et limites

Pour plus d'informations sur les quotas et les limites, consultez la section Quotas et limites.

Étape suivante