Freigeben über

Knoten 'Auswahlgruppe'

  • Artikel

Im BizTalk-Editor können Sie einen Knoten der Auswahlgruppe einfügen, der andere Knoten (oder ganze Unterstrukturen von Knoten) enthält, von denen nur einer in einer instance-Nachricht angezeigt werden kann. In jeder Instanznachricht (sofern diese gültig ist) steht nur eine der Auswahlmöglichkeiten zur Verfügung. Die enthaltenen Knoten müssen Knoten sein, die XML-Elementen entsprechen. Es darf sich jedoch dabei nicht um Knoten handeln, die XML-Attributen entsprechen.

Hinweis

Im BizTalk-Editor wird der Knoten Choice-Gruppe mit der Zeichenfolge <Choice> in der Schemastrukturansicht dargestellt. Wenn Sie einen Verweis auf einen Choice Group-Knoten festlegen, z. B. x, wird er in der Schemastrukturansicht als <Gruppe:x> dargestellt.

XSD-Darstellung

Wenn ein Choice Group-Knoten in einen Datensatzknoten eingefügt wird, wird er am Ende aller anderen untergeordneten Knoten innerhalb der Sequenz, Auswahl oder des gesamten Elements im Knoten Record eingefügt. Das folgende Beispiel zeigt fett, wie ein neuer Choice Group-Knoten in der XSD-Sprache (XML Schema Definition) als Choice-Element dargestellt wird, das am Ende des Sequenzelements in einem Record-Knoten eingefügt wird (mit Knoten, die zur Klärung ihrer Identität benannt sind).

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

Standardmäßig erhält das choice-Element den minOccurs-Attributwert null (0), der angibt, dass keine der Optionen erforderlich ist. Sie können diesen Wert im Visual Studio-Eigenschaftenfenster ändern, wenn der Knoten Auswahlgruppe in der Schemastrukturansicht ausgewählt ist.

Das folgende Beispiel zeigt dasselbe Choice-Element mit den XSD-Elementelementen, die zwei untergeordneten Record-Knoten entsprechen.

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

In diesem Beispiel werden zwei gleichgeordnete Datensatzknoten verwendet, um die Tatsache zu beschreiben, dass eine instance Nachricht entweder einen Datensatz mit USA Adressinformationen enthält oder einen Datensatz mit weltweiten Adressinformationen enthält. Darüber hinaus wurden die Eigenschaften minOccurs und maxOccurs des Knotens Choice Group im Visual Studio-Eigenschaftenfenster auf ein (1) festgelegt, was dazu führt, dass die MinOccurs- und maxOccurs-Attribute des Choice-Elements in der XSD-Darstellung auf 1 (1) festgelegt werden.

Weitere Informationen