Fonctions de liste et de tableau Omnistudio

Vous êtes ici :

Fonctions de liste et de tableau Omnistudio

Fonctions qui fonctionnent dans des listes et des tableaux.

Fonction Omnistudio AVG
Renvoie la moyenne d'une liste ou d'un tableau JSON de valeurs numériques.
Fonction Filtre Omnistudio
Filtre une liste d'objets JSON par une condition spécifiée et renvoie une liste JSON d'objets correspondants.
Fonction LISTE Omnistudio
Convertit une liste ou un tableau JSON nommé en tableau JSON anonyme.
Fonction LISTMERGE Omnistudio
Fusionne les nœuds de deux listes JSON d'objets ou plus dans une liste JSON unique basée sur les valeurs d'une ou de plusieurs clés de fusion.
Fonction Omnistudio LISTMERGEPRIMARY
Augmente les nœuds d'une liste d'objets JSON primaire avec les données d'une ou de plusieurs autres listes JSON basées sur les valeurs d'une ou de plusieurs clés de fusion.
Fonction LISTSIZE Omnistudio
Renvoie le nombre d'éléments dans une liste ou un tableau JSON.
Fonction Omnistudio MAPTOLIST
Convertit un objet JSON ou une hiérarchie d'objets en liste JSON.
Fonction Omnistudio MAX
Renvoie la valeur maximale d'une liste ou d'un tableau JSON de valeurs numériques.
Fonction Omnistudio MIN
Renvoie la valeur minimale d'une liste ou d'un tableau JSON de valeurs numériques.
Fonction SORTBY Omnistudio
Trie une liste JSON d'objets par clés spécifiées et renvoie une liste JSON triée. (Data Mappers uniquement)
Fonction SUM Omnistudio
Renvoie la somme d'une liste ou d'un tableau JSON de valeurs numériques.

Fonction Omnistudio AVG

Renvoie la moyenne d'une liste ou d'un tableau JSON de valeurs numériques.

Signature

AVG(list)

Valeur renvoyée

Numérique

Paramètres

Paramètre	Type de données	Nécessité	Description
`list`	Liste de numéros	Obligatoire	Une liste de valeurs numériques séparées par une virgule ou une liste de valeurs numériques d'un tableau JSON. Les valeurs nulles de la liste sont prises en compte dans le dénominateur, ce qui diminue la moyenne.

Exemple de liste

Formule : AVG(1, 2, 3, 4, 5, 6, 7, 8, 9, 10)

Valeur renvoyée : 5.5

Exemple de tableau JSON

Exemples de données :

"List": [ 
  {
    "Item": 3.5
  },
  {
    "Item": 4.25
  },
  {
    "Item": 5.75
  }
]

Formule : AVG(List:Item)

Formule : AVG(%List:Item%)

Valeur renvoyée : 4.5

Fonction Filtre Omnistudio

Filtre une liste d'objets JSON par une condition spécifiée et renvoie une liste JSON d'objets correspondants.

La fonction effectue la correspondance insensible à la casse des chaînes.

Signature

FILTER(LIST(list), condition)

Valeur renvoyée

Liste JSON

Paramètres

Paramètre	Type de données	Nécessité	Description
`LIST(list)`	Liste JSON	Obligatoire	Un tableau JSON anonyme d'objets à filtrer. Utilisez la fonction `LIST` pour transmettre un tableau JSON.
`condition`	Expression	Obligatoire	Une expression d'équivalence qui identifie le nœud sur lequel filtrer et la valeur que le nœud doit avoir pour être qualifié de correspondance. Spécifiez la valeur sous forme de chaîne ou de variable. Vous devez placer l'expression complète entre guillemets et également citer une valeur de chaîne dans l'expression.

Filtrage par exemple de chaîne

Exemples de données :

"NameList": [ 
  {
    "FirstName": "Zellie",
    "LastName": "Xavier"
  },
  {
    "FirstName": "Aaron",
    "LastName": "Xavier"
  },
  {
    "FirstName": "Mike",
    "LastName": "Smith"
  }
]

Formule : FILTER(LIST(NameList), 'LastName == "Xavier"')

Formule : FILTER(LIST(NameList), "LastName == 'Xavier'")

Valeur renvoyée :

[ 
  {
    "FirstName": "Aaron",
    "LastName": "Xavier"
  },
  {
    "FirstName": "Zellie",
    "LastName": "Xavier"
  }
]

Filtrage par exemple de variable

Exemples de données :

"NameList": [ 
  {
    "FirstName": "Zellie",
    "LastName": "Xavier"
  },
  {
    "FirstName": "Aaron",
    "LastName": "Xavier"
  },
  {
    "FirstName": "Mike",
    "LastName": "Smith"
  }
],
"FindName": "Xavier"

Formule : FILTER(LIST(NameList), 'LastName == "' + FindName + '"')

Formule : FILTER(LIST(NameList), "LastName == '" + FindName + "'")

Valeur renvoyée :

[ 
  {
    "FirstName": "Aaron",
    "LastName": "Xavier"
  },
  {
    "FirstName": "Zellie",
    "LastName": "Xavier"
  }
]

Fonction LISTE Omnistudio

Convertit une liste ou un tableau JSON nommé en tableau JSON anonyme.

Utilisez la fonction LIST avec d'autres fonctions qui nécessitent un tableau JSON anonyme (une liste JSON) en entrée : FILTER, LISTMERGE, LISTMERGEPRIMARY, SERIALIZE, SORTBY, et un FUNCTION personnalisé qui transmet une liste JSON en argument.

Signature

LIST(expression)

Valeur renvoyée

Liste JSON

Paramètres

Paramètre	Type de données	Nécessité	Description
`expression`	Tableau JSON Liste ou nommé	Obligatoire	Expression résolue en une liste de valeurs ou d'objets JSON, ou en un tableau JSON nommé d'une ou de plusieurs valeurs ou objets. Chaque objet peut contenir un ou plusieurs nœuds ou paires clé-valeur. Si vous lui transmettez un tableau JSON anonyme, la fonction renvoie un tableau avec un seul objet `VLOCITY-FORMULA-LIST` qui contient ce tableau anonyme.

Paramètre

Type de données

Nécessité

Description

expression

Tableau JSON Liste ou nommé

Obligatoire

Expression résolue en une liste de valeurs ou d'objets JSON, ou en un tableau JSON nommé d'une ou de plusieurs valeurs ou objets. Chaque objet peut contenir un ou plusieurs nœuds ou paires clé-valeur.

Si vous lui transmettez un tableau JSON anonyme, la fonction renvoie un tableau avec un seul objet VLOCITY-FORMULA-LIST qui contient ce tableau anonyme.

Exemple de liste de valeurs alphabétiques

Formule : LIST("a", "b", "c")

Valeur renvoyée : [ "a", "b", "c" ]

Exemple de liste de valeurs numériques

Formule : LIST(1, 2, 2, 3, 3, 4)

Valeur renvoyée : [ 1, 2, 2, 3, 3, 4 ]

Exemple d'objet JSON

Exemples de données :

"Contact": {
  "FirstName": "Mike",
  "LastName": "Smith"
}

Formule : LIST(Contact)

Valeur renvoyée :

[
  {
    "LastName": "Smith",
    "FirstName": "Mike"
  }
]

Exemple de tableau JSON nommé

Exemples de données :

"NameList": [
  {
    "FirstName": "Zellie",
    "LastName": "Xavier"
  },
  {
    "FirstName": "Aaron",
    "LastName": "Xavier"
  },
  {
    "FirstName": "Mike",
    "LastName": "Smith"
  }
]

Formule : LIST(NameList)

Valeur renvoyée :

[
  {
    "FirstName": "Zellie",
    "LastName": "Xavier"
  },
  {
    "FirstName": "Aaron",
    "LastName": "Xavier"
  },
  {
    "FirstName": "Mike",
    "LastName": "Smith"
  }
]

Exemple de tableau JSON nommé

Exemples de données :

"Account": [
  {
    "Cases": [
      {
        "Case1": {
          "CreatedDate": "2/1/2004T16:35:30 GMT -0500 (EDT)",
          "LastUpdate": "2/8/2024T09:15:00 GMT -0500 (EDT)"
        }
      },
      {
        "Case2": {
          "CreatedDate": "2/2/2004T11:05:05 GMT -0500 (EDT)",
          "LastUpdate": "2/3/2024T15:50:57 GMT -0500 (EDT)"
        }
      }
    ]
  }
]

Formule : LIST(Account:Cases)

Valeur renvoyée :

[
  {
    "Case1": {
      "CreatedDate": "2/1/2024T16:35:30 GMT -0500 (EDT)",
      "LastUpdate": "2/8/2024T09:15:00 GMT -0500 (EDT)"
    }
  },
  {
    "Case2": {
      "CreatedDate": "2/2/2025T11:05:05 GMT -0500 (EDT)",
      "LastUpdate": "2/3/2025T15:50:57 GMT -0500 (EDT)"
    }
  }
]

Fonction LISTMERGE Omnistudio

Fusionne les nœuds de deux listes JSON d'objets ou plus dans une liste JSON unique basée sur les valeurs d'une ou de plusieurs clés de fusion.

La fonction combine les nœuds des tableaux JSON anonymes spécifiés lorsque les valeurs des clés de fusion nommées correspondent. La liste générée contient tous les nœuds et clés de toutes les listes fusionnées. Si les listes contiennent des nœuds avec des clés de fusion identiques, mais des valeurs différentes, les valeurs des nœuds suivants remplacent celles des nœuds précédents. La fonction effectue la correspondance insensible à la casse des clés de fusion.

Signature

LISTMERGE(mergeKey..., LIST(list)...)

Valeur renvoyée

Liste JSON

Paramètres

Paramètre	Type de données	Nécessité	Description
`mergeKey...`	Chaîne	Obligatoire	Une liste d'une ou de plusieurs clés séparées par une virgule. La fonction combine les nœuds des listes lorsque les valeurs de leurs clés de fusion correspondent.
`LIST(list)...`	Liste JSON	Obligatoire	Deux tableaux JSON anonymes ou plus à fusionner. Utilisez la fonction `LIST` pour transmettre chaque tableau JSON. Si vous transmettez un seul tableau, la fonction renvoie ce tableau.

Exemple de liste de fusion

Exemples de données :

"ContactNames": [
  {
    "id": "0036ab",
    "lastName": "Jones",
    "firstName": "Cathy"
  },
  {
    "id": "2787kq",
    "lastName": "Smith",  
    "firstName": "Albert"
  },
  {
    "id": "3610xr",
    "lastName": "Smith",
    "firstName": "Ben"
  }
],
"ContactAddresses": [
  {
    "id": "0036ab",
    "city": "Phoenix",
    "state": "AZ"
  },
  {
    "id": "2787kq",
    "city": "San Francisco",
    "state": "CA"
  },
  {
    "id": "3610xr",
    "city": "Portland",
    "state": "OR"
  }
],
"ContactBirthdates": [
  {
    "id": "0036ab",
    "birthdate": "1976-10-04"
  },
  {
    "id": "2787kq",
    "birthdate": "1973-10-01"
  },
  {
    "id": "3610xr",
    "birthdate": "1974-10-02"
  }
]

Formule : LISTMERGE("id", LIST(ContactNames), LIST(ContactAddresses), LIST(ContactBirthdates))

Valeur renvoyée :

[
  {
    "id": "0036ab",
    "lastName": "Jones",
    "firstName": "Cathy",
    "city": "Phoenix",
    "state": "AZ",
    "birthdate": "1976-10-04"
  },
  {
    "id": "2787kq",
    "lastName": "Smith",  
    "firstName": "Albert",
    "city": "San Francisco",
    "state": "CA",
    "birthdate": "1973-10-01"
  },
  {
    "id": "3610fw",
    "lastName": "Smith",
    "firstName": "Ben",
    "city": "Portland",
    "state": "OR",
    "birthdate": "1974-10-02"
  }
]

Fonction Omnistudio LISTMERGEPRIMARY

Augmente les nœuds d'une liste d'objets JSON primaire avec les données d'une ou de plusieurs autres listes JSON basées sur les valeurs d'une ou de plusieurs clés de fusion.

La fonction augmente les nœuds du premier tableau JSON anonyme spécifié (principal) avec les données de tous les autres tableaux JSON anonymes spécifiés lorsque les valeurs des clés de fusion nommées correspondent. La liste générée contient tous les nœuds et clés de la première liste ainsi que les clés des autres listes correspondantes. Si les valeurs des nœuds de listes ultérieures avec des clés de fusion identiques sont différentes de celles de la première liste, les valeurs des nœuds suivants remplacent celles des nœuds précédents. La fonction effectue la correspondance insensible à la casse des clés de fusion.

Utilisez par exemple la fonction lorsque vous avez une liste de produits qualifiés que vous souhaitez augmenter avec les données de listes associées. La fonction n'inclut pas les produits des listes ultérieures qui apparaissent dans la liste principale.

Signature

LISTMERGEPRIMARY(mergeKey..., LIST(list)...)

Valeur renvoyée

Liste JSON

Paramètres

Paramètre	Type de données	Nécessité	Description
`mergeKey...`	Chaîne	Obligatoire	Une liste d'une ou de plusieurs clés séparées par une virgule. La fonction augmente les nœuds de la première liste avec les clés des autres listes lorsque les valeurs de leurs clés de fusion correspondent.
`LIST(list)...`	Liste JSON	Obligatoire	Un tableau JSON anonyme principal à étendre avec les données d'un ou de plusieurs autres tableaux JSON anonymes. La fonction inclut uniquement les nœuds de la première liste de la liste qu'elle renvoie. Utilisez la fonction `LIST` pour transmettre chaque tableau JSON. Si vous transmettez uniquement un tableau principal, la fonction renvoie ce tableau.

Exemple de liste de fusion principale

Exemples de données :

"ContactNames": [
  {
    "id": "0036ab",
    "lastName": "Jones",
    "firstName": "Cathy"
  },
  {
    "id": "3610xr",
    "lastName": "Smith",
    "firstName": "Ben"
  }
],
"ContactAddresses": [
  {
    "id": "0036ab",
    "city": "Phoenix",
    "state": "AZ"
  },
  {
    "id": "7723hw",
    "lastName": "Sacramento",
    "firstName": "CA"
  },
  {
    "id": "2787kq",
    "city": "San Francisco",
    "state": "CA"
  },
  {
    "id": "3610xr",
    "city": "Portland",
    "state": "OR"
  }
],
"ContactBirthdates": [
  {
    "id": "0036ab",
    "birthdate": "1976-10-04"
  },
  {
    "id": "7723hw",
    "birthdate": "1974-07-04"
  },
  {
    "id": "2787kq",
    "birthdate": "1973-10-01"
  },
  {
    "id": "3610xr",
    "birthdate": "1974-10-02"
  }
]

Formule : LISTMERGEPRIMARY("id", LIST(ContactNames), LIST(ContactAddresses), LIST(ContactBirthdates))

Valeur renvoyée :

[
  {
    "id": "0036ab",
    "lastName": "Jones",
    "firstName": "Cathy",
    "city": "Phoenix",
    "state": "AZ",
    "birthdate": "1976-10-04"
  },
  {
    "id": "3610fw",
    "lastName": "Smith",
    "firstName": "Ben",
    "city": "Portland",
    "state": "OR",
    "birthdate": "1974-10-02
  }
]

Fonction LISTSIZE Omnistudio

Renvoie le nombre d'éléments dans une liste ou un tableau JSON.

Pour tester un tableau vide, utilisez la fonction ISBLANK.

Signature

LISTSIZE(list)

Valeur renvoyée

Numérique

Paramètres

Paramètre	Type de données	Nécessité	Description
`list`	Tableau Liste ou JSON	Obligatoire	Une liste de valeurs séparées par une virgule ou un tableau JSON de valeurs ou de nœuds.

Exemple de liste

Formule : LISTSIZE(6, 7, 8, 9, 10)

Valeur renvoyée : 5

Exemple de liste vide

Formule : LISTSIZE()

Formule : LISTSIZE(())

Valeur renvoyée : 0

Exemple de tableau JSON

Exemples de données :

"NameList": [
  {
    "FirstName": "Zellie",
    "LastName": "Xavier"
  },
  {
    "FirstName": "Aaron",
    "LastName": "Xavier"
  },
  {
    "FirstName": "Mike",
    "LastName": "Smith"
  }
]

Formule : LISTSIZE(NameList)

Valeur renvoyée : 3

Exemple de tableau vide

Exemple de données : "EmptyList": []

Formule : LISTSIZE([])

Formule : LISTSIZE(EmptyList)

Valeur renvoyée : 1

Formule : IF(ISBLANK(EmptyList), 0, LISTSIZE(EmptyList))

Valeur renvoyée : 0

Fonction Omnistudio MAPTOLIST

Convertit un objet JSON ou une hiérarchie d'objets en liste JSON.

Signature

MAPTOLIST(jsonObject)

Valeur renvoyée

Liste JSON

Paramètres

Paramètre	Type de données	Nécessité	Description
`jsonObject`	Objet JSON	Obligatoire	Un nœud ou chemin de nœud d'un objet JSON à convertir en liste JSON. Chaque nœud peut contenir un ou plusieurs nœuds ou paires clé-valeur.

Exemple d'objet JSON

Exemples de données :

"Contact": {
  "FirstName": "William",
  "MiddleName": "Leslie",
  "LastName": "Edison",
  "Parents": {
    "Father": {
      "FirstName": "Thomas",
      "MiddleName": "Alva",
      "LastName": "Edison"
    },
    "Mother": {
      "FirstName": "Mary",
      "MiddleName": "Stilwell",
      "LastName": "Edison"
    }
  }
}

Formule : MAPTOLIST(Contact)

Valeur renvoyée :

[
  {
    "LastName": "Edison"
  },
  {
    "MiddleName": "Leslie"
  },
  {
    "FirstName": "William"
  },
  {
    "Parents": {
      "Father": {
        "MiddleName": "Alva",
        "LastName": "Edison",
        "FirstName": "Thomas"
      },
      "Mother": {
        "MiddleName": "Stilwell",
        "LastName": "Edison",
        "FirstName": "Mary"
      }
    }
  }
]

Formule : MAPTOLIST(Contact:Parents)

Valeur renvoyée :

[
  {
    "Mother": {
      "MiddleName": "Stilwell",
      "LastName": "Edison",
      "FirstName": "Mary"
    }
  },
  {
    "Father": {
      "MiddleName": "Alva",
      "LastName": "Edison",
      "FirstName": "Thomas"
    }
  }
]

Formule : MAPTOLIST(Contact:Parents:Mother)

Valeur renvoyée :

[
  {
    "LastName": "Edison"
  },
  {
    "MiddleName": "Stilwell"
  },
  {
    "FirstName": "Mary"
  }
]

Fonction Omnistudio MAX

Renvoie la valeur maximale d'une liste ou d'un tableau JSON de valeurs numériques.

Signature

MAX(list)

Valeur renvoyée

Numérique

Paramètres

Paramètre	Type de données	Nécessité	Description
`list`	Liste de numéros	Obligatoire	Une liste de valeurs numériques séparées par une virgule ou une liste de valeurs numériques d'un tableau JSON.

Exemple de liste

Formule : MAX(1, 2, 3, 4, 5, 6, 7, 8, 9, 10)

Valeur renvoyée : 10

Exemple de tableau JSON

Exemples de données :

"List": [ 
  {
    "Item": 3
  },
  {
    "Item": 4
  },
  {
    "Item": 5
  }
]

Formule : MAX(List:Item)

Valeur renvoyée : 5

Fonction Omnistudio MIN

Renvoie la valeur minimale d'une liste ou d'un tableau JSON de valeurs numériques.

Signature

MIN(list)

Valeur renvoyée

Numérique

Paramètres

Paramètre	Type de données	Nécessité	Description
`list`	Liste de numéros	Obligatoire	Une liste de valeurs numériques séparées par une virgule ou une liste de valeurs numériques d'un tableau JSON.

Exemple de liste

Formule : MIN(1, 2, 3, 4, 5, 6, 7, 8, 9, 10)

Valeur renvoyée : 1

Exemple de tableau JSON

Exemples de données :

"List": [ 
  {
    "Item": 3
  },
  {
    "Item": 4
  },
  {
    "Item": 5
  }
]

Formule : MIN(List:Item)

Valeur renvoyée : 3

Fonction SORTBY Omnistudio

Trie une liste JSON d'objets par clés spécifiées et renvoie une liste JSON triée. (Data Mappers uniquement)

La fonction effectue la correspondance insensible à la casse des clés et le tri des valeurs.

Signature

SORTBY(LIST(list), key..., [:DSC])

Valeur renvoyée

Liste JSON

Paramètres

Paramètre	Type de données	Nécessité	Description
`LIST(list)`	Liste JSON	Obligatoire	Un tableau JSON anonyme d'objets à trier. Utilisez la fonction `LIST` pour transmettre un tableau JSON.
`key...`	Chaîne	Obligatoire	Une ou plusieurs clés de tri des objets JSON.
`[:DSC]`	Chaîne	Facultatif	Trie les résultats par ordre décroissant. Vous devez placer la valeur entre guillemets simples ou doubles, par exemple `'[:DSC]'`. Omettez le paramètre pour trier les résultats par ordre ascendant par défaut.

Liste de tri par ordre croissant

Exemples de données :

"NameList": [
  {
    "FirstName": "Aaron",
    "LastName": "Xavier"
  },
  {
    "FirstName": "Zellie",
    "LastName": "Xavier"
  },
  {
    "FirstName": "Mike",
    "LastName": "Smith"
  }
]

Formule : SORTBY(LIST(NameList), 'LastName', 'FirstName')

Valeur renvoyée :

[ 
  {
    "FirstName": "Mike",
    "LastName": "Smith"
  },
  {
    "FirstName": "Aaron",
    "LastName": "Xavier"
  },
  {
    "FirstName": "Zellie",
    "LastName": "Xavier"
  }
]

Liste de tri par ordre décroissant

Exemples de données :

"NameList": [ 
  {
    "FirstName": "Aaron",
    "LastName": "Xavier"
  },
  {
    "FirstName": "Zellie",
    "LastName": "Xavier"
  },
  {
    "FirstName": "Mike",
    "LastName": "Smith"
  }
]

Formule : SORTBY(LIST(NameList), 'LastName', 'FirstName', '[:DSC]')

Valeur renvoyée :

[
  {
    "FirstName": "Zellie",
    "LastName": "Xavier"
  },
  {
    "FirstName": "Aaron",
    "LastName": "Xavier"
  },
  {
    "FirstName": "Mike",
    "LastName": "Smith"
  }
]

Fonction SUM Omnistudio

Renvoie la somme d'une liste ou d'un tableau JSON de valeurs numériques.

Signature

SUM(list)

Valeur renvoyée

Numérique

Paramètres

Paramètre	Type de données	Nécessité	Description
`list`	Liste de numéros	Obligatoire	Une liste de valeurs numériques séparées par une virgule ou une liste de valeurs numériques d'un tableau JSON.

Exemple de liste

Formule : SUM(1, 2, 3, 4, 5, 6, 7, 8, 9, 10)

Valeur renvoyée : 55

Exemple de tableau JSON

Exemples de données :

"List": [ 
  {
    "Item": 3.5
  },
  {
    "Item": 4.25
  },
  {
    "Item": 5.75
  }
]

Formule : SUM(List:Item)

Formule : SUM(%List:Item%)

Valeur renvoyée : 13.5

Cet article a-t-il résolu votre problème ?

Dites-nous ce que nous pouvons améliorer !

Ce texte a été traduit à l’aide du système de traduction automatique de Salesforce. Plus de détails, consultez <cette page.Basculer vers la page en anglaisPas maintenant

Gamme de produits

Impact des fonctionnalités

Edition

Expérience

Fonctions de liste et de tableau Omnistudio

Fonction Omnistudio AVG

Signature

Valeur renvoyée

Paramètres

Fonction Filtre Omnistudio

Signature

Valeur renvoyée

Paramètres

Fonction LISTE Omnistudio

Signature

Valeur renvoyée

Paramètres

Fonction LISTMERGE Omnistudio

Signature

Valeur renvoyée

Paramètres

Fonction Omnistudio LISTMERGEPRIMARY

Signature

Valeur renvoyée

Paramètres

Fonction LISTSIZE Omnistudio

Signature

Valeur renvoyée

Paramètres

Fonction Omnistudio MAPTOLIST

Signature

Valeur renvoyée

Paramètres

Fonction Omnistudio MAX

Signature

Valeur renvoyée

Paramètres

Fonction Omnistudio MIN

Signature

Valeur renvoyée

Paramètres

Fonction SORTBY Omnistudio

Signature

Valeur renvoyée

Paramètres

Fonction SUM Omnistudio

Signature

Valeur renvoyée

Paramètres

Ce texte a été traduit à l’aide du système de traduction automatique de Salesforce. Plus de détails, consultez <cette page.