Fonctions de transformation

  • Rversion finale: Zurich
  • Mis à jour 31 juil. 2025
  • 3 minutes de lecture
  • Transformez les valeurs de pastilles de données sans avoir besoin d’écrire un script. Utilisez les fonctions de transformation pour reformater le texte, effectuer des calculs mathématiques, nettoyer les instructions SQL potentiellement dangereuses et sérialiser des objets complexes en XML brut.

    Les catégories de fonctions de transformation disponibles incluent la date et l’heure, la chaîne, les utilitaires, les mathématiques simples, les arguments shell, SQL et lesdonnées complexes. Voici quelques exemples d’utilisations des fonctions de transformation :

    • Suppression de l’espace blanc d’une chaîne avant de l’intégrer dans le CMDB fichier .
    • Ajouter des jours, heures, minutes et secondes à une date ou une heure à localiser pour un fuseau horaire spécifique.
    • Nettoyage des valeurs SQL pour empêcher l’injection dans le cadre d’une étape JDBC pour un Centre d'intégration spoke.
    • Récupération d’une valeur appropriée à partir d’une carte de priorités ayant des valeurs équivalentes dans une base de données tierce.
    • Transformation d’un objet complexe en XML brut dans le cadre d’une étape REST Champ Corps de la demande .
    Remarque :
    Les fonctions de transformation personnalisées ne sont actuellement pas prises en charge. Pour plus d’informations sur la création de fonctions personnalisées pour transformer Studio de workflow les données, voir Scripts en ligne.

    Application d’une fonction de transformation

    Vous pouvez appliquer une fonction de transformation à une pastille de données lorsque vous concevez ou créez un flux. Pour appliquer une fonction de transformation, pointez ou tabulez sur une pastille de données et sélectionnez l’icône f(x) (icône de fonction) qui s’affiche. La sélection de l’icône affiche la liste des transformations disponibles. Sélectionnez la fonction de transformation que vous souhaitez appliquer à votre pastille de données, saisissez les informations dans les champs requis, puis sélectionnez Appliquer. La fonction de transformation que vous avez sélectionnée apparaît dans la liste Transformations appliquées.

    Application d’une fonction de transformation à une pastille de données.

    Application de plusieurs fonctions de transformation

    Vous pouvez appliquer plusieurs fonctions de transformation à la même pastille de données. Le système applique des fonctions de transformation séquentiellement de haut en bas, comme indiqué dans la liste Transformations appliquées. Par exemple, vous pouvez appliquer une fonction de transformation Chaîne à date, suivie de la fonction de transformation Ajouter une heure.

    Affichage des fonctions de transformation appliquées

    Vous pouvez découvrir quelles fonctions de transformation sont appliquées à une pastille de données en consultant la liste Transformations appliquées. Lorsque vous concevez ou créez un flux ou une action, pointez ou tabulez sur la pastille de données et sélectionnez l’icône f(x) ( icône de fonction sélectionnée). Vous pouvez également afficher les fonctions de transformation appliquées dans les détails de l’exécution du flux.
    Remarque :
    Les valeurs de sortie des fonctions de transformation appliquées sont des valeurs de champ, et non des valeurs d’affichage.
    Lorsqu’une pastille de données est déplacée dans certains types d’entrées, le système suggère automatiquement une catégorie de fonction de transformation associée à l’entrée. Par exemple, le système suggère des fonctions de transformation pour échapper les caractères spéciaux dans les instructions SQL, empêcher l’injection de script dans les scripts shell et valider les demandes d’API ou d’opération. Actuellement, le système suggère des catégories de fonctions de transformation pour ces entrées :

    Directives générales

    Appliquer des fonctions de transformation à des types valides de pastilles de données pour l’entrée
    Assurez-vous de vérifier le type de pastille de données pour l’entrée avant d’appliquer une fonction de transformation. L’application d’une fonction de transformation à un type de pastille de données non valide entraîne l’omission de la transformation par le système. Une erreur se produit également si les fonctions de transformation produisent des résultats que le système ne peut pas analyser. Par exemple, lors de la transformation d’une chaîne en date, le système génère une erreur si la transformation ne produit pas de date valide.
    Confirmer les fonctions de transformation appliquées pour plusieurs entrées avec la même pastille de données
    Une fonction de transformation crée une nouvelle valeur au moment de l’exécution pour une entrée spécifique et ne modifie pas la pastille de données d’origine. Si vous utilisez la même pastille de données dans plusieurs actions ou étapes, les fonctions de transformation doivent donc être appliquées à chaque inpuindividuelle.
    Afficher les valeurs finales transformées dans les détails de l’exécution du flux
    Seule la valeur transformée finale apparaît dans les détails d’exécution du flux, et non la valeur de chaque transformation appliquée.
    Tester les fonctions de transformation pour vérifier qu’elles produisent les résultats attendus
    Assurez-vous que vos fonctions de transformation produisent les valeurs d’exécution attendues pour les pastilles de données. Pour plus d’informations, consultez Tester un flux et Tester une action.