Configuration des fichiers BitLabels​.xml et aaBitLabelsSchema​.xsd

Les informations sur les étiquettes de bit sont définies dans le fichier BitLabels.xml et validées à l'aide du fichier aaBitLabelsSchema.xsd. Ces fichiers ne sont pas disponibles par défaut.

BitLabels.xml

Le fichier BitLabels.xml définit les étiquettes de chaque étiquettes de bit prise en charge. Par exemple, les étiquettes de bit « Standard ».

Pour définir une étiquette de bit, nous avons besoin d'un nom et d'un type. Par exemple : <Labels Name="Standard" Type="Default">.

1. Nome : le nom spécifié ici est répertorié dans la liste déroulante des étiquettes de bit.
   Le nom de étiquettes de bit doit avoir au moins une lettre. Les caractères valides sont les caractères alphanumériques et les caractères spéciaux ($, #, _). La longueur maximale du nom des étiquettes de bit est de 32.

2. Type : « Défaut » ou le « Name » de l’étiquette.

Chaque XML peut contenir plusieurs <Labels>. Chaque <Labels> comprend un ou plusieurs <Label>. Chaque étiquette comporte des informations sur le nom et la portée. Par exemple :

<Labels Name="Standard" Type="Default">.

<Label Name="B31" Range="0X80000000"/>

<Label Name="B30" Range="0X40000000"/>

<Label Name="B29" Range="0X20000000"/>

Chaque <Label> aura deux champs :

3. Le nom de l’étiquette et le nom des étiquettes de bit sont insensibles à la casse et la longueur maximale du nom de l’étiquette est de 4. Dans la boîte de dialogue Sélecteur de motif de bit, lorsque les étiquettes de bit « Standard » sont sélectionnées, le nom de l’étiquette « B31 » est affiché dans le premier coin supérieur gauche.

4. Plage : est un nombre entier au format hexadécimal spécifiant quel bit sera appliqué au nom. La plage à 32 bits et ne peut avoir qu'un seul bit à « 1 ». Tous les autres bits doivent être à « 0 ». Il y a une exception sur l'étiquette « CRIT » et l'étiquette « PRI » de l'étiquette « ALMSTA ».

Par exemple :

Dans l'étiquette « Standard », le bit « B31 » est affecté à « 0x80000000 ». En convertissant le nombre hexadécimal en binaire, on obtient « 1000 0000 0000 0000 0000 0000 0000 0000 ». Cela signifie que l'étiquette « B31 » est le bit le plus élevé.

<Label Name="B31" Range="0x80000000"/>

Dans l'étiquette « Standard », le bit « B5 » est affecté à « 0x20 ». En convertissant le nombre hexadécimal en binaire, on obtient « 0000 0000 0000 0000 0000 0000 0010 0000 ». Comme les vingt-six premiers chiffres sont des zéros, nous pouvons ignorer ces zéros dans la valeur de l'intervalle.

<Label Name="B5" Range="0x20"/>

Les règles suivantes seront appliquées lors de la validation des étiquettes de bit XML et de l'affichage de la boîte de dialogue Sélecteur de motif de bit :

• Le nom de l'étiquette et le nom des étiquettes de bit doivent contenir au moins une lettre. Les caractères valides sont les caractères alphanumériques et les caractères spéciaux ($, #, _).
  <Label Name="B31" Range="0x80000000"/>

• Le nom de l'étiquette doit être unique pour chaque type d'étiquette. Un nom d'étiquette ne peut être utilisé à plusieurs reprises dans un type d'étiquette.

• Le nom de l'étiquette de bit peut commencer par « , » pour réserver l'espace de l'étiquette. Par exemple : <Label Name=",PNT2" Range="0x4000"/>.

• Deux noms d'étiquettes différents ne peuvent pas pointer vers le même bit, bien qu'un bit puisse avoir plusieurs étiquettes. Les étiquettes peuvent être attribuées dans un Name et séparées par une virgule « , »'. Il peut avoir des valeurs séparées par des virgules jusqu'à 4 groupes. Par exemple, le bit « 0x2000000 » dans l’étiquette « ALMSTA », l’entrée dans BitLabels.xml sera <Label Name="HHA,TARG" Range="0x2000000"/>, alors que dans la boîte de dialogue Sélecteur de motif de bit, elle sera être affichée comme :

  

• Le Sélecteur de motif de bit prend en charge l'alias du nom de l'étiquette. Par exemple, le sélecteur appliquera toutes les étiquettes du type « ALMOPT » pour la sélection du nom d’étiquette « INHSTA » si le type d’étiquette suivant est défini dans le xml :
  <Labels Name="ALMOPT" Type="ALMOPT" SameAs="INHSTA"/>

• Si aucun nom d'étiquette n'est défini pour le bit, la configuration du bit correspondant sera désactivée dans le dialogue du sélecteur. L'étiquette provenant des étiquettes de bit standard sera associée au bit.

• Chaque nom d'étiquette, à l'exception de « CRIT » et « PRI », ne peut spécifier qu'un seul bit dans la plage. Pour plus d'informations, voir CRIT et PRI dans l'Étiquette ALMSTA.

aaBitLabelsSchema.xsd

Le fichier aaBitLabelsSchema.xsd contient le schéma permettant de valider le fichier BitLabels.xml. La liste déroulante Étiquettes de bit sera désactivée si :

• Les fichiers XML et XSD ne sont pas disponibles dans l'emplacement <installpath>\ArchestrA\Bin.

• Le XML n'est pas bien formé

• Une étiquette invalide est détectée lors du chargement du fichier BitLabels.xml; dans ce cas, un message d'avertissement sera enregistré et le type d'étiquette standard par défaut sera utilisé.

Si la fonction Étiquettes de bit est désactivée, les étiquettes de bit « Standard » seront appliquées à chaque bit dans la boîte de dialogue Sélecteur de motif de bit.

Bit non assigné

Si un bit n'est pas affecté à une étiquette, le bit sera grisé dans la boîte de dialogue Sélecteur de motif de bit.

Par exemple, les « B15 » à « B8 » sont grisés dans l'étiquette « ALMSTA ».

Un bit grisé ne peut pas être modifié et la valeur du bit s'affiche comme « X » (Ignorer).