Consultez les connecteurs compatibles avec Application Integration.

Tâche Data Transformer

La tâche Data Transformer propose deux modes (Diagramme et Script) pour transformer vos données. En mode Diagramme, vous utilisez un canevas de mappage visuel, appelé éditeur Data Transformer, pour effectuer des attributions et des mappages de données dans votre intégration. En outre, vous pouvez également utiliser les transformations compatibles pour transformer vos données en variables et formats significatifs pour 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 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 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 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 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égrations, cliquez sur 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 Data Transformer pour afficher le volet de configuration de la tâche.
  7. Cliquez sur Ouvrir l'éditeur Data Transformer. Sur la page Éditeur de tâches Data Transformer (aperçu), 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 visuellement le mappage de 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 de transformation de données complexes 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 connaître la procédure détaillée d'ajout d'un mappage, consultez la section Ajouter un mappage.

Ajouter un mappage

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

Utiliser le mode Diagramme

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. 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 Diagramme est ouvert.

    image montrant le mode diagramme image montrant le mode diagramme

  2. Pour ajouter la variable d'entrée au mappage, cliquez sur + Ajouter une entrée. La boîte de dialogue Choisir une variable ou une valeur d'entrée s'affiche. L'onglet Variable est sélectionné par défaut.

    image montrant la boîte de dialogue d'ajout d'entrée image montrant la boîte de dialogue d'ajout d'entrée

    Ensuite, procédez comme suit :

    1. Dans la liste Sélectionner une ou plusieurs variables, sélectionnez la ou les 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, vous pouvez cliquer 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 où elles sont créées. Par exemple, vous pouvez utiliser des constantes pour ajouter des séparateurs ou pour faire correspondre une valeur constante à une variable.

    image montrant la boîte de dialogue d'ajout d'une constante image montrant la boîte de dialogue d'ajout d'une constante

    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 Saisir 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.

    image montrant la boîte de dialogue "Ajouter une sortie" image montrant la boîte de dialogue "Ajouter une sortie"

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

      image montrant le mode de diagramme Data Transformer image montrant le mode de diagramme Data Transformer

    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 s'affiche 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.

        image montrant la transformation des données image montrant la transformation des données

        Ensuite, procédez comme suit :

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

          image montrant des opérations de transformation de données image montrant des opérations de transformation de données

        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, puis collez-les dans l'éditeur d'expressions.

          image montrant l'expression de la fonction image montrant l'expression de la fonction

        3. Cliquez sur OK.
      2. En fonction de l'opération, renseignez les informations requises. Vous pouvez éventuellement ajouter plusieurs opérations dans 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:

        image montrant plusieurs opérations de transformation image montrant plusieurs opérations de transformation

      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. Toutefois, vous ne pouvez ajouter qu'un seul mappage 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 le souhaitez, vous pouvez supprimer une ligne de mappage ou une transformation. Pour ce faire, 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 signalement de bugs sur un nouveau système de signalement

    Supposons que vous souhaitiez migrer un ancien système de gestion des bugs vers un nouveau système. Vous pouvez utiliser l'option Diagramme pour mapper les champs de l'ancien système sur le nouveau, comme illustré dans l'image suivante:

    image montrant le mode de diagramme Data Transformer image montrant le mode de diagramme Data Transformer

    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.

    image montrant l'ajout d'une constante par Data Transformer image montrant l'ajout d'une constante par Data Transformer

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

    image montrant l'ajout d'une transformation dans Data Transformer image montrant l'ajout d'une transformation dans Data Transformer

    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 :

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

    Sortie

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

    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 Data Transformer, consultez la section Limites d'utilisation.

    Étape suivante