Formateur de chaîne
    Modifiez la mise en forme d'une ou plusieurs valeurs en fonction d'une règle personnalisable.
Vous pouvez utiliser le formateur de chaîne pour :
- ajouter des caractères avant ou après une valeur, si la valeur de la variable source est numérique ;
 - formater et configurer les requêtes SQL à utiliser dans les objets de base de données ;
 - lier plusieurs chaînes dans une série ;
 - appliquer une mise en forme numérique, telle que des décimales ou des arrondis à virgule flottante.
 
Propriétés
      
  Propriété  | Description  | 
|---|---|
Format  | Règle de mise en forme pour la référence de variable : 
  | 
Mode  | Direction du lien dynamique : 
  | 
Source
      Source comprend une ou plusieurs variables, identifiées par un espace réservé avec un 
{index number}
. Le numéro d’index est progressif et doit être un entier supérieur à zéro {0}
. Vous pouvez utiliser des espaces réservés dans n'importe quel ordre dans la règle de mise en forme. Par exemple, the minimum value of {3}, {0} and {2} is {1}
 est une syntaxe valide.Vous pouvez imbriquer des espaces réservés dans la chaîne de formatage 
{index,alignment:format}
 pour modifier dynamiquement le formatage des données affichées.Exemples d’espaces réservés imbriqués :
- {0:f{1}}
 - La valeur de la variable liée à{1}définit le nombre de décimales.
 
- {0:{1}{2}}
 - La valeur de la variable liée à{1}définit le type de données numérique.
 - La valeur de la variable liée à{2}définit le nombre de décimales.
 
- {0,{1}:{2}{3}}
 - La valeur de la variable liée à{1}définit l’alignement.
 - La valeur de la variable liée à{2}définit le type de données numérique.
 - La valeur de la variable liée à{2}définit le nombre de décimales.
 
Types de données
      
  Format  | Description  | Exemple  | 
|---|---|---|
g  | Date et heure locales au format court  | 
  | 
F  | Date et heure locales au format étendu  | 
  | 
X  | Date et heure UTC au format court  | 
  | 
x  | Date et heure UTC au format étendu  | 
  | 
U  | Date et heure universelles UTC au format complet  | 
  | 
p  | Date locale au format court  | 
  | 
P  | Date locale au format étendu  | 
  | 
d  | Date UTC au format court  | 
  | 
D  | Date UTC au format étendu  | 
  | 
t  | Heure locale au format court  | 
  | 
T  | Heure locale au format étendu  | 
  | 
h  | Heure UTC au format court  | 
  | 
H  | Heure UTC au format étendu  | 
  | 
Format  | Description  | Exemple  | 
|---|---|---|
d  | Valeur numérique sans séparateur de milliers. Après l'espace réservé au format, le nombre de décimales est configuré avec un entier (sans remplissage).  | 
  | 
n  | Valeur numérique avec séparateur de milliers. Après l'espace réservé au format, le nombre de décimales est configuré avec un entier (sans remplissage).  | 
  | 
e  | Notation exponentielle. Après l'espace réservé au format, le nombre de chiffres significatifs est configuré avec un entier.  | 
  | 
f  | Notation à point fixe. Après l'espace réservé au format, le nombre exact de décimales est configuré avec un entier.  | 
  | 
p  | Pourcentage. Après l'espace réservé au format, un entier est utilisé pour configurer le nombre de décimales.  | 
  | 
x  | Notation hexadécimale.  | 255 ► ff  | 
b  | Notation binaire.  | 107 ► 1101011  | 
o  | Notation octale.  | 56 ► 70  | 
Format  | Description  | Exemple  | 
|---|---|---|
c  | Format constant :  [-][d’.’]hh’:’mm’:’ss[‘.’fffffff]  | 
  | 
g  | Format court général :  [-][d’.’]hh’:’mm’:’ss[‘.’fffffff]  | 
  | 
G  | Format général étendu :  [-][d’.’]hh’:’mm’:’ss[‘.’fffffff]  | 
  | 
Format  | Description  | Exemple  | 
|---|---|---|
l  | Tout en minuscules.  | grüßEN ► grüßen  | 
u  | Tout en majuscules.  | grüßEN ► GRÜSSEN  | 
t  | Toutes les premières lettres en majuscules.  | grüßEN ► GRÜSSEN  | 
f  | Indépendant de la casse.  | grüßEN ► grüssen  | 
Format  | Description  | Exemple  | 
|---|---|---|
sql_identifier  | Met en forme une donnée spécifique de type  String  ou LocalizedText  en tant qu'identificateur de table ou de colonne. | -  | 
sql_literal  | Met en forme la valeur d'une variable en tant que valeur littérale SQL ( Nombre , Chaîne , date  ou heure , par exemple). | -  | 
Exemples de requêtes SQL
      Configurez le nom de la colonne interne avec la condition suivante :
SELECT * FROM Table1 WHERE {0:sql_identifier} > 5
Comparaison avec une variable de données :
SELECT * FROM AlarmsDatalogger WHERE Time > {0:sql_literal}
Paramétrez l’opérateur 
LIKE
 :SELECT * FROM AlarmsDatalogger WHERE Name LIKE '{0}'
Configurez une partie d'une requête avec un espace réservé :
SELECT * FROM Table1 {0}
L’espace réservé avec index 
0
 est lié à une variable de chaîne du projet et paramètre une colonne. L’espace réservé avec index 1
 est lié à une variable numérique qui représente la valeur de l’opérateur de comparaison >
 :SELECT * FROM {0:sql_identifier} WHERE Column1 > {1:sql_literal}
Paramétrez le nom de la table, la colonne et l’opérateur 
LIKE
 :SELECT {0:sql_identifier} FROM {1:sql_identifier} WHERE {0:sql_identifier} LIKE '{2}'
Formatage du chemin
      Considérez les fonctionnalités suivantes de formatage du chemin :
- Pour formater une chaîne en tant que chemin d'accès au fichier, vous pouvez utiliser la syntaxe suivante :{index,alignment:.filepath}
- Input
 - ns=5;%PROJECTDIR%/Logo.svg
 - Output
 - C:\Users\UserName\AppData\Local\Rockwell Automation\FactoryTalk Optix\Emulator\Projects\ProjectName\ProjectFiles\Logo.svg
 
 - Pour formater une chaîne en tant qu’URI, vous pouvez utiliser la syntaxe suivante :{index,alignment:.uri}
- Input
 - ns=5;%PROJECTDIR%/Logo.svg
 - Output
 - file:///C:/Users/UserName/AppData/Local/Rockwell Automation/FactoryTalk Optix/Emulator/Projects/ProjectName/ProjectFiles/Logo.svg
 
 - Pour formater une partie d’un chemin d'accès, vous pouvez utiliser la syntaxe suivante :file:///C:/Reports/Report.{0}.pdf
 
Mise en forme inversée
      La fonctionnalité de formatage inversée vous permet de modifier une valeur mise en forme lors de l’exécution pour la remplacer par une nouvelle valeur que l’application affiche avec la même mise en forme lors de l’exécution.
La fonctionnalité de mise en forme inversée nécessite le bon fonctionnement des paramètres suivants :
- LeModede lien dynamique du convertisseur doit êtreLecture/Écriture.
 - Le champFormatne doit contenir qu'un seul espace réservé ou une seule source. L'espace réservé peut avoir un suffixe et/ou un préfixe, et être défini avec une chaîne de format telle que{0:n}.
 
Sortie
      Chaîne entrée dans la propriété 
Format
 en fonction des règles de mise en forme avec des valeurs à la place des espaces réservés.Exemple
      
Fournir une réponse
Lecture du nœud source au parent.
Écriture du parent au nœud source.
Lecture du nœud source au parent et écriture du parent au nœud source.