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 :
  • Index
    . Numéro d'index qui identifie une variable d'entrée. Pour chaque espace réservé
    {index}
    de la règle de mise en forme, un nouveau champ indiquant la source s'affiche.
  • Alignement
    . Entier représentant le nombre de caractères de la valeur source mise en forme en fonction de la règle.
  • Format
    . Mise en forme à appliquer aux variables d'entrée.
    L’espace réservé au format accepte un sous-ensemble de valeurs requises par la notation .NET Framework pour la méthode
    String.Format
    . Les espaces réservés doivent utiliser la syntaxe
    {index,alignment:format}
    .
Mode
Direction du lien dynamique :
  • 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.

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

Exemple de données : 23/04/2021 17:25:31, session avec décalage TimeZone de 60 minutes.
DateTime
Format
Description
Exemple
g
Date et heure locales au format court
  • (en-US) : 4/23/21, 06:25 PM
  • (it-IT) : 23/04/21, 18:25
F
Date et heure locales au format étendu
  • (en-US) : Apr 23, 2021, 6:25:31 PM
  • (it-IT) : 23 apr 2021, 18:25:31
X
Date et heure UTC au format court
  • (en-US) : 4/23/21, 4:25 PM (UTC)
  • (it-IT) : 23/04/21, 16:25 (UTC)
x
Date et heure UTC au format étendu
  • (en-US) : Apr 23, 2021, 4:25:31 PM (UTC)
  • (it-IT) : 23 apr 2021, 16:25:31 (UTC)
U
Date et heure universelles UTC au format complet
  • (en-US) : April 23, 2021 4:25:31 PM GMT (UTC)
  • (it-IT) : 23 aprile 2021 16:25:31 GMT (UTC)
p
Date locale au format court
  • (en-US) : 4/23/21
  • (it-IT) : 23/04/21
P
Date locale au format étendu
  • (en-US) : April 23, 2021
  • (it-IT) : 23 apr 2021
d
Date UTC au format court
  • (en-US) : 4/23/21 (UTC)
  • (it-IT) : 23/04/21 (UTC)
D
Date UTC au format étendu
  • (en-US) : Apr 23, 2021 (UTC)
  • (it-IT) : 23 apr 2021 (UTC)
t
Heure locale au format court
  • (en-US) : 6:25 PM
  • (it-IT) : 18:25
T
Heure locale au format étendu
  • (en-US) : 6:25:31 PM
  • (it-IT) : 18:25:31
h
Heure UTC au format court
  • (en-US) : 4:25 PM (UTC)
  • (it-IT) : 16:25 (UTC)
H
Heure UTC au format étendu
  • (en-US) : 4:25:31 PM (UTC)
  • (it-IT) : 16:25:31 (UTC)
Valeur numérique (Double Float Int16 Int32 Int64 Integer UInt16 UInt32 UInt64 UInteger)
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).
  • d
     : -1234 ► -1234
  • d
     : 5.618 ► 5618
  • d2
     : 1,234.239 ► 1234.24
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).
  • n1
     : -1234.23 ► -1,234.2
  • n2
     : 5804.236 ► 5,804.24
  • n3
     : -1234.23 ► -1,234.2
e
Notation exponentielle.
Après l'espace réservé au format, le nombre de chiffres significatifs est configuré avec un entier.
  • e10
     : 12345.6789 ► 1.234567890E4
  • e2
     : 2665.778 ► 2.7E3
f
Notation à point fixe.
Après l'espace réservé au format, le nombre exact de décimales est configuré avec un entier.
  • f3
     : 123 ► 123.000
  • f3
     : 123.23 ► 123.230
  • f4
     : -1898300.678 ► -1,898,300.6780
  • f3
     : 123.4 ► 123.400
p
Pourcentage.
Après l'espace réservé au format, un entier est utilisé pour configurer le nombre de décimales.
  • p
     : 1 = 100%
  • p3
     : -0.397481 ► -39.748%
x
Notation hexadécimale.
255 ► ff
b
Notation binaire.
107 ► 1101011
o
Notation octale.
56 ► 70
Durée et période
Format
Description
Exemple
c
Format constant :
[-][d’.’]hh’:’mm’:’ss[‘.’fffffff]
  • 3.17:25:30.5000000
  • 4:30:00 AM
g
Format court général :
[-][d’.’]hh’:’mm’:’ss[‘.’fffffff]
  • (en-US) : 1:3:16:50.5
  • (en-US) : 5:15:09:00
  • (fr-FR) : 2:9:02:00,0200000
  • (fr-FR) : 15:12:20:00
  • (en-US) : 5:12:00
  • (fr-FR) : 20:10:00
G
Format général étendu :
[-][d’.’]hh’:’mm’:’ss[‘.’fffffff]
  • (en-US) : 12:08:30 AM:00.0000000
  • (fr-FR) : 12:08:30 AM:00.0000000
  • (en-US) : 12:18:20 AM:00.0000000
  • (fr-FR) : 12:17:30 AM:00.0000000
Chaîne
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
SQL ANSI
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 :
  • Le
    Mode
    de lien dynamique du convertisseur doit être
    Lecture/Écriture
    .
  • Le champ
    Format
    ne 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
Vous avez des questions ou des commentaires sur cette documentation ? Veuillez envoyer vos commentaires ici.