Loading
Transformation de listes avec des mappeurs de données

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

Remarque
Remarque Les composants Bloc de boucle dans les procédures d'intégration nécessitent une entrée structurée comme la liste 2. La clé liste-élément elle-même peut contenir des paires clé-valeur. Pour des exemples, consultez Utilisation de données et de listes.

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 :

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" }
     ]
    }
 
Chargement
Salesforce Help | Article