Partager via

Nom du nœud (propriété node de tous les schémas)

 

Utilisez la propriété Nom du nœud pour afficher le nom du nœud tel qu’il apparaît dans l’arborescence de schéma dans l’éditeur BizTalk, et pour certains types de nœuds, pour modifier le nom du nœud afin de décrire son contenu.

S'applique aux nœuds de type

Schéma, enregistrement, élément Field, attribut champ, groupe de séquences, groupe de choix, tout groupe, groupe d’attributs, tout élément, attribut, équivalent, enfant

Category

Général

Valeurs autorisées

Les noms de nœuds doivent respecter les exigences de noms XSD et XML. Pour les nœuds pour lesquels la valeur de la propriété Nom du nœud peut être modifiée, si vous tapez un nom de nœud qui ne correspond pas à ces exigences, vous serez invité à utiliser les options suivantes :

  • coder le nom incorrect de sorte qu'il soit conforme aux exigences XSD/XML ;

  • annuler l'opération d'attribution de nom et revenir au nom précédent.

Pour plus d’informations sur le schéma d’encodage utilisé par l’éditeur BizTalk pour encoder des caractères non XML, consultez la documentation .NET Framework pour la méthode EncodeLocalName du System.Xml. Classe XmlConvert . L'Éditeur BizTalk se sert du même schéma de codage.

Un chiffre placé en tête et le caractère espace sont deux exemples courants de cas nécessitant un codage.

Valeur par défaut

La propriété Nom du nœud a différentes valeurs par défaut pour différents types de nœuds, comme suit :

Type de nœud Valeurs par défaut du nom de nœud
Schéma <Schéma>
Enregistrement Enregistrement
Field, élément Champ
Attribut de champ Champ
Groupe Séquence <Séquence>
Groupe Choix <Choix>
Groupe All <Tout>
Groupe d’attributs <AttrGroup:attrGroupN>

où « N » est un nombre croissant monotone commençant à zéro (0)
N’importe quel élément <Any>
Tout attribut <AnyAttribute>
Équivalent <Équivalent>
Enfant Équivalent Noms du type complexe de base et de l’ensemble de types complexes dérivés, affichés entre crochets (<type>), associés au nœud Équivalent contenant.

XSD_Persistence

La propriété Nom du nœud est conservée différemment dans le XSD pour différents types de nœuds, comme suit :

Type de nœud Persistance XSD du nom du nœud
Schéma En tant qu’élément de schéma .
Enregistrement Comme valeur de l’attribut name de l’élément correspondant .
Field, élément Comme valeur de l’attribut name de l’élément correspondant .
Attribut de champ Valeur de l’attribut name de l’élément d’attribut correspondant.
Groupe Séquence Lorsque la propriété Référence de groupe n’a aucune valeur, en tant qu’élément de séquence .

Lorsque la propriété Référence de groupe a une valeur, la partie variable du nom du nœud, qui suit la sous-chaîne « Group: » principale, est conservée en tant qu’attribut ref des instances de l’utilisation du groupe de séquences et en tant qu’attribut name de la définition globale du groupe de séquences.
Groupe Choix Lorsque la propriété Référence de groupe n’a aucune valeur, en tant qu’élément de choix .

Lorsque la propriété Référence de groupe a une valeur, la partie variable du nom du nœud, qui suit la sous-chaîne « Group: » principale, est conservée en tant qu’attribut ref des instances de l’utilisation du groupe de choix et en tant qu’attribut name de la définition globale du groupe de choix.
Groupe All Lorsque la propriété Référence de groupe n’a aucune valeur, en tant qu’élément all .

Lorsque la propriété Référence de groupe a une valeur, la partie variable du nom du nœud, qui suit la sous-chaîne « Group: » de début, est conservée en tant qu’attribut ref des instances de l’utilisation du groupe all et en tant qu’attribut name de la définition globale du groupe tout.
Groupe d’attributs La partie variable du nom du nœud, qui suit la sous-chaîne « AttrGroup: », est conservée en tant qu’attribut ref des instances de l’utilisation du groupe d’attributs et en tant qu’attribut name de la définition globale du groupe d’attributs.
N’importe quel élément En tant qu’élément n’importe quel .
Tout attribut En tant qu’élément anyAttribute .
Enfant équivalent et équivalent Les nœuds équivalents et enfants équivalents sont des constructions de l’éditeur BizTalk et ne font pas partie de la norme XSD. Leur objectif est de vous aider à visualiser l'héritage entre les types de base et les types dérivés du schéma.

Remarques

Vous pouvez examiner cette propriété et, dans certains cas, définir cette propriété dans le Fenêtre Propriétés Visual Studio lorsque vous sélectionnez un nœud dans BizTalk Editor.

La propriété Node Name se comporte différemment pour différents types de nœuds, comme suit :

Type de nœud Comportement de la propriété Node Name
Schéma Lecture seule. Il est toujours défini sur «< Schéma> ».
Record, Field Element et Field Attribute En lecture/écriture. Vous pouvez renommer les nœuds Record, Field Element et Field Attribute à l’aide de la propriété Nom du nœud ou sur place dans l’arborescence de schéma lorsque vous les insérez pour la première fois ou lorsque vous utilisez la commande Renommer dans le menu contextuel du nœud.

Les nœuds d’enregistrement frère et d’élément de champ du même espace de noms ne peuvent avoir la même valeur de propriété Node Name que s’ils ont le même type de données (sauf s’il s’agit d’une déclaration globale), et les nœuds d’attribut de champ frères du même espace de noms ne peuvent jamais avoir la même valeur de propriété Nom de nœud .
Groupe de séquences, Groupe de choix et Tout le groupe Lecture seule. Toutefois, toute valeur non vide dans la propriété référence de groupe correspondante contribue à la valeur de la propriété Node Name pour ces nœuds de groupe d’éléments. Par exemple, si vous définissez la propriété Référence de groupe sur la valeur « BillingAddress », la propriété Node Name devient « Group:BillingAddress ».
Groupe d’attributs Lecture seule. Toutefois, la valeur de la propriété référence de groupe correspondante, qu’il s’agisse de la valeur par défaut ou d’une valeur que vous fournissez, contribue à la valeur de la propriété Nom du nœud pour les nœuds du groupe d’attributs . Par exemple, si vous définissez la propriété Référence de groupe sur la valeur « ProductDimensions », la propriété Node Name devient « AttrGroup:ProductDimensions ».
N’importe quel élément Lecture seule. Il est toujours défini sur «< Any> ».
Tout attribut Lecture seule. Elle est toujours définie sur «< AnyAttribute> ».
Équivalent Lecture seule. Elle est toujours définie sur «< Équivalent> ».
Enfant Équivalent Lecture seule. Il est toujours défini sur l’un des noms de types complexes associés au nœud parent Équivalent , soit le nom de type complexe de base, soit l’un des noms de type complexe dérivés.

Voir aussi

Propriétés de nœud de tous les schémas