Transformer des données avec le générateur de transformation

Lorsque vous mappez des champs dans un flux, si les formats de données source et cible ne correspondent pas, utilisez le générateur de transformation pour créer des expressions JSONata qui convertissent vos données source au format cible requis.

A propos de cette tâche

Les transformations suivantes sont prises en charge.

Transformation du modèle

Cette transformation permet de modifier le format des données source transmises à une application cible si les formats des données source et cible ne correspondent pas. Les données sources peuvent être spécifiées sous forme de mappages de nœuds précédents dans le flux ou de texte statique dans le champ de texte cible.

Par exemple, si une application source nécessite que les dates soient au format DD/MM/YYYY, mais que l'application cible exige le format MM/DD/YYYY, fournissez des exemples de données aux formats source et cible, puis utilisez le générateur de transformation pour générer une expression JSONata pour le mappage source dans le champ cible. De même, si une application source exige que les noms soient au format Firstname Surname et que l'application cible exige Firstname SURNAME, le générateur de transformation peut construire une expression JSONata en utilisant les échantillons que vous fournissez.

Transformation enum

Utilisez cette transformation pour définir comment mapper les valeurs des listes déroulantes source et cible qui ne correspondent pas afin de vous assurer que les valeurs appropriées sont transmises à l'application cible.

Par exemple, si les applications source et cible proposent des valeurs différentes pour une liste de priorités (comme indiqué dans le tableau suivant), vous pouvez mapper les valeurs source et cible comme suit : High, MediumUrgent,Normal et Low.Low Vous pouvez ensuite utiliser le générateur de transformation pour générer une expression JSONata pour le mappage source dans le champ cible.

Application de la source	Application cible
`High` `Medium` `Low`	`Urgent` `Normal` `Low`

Si vous avez appliqué des suggestions de mappage pour remplir automatiquement les champs d'une action avec les mappages des nœuds précédents, vous pouvez insérer manuellement des mappages dans les champs restants. Vous pouvez ensuite appliquer les transformations nécessaires aux mappages remplis. Pour transformer vos données, consultez les scénarios suivants.

Générer des transformations de modèles : Transformer le format de données d'un seul mappage dans un champ cible qui est rempli avec un ou plusieurs mappages

Si un champ de texte est rempli avec des mappages provenant des listes Mappages suggérés ou Mappages disponibles, mais que les formats de données des mappages source ne correspondent pas au format de données du champ cible qui est rempli, vous pouvez générer une expression JSONata pour définir comment présenter les données source dans l'application cible.

A propos de cette tâche

Cette information est applicable lorsqu'un champ cible est rempli avec une ou plusieurs correspondances "source" provenant de nœuds précédents dans le flux. Vous pouvez transformer le format des données d'un seul mappage inséré dans un champ cible.

Procédure

Pour transformer le format de données d'un seul mappage dans un champ cible rempli avec un ou plusieurs mappages, procédez comme suit.

Sélectionnez le champ cible, puis cliquez sur Transformer le format des données.

Le volet Générer une transformation pour l' TargetFieldName s'ouvre avec cinq champs source et cible correspondants vides pour vous permettre de mapper vos formats de données.
Donnez au moins cinq exemples de formats source et cible.
Vous pouvez soit saisir les valeurs manuellement, soit cliquer sur Remplir à l'aide de données d'exemple pour récupérer les valeurs de vos applications source et cible. Pour ajouter plus de cinq correspondances, cliquez sur Ajouter une ligne +. Si des données sont découvertes dans l'application source, les champs de la colonne source sont remplis avec un échantillon aléatoire d'exemples uniques de l'application source. Si moins de cinq exemples sont découverts, saisissez manuellement des exemples similaires dans les champs source vides.
Si des données sont également découvertes dans l'application cible, elles sont analysées pour identifier les formats spécifiés, tels que les formats minuscules ou majuscules. Les exemples sources sont ensuite utilisés pour générer des exemples cibles basés sur les formats cibles découverts. Jusqu'à cinq formats peuvent être affichés dans des onglets individuels (numérotés de 1 à 5 ) dans la colonne cible. Une copie du lien source est également fournie. Cliquez sur chaque onglet numéroté pour examiner les formats cibles générés. Pour accepter un format généré, assurez-vous que son onglet numéroté est actif.

Pour spécifier un format personnalisé, modifiez les données dans un onglet numéroté ou cliquez sur Copier à partir de la source pour ajouter une copie des exemples sources en tant qu'exemples cibles. Lorsque vous modifiez les données ou que vous cliquez sur Copier depuis la source, un onglet Modifié est ajouté aux onglets numérotés existants, et le focus passe à cet onglet. Utilisez l'onglet Modifié pour spécifier un format personnalisé, tout en conservant les formats générés dans les onglets numérotés afin de pouvoir les sélectionner à nouveau si nécessaire. Les données de l'onglet Modifié indiquent toujours votre dernière mise à jour.

Si aucune donnée n'est découverte dans l'application cible, les champs de la colonne cible restent vides. Vous pouvez utiliser le lien Copier à partir de la source pour ajouter une copie des exemples sources en tant qu'exemples cibles, puis modifier les données copiées si nécessaire. Vous pouvez également spécifier des exemples manuellement dans le format de votre choix.

Si aucune donnée n'est découverte dans les applications source et cible après avoir cliqué sur Remplir à l'aide de données échantillons, les champs source et cible restent vides. Le lien Copier à partir de la source est également indiqué comme étant initialement désactivé. Dans la colonne source, indiquez manuellement au moins cinq exemples pour le champ source. (Le lien Copier depuis la source est activé lorsque vous ajoutez la première entrée.) Pour compléter les champs cibles, cliquez sur Copier à partir de la source pour ajouter une copie des exemples sources comme exemples cibles, ou spécifiez manuellement des exemples dans le format de votre choix.
Conseils pour remplir les champs source et cible :
Pour spécifier des exemples manuellement, tenez compte des conseils suivants.
- Veillez à utiliser un format de données identique pour tous les exemples de champs source. Veillez également à utiliser un format de données identique pour tous les exemples de champs cibles.
- Assurez-vous qu'il existe un exemple complet pour chaque paire de champs source et cible.
- Assurez-vous que chaque exemple correspond au type de données attendu. Par exemple, utilisez un format de date si les champs source et cible sont utilisés pour présenter des dates.
Cliquez sur Transformer le format des données pour générer une expression JSONata qui représente vos sélections.
Cliquez sur Insérer une transformation pour insérer l'expression JSONata dans le champ cible.

Générer des transformations de modèles : Transformer l'ensemble du contenu d'un champ cible qui contient plusieurs mappings

A propos de cette tâche

Si le champ cible est rempli de plusieurs mappings, vous pouvez transformer des mappings individuels ou transformer collectivement l'ensemble du contenu du champ. Si le champ cible comprend des données statiques, vous devez inclure ces données dans les exemples de cibles que vous fournissez pour générer l'expression JSONata.

Procédure

Cliquez sur le champ cible, puis sur Transformer le format des données.

Le volet Générer une transformation pour l' TargetFieldName s'ouvre avec une colonne pour chaque format source et format cible.
Donnez au moins cinq exemples de formats source et cible.
Cliquez sur Remplir à l'aide de données d'exemple pour récupérer les valeurs de vos applications source et cible. Pour ajouter plus de cinq correspondances, cliquez sur Ajouter une ligne +. Si des données sont découvertes dans l'application source, les champs de la colonne source sont remplis avec un échantillon aléatoire d'exemples uniques de l'application source. Si moins de cinq exemples sont découverts, saisissez manuellement des exemples similaires dans les champs source vides.
Si le type de données approprié est également découvert dans l'application cible, ces données sont analysées pour identifier les formats spécifiés, tels que les minuscules ou les majuscules, ou les formats de date. Les exemples sources sont ensuite utilisés pour générer des exemples cibles basés sur les formats cibles découverts. Jusqu'à cinq formats peuvent être affichés dans des onglets individuels (numérotés de 1 à 5 ) dans la colonne cible. Cliquez sur chaque onglet numéroté pour examiner les formats cibles générés. Pour accepter un format généré, assurez-vous que son onglet numéroté est actif.

Pour spécifier un format personnalisé, modifiez les données dans un onglet numéroté ou cliquez sur Copier à partir de la source pour ajouter une copie concaténée des exemples sources en tant qu'exemples cibles. Lorsque vous modifiez les données ou cliquez sur Copier depuis la source, un onglet Modifié est ajouté aux onglets numérotés existants, et le focus passe à cet onglet. Utilisez l'onglet Modifié pour spécifier un format personnalisé, tout en conservant les formats générés dans les onglets numérotés afin de pouvoir les sélectionner à nouveau si nécessaire. Les données de l'onglet Modifié indiquent toujours votre dernière mise à jour.

Si aucune donnée appropriée n'est découverte dans l'application cible, les champs de la colonne cible restent vides. Vous pouvez cliquer sur Copier à partir de la source pour ajouter une copie concaténée des exemples sources en tant qu'exemples cibles dans chaque ligne. Vous pouvez ensuite modifier les données copiées selon vos besoins. (Dans l'exemple suivant, le symbole @ et le domaine de messagerie ont été supprimés des adresses électroniques dans les champs cibles, et l'heure a été supprimée des dates.) Vous pouvez également spécifier manuellement des exemples cibles sans copier la source.

Si aucune donnée n'est découverte dans les applications source et cible après avoir cliqué sur Remplir à l'aide de données échantillons, les champs source et cible restent vides. Le lien Copier à partir de la source est également indiqué comme étant initialement désactivé. Dans les colonnes sources, spécifiez manuellement au moins cinq exemples pour chacun des champs sources. (Le lien Copier depuis la source est activé lorsque vous ajoutez la première entrée.) Pour compléter les champs cibles, cliquez sur Copier à partir de la source pour ajouter une copie des exemples sources comme exemples cibles, ou spécifiez manuellement des exemples dans le format de votre choix.
Conseils pour remplir les champs source et cible :
Pour spécifier des exemples manuellement, tenez compte des conseils suivants.
- Si aucun exemple cible n'est généré, l'option la plus rapide consiste à utiliser Copier depuis la source pour ajouter une copie concaténée des exemples source dans chaque ligne aux champs cibles, puis à modifier les formats cibles. Assurez-vous également que les exemples cibles concaténés sont répertoriés dans le même ordre que les mappages source.
  Si le champ cible dans l'éditeur de flux contient des données statiques, incluez et positionnez correctement ces données dans vos exemples cibles afin de vous assurer que le champ cible est correctement renseigné lorsque vous insérez la transformation.
- Veillez à utiliser un format de données identique pour tous les exemples de champs source. Veillez également à utiliser un format de données identique pour tous les exemples de champs cibles.
- Assurez-vous qu'il existe un exemple complet pour chaque paire de champs source et cible.
- Assurez-vous que chaque exemple correspond au type de données attendu. Par exemple, utilisez un format de date si les champs source et cible sont utilisés pour présenter des dates.
Cliquez sur Transformer le format des données pour générer une expression JSONata qui représente vos sélections.
Cliquez sur Insérer une transformation pour insérer l'expression JSONata dans le champ cible.
- L'exemple suivant montre une transformation qui inclut du texte statique. Cet exemple illustre comment transformer les données dans un champ cible qui comprend plusieurs mappages préfixés par du texte statique (dans ce cas, Reference:). Dans le volet Générer une transformation, le texte statique est ajouté en tant que préfixe à chacun des formats cibles afin de garantir que ce texte soit inclus dans l'expression JSONata générée.

Générer des transformations enum

A propos de cette tâche

Si un champ déroulant est renseigné avec un seul mappage provenant de la liste des mappages suggérés ou disponibles, et que les valeurs de la liste déroulante pour le mappage source inséré ne correspondent pas aux valeurs de la liste déroulante pour le champ cible qui est renseigné, la notification suivante s'affiche.

SourceApplication has different values for SourceFieldName

Transformer le lien de format de données sous un champ cible

Procédure

Pour mapper les valeurs de la liste déroulante pour les champs source et cible, procédez comme suit.

Cliquez sur Transformer le format des données pour ouvrir le volet Générer une transformation pour l' SourceFieldName.
Les valeurs de la liste déroulante pour le champ source sont répertoriées dans la colonne source, et la colonne cible contient des listes déroulantes correspondantes qui sont remplies avec des valeurs cibles.
Utilisez les listes déroulantes des cibles pour associer une valeur cible appropriée à chaque valeur source.
Cliquez sur Transformer le format des données pour générer une expression JSONata qui représente vos sélections.
Cliquez sur Insérer une transformation pour insérer l'expression JSONata dans le champ cible.

Avertissement : vous êtes responsable de toutes les données d'exemple (y compris les informations personnelles) utilisées pour, et de toute décision de poursuivre, tout flux automatisé suggéré pour votre commodité lors App Connect de l'utilisation de. IBM® n'assume aucune responsabilité pour ces flux automatisés et IBM les garanties et l'assistance ne s'appliquent pas à eux; leur utilisation se fait à vos propres risques. IBM pourrait modifier périodiquement les modèles d'apprentissage sous-jacents dans App Connect par le biais de mises à jour, de corrections ou de correctifs afin d'améliorer App Connect les performances.