Partager via

Nœuds Groupe Choix

  • Article

Dans l’éditeur BizTalk, vous pouvez insérer un nœud Groupe de choix pour contenir d’autres nœuds (ou des sous-arborescences entières de nœuds), dont un seul peut apparaître dans un message instance. Un message d’instance donné, s’il est valide, ne comportera que l'un des choix présents. Les nœuds contenus doivent correspondre à des éléments XML, et non à des attributs XML.

Notes

Dans l’éditeur BizTalk, le nœud Groupe de choix est représenté avec la chaîne <Choice> dans l’arborescence de schéma. Si vous définissez une référence à un nœud Groupe de choix , tel que x, il est représenté sous la forme <Group :x> dans l’arborescence de schéma.

Représentation XSD

Lorsqu’un nœud Groupe de choix est inséré dans un nœud Record , il est inséré à la fin de tout autre nœud enfant au sein de la séquence, du choix ou de tout l’élément dans le nœud Record . L’exemple suivant montre, en gras, comment un nouveau nœud Groupe de choix est représenté dans le langage XSD (XML Schema Definition) en tant qu’élément de choix inséré à la fin de l’élément de séquence dans un nœud Record (avec des nœuds nommés pour clarifier leur identité).

<xs:element name="ContainingRecord">  
    <xs:complexType>  
        <xs:sequence>  
            <xs:element name="ExistingFieldElement" type="xs:string" />  
        </xs:sequence>  
    </xs:complexType>  
</xs:element>

Par défaut, l’élément choice reçoit une valeur d’attribut minOccurs égale à zéro (0), ce qui indique qu’aucun des choix n’est nécessaire. Vous pouvez modifier cette valeur dans visual Studio Fenêtre Propriétés lorsque le nœud Groupe de choix est sélectionné dans l’arborescence du schéma.

L’exemple suivant montre le même élément de choix avec les éléments d’élément XSD correspondant à deux nœuds Record subordonnés.

<xs:element name="ContainingRecord">  
    <xs:complexType>  
        <xs:sequence>  
            <xs:element name="ExistingFieldElement" type="xs:string" />  
            <xs:choice minOccurs="1" maxOccurs="1">  
                <xs:element name="usAddress">  
                    <xs:complexType>  
                        <xs:sequence>  
                        </xs:sequence>  
                    </xs:complexType>  
                </xs:element>  
                <xs:element name="foreignAddress">  
                    <xs:complexType>  
                        <xs:sequence>  
                        </xs:sequence>  
                    </xs:complexType>  
                </xs:element>  
            </xs:choice>  
        </xs:sequence>  
    </xs:complexType>  
</xs:element>

Dans cet exemple, deux nœuds Record frères sont utilisés pour décrire le fait qu’un message instance contient un enregistrement contenant États-Unis informations d’adresse, ou un enregistrement contenant des informations d’adresse dans le monde entier. En outre, les propriétés minOccurs et maxOccurs du nœud Groupe de choix ont toutes deux été définies sur un (1) dans le Fenêtre Propriétés Visual Studio, ce qui a pour effet que les attributs minOccurs et maxOccurs de l’élément choice sont définis sur un (1) dans la représentation XSD.

Voir aussi