Formateur de chaîne

Modifiez la mise en forme d'une ou plusieurs valeurs en fonction d'une règle personnalisable.
CONSEIL: À l'aide du formateur de chaîne, vous pouvez, par exemple :
  • 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 ensemble dans une série ;
  • appliquer une mise en forme telle que des décimales ou des arrondis à virgule flottante aux chiffres.

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}
    .
    CONSEIL:
    Pour formater un chemin (par exemple,
    ns=5;%PROJECTDIR%/Logo.svg
    ), vous pouvez utiliser :
    • {index,alignment:
      filepath
      }
      . Pour formater une chaîne en tant que chemin du fichier.
      Exemple :
      C:\Users\
      UserName
      \AppData\Local\Rockwell Automation\FactoryTalk Optix\Emulator\Projects\
      ProjectName
      \ProjectFiles\Logo.svg
    • {index,alignment:
      uri
      }
      . Pour formater une chaîne en tant qu’URI.
      Exemple :
      file:///C:/Users/
      UserName
      /AppData/Local/Rockwell Automation/FactoryTalk Optix/Emulator/Projects/
      ProjectName
      /ProjectFiles/Logo.svg
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

Une ou plusieurs variables identifiées par un espace réservé avec un numéro d'index au format {index} suivant. Le numéro d’index est progressif et doit être un entier supérieur à zéro {0}.
CONSEIL: Les espaces réservés peuvent s'afficher dans n'importe quel ordre dans la règle de mise en forme. Par exemple, la syntaxe « la valeur minimale de {3}, {0} et {2} est {1} » est valide.

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

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

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}'
Fournir une réponse
Vous avez des questions ou des commentaires sur cette documentation ? Veuillez envoyer vos commentaires ici.