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 de chaîne. Assurez-vous d’utiliser le type de pastille de données d’entrée correct lors de l’application des 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 : numéro converti à partir d’une chaîne.

Figure 1. Exemple

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

Contient

Renvoie la valeur vrai 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 vrai 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 lorsqu’un enregistrement d’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 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 résultante après le remplacement avec 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 comme 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 n’est pas renseigné, la chaîne d’entrée n’est transformée lors de 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 par 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 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. 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 sous-chaîne de la chaîne d’entrée

Remarque :

Si la Start Index valeur est supérieure à la longueur de la chaîne, la fonction de transformation renvoie la chaîne d’entrée. Ce comportement est différent de la méthode JavaScript substring(), qui renvoie à la place une chaîne vide.

Figure 11. Exemple 1

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

Figure 12. Exemple 2

• Entrée : exemple de chaîne d’entrée
• Index de départ : 30
• Indice final : 40
• Sortie : exemple de chaîne d’entrée

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 13. 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 14. 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 15. 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 espace tronqué

Figure 16. Exemple

• Entrée : serveur SQL 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 Trim transform supprime tout espace blanc indésirable avant d’ajouter le nom du serveur à un nouvel enregistrement dans la table Server [cmdb_ci_server].