Altova StyleVision 2025 Enterprise Edition

La syntaxe du Formatage valeur est :

([prefix character/s]field[suffix character/s][{field-option1,field-option2,...}])+

Explication de la syntaxe de définition

La définition du Formatage valeur est construite comme suit :

•La définition est composée d’un ou de plusieurs champs. Par exemple, la définition DD Month YYYY a trois champs.

•Les champs peuvent être exécutés ensemble, ou ils peuvent être séparés par les caractères suivants : espace, trait d’union, virgule, point, période, ou par string de texte entre guillemets simples ou doubles. Par exemple, dans la définition : DD-Month' in the year 'YYYY, les champs DD et Month sont séparés par un trait d’union, et les champs Month et YYYY sont séparés par un string de texte enveloppé par des guillemets simples.

•Un champ peut avoir un/des caractère/s de préfixe et/ou suffixe optionnel/s. Par exemple : <+###,##0.00.

•Un champ peut avoir un ou plusieurs options de champ optionnel. L’/les option/s de champ doit/doivent être contenue/s dans un ensemble d’accolades, et doivent suivre le champ sans espace intervenant. De multiples options de champ pour un champ simple sont séparées par une "," (comma). Par exmple, dans la définition : DD Month{uc,ro} YYYY, uc et ro enveloppés par des accolades sont des options de champ pour le champ Month.

Exemples

Exemple du Formatage valeur pour un type de données xs:decimal :

"$"(##0.00)

Exemples de la sortie :

$ 25.00

$ 25.42

$267.56

Exemple du Formatage valeur pour un type de données xs:date :

DD Month{uc,ro} YYYY

Un exemple de la sortie serait :

24 SEPTEMBER 2003

Types de champs

Un type de champ représente un composant des données et de la manière dont ce composant doit être formaté. Le formatage inhérent dans le type de champ peut être modifié davantage par des modificateurs de préfixe et suffixe ainsi que par les options de champ. Les tables suivantes recensent les types de champ disponibles. Notez que, dans le menu de la liste déroulante du dialogue Formatage valeur, il existe des définitions du Formatage valeur ‘type-specific’ et ‘field-only’. Vous pouvez sélectionner un de ceux et les modifier tel que requis en ajoutant des modificateurs de préfixe, de suffixe et/ou d’options de champs.

Notes sur longueur de champ et longueur d’entrée

Les points suivants liés à la longueur des composants devraient être notés :

Longueur des champs de date : Lorsque des champs comme MM, DD, HH, hh, mm, et ss sont utilisés, il doivent avoir la longueur de 2 dans la définition. Lorsque les champs y ou Y sont utilisés, le nombre de caractères y ou Y dans la définition détermine la longueur de la sortie. Par exemple, si vous spécifiez YYY, alors la sortie pour une valeur de 2006 serait 006 ; pour une définition de YYYYYY, ce serait 002006. Voir aussi ‘Base Year’ ci-dessous.

Étendre la longueur du champ : Le symbole * (astérisque) est utilisé pour étendre la longueur d’un champ numérique non sémantique (entiers, décimales, etc). Dans le cas des décimales, il peut être utilisé soit d’un côté ou des deux du point décimal. Par exemple, le Formatage valeur *0.00* assure qu’un nombre aura les zéros tel que spécifié dans le formatage si ces emplacements de chiffres sont vides, de même que tout nombre de chiffres des deux côtés du point décimal.

Longueurs d’entrée dans Authentic View: L’affichage dans Authentic View des contenus d’un nœud est basé sur la définition du Formatage valeur pour ce nœud. Pour cette raison, l’utilisateur Authentic View ne sera pas à même d’insérer plus de caractères que ceux autorisés par la définition du Formatage valeur. Il s’agit d’une manière utile pour restreindre l’entrée dans Authentic View. Notez, toutefois, que si la longueur d’une valeur pré-existante dans le document XML excéde la longueur spécifiée dans la définition du formatage, alors toute la valeur est affichée.

Note : si un champ ne rend pas de texte, ceci peut être dû à votre paramètre de région dans Windows. Par exemple, Windows renvoie un string vide pour le champ AM/PM si le paramètre de langage régional est allemand.

Modificateurs de préfixe et de suffixe

Les modificateurs de préfixe et de suffixe sont utilisés pour modifier l’alignement textuel et les représentations positives/négatives des champs. La table suivante recense les modificateurs de préfixe et suffixe disponibles.

Options de champs

Les options de champ permettent des modifications avancées à réaliser dans les champs. Les options suivantes sont disponibles :

Les options de champs devraient être utilisées pour générer le formatage de numéro pour les langues européennes, qui échangent les virgules et les périodes du système de la langue anglaise : par exemple, 123.456,75.

Le Formatage valeur à utiliser pour obtenir le formatage ci-dessus serait : ###,###.##{dec=,,sep=.}

Notez que le champ maintient le formatage anglais, tandis que ce sont les options de champs dec et sep qui spécifient le symbole décimal et le séparateur de chiffres. Si le symbole décimal et le séparateur de chiffres ne sont pas spécifiés, ces caractères passent par défaut au symbole décimal et séparateur de chiffre des paramètres régionaux de Windows OS (Panel de commande | Tous items | Région | Format).

Note sur année de base

Lorsque vous utilisez des formats d’année courts (tel que yy et YY), l’année de base spécifie un ‘cut-off’ pour un siècle. Par exemple, l’option de champ de l’année de base pourrait être utilisée dans la définition DD-MM-YY{base=1940}. Si l’utilisateur saisit une valeur égale à ou supérieure aux deux derniers chiffres de l’année de base, qui sont considérés ensemble en tant qu’entiers positifs à deux chiffres, alors le siècle est le même que celle de l’année de base. Si la valeur saisie par l’utilisateur est inférieure à la valeur de l’entier des deux derniers chiffres, alors le siècle est le siècle de l’année de base plus un. Par exemple, si vous définissez base=1940, si l’utilisateur de Authentic View saisit 50, la valeur saisie dans le document XML sera 1950 ; si l’utilisateur saisit 23, la valeur saisie dans le document XML sera 2023.

Veuillez prendre note des points suivants :

•Bien que deux chiffres sont généralement utilisés en tant que format court de l’année, les formats d’année courts ‘one-digit’ et ‘three-digit’ peuvent également être utilisés avec une année de base.

•Les types de données pour lesquels des formats d’année courts peuvent être utilisés sont : xs:date, xs:dateTime, xs:gYear, et xs:gYearMonth.

•Si le Formatage valeur est défini pour n composant de calcul automatique, assurez-vous que le datatype correct est sélectionné dans le dialogue du Formatage valeur. (Le type de données de la date sélectionné devrait être celui du résultat pour lequel le calcul automatique est évalué.)

•Si le type de champ yy est utilisé, l’année de base par défaut est 1930. Définir explicitement une année de base écrase le défaut.

•Si le type de champ YY est utilisé sans année de base définie, alors l’utilisateur Authentic View sera à même de modifier uniquement les deux derniers chiffres de la valeur de l’année à ‘four-digit’ ; les deux premiers chiffres restent inchangés dans le document XML.