Utilitaires : fonctions de transformation

  • Rversion finale: Zurich
  • Mis à jour 31 juil. 2025
  • 5 minutes de lecture

    • 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 Nth Item dans le tableau d’entrée que vous souhaitez renvoyer. Le Nth Item représente 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é de correspondance 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 - 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 l’élément à partir du nom/des valeurs, considérez que la valeur d’exécution peut être la valeur système et non la valeur d’affichage. Par exemple, si vous mappez le champ 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é : username
    • Par défaut : example.username
    • Sortie : abel.tuter

    Dans cet exemple, une action effectue un appel REST vers un système tiers et envoie des données de ticket 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.

    Valeur associée à ticket_id clé ou « ID du ticket introuvable » renvoyée en tant que sortie de l’action.

    Obtenir le dernier élément du tableau

    Renvoie le dernier é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 - 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 de nombre entier 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 entière avec 0
    • Sortie : vrai

    Est faux

    Renvoie la valeur vrai lorsque l’entrée est faux. Une chaîne est fausse lorsqu’il s’agit d’une chaîne 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’il ne s’agit pas d’une chaîne vide. Un entier n’est pas vide lorsqu’il est différent de 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 null si elle n’est pas initialisée, ou s’il s’agit d’un objet ou d’une référence null.

    Pastille de données d’entrée Sortie
    N'importe lequel Renvoie vrai ou faux
    Exemple d’utilisation :
    • Entrée : pastille de données entière avec 725
    • Sortie : fausse

    Est vrai

    Renvoie la valeur vrai lorsque l’entrée est vrai. Une chaîne est vraie lorsqu’il ne s’agit pas d’une chaîne 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 s’il n’y a pas 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 de 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.

    Une carte clé-valeur transforme une valeur d’un nombre en chaîne.

    Trier

    Trie le tableau spécifié dans l’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 : Ascendant
    • 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 la 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 renvoie 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