Consultez les connecteurs compatibles avec Application Integration.

Tâche Data Transformer

Preview

Ce produit ou cette fonctionnalité est soumis aux "Conditions des offres de pré-DG" dans la section "Conditions d'utilisation générales" des Conditions spécifiques au service. Les produits et fonctionnalités pré-DG sont disponibles "en l'état" et peuvent bénéficier d'une assistance limitée. Pour en savoir plus, consultez les descriptions des étapes de lancement.

La tâche Transformateur de données propose deux modes (Diagramme et Script) pour transformer vos données. En mode Diagramme, vous utilisez un canevas de mappage visuel, appelé "éditeur du transformateur de données", pour effectuer des attributions de données et des mappages dans votre intégration. Vous pouvez également utiliser les transformations compatibles pour transformer vos données en variables et formats significatifs, afin de les rendre accessibles aux autres tâches ou déclencheurs de votre intégration. En mode Script, vous pouvez écrire, modifier et évaluer des modèles Jsonnet personnalisés pour mapper des 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 des données.

Configurer la tâche Data Transformer

Pour ajouter une tâche Data Transformer à votre intégration, procédez comme suit :

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 et 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 Create Integration (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 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.
      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.

   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 Data Transformer et placez-le dans l'éditeur d'intégrations.
6. Cliquez sur l'élément Transformateur de données pour afficher le volet de configuration des tâches.
7. Cliquez sur Ouvrir l'éditeur Data Transformer. Sur la page Éditeur de tâches Data Transformer (preview), sélectionnez l'une des options suivantes :
• Par défaut, le mode Diagramme s'ouvre. Le mode Diagramme offre une expérience basée sur la console pour sélectionner les variables d'entrée et de sortie, et effectuer des transformations dans l'éditeur de transformation des données.

  Dans le mode Diagramme, vous pouvez effectuer un mappage visuel des données entre les variables d'entrée et de sortie.

• Pour effectuer des transformations de données dans votre intégration en écrivant, en modifiant et en évaluant des modèles Jsonnet personnalisés, accédez au mode script en cliquant sur Script. Vous pouvez utiliser le mode Script si vous avez des exigences complexes en termes de transformation de données et si vous souhaitez exploiter les fonctions Jsonnet.

  L'éditeur Data Transformer s'affiche avec un exemple de modèle Jsonnet commenté par défaut. Rédigez votre code Jsonnet, puis fermez l'éditeur. Toutes les modifications seront enregistrées automatiquement.

Pour obtenir des étapes détaillées sur l'ajout d'un mappage, consultez Ajouter un mappage.

Ajouter un mappage

Pour ajouter un mappage, vous pouvez utiliser le mode Diagram ou Script.

Utiliser le mode Diagramme

Le mode Diagram offre une expérience basée sur une console pour sélectionner les variables d'entrée et de sortie, et effectuer des transformations dans l'éditeur de transformation de données. Pour ajouter un mappage à l'aide du mode Diagramme, procédez comme suit :

1. Dans le volet de configuration de la tâche Data Transformer, cliquez sur Ouvrir l'éditeur Data Transformer.

   Par défaut, le mode Diagram est ouvert.

   

2. Pour ajouter la variable d'entrée à mapper, cliquez sur + Ajouter une entrée. La boîte de dialogue Choose Input Variable or Value (Sélectionner une variable ou une valeur d'entrée) s'affiche. L'onglet Variable est sélectionné par défaut.
   Entrée : source de l'entrée de transformation des données. La source peut être une valeur littérale, une fonction de base ou une variable d'entrée, avec des fonctions de mappage.

   

   Ensuite, procédez comme suit :

   1. Dans la liste Sélectionner une ou plusieurs variables, choisissez une ou plusieurs variables d'entrée. Si vous souhaitez créer une variable, cliquez sur + Ajouter une variable.
   2. Cliquez sur Envoyer.

   Si vous souhaitez ajouter une constante, cliquez sur l'onglet Constante.

   Contrairement aux variables, les constantes ne sont pas accessibles aux autres tâches ou déclencheurs de votre intégration. Elles ne peuvent être utilisées que dans la tâche de transformation des données dans laquelle elles sont créées. Par exemple, vous pouvez utiliser des constantes pour ajouter des délimiteurs ou pour mapper une valeur de constante à une variable.

   

   Ensuite, procédez comme suit :

   1. Dans le champ Identifiant de la constante, saisissez le nom de la constante.
   2. Dans la liste Type de données, sélectionnez l'un des types de données suivants :
      • Chaîne
      • Booléen
      • Number
   3. Dans le champ Saisissez la valeur constante, saisissez la valeur.
   4. Cliquez sur Envoyer.
3. Pour ajouter la variable de sortie au mappage, cliquez sur + Ajouter une sortie, puis sélectionnez la variable de sortie ou créez-en une.

   

4. Configurez le mappage :
   1. Ajoutez un mappage à partir d'une variable ou de son sous-champ de la liste Variables de la section Entrée vers la variable ou son sous-champ depuis la liste Variables de la section Sortie.

      

   2. Pour ajouter une fonction de transformation, pointez sur la ligne de mappage, puis cliquez sur  pour ajouter la fonction de transformation des données. Le bouton Transformation apparaît sur le canevas.

      Vous pouvez également cliquer sur Ajouter une transformation pour ajouter la fonction de transformation.

      Ensuite, procédez comme suit :

      1. Pour ajouter la transformation, cliquez sur le bouton Transformation. Le panneau Transformation s'affiche.

         

         Ensuite, procédez comme suit :

         1. Cliquez sur + Ajouter une opération. La boîte de dialogue Ajouter une opération s'affiche.

            

         2. Dans le champ Opérations de recherche, saisissez l'opération que vous souhaitez ajouter. Vous pouvez également sélectionner l'opération dans la liste des opérations.

            Si vous souhaitez ajouter une opération personnalisée, sélectionnez Expression de fonction, puis saisissez l'expression de fonction. Pour copier les variables, cliquez sur dans la liste Variables et collez-les dans l'éditeur d'expressions.

            

         3. Cliquez sur OK.
      2. Renseignez les informations requises en fonction de l'opération. Vous pouvez éventuellement ajouter plusieurs opérations à une transformation. Si vous souhaitez choisir le résultat de l'opération précédente dans l'opération suivante, sélectionnez la variable Résultat de l'opération précédente, comme illustré dans l'image suivante :

         

      3. Pour supprimer l'opération, cliquez sur  Supprimer à côté de l'opération.
   3. Vous pouvez également ajouter un mappage de plusieurs variables d'entrée à une fonction de transformation. Cependant, un seul mappage peut être ajouté pour chaque variable de sortie d'une fonction de transformation.
   4. Pour supprimer les variables d'entrée et de sortie, cliquez sur > Supprimer.
   5. Si vous souhaitez supprimer une ligne de mappage ou une transformation, sélectionnez le mappage, puis appuyez sur Supprimer.
   6. Fermez l'éditeur de mappage de données une fois le mappage terminé. Toutes les modifications seront enregistrées automatiquement.

   Exemple: Mappage d'un ancien système de suivi des bugs vers un nouveau système

   Supposons que vous disposez d'un ancien système de suivi des bugs que vous souhaitez migrer vers un nouveau système. Vous pouvez utiliser l'option Diagram (Diagramme) pour mapper les champs de l'ancien système au nouveau, comme illustré dans l'image suivante:

   

   Pour ajouter une valeur constante à l'un des champs, cliquez sur Ajouter une entrée, puis ajoutez une constante. Vous pouvez mapper la constante nouvellement ajoutée de la section Entrée au champ de la section Sortie.

   

   Pour ajouter la transformation pour les champs qui ne peuvent pas être mappés directement, cliquez sur Paramètres Transformation, puis ajoutez l'opération de transformation en cliquant sur + Ajouter une opération :

   

   Une fois la transformation terminée, vous pouvez exécuter l'intégration pour mapper l'ancien système de gestion des tickets sur le nouveau.

   Utiliser le mode script

   Vous pouvez utiliser l'éditeur de script Data Transformer pour accéder 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.

   Par défaut, l'éditeur de script Data Transformer importe functions, une bibliothèque personnalisée prédéfinie contenant un ensemble de fonctions Jsonnet destinée au 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 :

   

   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.

   Attention : Jsonnet n'autorise pas l'utilisation de traits d'union (-) dans le nom d'un identifiant, tel qu'un nom de variable ou un nom de fonction. Si vous souhaitez utiliser un trait d'union (-) dans le nom d'une variable, celle-ci doit être déclarée entre guillemets doubles, comme indiqué dans l'exemple suivant.

   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"
   }

   Sortie

   

   Documentation de référence sur l'utilisation de Jsonnet

   Jsonnet est un langage purement fonctionnel, et ses programmes sont composés d'expressions. Pour en savoir plus sur la forme de ces expressions, consultez la page Expressions Jsonnet.

   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 en savoir plus sur les limites d'utilisation qui s'appliquent à la tâche Transformateur de données, consultez la page Limites d'utilisation.

   Étape suivante

   • Apprenez-en plus sur les points suivants:
     • Toutes les tâches et tous les déclencheurs.
     • Fonctions Data Transformer (preview)
     • Test et publication des intégrations.
     • Traitement des erreurs
     • Journaux d'exécution d'intégration