Fonctions de transformation
Transformez les valeurs de pastilles de données sans avoir besoin d’écrire un script. Utilisez les fonctions de transformation pour reformater du 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, l’assainissement des arguments shell, l’assainissement du SQL et lesdonnées complexes. Voici quelques exemples d’utilisations des fonctions de transformation :
- Découpage de l’espace d’une chaîne de caractères avant de l’intégrer dans le CMDBfichier .
- Ajout de jours, d’heures, de minutes et de 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 Hub 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.
Application d’une fonction de transformation
Vous pouvez appliquer une fonction de transformation à une pastille de données lors de la conception ou de la création d’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) ( ) qui apparaît. La sélection de l’icône affiche la liste Transformations disponibles. Sélectionnez la fonction de transformation que vous souhaitez appliquer à votre pastille de données, saisissez des informations dans les champs requis, puis sélectionnez Appliquer. La fonction de transformation que vous avez sélectionnée s’affiche dans la liste Transformations appliqué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 les fonctions de transformation séquentiellement, de haut en bas, telles que répertoriées 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
- Pour les pastilles de données déposées dans l’entrée d’instruction SQL de l’étape JDBC, la catégorie de fonction de transformation SQL d’assainissement s’affiche automatiquement.
- Pour les pastilles de données déposées dans l’entrée Commande de l’étape SSH, la catégorie de fonction de transformation des arguments de l’interpréteur de commandes s’affiche automatiquement.
Directives générales
- Appliquer les fonctions de transformation aux 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 lors 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 sur plusieurs actions ou étapes, les fonctions de transformation doivent donc être appliquées à chaque input individuel.
- Afficher les valeurs transformées finales 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 escomptés
- 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 Test d’un flux et Tester une action.