Mit Datenwörterbücher sind die Benutzer in der Lage, Informationen aus Back-End-Datenquellen zu verwenden, ohne technische Details der zugrunde liegenden Datenmodelle zu kennen. Ein Datenwörterbuch besteht aus Datenwörterbuchelementen (DDEs). Diese Datenelemente können Sie verwenden, um Back-End-Daten als Eingaben in Briefe einzufügen, um sie bei der Kundenkorrespondenz zu verwenden.
Ein Datenwörterbuch ist eine unabhängige Darstellung von Metadaten, die zu Grunde liegende Datenstrukturen und die dazugehörigen Attribute beschreibt. Ein Datenwörterbuch wird mit Hilfe von Unternehmensvokabular aufgebaut. Es kann einem oder mehreren zu Grunde liegenden Datenmodellen zugeordnet werden.
Ein Datenwörterbuch besteht aus Datenwörterbuchelementen (DDEs), von denen es drei Typen gibt: Elemente des Typs „Simple“, „Composite“ und „Collection“. Simple-DDEs sind Primitive-Elemente wie Zeichenfolgen, Zahlen, Daten und boolesche Werte, die Informationen wie z. B. den Stadtnamen enthalten. Ein Composite DDE enthält andere DDEs, die vom Typ „Primitive“, „Composite“ oder „Collection“ sein können. Das kann z. B. eine Adresse sein, die aus einer Straße, einer Stadt, einem Bezirk, einem Land und einer Postleitzahl besteht. Eine „Collection“ ist eine Liste von ähnlichen Simple- oder Composite-DDEs. Beispielsweise ein Kunde mit mehreren Wohnsitzen oder mit unterschiedlicher Rechnungs- und Versandadresse.
Correspondence Management verwendet das Back-End sowie kunden- oder empfängerspezifische Daten, die gemäß der Datenwörterbuchstruktur gespeichert sind, um Korrespondenz für verschiedene Kunden zu erstellen. Beispielsweise kann ein Dokument mit Anzeigenamen wie „Lieber {Vorname}“, „Herr {Nachname}“ erstellt werden.
In der Regel müssen Geschäftsbenutzer keine Kenntnisse über Metadatendarstellungen wie XSD (XML-Schema) und Java-Klassen haben. Sie müssen allerdings in der Regel Zugriff auf diese Datenstrukturen und Attribute haben, um Lösungen erstellen zu können.
Installieren Sie das Kompatibilitätspaket, um die Option Datenwörterbücher auf der Seite Formulare anzuzeigen.
Verwenden Sie den Datenwörterbucheditor zum Erstellen eines Datenwörterbuchs oder laden Sie eine XSD-Schemadatei hoch, um ein Datenwörterbuch auf dieser Grundlage zu erstellen. Anschließend können Sie das Datenwörterbuch durch Hinzufügen weiterer erforderlicher Informationen, einschließlich Felder, erweitern. Unabhängig davon, wie ein Datenwörterbuch erstellt wurde, muss der Eigentümer des Geschäftsprozesses keine Kenntnisse über Back-End-Systeme haben. Er muss nur über Kenntnisse zu Domain-Objekten und deren Definitionen verfügen.
Bei mehreren Briefe, die ähnliche Elemente erfordern, können Sie ein allgemeines Datenwörterbuch erstellen. Ein großes Datenwörterbuch mit vielen Elementen kann jedoch Leistungseinbußen bei der Verwendung des Datenwörterbuchs und beim Laden der Elemente verursachen, etwa in Briefen und Dokumentfragmenten. Falls Leistungsprobleme auftreten, erstellen Sie separate Datenwörterbücher für verschiedene Briefe.
Wählen Sie Formulare > Datenwörterbücher.
Tippen Sie auf Datenwörterbuch erstellen.
Fügen Sie im Bildschirm „Eigenschaften“ Folgendes hinzu:
Titel: (Optional) Geben Sie den Titel für das Datenwörterbuch ein. Titel müssen nicht eindeutig sein und dürfen Sonderzeichen und nichtenglische Zeichen enthalten. Briefe und andere Dokumentfragmente werden durch ihren Titel (falls verfügbar) referenziert, z. B. in Miniaturansichten und Asset-Eigenschaften. Auf Datenwörterbücher wird nicht über ihre Titel, sondern über ihre Namen verwiesen.
Name: Der eindeutige Name des Datenwörterbuchs. Im Feld „Name“ können Sie nur englische Sprachzeichen, Zahlen und Bindestriche eingeben. Das Feld „Name“ wird automatisch basierend auf dem Feld „Titel“ ausgefüllt, wobei Sonderzeichen, Leerzeichen, Zahlen und nichtenglische Zeichen aus dem Feld „Titel“ durch Bindestriche ersetzt werden. Obwohl der Wert im Feld „Titel“ automatisch in das Feld „Name“ kopiert wird, können Sie den Wert bearbeiten.
Beschreibung: (Optional) Beschreibung des Datenwörterbuchs.
Tags:(Optional) Um einen benutzerdefinierten Tag zu erstellen, geben Sie einen Wert in das Textfeld ein und drücken Sie die Eingabetaste. Sie können den Tag unterhalb des Textfeldes der Tags sehen. Wenn Sie diesen Text speichern, werden die neu hinzugefügten Tags auch erstellt.
Erweiterte Eigenschaften: (Optional) Klicken Sie auf Feld hinzufügen, um Metadatenattribute für Ihr Datenwörterbuch anzugeben. Geben Sie in der Spalte „Eigenschaftsname“ einen eindeutigen Namen für die Eigenschaft ein. Geben Sie in der Spalte „Wert“ einen Wert ein, der mit der Eigenschaft verknüpft werden soll.
(Optional) Wenn Sie eine XSD-Schemadefinition für Ihr Datenwörterbuch hochladen möchten, klicken Sie im Bereich „Datenwörterbuchstruktur“ auf XML-Schema hochladen. Navigieren Sie zu der gewünschten XSD-Datei, wählen Sie diese aus und klicken Sie auf Öffnen. Ein Datenwörterbuch wird basierend auf dem hochgeladenen XML-Schema erstellt. Sie müssen die Anzeigenamen und Beschreibungen des Elements im Datenwörterbuch anpassen. Dazu müssen Sie die Namen der Elemente wählen, indem Sie darauf tippen und dann ihre Beschreibungen, Anzeigenamen und andere Details in den Feldern im rechten Bereich ändern.
Weitere Informationen zu berechneten DD-Elementen finden Sie unter Berechnete Datenwörterbuchelemente.
Sie können das Hochladen der Schemadatei überspringen und Ihr eigenes Datenwörterbuch von Grund auf mithilfe der Benutzeroberfläche erstellen. Hierzu überspringen Sie diesen Schritt und fahren Sie mit den nächsten Schritten fort.
Tippen Sie auf Weiter.
Fügen Sie im Bildschirm „Eigenschaften hinzufügen“ die Elemente zum Datenwörterbuch hinzu. Sie können auch Elemente hinzufügen/löschen und ihre Details bearbeiten, wenn Sie ein Schema hochgeladen haben, um eine Basisstruktur des Datenwörterbuchs zu erhalten.
Sie können auf die drei Punkte auf der rechten Seite eines Elements tippen und der Datenwörterbuchstruktur ein Element hinzufügen.
Wählen Sie entweder Composite-Element, Collection-Element oder Primitive-Element aus.
Nachfolgend finden Sie einige Regeln zu Erstellen eines Datenwörterbuchs:
Weitere Informationen zu Composite-, Collection- und Primitive-Elementen und zum Arbeiten mit Datenwörterbuchelementen finden Sie unter Zuordnen von Datenwörterbuchelementen zum XML-Schema.
Weitere Informationen zu Überprüfungen im Datenwörterbuch finden Sie unter Überprüfungen des Datenwörterbucheditors.
(Optional) Nach der Auswahl eines Elements können Sie auf der Registerkarte „Erweitert“ Eigenschaften (Attribute) hinzufügen. Sie können auch auf Feld hinzufügen tippen und die Eigenschaften eines DD-Elements erweitern.
(Optional) Sie können ein Element durch Tippen auf die drei Punkte auf der rechten Seite eines Elements und durch Auswahl von Löschen entfernen.
Beim Löschen eines Composite-/Collection-Elements mit untergeordneten Knoten werden seine untergeordneten Knoten auch gelöscht.
(Optional) Wählen Sie ein Element im Bereich „Datenwörterbuchstruktur“ und im Bereich „Feld- und Variablenliste“. Ändern Sie alle erforderlichen Attribute, die mit dem Element verknüpft sind, oder fügen Sie Attribute hinzu.
Tippen Sie auf Speichern.
Um schnell ein oder mehrere Datenwörterbücher mit Eigenschaften und Elementen zu erstellen, die denen von vorhandenen Datenwörterbüchern ähnlich sind, können Sie diese kopieren und einfügen.
Beim Bearbeiten oder Anzeigen des Datenwörterbuchs sehen Sie, welche Elemente des Datenwörterbuchs in welchen Texten, Bedingungen, Briefe und interaktive Kommunikation referenziert werden.
Führen Sie einen der folgenden Schritte aus, um das Datenwörterbuch zu bearbeiten:
Oder tippen Sie auf ein Datenwörterbuch, um es anzuzeigen.
Im Datenwörterbuch tippen Sie auf ein einfaches Element, um es auszuwählen. Composite- und Collection-Elemente haben keine Verweise.
Zusammen mit den grundlegenden und erweiterten Eigenschaften des Elements wird auch geliehener Inhalt angezeigt.
Tippen Sie auf „Geliehener Inhalt“.
Die Registrierkarte „Geliehener Inhalt“ mit dem folgenden Inhalten wird angezeigt: Texte, Bedingungen, Briefe und Interaktive Kommunikation. Bei jeder dieser Überschriften wird auch die Anzahl der Verweise auf das ausgewählte Element angezeigt.
Tippen Sie auf ein Überschrift, um den Namen des Assets, in dem auf das Element verwiesen wird, anzuzeigen.
Um geliehenen Inhalt für ein anderes Element anzuzeigen, tippen Sie auf das Element.
Um ein Asset anzuzeigen, das auf ein Element verweist, tippen Sie auf seinen Namen. Das Asset, der Brief oder das ainteraktive Kommunikation wird im Browser angezeigt.
Tippen Sie auf der Seite „Datenwörterbücher“ auf Auswählen.
Tippen Sie auf ein Datenwörterbuch, für das Sie Testdaten herunterladen möchten, und tippen Sie dann auf XML-Beispieldaten herunterladen.
Tippen Sie bei der Warnmeldung auf OK. Eine XML-Datei wird heruntergeladen.
Öffnen Sie die XML-Datei mit Notepad oder einem anderen XML-Editor. Die XML-Datei hat dieselbe Struktur wie das Datenwörterbuch und die Platzhalterzeichenfolgen in den Elementen. Ersetzen Sie die Platzhalterzeichenfolgen mit den Daten, mit denen Sie einen Brief testen wollen.
<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<Company>
<Name>string</Name>
<Type>string</Type>
<HeadOfficeAddress>
<Street>string</Street>
<City>string</City>
<State>string</State>
<Zip>string</Zip>
</HeadOfficeAddress>
<SalesOfficeAddress>
<Street>string</Street>
<City>string</City>
<State>string</State>
<Zip>string</Zip>
</SalesOfficeAddress>
<HeadCount>1.0</HeadCount>
<CEO>
<PersonName>
<FirstName>string</FirstName>
<MiddleName>string</MiddleName>
<LastName>string</LastName>
</PersonName>
<DOB>string</DOB>
<CurrAddress>
<Street>string</Street>
<City>string</City>
<State>string</State>
<Zip>string</Zip>
</CurrAddress>
<DOJ>14-04-1973</DOJ>
<Phone>1.0</Phone>
</CEO>
</Company>
In diesem Beispiel erstellt XML Platz für drei Werte für ein Collection-Element, aber die Anzahl der Werte kann je nach Anforderung reduziert bzw. erhöht werden.
Nachdem die Dateneinträge vorgenommen wurden, können Sie diese XML-Datei verwenden, wenn Sie einen Brief mit Testdaten in der Vorschau anzeigen.
Sie können diese Testdaten mit DD hinzufügen (Wählen Sie DD, tippen Sie auf „Testdaten hochladen“ und laden Sie diese XML-Datei hoch). Wenn Sie danach den Brief normal in der Vorschau anzeigen (nicht benutzerdefiniert), werden diese XML-Daten in dem Brief verwendet. Sie können auch auf „Benutzerdefiniert“ tippen und diese XML hochladen.
Im Folgenden sind Codebeispiele aufgelistet, die Implementierungsdetails für das Datenwörterbuch zeigen.
<?xml version="1.0" encoding="utf-8"?>
<xs:schema xmlns="DCT" targetNamespace="DCT" xmlns:xs="https://www.w3.org/2001/XMLSchema"
elementFormDefault="qualified" attributeFormDefault="unqualified">
<xs:element name="Company">
<xs:complexType>
<xs:sequence>
<xs:element name="Name" type="xs:string"/>
<xs:element name="Type" type="xs:anySimpleType"/>
<xs:element name="HeadOfficeAddress" type="Address"/>
<xs:element name="SalesOfficeAddress" type="Address" minOccurs="0"/>
<xs:element name="HeadCount" type="xs:integer"/>
<xs:element name="CEO" type="Employee"/>
<xs:element name="Workers" type="Employee" maxOccurs="unbounded"/>
</xs:sequence>
</xs:complexType>
</xs:element>
<xs:complexType name="Employee">
<xs:complexContent>
<xs:extension base="Person">
<xs:sequence>
<xs:element name="CurrAddress" type="Address"/>
<xs:element name="DOJ" type="xs:date"/>
<xs:element name="Phone" type="xs:integer"/>
</xs:sequence>
</xs:extension>
</xs:complexContent>
</xs:complexType>
<xs:complexType name="Person">
<xs:sequence>
<xs:element name="PersonName" type="Name"/>
<xs:element name="DOB" type="xs:dateTime"/>
</xs:sequence>
</xs:complexType>
<xs:complexType name="Name">
<xs:sequence>
<xs:element name="FirstName" type="xs:string"/>
<xs:element name="MiddleName" type="xs:string"/>
<xs:element name="LastName" type="xs:string"/>
</xs:sequence>
</xs:complexType>
<xs:complexType name="Address">
<xs:sequence>
<xs:element name="Street" type="xs:string"/>
<xs:element name="City" type="xs:string"/>
<xs:element name="State" type="xs:string"/>
<xs:element name="Zip" type="xs:string"/>
</xs:sequence>
</xs:complexType>
</xs:schema>
In der folgenden Tabelle werden allgemeine Attribute, die mit einem DDE verknüpft sind, gezeigt:
Attribut | Typ | Beschreibung |
Name | Zeichenfolge | Erforderlich. Name des DDEs. Es muss eindeutig sein. |
Referenz name |
Zeichenfolge | Erforderlich. Eindeutiger Verweisname für das DDE, der Verweise auf das DDE ermöglicht, die unabhängig von Hierarchie- oder Strukturänderungen des Datenwörterbuchs sind. Textmodule werden mithilfe dieses Namens zugeordnet. |
Anzeigename | Zeichenfolge | Ein optionaler benutzerfreundlicher Name des DDEs. |
description | Zeichenfolge | Beschreibung des DDE. |
elementType | Zeichenfolge | Erforderlich. Der Typ des DDEs: STRING, NUMBER, DATE, BOOLEAN, COMPOSITE, COLLECTION. |
elementSubType | Zeichenfolge | Der Subtyp für DDE: ENUM. Nur für elementType STRING und NUMBER. |
Schlüssel | Boolesch | Ein boolesches Feld, um anzuzeigen, ob ein DDE ein Schlüsselelement ist. |
Berechnet | Boolesch | Ein boolesches Feld, um anzuzeigen, ob ein DDE berechnet wurde. Ein berechneter DDE-Wert ist eine Funktion anderer DDE-Werte. JSP-Ausdrücke werden standardmäßig unterstützt. |
Ausdruck | Zeichenfolge | Der Ausdruck für das „berechnete“ DDE. Der standardmäßig versandte Ausdrucksauswertungsdienst unterstützt JSP-EL-Ausdrücke. Sie können den Ausdrucksdienst durch eine benutzerdefinierte Implementierung ersetzen. |
valueSet | Liste | Ein Satz zulässiger Werte für ein DDE vom Typ „Enum“. Beispielsweise kann Accounttype nur zwei Werte (Sparkonto, Girokonto) haben. |
extendedProperties | Object | Eine Zuordnung von benutzerdefinierten Eigenschaften, die dem DDE hinzugefügt wurden (benutzeroberflächenspezifische oder andere Informationen). |
Erforderlich | Boolesch | Die Markierung gibt an, dass die dem Datenwörterbuch entsprechende Quelle von Instanzdaten den Wert dieses bestimmten DDE enthalten muss. |
Bindung | BindingElement | Die XML- oder Java-Bindung des Elements. |
Ein Datenwörterbuch kann auch berechnete Elemente enthalten. Ein berechnetes Datenwörterbuchelement ist immer mit einem Ausdruck verknüpft. Der Ausdruck wird geprüft, um den Wert eines Datenwörterbuchelements zur Laufzeit abzurufen. Ein berechneter DDE-Wert ist eine Funktion anderer DDE-Werte oder Literale. Standardmäßig werden JSP-Expression Language(EL)-Ausdrücke unterstützt. Die EL-Ausdrücke verwenden die ${ }-Zeichen und gültige Ausdrücke können Literale, Operatoren, Variablen (Datenwörterbuchelementverweise) und Funktionsaufrufe enthalten. Beim Verweisen auf ein Datenwörterbuchelement im Ausdruck wird der Verweisname des DDE verwendet. Der Verweisname ist für jedes Datenwörterbuchelement in einem Datenwörterbuch eindeutig.
Ein berechneter DDE PersonFullName kann mit einem EL-Verkettungsausdruck wie ${PersonFirstName} ${PersonLastName} verknüpft werden.
Das Exportieren einer XSD-Datei erfordert eine bestimmte Datenzuordnung, die in der folgenden Tabelle aufgeführt ist. Die DDI-Spalte gibt den Typ des DDE-Wertes an, wie er in der DDI verfügbar ist.
XSD |
Datenwörterbuch |
DDI (Datentyp des Instanzwertes) |
xs:element des Typs „Composite“ |
DDE des Typs COMPOSITE |
java.util.Map |
xs:element, wobei maxOccurs > 1 |
DDE des Typs COLLECTION Ein DDE-Knoten wird neben dem COLLECTION-DDE erstellt, das Informationen aus dem übergeordneten COLLECTION-Knoten erfasst. Derselbe Knoten wird für die Collection der Simple-/Composite-Datentypen erstellt. Wenn Sie eine COLLECTION des Typs „Composite“ haben, erfasst die Baumstruktur des Datenwörterbuchs die einzelnen Felder in den untergeordneten Elementen des DDE, die zum Erfassen von Typinformationen erstellt wurden. - DDE (COLLECTION) - DDE(COMPOSITE für Typinfo) - DDE(STRING) field1 - DDE(STRING) field2 |
java.util.List |
Attribut des Typs „xs:ID“ |
DDE des Typs STRING |
java.lang.String |
xs:attribute/xs:element des Typs „xs:string“ | DDE des Typs STRING |
java.lang.String |
xs:attribute/xs:element des Typs „xs: boolean“ |
DDE des Typs „Boolean“ |
java.lang.Boolean |
xs:attribute/xs:element des Typs „xs:date“ | DDE des Typs DATE | java.lang.String |
xs:attribute/xs:element des Typs „xs:integer“ | DDE des Typs NUMBER | java.lang.Double |
xs:attribute/xs:element des Typs „xs:long“ | DDE des Typs NUMBER | java.lang.Double |
xs:attribute/xs:element des Typs „xs:double“ | DDE des Typs NUMBER | java.lang.Double |
Element des Typs „Enum“ und „baseType“ – xs: String | DDE des Typs - STRING subtype - ENUM valueSet - der zulässige Wert für ENUM |
java.lang.String |
Nachdem Sie ein Datenwörterbuch erstellt haben, können Sie es in eine XML-Beispieldatendatei herunterladen, um darin Texteinträge vorzunehmen.
Tippen Sie auf der Seite „Datenwörterbücher“ auf Auswählen und tippen Sie dann auf ein Datenwörterbuch, um es auszuwählen.
Wählen Sie XML-Beispieldaten herunterladen.
Tippen Sie bei der Warnmeldung auf OK.
Correspondence Management erstellt eine XML-Datei, die auf der ausgewählten Datenwörterbuchstruktur basiert und lädt sie auf Ihren Computer mit dem Namen <data-dictionary-name>-SampleData. Jetzt können Sie diese Datei in einem XML- oder einem Texteditor bearbeiten, um beim Erstellen eines Briefs Dateneinträge vorzunehmen.
Wenn Sie denselben Brief in unterschiedlichen Sprachen senden möchten, können Sie den Anzeigenamen, die Beschreibung und die Enum-Wertesätze des Datenwörterbuchs und der Datenwörterbuchelemente lokalisieren.
Tippen Sie auf der Seite „Datenwörterbücher“ auf Auswählen und tippen Sie dann zum Auswählen auf ein Datenwörterbuch.
Tippen Sie auf Lokalisierungsdaten herunterladen.
Tippen Sie bei der Warnmeldung auf OK. Correspondence Management lädt eine ZIP-Datei auf Ihrem Computer mit dem Namen DataDictionary-<DDname>.zip herunter.
Die ZIP-Datei enthält eine Datei des Typs „.properties“. Diese Datei definiert das heruntergeladene Datenwörterbuch. Der Inhalt dieser Datei ist ähnliche wie folgender Inhalt:
#Wed May 20 16:06:23 BST 2015
DataDictionary.EmployeeDD.description=
DataDictionary.EmployeeDD.displayName=EmployeeDataDictionary
DataDictionaryElement.name.description=
DataDictionaryElement.name.displayName=name
DataDictionaryElement.person.description=
DataDictionaryElement.person.displayName=person
In der Struktur der Eigenschaftendatei definiert jeweils eine Zeile die Beschreibung und den Anzeigenamen des Datenwörterbuchs sowie jedes Datenwörterbuchelement im Datenwörterbuch. Darüber wird in der Eigenschaftendatei in jeweils einer Zeile ein Enum-Wertesatz für jedes Datenwörterbuchelement definiert. Wie ein Datenwörterbuch kann auch die entsprechende Eigenschaftendatei über mehrere Datenwörterbuch-Elementdefinitionen verfügen. Darüber hinaus kann die Datei die Definitionen für einen oder mehrere Enum-Wertesätze enthalten.
Um die .properties-Datei in einem anderen Gebietsschema zu aktualisieren, aktualisieren Sie die Anzeigenamen- und Beschreibungswerte in der Datei. Erstellen Sie weitere Instanzen der Datei für jede Sprache, die Sie lokalisieren wollen. Nur Französisch, Deutsch, Japanisch und Englisch werden unterstützt.
Speichern Sie die verschiedenen aktualisierten Eigenschaftsdateien unter den folgenden Namen:
_fr_FR.properties Französisch
_de_DE.properties Deutsch
_ja_JA.properties Japanisch
_en_EN.properties Englisch
Archivieren Sie die .properties-Datei (oder bei mehreren Gebietsschemas die Dateien) in einer einzelnen ZIP-Datei.
Wählen Sie auf der Seite „Datenwörterbuch“ Mehr > Lokalisierungsdaten hochladen und wählen Sie die ZIP-Datei mit lokalisierten Eigenschaftendateien.
Um die durch die Lokalisierung vorgenommenen Änderungen anzuzeigen, ändern Sie das Gebietsschemas des Browsers.
Der Datenwörterbucheditor erzwingt folgende Überprüfungen beim Erstellen oder Aktualisieren eines Datenwörterbuchs.
Überprüfungen, die auf Datenwörterbuchebene angewendet werden
Überprüfungen, die auf Datenwörterbuchelementebene angewendet werden.
Sie können ein Datenwörterbuch aus einem XML-Schema erstellen oder es mithilfe der Datenwörterbuch-Benutzeroberfläche erstellen. Alle Datenwörterbuchelemente innerhalb eines Datenwörterbuchs verfügen über ein XML-Bindungsfeld, um die Bindung des DDE an ein Element im XML-Schema zu speichern. Die Bindung in jedem DDE ist relativ zum übergeordneten DDE.
Im Folgenden sind Beispielmodelle und Codebeispiele aufgelistet, die Implementierungsdetails für das Datenwörterbuch zeigen.
Ein Primitive-DDE stellt ein Feld oder ein Attribut dar, das atomisch ist. Primitive-DDEs, die außerhalb eines komplexen Typs (Composite-DDE) definiert werden, oder wiederholte Elemente (Collection-DDE) können an einem beliebigen Speicherort im XML-Schema gespeichert werden. Der Speicherort der Daten, die einem Primitive-DDE entsprechen, hängt nicht von der Zuordnung seines übergeordneten DDE ab. Ein Primitive-DDE verwendet Zuordnungsinformationen aus dem XML-Bindungsfeld, um seinen Wert zu bestimmen, und die Zuordnungen können eins der Folgenden sein:
Das nachstehende Beispiel zeigt ein einfaches Schema.
<?xml version="1.0" encoding="UTF-8"?>
<xs:schema xmlns:xs="https://www.w3.org/2001/XMLSchema">
<xs:element name='age' type='integer'/>
<xs:element name='price' type='decimal'/>
</xs:schema>
Datenwörterbuchelement | XML-Standardbindung |
---|---|
age | /age |
price | /price |
Bindung wird nicht für Composite-Elemente unterstützt. Wenn Bindung bereitgestellt wird, wird sie ignoriert. Die Bindung für alle untergeordneten DDEs des Primitive-Typs muss absolut sein. Die Zulassung absoluter Zuordnung für untergeordnete Elemente eines Composite-DDE bietet mehr Flexibilität hinsichtlich der XPath-Bindung. Die Zuordnung eines Composite-DDE zu einem komplexen Elementtyp im XML-Schema schränkt den Bereich der Bindung für die untergeordneten Elemente ein.
Im folgenden Beispiel wird das Schema für eine Anmerkung gezeigt.
<xs:element name="note">
<xs:complexType>
<xs:sequence>
<xs:element name="to" type="xs:string"/>
<xs:element name="from" type="xs:string"/>
<xs:element name="heading" type="xs:string"/>
<xs:element name="body" type="xs:string"/>
</xs:sequence>
</xs:complexType>
</xs:element>
Datenwörterbuchelement | XML-Standardbindung |
Hinweis | empty(null) |
in | /note/to |
von | /note/from |
heading | /note/heading |
body | /note/body |
Ein Collection-Element wird nur einem anderen Collection-Element zugeordnet, das eine Kardinalität von > 1 aufweist. Die untergeordneten DDEs eines Collection-DDE verfügen über relative (lokale) XML-Bindung in Bezug auf ihre übergeordnete XML-Bindung. Da die untergeordneten DDEs eines Collection-Elements dieselbe Kardinalität wie die übergeordneten Elemente aufweisen müssen, ist die relative Bindung vorgeschrieben, um sicherzustellen, dass die Kardinalitätseinschränkungen derart sind, dass die untergeordneten DDEs nicht auf ein nicht wiederholtes XML-Schemaelement verweisen. Im nachfolgenden Beispiel muss die Kardinalität von „TokenID“ dieselbe sein wie „Token“, die die übergeordnete Collection DDE ist.
Beim Zuordnen eines Collection DDE zu einem XML-Schema muss Folgendes beachtet werden:
Die Bindung für das DDE, das dem Collection-Element entspricht, muss der absolute XPfad sein
Es darf keine Bindung für das DDE, das den Typ des Collection-Elements darstellt, bereitgestellt werden. Wenn eine Bindung bereitgestellt wird, wird sie ignoriert.
Die Bindung für alle untergeordneten DDEs muss relativ zum übergeordneten Collection-Element sein.
Im folgenden XML-Schema wird ein Element mit dem Namen „Tokens“ und ein Attribut „maxOccurs“ mit „unbounded“ gezeigt. Daher ist „Tokens“ ein Collection-Element.
<?xml version="1.0" encoding="utf-8"?>
<Root>
<Tokens>
<TokenID>string</TokenID>
<TokenText>
<TextHeading>string</TextHeading>
<TextBody>string</TextBody>
</TokenText>
</Tokens>
<Tokens>
<TokenID>string</TokenID>
<TokenText>
<TextHeading>string</TextHeading>
<TextBody>string</TextBody>
</TokenText>
</Tokens>
<Tokens>
<TokenID>string</TokenID>
<TokenText>
<TextHeading>string</TextHeading>
<TextBody>string</TextBody>
</TokenText>
</Tokens>
</Root>
Die mit diesem Beispiel verknüpfte „Token.xsd“, lautet wie folgt:
<xs:element name="Root">
<xs:complexType>
<xs:sequence>
<xs:element name="Tokens" type="TokenType" maxOccurs="unbounded"/>
</xs:sequence>
</xs:complexType>
</xs:element>
<xs:complexType name="TokenType">
<xs:sequence>
<xs:element name="TokenID" type="xs:string"/>
<xs:element name="TokenText">
<xs:complexType>
<xs:sequence>
<xs:element name="TextHeading" type="xs:string"/>
<xs:element name="TextBody" type="xs:string"/>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:sequence>
</xs:complexType>
Datenwörterbuchelement | XML-Standardbindung |
---|---|
Root | empty(null) |
Tokens | /Root/Tokens |
Composite | empty(null) |
TokenID | TokenID |
TokenText | empty(null) |
TokenHeading | TokenText/TextHeading |
TokenBody | TokenText/TextBody |