Utiliser le composant Formater le texte

Mettez en forme le texte à l’aide d’espaces réservés de variables et de variables de ligne et de tabulation avec le composant Format de texte dans Studio de conception de bureau de RPA. Vous pouvez facilement mettre à jour le texte et leurs positions en mettant simplement à jour les espaces réservés des variables et les variables de ligne et de tabulation.

Avant de commencer

Rôle requis : aucun

Pourquoi et quand exécuter cette tâche

Conseils essentiels à retenir lors de l’utilisation du composant Formater le texte pour éviter les exceptions suivantes.

Arguments manquants

Ce problème se produit lorsque la chaîne de format contient plus d’espaces réservés que le nombre d’arguments fournis.

Par exemple :

• Chaîne de format : {0} {1}
• Arguments fournis : « Bonjour »

Le message d’erreur affiché pour ce problème est « Une erreur s’est produite lors de l’exécution. Échec de l’exécution du composant « Formater le texte » dans l’activité « Nouvelle activité ».

L’index (basé sur zéro) doit être supérieur ou égal à zéro et inférieur à la taille de la liste d’arguments.

La solution consiste à s’assurer que le nombre d’arguments correspond au nombre d’espaces réservés dans la chaîne de format :

« Bonjour »

« Monde »

Placement correct des arguments

L’index (basé sur zéro) doit être supérieur ou égal à zéro et inférieur à la taille de la liste d’arguments.

Solution:

La solution consiste à s’assurer que le nombre d’arguments correspond au nombre d’espaces réservés dans la chaîne de format. Par exemple :

• Chaîne de format : « Hello »
• Argument : « Monde »

Dans ce cas, la chaîne de format ne contient pas d’espaces réservés, donc aucun argument n’est nécessaire. Si vous avez une chaîne de format comme « Hello, {0} ! Bienvenue dans {1}. », vous devez fournir deux arguments, tels que « Monde » et « ServiceNow ».

Utilisation d’accolades courbes littérales dans les chaînes de format

Problème : les accolades {} ont une signification particulière dans le formatage de chaîne et doivent être échappées lorsqu’elles sont utilisées comme caractères littéraux.

Exemple d’utilisation incorrecte :

Chaîne de format :

{
{0}
{1}
},

Message d’erreur : une erreur s’est produite lors de l’exécution. Échec de l’exécution du composant « Formater le texte » dans l’activité « Nouvelle activité ».

La chaîne d’entrée n’était pas dans un format correct

La solution consiste à utiliser des accolades doubles pour représenter les accolades littérales :

{{
{0}
{1}
}},

Règle à retenir :

• {{ représente un { littéral
• }} représente un } littéral

Vous pouvez configurer les propriétés du composant Format de texte. Pour plus d’informations sur ces propriétés, reportez-vous à la section Propriétés des composants généraux.

Procédure

1. Dans le volet Boîte à outils, accédez à Général > Mettre en forme le texte.
2. Faites glisser le composant Format de texte vers l’aire de conception.
3. Pour définir la variable d’espace réservé de texte, procédez comme suit.
   1. Cliquez sur l’icône Ajouter une variable ( icône ).
      Un port d’entrée de données est ajouté pour chaque variable ajoutée.
   2. Pour configurer la valeur de la variable, reportez-vous à la section Configurer les propriétés des ports.
   3. Facultatif : Répétez les étapes pour ajouter d’autres variables et valeurs.
4. Cliquez sur l’icône Paramètres du composant ( ).
5. Insérez le texte dans l’ÉDITEUR DE FORMAT DE TEXTE.
6. Insérez le texte.
7. Facultatif : Insérez la variable séparateur de lignes \n ou séparateur de tabulations \t aux emplacements appropriés dans le texte.
8. Insérez les espaces réservés à la variable de texte dans le corps du texte, le cas échéant.
   Conseil :

   Pour mettre à jour le texte, mettez à jour la valeur de l’espace réservé.
9. Connectez les ports de données et de contrôle du composant Format de texte aux ports correspondants de l’autre composant, comme décrit dans le tableau suivant.

   Type de port	Objectif de la connexion	Obligatoire ?
   Données d’entrée (variable)	Prend la valeur de variable d’un composant précédemment exécuté.	Oui
   Sortie de données (sortie formatée)	Renvoie le texte mis en forme et passe au composant suivant.	Oui. Pour afficher la sortie, cliquez avec le bouton droit sur le champ Retour et cliquez sur Prévisualiser les données.
   Contrôle entrant	Transmet le contrôle à partir du composant précédemment exécuté.	Oui
   Contrôle sortant	Transmet le contrôle au composant suivant.	Non. La connexion du port est facultative.

10. Facultatif : Pour tester le composant, sous l’onglet CONCEPTION , cliquez sur Exécuter.