Fonctions de transformation de chaîne

  • Rversion finale: Xanadu
  • Mis à jour 14 août 2024
  • 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 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.

    Pilule de données d’entrée Pilule de données de sortie
    Chaîne Nombre : numéro 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.

    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
    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.

    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
    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 par une séquence donnée de caractères.

    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
    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.

    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
    Figure 5. Exemple
    • Entrée : Madrid
    • Sortie : M

    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.

    Mettre à jour le code de ville d’un utilisateur.

    Dernier caractère

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

    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
    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.

    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
    		 Chaîne résultante après 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 : \"Exemple de chaîne d’entrée.\ »

    Taille

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

    Pilule de données d’entrée Pilule 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. 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.

    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
    Figure 9. Exemple
    • Entrée : exemple, entrée, chaîne.
    • Séparateur : ,
    • Sortie : ["Exemple », « entrée », « chaîne."]

    Commence par

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

    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
    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 commence à 0.

    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
    		 Chaîne : chaîne transformée en 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
    • Index de fin : 6
    • Sortie : mple

    Vers minuscules

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

    Pilule de données d’entrée Pilule 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.

    Pilule de données d’entrée Pilule de données de sortie
    Chaîne Chaîne avec la casse appropriée
    Figure 13. Exemple
    • Entrée : exAMPle-chaîne d’entrée/TEXTE
    • Sortie : Exemple de chaîne d’entrée/de texte

    Vers majuscules

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

    Pilule de données d’entrée Pilule 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.

    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é
    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 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].

    Supprimez l’espace d’un nom de serveur avant de l’ajouter à la CMDB.