---
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 de chaîne

# Fonctions de transformation de chaîne {#ariaid-title1}

* Rversion finale: Xanadu
* 
* Mis à jour 14 août 2024
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 5 minutes de lecture

Utilisez les fonctions de transformation de chaîne pour reformater ou effectuer des calculs sur des pastilles de données de chaîne.
Les fonctions de transformation de chaîne nécessitent une pastille de données d'entrée de chaîne. Assurez-vous d'utiliser le [type de pastille de données](https://servicenow-prod.fluidtopics.net/q2AhkYwDpHzhPWvMpLsi~g "Les actions et les flux secondaires utilisent des variables pour stocker les données d’entrée et de sortie. Le type de données variable détermine le type de données qu’elle stocke et ses options de configuration avancées.") d'entrée correct lors de l'application de fonctions de transformation de chaîne. Si une fonction de transformation de chaîne 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](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.").

## Convertir la chaîne en numéro {#string-transform-functions__section_dmq_3lk_hrb}

Convertit une chaîne en nombre.
{#string-transform-functions__table_xjp_llk_hrb__entry__2}

| Pilule de données d'entrée | Pilule de données de sortie |
|-|-|
| Chaîne | Nombre : numéro converti à partir d'une chaîne. |
[ ]

{#string-transform-functions__table_xjp_llk_hrb} Figure 1. Exemple

* Entrée : `<< 500 >>`
* Sortie : `500`
{#string-transform-functions__ul_yq4_plk_hrb}

## Contient {#string-transform-functions__section_ndv_q54_mpb}

Renvoie la valeur true lorsque la chaîne d'entrée contient une séquence donnée de caractères.  
{#string-transform-functions__table_wd2_x54_mpb__entry__3}

| Pilule de données d'entrée | Paramètres | Pilule de données de sortie |
|-|-|-|
| Chaîne | Caractères à rechercher. | Booléen indiquant s'il existe une séquence de caractères dans la chaîne d'entrée |
[ ]

{#string-transform-functions__table_wd2_x54_mpb}  
Figure 2. Exemple

* Entrée : `Pizza au fromage`
* `Paramètre : Fromage`
* Sortie : `vrai`
{#string-transform-functions__ul_cbn_dv4_mpb}

## Ne contient pas {#string-transform-functions__section_zk4_r54_mpb}

Renvoie la valeur true lorsque la chaîne d'entrée ne contient pas une séquence donnée de caractères.  
{#string-transform-functions__table_bpj_mv4_mpb__entry__3}

| Pilule de données d'entrée | Paramètres | Pilule de données de sortie |
|-|-|-|
| Chaîne | Caractères à rechercher. | Booléen indiquant s'il n'existe pas de séquence de caractères dans la chaîne d'entrée |
[ ]

{#string-transform-functions__table_bpj_mv4_mpb}  
Figure 3. Exemple

* Entrée : `Pizza au fromage`
* Paramètre : `Joey`
* Sortie : `vrai`
{#string-transform-functions__ul_kkd_qv4_mpb}

## Se termine par {#string-transform-functions__section_kqc_s54_mpb}

Renvoie la valeur true lorsque la chaîne d'entrée se termine par une séquence donnée de caractères.  
{#string-transform-functions__table_zck_wv4_mpb__entry__3}

| Pilule de données d'entrée | Paramètres | Pilule de données de sortie |
|-|-|-|
| Chaîne | Caractères à rechercher. | Booléen indiquant si la chaîne d'entrée se termine avec la séquence de caractères donnée |
[ ]

{#string-transform-functions__table_zck_wv4_mpb}  
Figure 4. Exemple

* Entrée : `Pizza au fromage`
* `Paramètre : Pizza`
* Sortie : `vrai`
{#string-transform-functions__ul_wvj_2w4_mpb}

## Premier caractère {#string-transform-functions__first-character}

Renvoie le premier caractère de la chaîne d'entrée.  
{#string-transform-functions__table_lq2_rdg_mkb__entry__2}

| Pilule de données d'entrée | Pilule de données de sortie |
|-|-|
| Chaîne | Chaîne : chaîne transformée comme premier caractère de la chaîne d'entrée |
[ ]

{#string-transform-functions__table_lq2_rdg_mkb}  
Figure 5. Exemple

* Entrée : `Madrid`
* Sortie : `M`

{#string-transform-functions__ul_pby_rdz_jjb}

Dans cet exemple, le flux se déclenche lorsqu'un enregistrement Utilisateur \[sys_user\] est créé. Le flux met ensuite à jour le champ Ville de l'enregistrement Utilisateur \[sys_user\] avec un code représenté comme le premier caractère du nom de la ville.

## Dernier caractère {#string-transform-functions__section_rhh_tzx_2jb}

Renvoie le dernier caractère de la chaîne d'entrée.  
{#string-transform-functions__table_tll_rhg_mkb__entry__2}

| Pilule de données d'entrée | Pilule de données de sortie |
|-|-|
| Chaîne | Chaîne : chaîne transformée comme dernier caractère de la chaîne d'entrée |
[ ]

{#string-transform-functions__table_tll_rhg_mkb}  
Figure 6. Exemple

* Entrée : `Madrid`
* Sortie : `d`
{#string-transform-functions__ul_opv_3cz_jjb}

## Remplacer une chaîne {#string-transform-functions__section_cty_s54_mpb}

Renvoie une chaîne remplacée de la chaîne d'entrée en fonction de l'expression régulière (regex) et de la chaîne de remplacement fournies. Utilisez le format d'expression régulière JavaScript.  
{#string-transform-functions__table_el5_3w4_mpb__entry__3}

| Pilule de données d'entrée | Paramètres | Pilule de données de sortie |
|-|-|-|
| Chaîne | * Regex - Expression régulière à apparier pour le remplacement * Replace String - Corde de remplacement {#string-transform-functions__ul_xdx_jw4_mpb} | Chaîne résultante après remplacement par les paramètres donnés |
[ ]

{#string-transform-functions__table_el5_3w4_mpb}  
Figure 7. Exemple

* Entrée : `<< Exemple de chaîne d'entrée. >>`
* Paramètres :
  * Regex : `\"`
  * Chaîne de remplacement : `\\\"`
  {#string-transform-functions__ul_ccj_zw4_mpb}
* Sortie : `\"Exemple de chaîne d'entrée.\ >>`
{#string-transform-functions__ul_vmq_tw4_mpb}

## Taille {#string-transform-functions__section_i4n_tzx_2jb}

Renvoie le nombre total de caractères dans la chaîne d'entrée.  
{#string-transform-functions__table_k4c_31n_mkb__entry__2}

| Pilule de données d'entrée | Pilule de données de sortie |
|-|-|
| Chaîne | Entier |
[ ]

{#string-transform-functions__table_k4c_31n_mkb}  
Figure 8. Exemple

* Entrée : `exemple de chaîne d'entrée.`
* Sortie : `21`
{#string-transform-functions__ul_br1_cfz_jjb}

## Division {#string-transform-functions__section_tx4_tzx_2jb}

Renvoie un Array.String en fonction du séparateur fourni qui divise la chaîne d'entrée. Si le champ Séparateur est laissé vide, la transformation est ignorée et le système renvoie la chaîne d'entrée. En cas de saisie d'un type de données autre qu'une chaîne comme séparateur, le système convertit la valeur fournie en chaîne.  
{#string-transform-functions__table_igr_41n_mkb__entry__3}

| Pilule de données d'entrée | Paramètres | Pilule de données de sortie |
|-|-|-|
| Chaîne | Separator - Saisissez un délimiteur qui spécifie où la chaîne d'entrée doit être divisée. Si ce champ est laissé vide, la chaîne d'entrée n'est pas transformée pendant l'exécution. | Array.String : un tableau des sous-chaînes de la chaîne d'entrée |
[ ]

{#string-transform-functions__table_igr_41n_mkb}  
Figure 9. Exemple

* Entrée : `exemple, entrée, chaîne.`
* Séparateur : `,`
* Sortie : `["Exemple >>, << entrée >>, << chaîne."]`
{#string-transform-functions__ul_unn_xjz_jjb}

## Commence par {#string-transform-functions__section_u3s_t54_mpb}

Renvoie la valeur true lorsque la chaîne d'entrée commence par une séquence de caractères donnée.  
{#string-transform-functions__table_js2_2x4_mpb__entry__3}

| Pilule de données d'entrée | Paramètres | Pilule de données de sortie |
|-|-|-|
| Chaîne | Caractères à rechercher. | Booléen indiquant si la chaîne d'entrée commence avec la séquence de caractères donnée |
[ ]

{#string-transform-functions__table_js2_2x4_mpb}  
Figure 10. Exemple

* Entrée : `Pizza au fromage`
* Paramètre : `Chees`
* Sortie : `vrai`
{#string-transform-functions__ul_ls2_2x4_mpb}

## Sous-chaîne {#string-transform-functions__section_l25_tzx_2jb}

Renvoie une sous-chaîne à partir de la chaîne d'entrée qui est basée sur l'index de début et l'index de fin fournis. L'index de la chaîne d'entrée commence à 0.  
{#string-transform-functions__table_orx_v1n_mkb__entry__3}

| Pilule de données d'entrée | Paramètres | Pilule de données de sortie |
|-|-|-|
| Chaîne | * Start Index - Index du premier caractère à inclure dans la sous-chaîne retournée * End Index - Index du dernier caractère à inclure dans la sous-chaîne retournée {#string-transform-functions__ul_g5q_xmz_jjb} | Chaîne : chaîne transformée en sous-chaîne de la chaîne d'entrée |
[ ]

{#string-transform-functions__table_orx_v1n_mkb}  
Figure 11. Exemple

* Entrée : `exemple de chaîne d'entrée`
* Index de départ : `3`
* Index de fin : `6`
* Sortie : `mple`
{#string-transform-functions__ul_pkz_dnz_jjb}

## Vers minuscules {#string-transform-functions__section_atv_tzx_2jb}

Convertit la chaîne d'entrée dans des caractères tout en minuscule  
{#string-transform-functions__table_o3t_nbn_mkb__entry__2}

| Pilule de données d'entrée | Pilule de données de sortie |
|-|-|
| Chaîne | Chaîne toute en minuscule |
[ ]

{#string-transform-functions__table_o3t_nbn_mkb}  
Figure 12. Exemple

* Entrée : `ExamPle inpuT stRing`
* Sortie : `exemple de chaîne d'entrée`
{#string-transform-functions__ul_r2z_x41_kjb}

## Vers le ticket approprié {#string-transform-functions__section_a4y_3wv_knb}

Modifie la casse des mots dans la chaîne d'entrée. Met en majuscule la première lettre de chaque mot et met les lettres restantes en minuscules. Un mot est considéré comme une chaîne séparée par un espace, un tiret, une barre oblique inverse ou une barre oblique. La fonction de transformation évalue toujours les mots de gauche à droite pour déterminer la première lettre.  
{#string-transform-functions__table_ld1_m1w_knb__entry__2}

| Pilule de données d'entrée | Pilule de données de sortie |
|-|-|
| Chaîne | Chaîne avec la casse appropriée |
[ ]

{#string-transform-functions__table_ld1_m1w_knb}  
Figure 13. Exemple

* Entrée : `exAMPle-chaîne d'entrée/TEXTE`
* Sortie : `Exemple de chaîne d'entrée/de texte`
{#string-transform-functions__ul_qxj_4wv_knb}

## Vers majuscules {#string-transform-functions__section_hrw_tzx_2jb}

Convertit la chaîne d'entrée dans des caractères tout en majuscule.  
{#string-transform-functions__table_lsr_dcn_mkb__entry__2}

| Pilule de données d'entrée | Pilule de données de sortie |
|-|-|
| Chaîne | Chaîne toute en majuscule |
[ ]

{#string-transform-functions__table_lsr_dcn_mkb}  
Figure 14. Exemple

* Entrée : `ExamPle inpuT stRing`
* Sortie : `EXEMPLE DE CHAÎNE D'ENTRÉE`
{#string-transform-functions__ul_qkn_dbp_kkb}

## Découpage {#string-transform-functions__section_r2l_tzx_2jb}

Supprime l'espace du début et de la fin de la chaîne d'entrée. Ne supprime pas l'espace dans la chaîne d'entrée.  
{#string-transform-functions__table_rcg_pcn_mkb__entry__2}

| Pilule de données d'entrée | Pilule de données de sortie |
|-|-|
| Chaîne | Chaîne : chaîne transformée avec un espace tronqué |
[ ]

{#string-transform-functions__table_rcg_pcn_mkb}  
Figure 15. Exemple

* Entrée : ` SQL Server APAC 1 `
* Sortie : `SQL Server APAC 1`

{#string-transform-functions__ul_b2y_z41_kjb}

Dans cet exemple, l'action effectue un appel REST vers un système tiers et GETe un corps de réponse contenant des données sur un serveur. Ensuite, la fonction de transformation Trim supprime tout espace vide avant d'ajouter le nom du serveur à un nouvel enregistrement dans la table du serveur \[cmdb_ci_server\].


