Fonctions de tableau

Les fonctions de tableau typiquement utilisées dans Alaya Connector sont les suivantes.

add (array ; value1 ; value2 ; ...)

Cette fonction ajoute les valeurs spécifiées dans les paramètres à un tableau et renvoie ce tableau.

contains (array; value)

Cette fonction vérifie si un tableau contient la valeur.

distinct (array; [key])

Cette fonction supprime les doublons dans un tableau. L'argument « use » permet d'accéder aux propriétés des objets complexes. Pour accéder aux propriétés imbriquées, utilisez la notation par points. Le premier élément d’un ensemble est l’indice 1.

distinct(Contacts[];name)
= Supprime les doublons dans un tableau de contacts en comparant la propriété « name ».

flatten (array)

Cette fonction crée un nouveau tableau dans lequel sont concaténés tous les éléments des sous-réseaux, et ce de manière récursive jusqu'à la profondeur spécifiée.

Nous fournirons à l'avenir des articles plus instructifs sur cette fonction.

join (array; separator)

Cette fonction concatène tous les éléments d'un tableau en une chaîne de caractères et utilise un séparateur spécifié entre chaque élément.

keys (object)

Cette fonction renvoie un tableau des propriétés d'un objet ou d'un tableau donné.

length (array)

Cette fonction renvoie le nombre d'éléments d'un tableau.

map (complex array; key;[key for filtering];[valeurs possibles pour le filtrage séparées par une virgule])

Cette fonction renvoie un tableau primitif contenant les valeurs d'un tableau complexe. Les valeurs de filtrage sont autorisées et cette fonction utilise des noms de variables bruts pour les clés.

map(Emails[];email)
= Renvoie un tableau primitif contenant les courriels.

map(Emails[];email;label;work,home)
= Renvoie un tableau primitif contenant les courriels dont le libellé est égal à travail ou domicile.

merge (array1 ; array2 ; ...)

Cette fonction fusionne deux ou plusieurs tableaux en un seul.

remove (array ; value1 ; value2 ; ...)

Cette fonction supprime les valeurs spécifiées dans les paramètres d'un tableau. Efficace uniquement dans le cas de tableaux primitifs de texte ou de nombres.

reverse (array)

La fonction inverse le premier élément du tableau en dernier élément, et vice versa.

slice (array ; start ; [end])

Cette fonction renvoie un nouveau tableau contenant uniquement les éléments sélectionnés.

sort (array ; [order] ; [key])

Cette fonction trie les valeurs d'un tableau. Les valeurs valables du paramètre order sont les suivantes :

• asc (default) - ascending order: 1, 2, 3, ... for type Number. A, B, C, a, b, c, ... for type Text.
• desc - descending order: ..., 3, 2, 1 for type Number. ..., c, b, a, C, B, A for type Text.
• asc ci - case insensitive ascending order: A, a, B, b, C, c, ... for type Text.
• desc ci - case insensitive descending order: ..., C, c, B, b, A, a for type Text.

Cette fonction utilise le paramètre key pour accéder aux propriétés à l'intérieur d'objets complexes et utilise des noms de variables bruts pour les clés. Pour accéder aux propriétés imbriquées, utilisez plutôt la notation par points. Le premier élément d’un ensemble est l’indice 1.

sort(Contacts[];name)
= Trie un tableau de contacts par la propriété « name » dans l'ordre croissant par défaut.

sort(Contacts[];desc;name)
= Trie un tableau de contacts par la propriété « name » dans l'ordre décroissant.

sort(Contacts[];asc ci;name)
= Trie un tableau de contacts en fonction de la propriété « name » dans un ordre croissant insensible à la casse.

sort(Emails[];sender.name)
= Trie un tableau d'emails en fonction de la propriété « sender.name ».