Tâche Data Transformer Script

La tâche Script Data Transformer vous permet d'écrire, de modifier et d'évaluer des modèles Jsonnet personnalisés pour effectuer un mappage de données dans votre intégration.

Pour en savoir plus sur le mappage de données dans Application Integration, consultez la section Présentation du mappage de données.

Configurer la tâche Script Data Transformer

Procédez comme suit pour ajouter une tâche Script Data Transformer à 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.
    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.
    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 Script Data Transformer et placez-le dans l'éditeur d'intégrations.
  6. Cliquez sur l'élément Script Data Transformer dans le concepteur pour afficher le volet de configuration de la tâche Script Data Transformer.
  7. Cliquez sur Ouvrir l'éditeur de script Data Transformer.
  8. L'éditeur de script Data Transformer s'affiche avec un exemple de modèle Jsonnet commenté par défaut.
  9. Rédigez votre code Jsonnet, puis fermez l'éditeur. Toutes les modifications seront enregistrées automatiquement.

Utiliser l'éditeur de script Data Transformer

Vous pouvez utiliser l'éditeur de script Data Transformer pour access aux variables d'intégration, effectuer des attributions de variables et ajouter ou modifier des variables dans votre intégration. L'éditeur de script Data Transformer fournit les fonctionnalités suivantes pour enrichir votre expérience d'écriture de script :

  • 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.
  • Mini-carte affichant un aperçu général du code du script et permettant de naviguer rapidement dans celui-ci.
  • Option "Cliquer pour copier" permettant de copier le code du script dans le presse-papiers.

Pour ouvrir l'éditeur, accédez au volet de configuration de la tâche Script Data Transformer, puis cliquez sur Ouvrir l'éditeur de script Data Transformer.

L'éditeur de script Data Transformer importe par défaut functions, une bibliothèque personnalisée prédéfinie contenant un ensemble de fonctions Jsonnet pour le mappage de données dans Application Integration. Pour en savoir plus sur les fonctions personnalisées disponibles, consultez la page Fonctions de Data Transformer.

L'image suivante montre l'exemple de mise en page de l'éditeur de Data Transformer Script :

Image montrant l'éditeur de Data Transformer Script Image montrant l'éditeur de Data Transformer Script

Accéder aux variables d'intégration

Pour lire une variable d'intégration existante à partir de l'éditeur de script Data Transformer, utilisez la fonction extVar de la bibliothèque prédéfinie functions.

Exemple : Lire et mettre à jour des variables d'intégration existantes à l'aide de l'éditeur de script Data Transformer.

Script Jsonnet

local f = import "functions"; // Import predefined Data Transformer function library

local str1 = f.extVar("inputVar1"); // Access integration input variable "Inputstr1" with value "Hello"
local str2 = f.extVar("inputVar2"); // Access integration input variable "Inputstr2" with value "World"
{
  OutputVar: str1 + " " + str2 + "!", // Write to Jsonnet output variable "OutputVar"
  "output-str-var": str1 + " Integration " + str2 + "!", // Write to Jsonnet output variable "output-str-var"
}

Résultat

image montrant un exemple de script Data Transformer image montrant un exemple de script Data Transformer

Bonnes pratiques

Pour en savoir plus sur les limites d'utilisation qui s'appliquent à la tâche Data Transformer Script, consultez la section Limites d'utilisation.

Étapes suivantes