--- sourceDocument: Workflows de version Xanadu sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/fr-FR/xanadu/build-workflows Release : - xanadu ft:locale : - fr-FR ft:publication_title : - Workflows de version Xanadu ft:clusterId : - crworkflow bundleId : - crworkflow workflow : - Creator --- # Fonctions de transformation # Fonctions de transformation {#ariaid-title1} * Rversion finale: Xanadu * * Mis à jour 1 août 2024 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 4 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 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](https://servicenow-prod.fluidtopics.net/IhD5HTbrNU4rkCdXUo8vyQ "Utilisez les fonctions de transformation de date et d’heure pour recalculer ou reformater les pastilles de données pour les valeurs date/heure."), [la chaîne](https://servicenow-prod.fluidtopics.net/KzEbQpEuLVVMLUhTeMBOEA "Utilisez les fonctions de transformation de chaîne pour reformater ou effectuer des calculs sur des pastilles de données de chaîne."), [les utilitaires](https://servicenow-prod.fluidtopics.net/1eduFHPkaAmRqzLqcq~SsA "Utilisez les utilitaires transform functions pour retourner un objet complexe à partir d’un tableau ou une valeur associée à une clé spécifique."), [les mathématiques simples](https://servicenow-prod.fluidtopics.net/tP7nCeFWUVOfvjKFonULwg "Utilisez des fonctions de transformation mathématique simples pour effectuer des calculs mathématiques de base sur des pastilles de données numériques."), [l'assainissement des arguments shell](https://servicenow-prod.fluidtopics.net/~P7U3NPZNqxGo3sp9E2_ig "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 Bash Shell."), [l'assainissement du SQL et les](https://servicenow-prod.fluidtopics.net/oo8U9NL1gLmk5agA~nqUgw "Utilisez les fonctions de transformation Sanitize SQL 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.")[données complexes](https://servicenow-prod.fluidtopics.net/7KnUO58P23Je6Do1bmZu_A "Utilisez des fonctions de transformation de données complexes pour sérialiser des pastilles de données d’objets complexes dans un format XML."). 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](https://servicenow-prod.fluidtopics.net/NsVYTMkfYq9ONAPpUTmBMw "Créez une action réutilisable pour envoyer des commandes SQL à une base de données relationnelle.") 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](https://servicenow-prod.fluidtopics.net/dQMKpRHUA2ZGCf73JT9nSA "Envoyez une demande de service Web REST sortante à un système externe.") Champ Corps de la demande. {#transform-functions__ul_n23_4cl_t3b} 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 des données, consultez [Scripts en ligne](https://servicenow-prod.fluidtopics.net/yspe03vPNnsFZu3q97dWyQ "Permettez aux utilisateurs ayant de l’expérience en codage d’écrire des scripts en ligne qui définissent et modifient les valeurs d’entrée pendant la configuration d’une action ou d’un flux. Utilisez les scripts en ligne pour modifier les valeurs d’entrée qui nécessitent des conversions de petits formats, des transformations de données ou des opérations mathématiques."). ## Application d'une fonction de transformation {#transform-functions__section_rjd_mhl_t3b} 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) ( ![icône de fonction]()) 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 {#transform-functions__section_f5v_dqn_kjb} 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 {#transform-functions__section_afb_fng_r3b} 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 sur la pastille de données ou appuyez sur la touche de tabulation 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 d'exécution du flux](https://servicenow-prod.fluidtopics.net/_4mO8shwim0Z6VstukiH3Q "Affichez les informations d’exécution sur une action ou un flux directement à partir de l’environnement de conception, telles que l’état actuel, les éléments exécutés et les valeurs produites. Ouvrez les enregistrements connexes à partir d’éditeurs incorporés Now Platform ou dans un nouvel onglet."). 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 ces entré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](https://servicenow-prod.fluidtopics.net/oo8U9NL1gLmk5agA~nqUgw "Utilisez les fonctions de transformation Sanitize SQL 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.") 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](https://servicenow-prod.fluidtopics.net/~P7U3NPZNqxGo3sp9E2_ig "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 Bash Shell.") de commandes s'affiche automatiquement. {#transform-functions__ul_wd4_13d_ljb} ## Directives générales {#transform-functions__id_m33_yvb_ptb} 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{#transform-functions__final-transformed-value} : Seule la valeur transformée finale apparaît dans les [détails d'exécution du flux](https://servicenow-prod.fluidtopics.net/_4mO8shwim0Z6VstukiH3Q "Affichez les informations d’exécution sur une action ou un flux directement à partir de l’environnement de conception, telles que l’état actuel, les éléments exécutés et les valeurs produites. Ouvrez les enregistrements connexes à partir d’éditeurs incorporés Now Platform ou dans un nouvel onglet."), 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](https://servicenow-prod.fluidtopics.net/jYXAr_qJ00o0LsmFoUH8VA "Avant d’activer un flux pour que d’autres utilisateurs puissent y accéder, testez-le pour vous assurer qu’il fonctionne comme prévu.") et [Tester une action](https://servicenow-prod.fluidtopics.net/k98~doMbYnGQNWYPDEAXuA "Testez une action avant de la publier pour d’autres utilisateurs."). * **[Fonctions de transformation de date et d'heure](https://servicenow-prod.fluidtopics.net/IhD5HTbrNU4rkCdXUo8vyQ)** 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îne](https://servicenow-prod.fluidtopics.net/KzEbQpEuLVVMLUhTeMBOEA)** Utilisez les fonctions de transformation de chaîne pour reformater ou effectuer des calculs sur des pastilles de données de chaîne. * **[Les utilitaires transforment les fonctions](https://servicenow-prod.fluidtopics.net/1eduFHPkaAmRqzLqcq~SsA)** Utilisez les utilitaires transform functions pour retourner un objet complexe à partir d'un tableau ou une valeur associée à une clé spécifique. * **[Fonctions de transformation mathématiques simples](https://servicenow-prod.fluidtopics.net/tP7nCeFWUVOfvjKFonULwg)** Utilisez des fonctions de transformation mathématique simples pour effectuer des calculs mathématiques de base sur des pastilles de données numériques. * **[Expurger les arguments de l'interpréteur de commandes Fonctions de transformation](https://servicenow-prod.fluidtopics.net/~P7U3NPZNqxGo3sp9E2_ig)** 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 Bash Shell. * **[Fonctions de transformation Sanitize SQL](https://servicenow-prod.fluidtopics.net/oo8U9NL1gLmk5agA~nqUgw)** Utilisez les fonctions de transformation Sanitize SQL 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](https://servicenow-prod.fluidtopics.net/7KnUO58P23Je6Do1bmZu_A)** Utilisez des fonctions de transformation de données complexes pour sérialiser des pastilles de données d'objets complexes dans un format XML.