Vous êtes ici :
Transformation de listes avec des mappeurs de données
Les mappeurs de données peuvent effectuer des transformations de liste. Pour mapper l'entrée avec la sortie, les mappeurs de données nécessitent une entrée de liste dans laquelle chaque valeur est associée à une clé.
Par exemple, les listes suivantes sont valides et chacune peut être convertie en une autre liste.
Liste 1 :
{
"Oldest": "Huey",
"Middle": "Dewey",
"Youngest": "Louie"
}
Liste 2 :
{
"Nephews": [
{
"Name": "Huey"
},
{
"Name": "Dewey"
},
{
"Name": "Louie"
}
]
}
La liste 1 n'a pas de nœud JSON pour l'ensemble de la liste, et chaque valeur a une clé différente. La liste 2 a son propre nœud JSON et chaque élément de liste a la même clé.
Pour convertir Liste 1 en Liste 2, utilisez les mappages ci-dessous sous l'onglet Transformations d'une Transformation Data Mapper. Les |1, |2 et |3 sont des index de position de liste.
Chemin JSON d'entrée |
Chemin JSON de sortie |
|---|---|
Plus ancien |
Nephews|1:Name |
Milieu |
Nephews|2:Name |
Plus jeune |
Nephews|3:Name |
Pour convertir Liste 2 en Liste 1, utilisez les mappages inverses.
Dans la liste suivante, les valeurs n'ont pas de clé.
Liste 3 :
{
"Nephews": [
"Huey",
"Dewey",
"Louie"
]
}
Vous pouvez convertir Liste 1 en Liste 3 en utilisant les mappages suivants :
Chemin JSON d'entrée |
Chemin JSON de sortie |
|---|---|
Plus ancien |
Nephews|1 |
Milieu |
Nephews|2 |
Plus jeune |
Nephews|3 |
Cependant, vous ne pouvez pas convertir Liste 3 en Liste 1 ou Liste 2.
Pour convertir Liste 2 en Liste 3, et effectuer ces conversions de listes de n'importe quelle longueur, consultez Conversion d'une liste d'objets en liste de valeurs.
Si chaque objet d'une liste a une clé différente, Transformation Data Mapper crée une carte unique avec des paires de clés et de valeurs combinées de cette liste, et ignore toutes les valeurs vides. Voici un exemple de produits pour un site Web d'e-commerce :
{
"Cleaning products": [
{
"Name": "WonderProduct"
"Property": ""
},
{
"Name": ""
"Property": "Fast-acting"
},
{
"Scent": "Lavender"
}
]
}
Liste de sortie transformée :
{
"Cleaning products": [
{
"Name": "WonderProduct"
"Property": "Fast-acting"
"Scent": ":Lavender"
}
]
}
Pour plus d'informations sur les listes, consultez :
-
Fonctions AVG, FILTER, IF, LIST, LISTMERGE, LISTMERGEPRIMARY, LISTSIZE, MAX, MIN, SORTBY et SUM dans les fonctions Mappeur de données et Procédure d'intégration prises en charge
-
Utilisation de données et de listes dans des procédures d'intégration
-
Action de liste pour les procédures d'intégration dans les procédures d'intégration
-
Action de procédure d'intégration dans les procédures d'intégration (l'exemple transforme une liste)
Comportement attendu pour les entrées de tableau
Lorsqu'une entrée de liste (tableau) est mappée avec une sortie qui devrait être un objet unique (non-tableau), la transformation Data Mapper aplatit automatiquement le tableau ou fusionne les objets en fonction du nombre d'enregistrements dans le tableau d'entrée.
- Si le tableau d'entrée de liste contient deux enregistrements, la Transformation Data Mapper aplatit le tableau et tente de fusionner les enregistrements dans un objet JSON unique dans la sortie. Le nœud de sortie est un
{}d'objet unique au lieu d'un[]de tableau.Exemple d'entrée :
{ "In": [ { "field1": "data1" }, { "field2": "data2" } ] }Exemple de sortie :
{ "Out": { "field1": "data1", "field2": "data2" } } - Si le tableau d'entrée contient plus de deux enregistrements (objets multiples), la transformation Data Mapper conserve la structure du tableau et n'aplatit pas les enregistrements. Le tableau est renvoyé en l'état dans la sortie.
Exemple d'entrée :
{ "In": [ { "field1": "data1" }, { "field2": "data2" }, { "field3": "data3" } ] }Exemple de sortie :
{ "Out": [ { "field1": "data1" }, { "field2": "data2" }, { "field3": "data3" } ] }
