Fonctions de transformation

Transformez les valeurs des pastilles de données sans avoir besoin d’écrire un script. Utilisez des 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 SQL et lesdonnées complexes. Voici quelques exemples d’utilisations des fonctions de transformation :

• Découpage de l’espace d’une chaîne avant de l’intégrer dans le CMDBfichier .
• Ajout de jours, heures, minutes et secondes à une date ou une heure à localiser pour un fuseau horaire spécifique.
• Assainissement 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.

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 Concepteur de flux les données, consultez 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) ( ) qui apparaît. 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 sélectionnée apparaît 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 d’une fonction de transformation Ajouter une heure.

Affichage des fonctions de transformation appliquées

Pour savoir quelles fonctions de transformation sont appliquées à une pastille de données, consultez la liste Transformations appliquées. Lorsque vous concevez ou créez un flux ou une action, pointez vers la pastille de données ou appuyez sur la touche de tabulation et sélectionnez l’icône f(x) ( ). Vous pouvez également afficher les fonctions de transformation appliquées dans les détails d’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éposé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 les entrées suivantes :

• Pour les pastilles de données déposées dans l’entrée Instruction SQL de l’étape JDBC, la catégorie de fonction de transformation SQL de nettoyage 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.

Lignes directrices 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 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 pour 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 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.

• Fonctions de transformation de la date et de l’heure
  Utilisez les fonctions de transformation de date et d’heure pour recalculer ou reformater les pastilles de données pour les valeurs Date/Heure.
• Fonctions de transformation de chaînes
  Utilisez des fonctions de transformation de chaîne pour reformater ou effectuer des calculs sur des pastilles de données de chaîne.
• Fonctions de transformation des utilitaires
  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.
• Fonctions de transformation mathématiques simples
  Utilisez des fonctions de transformation mathématique simples pour effectuer des calculs mathématiques de base sur des pastilles de données numériques.
• Sanitize shell arguments transform functions (Fonctions de transformation des arguments de l’interpréteur de commandes)
  Utilisez les fonctions de transformation des arguments Sanitize Shell pour supprimer toute injection de commande potentiellement dangereuse dans les pastilles de données de chaîne à utiliser pour les scripts shell Bash.
• Fonctions de transformation Sanitize SQL
  Utilisez les fonctions de transformation SQL de nettoyage pour échapper les caractères spéciaux et empêcher l’injection dans les pastilles de données de chaîne à utiliser pour les instructions SQL.
• Fonctions de transformation de données complexes
  Utilisez des fonctions de transformation de données complexes pour sérialiser des pastilles de données d’objets complexes au format XML.