Fonctions de transformation de chaîne

Utilisez les fonctions de transformation de chaîne pour reformater ou effectuer des calculs sur les pastilles de données de chaîne.

Les fonctions de transformation de chaîne nécessitent une pastille de données d’entrée Chaîne. Assurez-vous d’utiliser le type de pastille de donné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.

Convertir la chaîne en numéro

Convertit une chaîne en nombre.

Pastille de données d’entrée	Pastille de données de sortie
Chaîne	Numéro : nombre converti à partir d’une chaîne.

Figure 1. Exemple

• Entrée : « 500 »
• Sortie : 500

Contient

Renvoie la valeur true lorsque la chaîne d’entrée contient une séquence donnée de caractères.

Pastille de données d’entrée	Paramètres	Pastille 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

Figure 2. Exemple

• Entrée : Pizza au fromage
• Paramètre : fromage
• Sortie : vrai

Ne contient pas

Renvoie la valeur true lorsque la chaîne d’entrée ne contient pas une séquence donnée de caractères.

Pastille de données d’entrée	Paramètres	Pastille de données de sortie
Chaîne	Caractères à rechercher.	Booléen indiquant si une séquence de caractères n’existe pas dans la chaîne d’entrée

Figure 3. Exemple

• Entrée : Pizza au fromage
• Paramètre : Joey
• Sortie : vrai

Se termine par

Renvoie la valeur true lorsque la chaîne d’entrée se termine avec une séquence de caractères donnée.

Pastille de données d’entrée	Paramètres	Pastille 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

Figure 4. Exemple

• Entrée : Pizza au fromage
• Paramètre : Pizza
• Sortie : vrai

Premier caractère

Renvoie le premier caractère de la chaîne d'entrée.

Pastille de données d’entrée	Pastille de données de sortie
Chaîne	Chaîne : chaîne transformée comme premier caractère de la chaîne d’entrée

Figure 5. Exemple

• Entrée : Madrid
• Sortie : M

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

Dernier caractère

Renvoie le dernier caractère de la chaîne d'entrée.

Pastille de données d’entrée	Pastille de données de sortie
Chaîne	Chaîne : chaîne transformée comme dernier caractère de la chaîne d’entrée

Figure 6. Exemple

• Entrée : Madrid
• Sortie : d

Remplacer une chaîne

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.

Pastille de données d’entrée	Paramètres	Pastille de données de sortie
Chaîne	Regex - Expression régulière à faire correspondre pour le remplacement Replace String - Corde de remplacement	Chaîne obtenue après le remplacement par les paramètres donnés

Figure 7. Exemple

• Entrée : « exemple de chaîne d’entrée. »
• Paramètres :
  • Regex : \"
  • Chaîne de remplacement : \\\"
• Sortie : \"Example input string.\ »

Taille

Renvoie le nombre total de caractères dans la chaîne d'entrée.

Pastille de données d’entrée	Pastille de données de sortie
Chaîne	Entier

Figure 8. Exemple

• Entrée : exemple de chaîne d’entrée.
• Sortie : 21

Division

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. Si vous entrez un type de données autre qu’une chaîne en tant que séparateur, le système convertit la valeur fournie en chaîne.

Pastille de données d’entrée	Paramètres	Pastille de données de sortie
Chaîne	Separator - Entrez 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 transformée pendant l’exécution.	Array.String : un tableau des sous-chaînes de la chaîne d'entrée

Figure 9. Exemple

• Entrée : exemple, entrée, chaîne.
• Séparateur : ,
• Sortie : ["Example », « input », « string."]

Commence par

Renvoie la valeur true lorsque la chaîne d’entrée commence avec une séquence de caractères donnée.

Pastille de données d’entrée	Paramètres	Pastille 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

Figure 10. Exemple

• Entrée : Pizza au fromage
• Paramètre : Chees
• Sortie : vrai

Sous-chaîne

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 débute à 0.

Pastille de données d’entrée	Paramètres	Pastille 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.	Chaîne : chaîne transformée en tant que sous-chaîne de la chaîne d’entrée

Figure 11. Exemple

• Entrée : exemple de chaîne d’entrée
• Index de départ : 3
• Indice de fin : 6
• Sortie : mple

Vers minuscules

Convertit la chaîne d'entrée dans des caractères tout en minuscule

Pastille de données d’entrée	Pastille de données de sortie
Chaîne	Chaîne toute en minuscule

Figure 12. Exemple

• Entrée : ExamPle inpuT stRing
• Sortie : exemple de chaîne d’entrée

Vers le ticket approprié

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.

Pastille de données d’entrée	Pastille de données de sortie
Chaîne	Chaîne avec la casse appropriée

Figure 13. Exemple

• Entrée : exAMPle-input string/TEXT
• Sortie : exemple-entrée chaîne/texte

Vers majuscules

Convertit la chaîne d'entrée dans des caractères tout en majuscule.

Pastille de données d’entrée	Pastille de données de sortie
Chaîne	Chaîne toute en majuscule

Figure 14. Exemple

• Entrée : ExamPle inpuT stRing
• Sortie : EXEMPLE DE CHAÎNE D’ENTRÉE

Découpage

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.

Pastille de données d’entrée	Pastille de données de sortie
Chaîne	Chaîne : chaîne transformée avec un espace tronqué

Figure 15. Exemple

• Entrée : SQL Server APAC 1
• Sortie : SQL Server APAC 1

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