Loading
Utilisation de formules dans les mappeurs de données Omnistudio

Vous êtes ici :

  1. Aide de Salesforce
  2. Documents
  3. OmniStudio

Utilisation de formules dans les mappeurs de données Omnistudio

Pour ajouter des données à la sortie d'un Mappeur de données, définissez des formules. Plusieurs types de mappeur de données (extraction, transformation et chargement) prennent en charge les formules. Lorsque vous définissez une formule, vous mappez sa sortie avec le champ d'objet JSON de sortie (pour les extractions et les transformations) ou Salesforce (pour les chargements).

Pour plus d'informations sur les opérateurs et les fonctions que vous pouvez utiliser dans des formules, consultez Formules et fonctions OmniStudio.

Remarque
Remarque

Si un nom de variable contient des espaces ou des caractères non alphanumériques, placez le nom de la variable entre guillemets doubles et faites-le précéder de var: dans des formules. Par exemple, si le nom du nœud JSON est Primary Guardian, spécifiez-le en tant que var:"Primary Guardian" dans les formules.

Si le nom d'un champ personnalisé contient des caractères spéciaux, parfois vous ne pouvez pas référencer le champ dans une formule.

Dans l'exécution standard Omnistudio, la saisie de la formule de requête incorrecte pour Data Mappers renvoie null, mais n'affiche pas les journaux d'erreur. Si vous obtenez une réponse nulle d'une requête, mettez la requête à jour.

  1. Dans la page Interface du mappeur de données, accédez à l'onglet Formules.
  2. Cliquez sur Ajouter une formule. Une formule vide est ajoutée à la liste.
  3. Dans le champ Formule, spécifiez la logique souhaitée. Par exemple, pour déterminer le prix total des articles achetés par un client, saisissez une formule telle que :

    SUM(Products:Price)

    Vous pouvez également utiliser la notation des relations dans des formules pour référencer des champs dans un objet parent. Consultez Notation de relation par rapport aux étapes d'extraction multiples.

  4. Dans le champ Chemin de résultat de la formule, spécifiez un nœud JSON dans lequel stocker le résultat de la formule.
  5. Mappez le résultat avec la sortie finale.
    • Pour un mappeur de données Extraire, sous l'onglet Sortie, mappez le résultat de la formule avec la structure de sortie. Utilisez deux points (:) pour délimiter les niveaux dans les chemins d'entrée et de sortie des mappages.
    • Pour un mappeur de données Transformation, sous l'onglet Transformations, mappez le résultat de la formule avec la structure de sortie. Utilisez deux points (:) pour délimiter les niveaux dans les chemins d'entrée et de sortie des mappages.
    • Pour un Mappeur de données de chargement, pour chaque sObject que vous souhaitez mettre à jour, sous l'onglet Champs, mappez le résultat de la formule avec le champ que vous souhaitez mettre à jour.
  6. Chargement : Pour chaque sObject que vous souhaitez mettre à jour, accédez à son onglet Champs, puis mappez le résultat de la formule avec le champ spécifique que vous souhaitez mettre à jour.

Création d'un exemple de mappeur de données Omnistudio avec une formule

L'exemple suivant accepte une liste de prix et utilise une formule pour calculer le prix total.

Pour créer cette transformation Data Mapper, procédez comme suit :

  1. Accédez à l'onglet Concepteur Omnistudio Data Mapper, puis cliquez sur Nouveau. Le dialogue Créer est affiché.
  2. Spécifiez un nom pour le Mappeur de données et configurez ses paramètres comme suit :
    • Type d'interface : Transformation
    • Type d'entrée : JSON
    • Type de sortie : JSON
  3. Cliquez sur Enregistrer. La page Interface du mappeur de données est affichée.
  4. Accédez à l'onglet Formules, puis cliquez sur Ajouter une formule.
  5. Dans le champ Formule, saisissez SUM(Products:Price).
  6. Dans le champ Chemin de résultat de la formule, saisissez TotalPrice.
  7. Sous l'onglet Transformations, agrandissez le volet JSON Entrée et collez-y cette structure JSON : 
    {
    "CustomerName": "Bob Smith",
    "Products": [
        {
            "Name": "iPhone",
            "Price": 600
        },
        {
            "Name": "iPhone Case",
            "Price": 30
        },
        {
            "Name": "Ear Buds",
            "Price": 200
        }
    ]
}
  8. Agrandissez le volet Sortie JSON attendue et collez-y cette structure JSON : 
    {
    "CustomerName": "Bob Smith",
    "TotalPrice": 830,
    "Products": [
        {
            "Name": "iPhone",
            "Price": 600
        },
        {
            "Name": "iPhone Case",
            "Price": 30
        },
        {
            "Name": "Ear Buds",
            "Price": 200
        }
    ]
}
  9. Cliquez sur Correspondance rapide. Dans la fenêtre Correspondance rapide, cliquez sur Correspondance automatique, puis sur Enregistrer.
  10. Sous l'onglet Aperçu, cliquez sur Exécuter.

    Si vous avez correctement élaboré l'exemple, la structure JSON du volet Réponse correspond à la Sortie JSON attendue, à l'exception de l'ordre des nœuds de niveau supérieur.

  11. Dans le volet Entrée, modifiez un ou plusieurs prix, puis cliquez de nouveau sur Exécuter.

    Notez comment la valeur de TotalPrice change.

 
Chargement
Salesforce Help | Article