Les utilitaires transforment les fonctions

  • Rversion finale: Xanadu
  • Mis à jour 1 août 2024
  • 5 minutes de lecture

    • Utilisez les utilitaires transform functions pour retourner 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, 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.

    Pilule de données d’entrée Pilule 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 retourner. Le Nth Item représente l’index du tableau, à partir de 0.

    Pilule de données d’entrée Paramètres Pilule 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é de correspondance à partir d’une carte de paires nom-valeur.

    Pilule de données d’entrée Paramètres Pilule de données de sortie
    Paires nom-valeur
    • Key : nom de la clé qui est utilisée pour rechercher sa valeur correspondante
    • Default - Valeur retourné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, tenez compte du fait 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 d’une table distante, la valeur d’exécution renvoyée peut être 2, et non 2 : Élevée.
    Figure 1. Exemple
    • 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 GETs les données du ticket sous la forme d’une 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 » retourné comme sortie d’action.

    Obtenir le dernier élément du tableau

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

    Pilule de données d’entrée Pilule 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 égale à zéro. Une entrée booléenne est vide lorsqu’elle est fausse.

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

    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 entier est faux lorsqu’il est égal à zéro. Une entrée booléenne est fausse lorsqu’elle est fausse.

    Pilule de données d’entrée Pilule 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.

    Pilule de données d’entrée Pilule 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 : 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 Null.

    Pilule 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 true lorsque l’entrée est true. Une chaîne est vraie lorsqu’elle n’est pas vide. Un entier est vrai lorsqu’il est autre chose que zéro. Une entrée booléenne est vraie quand elle est vraie.

    Pilule de données d’entrée Pilule 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 : vrai

    Carte de valeur de clé

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

    Pilule de données d’entrée Paramètres Pilule de données de sortie
    Chaîne ou entier
    • Name - La clé qui est utilisée pour trouver la valeur correspondante
    • Value - 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
    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 d’un nombre en une chaîne.

    Trier

    Trie le tableau spécifié dans l’ordre croissant ou décroissant.

    Pilule de données d’entrée Paramètres Pilule de données de sortie
    Array.String, Array.Integer, Array.Boolean 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é.
    Pilule de données d’entrée Pilule de données de sortie
    Array.String, Array.Integer, Array.Boolean 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.

    Pilule de données d’entrée Paramètres Pilule 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.
    Figure 10. Exemple
    • Entrée : [1, 2, 3]
    • Paramètres : <
    • Sortie : 1<2<3