Generieren eines XML-Ausschnitts aus einem XML-Schema

Artikel
06/19/2023

Der XML-Editor verfügt über die Funktion, XML-Ausschnitte aus einem XSD-Schema (XML Schema Definition Language) zu generieren. Wenn Sie beispielsweise eine XML-Datei erstellen, können Sie, wenn der Cursor neben dem Elementnamen platziert ist, die TAB-TASTE drücken, um das Element mit XML-Daten aufzufüllen, die aus den Schemainformationen für das betreffende Element generiert werden.

Diese Funktion ist nur für Elemente verfügbar. Zudem gelten die folgenden Regeln:

Dem Element muss ein Schematyp zugeordnet sein, d. h., das Element muss gemäß dem zugeordneten Schema gültig sein. Der Schematyp darf nicht abstrakt sein, und der Typ muss die erforderlichen Attribute und/oder die erforderlichen untergeordneten Elemente enthalten.
Das aktuelle Element im Editor muss leer sein und darf keine Attribute aufweisen. Alle folgenden Elemente sind z. B. gültig
- <Account
- <Account>
- <Account></Account>
Der Cursor muss direkt rechts neben dem Elementnamen platziert werden.

Der generierte Ausschnitt enthält alle erforderlichen Attribute und Elemente. Wenn minOccurs größer als eins (1) ist, wird die erforderliche Mindestanzahl von Instanzen dieses Elements (bis zu 100 Instanzen) in den Ausschnitt eingefügt. Für alle festen Werte im Schema werden feste Werte im Ausschnitt generiert. xsd:any- und xsd:anyAttribute-Elemente werden ignoriert und führen nicht zu zusätzlichen Konstrukten im Ausschnitt.

Es werden Standardwerte generiert und als Werte gekennzeichnet, die bearbeitet werden können. Wenn im Schema ein Standardwert angegeben ist, wird dieser Standardwert verwendet. Wenn es sich bei dem Schemastandardwert um eine leere Zeichenfolge handelt, werden vom Editor folgendermaßen Standardwerte generiert:

Wenn der Schematyp Enumerationsfacets entweder direkt oder indirekt durch Member eines union-Typs enthält, wird der erste in einem SOM (Schema Object Model) gefundene Enumerationswert als Standardwert verwendet.
Wenn es sich bei dem Schematyp um einen atomaren Typ handelt, ruft der Editor den atomaren Typ ab und fügt den Namen des atomaren Typs ein. Für einen abgeleiteten einfachen Typ wird der einfache Basistyp verwendet. Bei einem Listentyp ist der atomare Typ der itemType. Bei einer Union ist der atomare Typ der atomare Typ des ersten memberType.

Beispiel

Anhand der Schritte in diesem Abschnitt wird die Verwendung des Features für schemagenerierte XML-Ausschnitte des XML-Editors veranschaulicht.

Hinweis

Speichern Sie vor dem Starten dieser Prozeduren die Schemadatei auf dem lokalen Computer.

So erstellen Sie eine neue XML-Datei und ordnen ihr ein XML-Schema zu:

Zeigen Sie im Menü Datei auf Neu, und klicken Sie auf Datei.
Wählen Sie im Bereich Vorlagen die Option XML-Datei aus, und klicken Sie auf Öffnen.

Im Editor wird eine neue Datei geöffnet. Die Datei enthält eine XML-Standarddeklaration, <?xml version="1.0" encoding="utf-8">.
Klicken Sie im Dokumenteigenschaftenfenster im Feld Schemata auf die Schaltfläche zum Durchsuchen ( … ).

Das Dialogfeld XSD-Schemas wird angezeigt.
Klicken Sie auf Hinzufügen.

Das Dialogfeld XSD-Schema öffnen wird angezeigt.
Wählen Sie die Schemadatei aus, und klicken Sie auf Öffnen.
Klicken Sie auf OK.

Das XML-Schema wird jetzt dem XML-Dokument zugeordnet.

So generieren Sie einen XML-Ausschnitt

Geben Sie im Editorbereich < ein.
In der Memberliste werden die möglichen Elemente angezeigt:

!-- zum Hinzufügen eines Kommentars.

!DOCTYPE zum Hinzufügen eines Dokumenttyps.

? zum Hinzufügen einer Verarbeitungsanweisung.

Contact zum Hinzufügen des Stammelements.
Wählen Sie in der Memberliste Contact aus, und drücken Sie die EINGABETASTE.

Der Editor fügt das Starttag <Contact hinzu und platziert den Cursor nach dem Elementnamen.
Drücken Sie die TAB-TASTE, um XML-Daten für das Contact-Element auf der Grundlage seiner Schemainformationen zu generieren.

Eingabe

Bei der exemplarischen Vorgehensweise wird die folgende Schemadatei verwendet.

<?xml version="1.0" encoding="utf-8" ?>
<xs:schema elementFormDefault="qualified"
           xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:simpleType name="phoneType">
    <xs:restriction base="xs:string">
      <xs:enumeration value="Voice"/>
      <xs:enumeration value="Fax"/>
      <xs:enumeration value="Pager"/>
    </xs:restriction>
  </xs:simpleType>
  <xs:element name="Contact">
    <xs:complexType>
      <xs:sequence>
        <xs:element name="Name">
          <xs:simpleType>
            <xs:restriction base="xs:string"></xs:restriction>
          </xs:simpleType>
        </xs:element>
        <xs:element name="Title"
                    type="xs:string" />
        <xs:element name="Phone"
                    minOccurs="1"
                    maxOccurs="unbounded">
          <xs:complexType>
            <xs:sequence>
              <xs:element name="Number"
                          minOccurs="1">
                <xs:simpleType>
                  <xs:restriction base="xs:string"></xs:restriction>
                </xs:simpleType>
              </xs:element>
              <xs:element name="Type"
                          default="Voice"
                          minOccurs="1"
                          type="phoneType"/>
            </xs:sequence>
          </xs:complexType>
        </xs:element>
      </xs:sequence>
    </xs:complexType>
  </xs:element>
</xs:schema>

Output

Es folgen die XML-Daten, die aufgrund der dem Contact-Element zugeordneten Schemainformationen generiert werden. Als bold gekennzeichnete Elemente legen Felder im XML-Ausschnitt fest, die bearbeitet werden können.

<Contact>
  <Name>name</Name>
  <Title>title</Title>
  <Phone>
    <Number>number</Number>
    <Type>Voice</Type>
  </Phone>
</Contact>