Fonctions de transformation des utilitaires

  • Rversion finale: Washingtondc
  • Mis à jour 1 févr. 2024
  • 5 minutes de lecture

    • Utilisez les fonctions de transformation des utilitaires 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 d’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 Array, à 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 Array commence à 0. Objet complexe

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

    Renvoie une valeur associée à une clé correspondante à partir 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é qui est utilisé pour rechercher sa valeur correspondante
    • Default - La valeur retournée lorsqu’il n’y a pas de clé correspondante
    		 Chaîne associée à la clé correspondante
    Remarque :
    Lors de l’application de la fonction de transformation Obtenir un élément à partir du nom/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é.
    Figure 1. Exemple
    • Entrée : « username » :"abel.tuter »
    • Clé : username
    • Valeur par défaut : example.username
    • Sortie : abel.tuter

    Dans cet exemple, une action effectue un appel REST vers un système tiers et GETs les données de ticket en tant que carte de paires nom-valeur. Un ID de ticket est fourni en tant que 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 pour ticket_id clé ou « ID de ticket introuvable » renvoyée en tant que sortie d’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 true 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 nulle. Une entrée booléenne est vide lorsqu’elle est fausse.

    Pastille de données d’entrée Sortie
    N'importe lequel Renvoie vrai ou faux
    Figure 2. Exemple
    • Entrée : une pastille de données d’entier avec 0
    • Sortie : true

    Est faux

    Renvoie la valeur true lorsque l’entrée est false. Une chaîne est fausse lorsqu’il s’agit d’une chaîne vide. Un nombre 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
    Figure 3. Exemple
    • Entrée : une pastille de données d’entier avec 13
    • Sortie : false

    N’est pas vide

    Renvoie la valeur true 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.

    Pastille de données d’entrée Pastille de données de sortie
    N'importe lequel Renvoie vrai ou faux
    Figure 4. Exemple
    • Entrée : une pastille de données d’entier avec 13
    • Sortie : true

    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
    Figure 5. Exemple
    • Entrée : une pastille de données d’entier avec 725
    • Sortie : false

    Est vrai

    Renvoie la valeur true 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 autre chose que 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
    Figure 6. Exemple
    • Entrée : une pastille de données d’entier avec 13
    • Sortie : true

    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é qui est 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é correspondante
    Figure 7. Exemple

    Dans cet exemple, une action de journal stocke la priorité d’un enregistrement sous la forme d’un 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 de nombre en chaîne.

    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.Booléen ou Array.Datetime. - Tableau non trié Sort Order - Ascendant ou descendant Tableau : tableau trié
    Remarque :
    La fonction de tri est sensible à la casse pour array.strings.
    Figure 8. Exemple
    • 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.Booléen ou Array.Datetime. Tableau : après la suppression des éléments dupliqués
    Figure 9. Exemple
    • 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.Booléen 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.
    Figure 10. Exemple
    • Entrée : [1, 2, 3]
    • Paramètres : <
    • Sortie : 1<2<3