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