Utilitaires : fonctions de transformation

Utilisez des utilitaires pour transformer les fonctions pour renvoyer un objet complexe à partir d’un tableau ou une valeur associée à une clé spécifique.

Les fonctions de transformation des utilitaires nécessitent une pastille de données d’entrée Tableau, Paire nom-valeur, Chaîne, Entier ou Choix. Assurez-vous d’utiliser le type de pastille de données d’entrée correct lors de l’application des fonctions de transformation des utilitaires. Si une fonction de transformation utilitaire est appliquée à un type de données incorrect, les données ne sont pas transformées pendant l’exécution et la valeur d’entrée est renvoyée à la place. Pour plus d’informations sur la confirmation des valeurs d’exécution de votre flux, consultez Tester un flux.

Obtenir le dernier élément du tableau

Renvoie le premier élément du tableau d’entrée comme un objet complexe.

Pastille de données d’entrée	Pastille de données de sortie
Tableau	Complex Object - Premier élément trouvé dans le tableau d’entrée

Obtenir l’élément du tableau

Renvoie un objet complexe du tableau d’entrée. Entrez une valeur pour le tableau d’entrée Nth Item que vous souhaitez renvoyer. Représente Nth Item l’index du tableau, à partir de 0.

Pastille de données d’entrée	Paramètres	Pastille de données de sortie
Tableau	Nth Item - Entrez l’index de l’objet cible dans le tableau d’entrée. L’index du tableau débute à 0.	Objet complexe

Obtenir l’élément à partir du nom/des valeurs

Renvoie une valeur associée à une clé correspondante d’une carte de paires nom-valeur.

Pastille de données d’entrée	Paramètres	Pastille de données de sortie
Paires nom-valeur	Key - Nom de la clé utilisée pour rechercher sa valeur correspondante Default - La valeur renvoyée lorsqu’il n’y a pas de clé correspondante	Chaîne associée à la clé de correspondance

Remarque :

Lors de l’application de la fonction de transformation Obtenir un élément à partir du nom/des valeurs, considérez que la valeur d’exécution peut être la valeur du système, et non la valeur d’affichage. Par exemple, si vous mappez le champ Priority (Priorité ) de la table Incident à un champ similaire dans une table distante, la valeur d’exécution renvoyée peut être 2 et non 2 : élevé.

Exemple d’utilisation :

• Entrée : « username » :"abel.tuter »
• Clé : nom d’utilisateur
• Par défaut : example.username
• Sortie : abel.tuter

Dans cet exemple, une action effectue un appel REST vers un système tiers et les données de ticket des GET sous forme de carte de paires nom-valeur. Un ID de ticket est fourni comme sortie pour cette action. La fonction de transformation Obtenir l’élément à partir du nom/des valeurs renvoie soit la valeur associée à la clé de ticket_id , soit l’ID de ticket introuvable.

Obtenir le dernier élément du tableau

Renvoie le dernier élément du tableau d’entrées comme un objet complexe.

Pastille de données d’entrée	Pastille de données de sortie
Tableau	Complex Object - Dernier élément trouvé dans le tableau d’entrée

Est vide

Renvoie la valeur vrai lorsque l’entrée est vide. Une entrée de chaîne est vide lorsqu’il s’agit d’une chaîne vide. Une entrée entière est vide lorsqu’elle est égale à zéro. Une entrée booléenne est vide lorsqu’elle est faux.

Remarque :

Cette fonction de transformation ne prend pas en charge les entrées de référence.

Pastille de données d’entrée	Sortie
N'importe lequel	Renvoie vrai ou faux

Exemple d’utilisation :

• Entrée : une pastille de données d’entier avec 0
• Sortie : vrai

Est faux

Renvoie la valeur « vrai » lorsque l’entrée est « faux ». Une chaîne est fausse lorsqu’elle est vide. Un entier est faux lorsqu’il est égal à zéro. Une entrée booléenne est fausse lorsqu’elle est fausse.

Pastille de données d’entrée	Pastille de données de sortie
N'importe lequel	Renvoie vrai ou faux

Exemple d’utilisation :

• Entrée : une pastille de données entière avec 13
• Sortie : fausse

N’est pas vide

Renvoie la valeur vrai lorsque l’entrée n’est pas vide. Une chaîne n’est pas vide lorsqu’elle n’est pas vide. Un entier n’est pas vide lorsqu’il est autre chose que zéro. Une entrée booléenne n’est pas vide lorsqu’elle a la valeur vrai.

Remarque :

Cette fonction de transformation ne prend pas en charge les entrées de référence.

Pastille de données d’entrée	Pastille de données de sortie
N'importe lequel	Renvoie vrai ou faux

Exemple d’utilisation :

• Entrée : une pastille de données entière avec 13
• Sortie : vrai

Est nul

Renvoie la valeur true lorsque la valeur d’entrée est nulle. Une entrée est nulle si elle n’est pas initialisée, ou s’il s’agit d’un objet ou d’une référence nul.

Pastille de données d’entrée	Sortie
N'importe lequel	Renvoie vrai ou faux

Exemple d’utilisation :

• Entrée : une pastille de données d’entier avec 725
• Sortie : fausse

Est vrai

Renvoie la valeur vrai lorsque l’entrée est vraie. Une chaîne est vraie lorsqu’elle n’est pas vide. Un entier est vrai lorsqu’il est différent de zéro. Une entrée booléenne est vraie lorsqu’elle est vraie.

Pastille de données d’entrée	Pastille de données de sortie
N'importe lequel	Renvoie vrai ou faux

Exemple d’utilisation :

• Entrée : une pastille de données entière avec 13
• Sortie : vrai

Carte de valeur de clé

Renvoie une valeur associée à une clé correspondante ou une valeur par défaut en l’absence de correspondance.

Pastille de données d’entrée	Paramètres	Pastille de données de sortie
Chaîne ou entier	Name - La clé utilisée pour trouver la valeur correspondante Value - La valeur correspondant à une clé spécifique Default - La valeur renvoyée lorsqu’il n’y a pas de nom correspondant	Chaîne associée à la clé de correspondance

Exemple d’utilisation :

Dans cet exemple, une action Journal stocke la priorité d’un enregistrement sous forme de message. Dans la section Nom-valeurs, chaque priorité est mappée à une valeur de chaîne correspondante. Lorsque le flux s’exécute, le numéro de priorité de l’enregistrement est transformé en chaîne, et la chaîne est consignée dans un message.

Trier

Trie le tableau spécifié par ordre croissant ou décroissant.

Pastille de données d’entrée	Paramètres	Pastille de données de sortie
Array.String, Array.Integer, Array.Boolean ou Array.Datetime. : tableau non trié	Sort Order - Ascendant ou décroissant	Tableau : tableau trié

Remarque :

La fonction de tri est sensible à la casse pour array.strings.

Exemple d’utilisation :

• Entrée : [7, 2, 3, 1, 7, 9]
• Paramètre : Croissant
• Sortie : [1, 2, 3, 7, 7, 9]

Unique

Supprime les éléments en double du tableau spécifié.

Pastille de données d’entrée	Pastille de données de sortie
Array.String, Array.Integer, Array.Boolean ou Array.Datetime.	Tableau : après suppression des éléments dupliqués

Exemple d’utilisation :

• Entrée : [7, 2, 3, 2, 7, 9]
• Sortie : [7, 2, 3, 9]

Joindre

Concatène les éléments individuels du tableau spécifié avec le délimiteur spécifié et retourne la chaîne concaténée.

Pastille de données d’entrée	Paramètres	Pastille de données de sortie
Array.String, Array.Integer, Array.Boolean ou Array.Datetime.	Délimiteur : caractère qui sépare les éléments individuels après la concaténation.	Chaîne : chaîne après l’ajout d’un délimiteur.

Exemple d’utilisation :

• Entrée : [1, 2, 3]
• Paramètres : <
• Sortie : 1<2<3