Grundlegendes zum Baustein „Data Dictionary“

Im Bereich „Datenwörterbücher“ können Sie Datenwörterbücher erstellen und verwalten. In diesem Bereich ist es möglich, bereits vorhandene Datenwörterbücher zu erstellen oder zu bearbeiten, indem Sie den Datenwörterbucheditor durch die Option „Neu“ oder „Bearbeiten“ starten.

Grafik in Originalgröße anzeigen

Bereich „Datenwörterbücher“

Der Datenwörterbucheditor wird zum Verwalten von Datenwörterbüchern und den zugehörigen Elementen verwendet. Ein Middleware-Entwickler kann Metadateneigenschaften sowohl für das Datenwörterbuch als auch dessen Elemente mithilfe des Datenwörterbucheditors erstellen, ändern und löschen.

Grafik in Originalgröße anzeigen

Datenwörterbucheditor

Der Datenwörterbucheditor erzwingt Überprüfungen beim Erstellen oder Aktualisieren eines Datenwörterbuchs. Weitere Informationen zu Regeln zum Erstellen von DDEs für ein gültiges Schema finden Sie unter Elemente eines Datenwörterbuchs.

Grafik in Originalgröße anzeigen

Elemente eines Datenwörterbuchs

Der Datenwörterbucheditor ermöglicht den Eigentümern eines Geschäftsprozesses Datenwörterbücher zu erstellen, indem diese aus einem gültigen XML-Schema oder einem FML-Modell importiert werden. Eigentümer von Geschäftsprozessen können ihre Datenwörterbücher auch in eine FML exportieren oder XML-Beispieldaten aus dem Datenwörterbucheditor generieren.

Wenn der Middleware-Entwickler versucht, ein Schema mit mehreren Elementen der obersten Ebene zu importieren, wird er vom Datenwörterbucheditor aufgefordert, ein einzelnes Element der obersten Ebene zu importieren. Der Entwickler wählt eines der Elemente der obersten Ebene für die Erstellung einer Baumstruktur des Datenwörterbuchs aus. Das Datenwörterbuch stellt eine zusammenhängende Instanz von Daten für einen gegebenen Kontext anstatt eines Satzes von unzusammenhängenden Daten dar. Eine XSD mit vielen Elementen stellt mehrere Baumstrukturen von Elementen dar, wobei jede Struktur ein unabhängiger Datensatz ist. Ein Datenwörterbuch wird über eine derartige Baumstruktur erstellt. Dabei ist das Importieren von mit Anmerkungen versehener FML-Dateien mit mehreren Entitäten der obersten Ebene nicht möglich. Geben Sie den Namen, Verweisnamen und Elementtyp für ein Datenwörterbuch/DDE ein, da dies erforderliche Parameter sind. Ein übergeordnetes DDE (Composite) darf nicht zwei untergeordnete DDE mit demselben Namen haben.

Der Datenwörterbucheditor-Definitionsbereich ist die Benutzeroberfläche zum Erstellen von DDEs, die in einer Baumstruktur angezeigt werden. Im Bereich Datenwörterbuchstruktur wird die Liste der DDEs angezeigt. Im Bereich Feld- und Variablenliste wird die Liste der Eigenschaften des ausgewählten DDE angezeigt. Ein Datenelement kann auch eingegeben werden, indem mit der rechten Maustaste auf das Element geklickt wird.

Grafik in Originalgröße anzeigen

Bereich „Datenelemente“

Das folgende Diagramm zeigt die End-to-End-Datenwörterbuchdefinition. Es beinhaltet den Integrationsprozess einschließlich der involvierten Benutzer, verwendeten Tools, Metadatenspeicherung und Zugriff zur Laufzeit.

Grafik in Originalgröße anzeigen

Datenwörterbuchdefinition

1. Der Eigentümer des Geschäftsprozesses kann zur manuellen Erstellung eines Datenwörterbuchs den Datenwörterbucheditor verwenden. Weitere Informationen zur Erstellung des Datenwörterbuchs mit dem Datenwörterbucheditor finden Sie unter Datenwörterbuch erstellen.

2. Der Eigentümer des Geschäftsprozesses kann den Datenwörterbucheditor auch verwenden, um ein Datenwörterbuch durch Importieren eines Schemas zu erstellen.

3. Beim Speichern des Datenwörterbuchs wird die Datenwörterbuchmetadatendefinition im Back-End, d. h. im Inhalts-Repository, gespeichert.

4. Der Eigentümer des Geschäftsprozesses kann das Datenwörterbuch mithilfe des Datenwörterbucheditors in Form eines mit Anmerkungen versehenen FML-Modells exportieren. Dieses mit Anmerkungen versehene Modell kann dann importiert werden, um ein Datenwörterbuch zu erstellen.

5. Ein Entwickler kann die Domäne-XSD zum Erstellen des Datenwörterbuchs und der Artefakte wie Formulare für die Anwendung verwenden. Designer kann zum Importieren einer XSD und zum Erstellen von relevanten Formularen daraus verwendet werden.

6. Der Lösungsentwickler erstellt die Lösung hinsichtlich der Artefakte wie Formulare, die von der Anwendung erforderlich sind, entsprechende Java-Klassen, Flex-Komponenten usw.

7. Der Lösungsentwickler führt sie in einem Archiv zusammen, das bereitgestellt werden kann. Die Lösung wird dann bereitgestellt. Die Lösung kann mithilfe der Funktion zum Generieren von XML-Daten des Beispieldatenwörterbuchs, die über den Datenwörterbucheditor bereitgestellt wird, getestet werden.

8. Die bereitgestellte Kundenlösung greift auf die Datenwörterbuchmetadaten und -laufzeit zu, um die Abläufe durchzuführen. Beispielsweise greift eine Dokumentcomposeranwendung auf ein Briefdatenwörterbuch zu, um die erforderlichen Felder zu rendern.

9. Die Datenwörterbuchlaufzeit greift auf die Datenwörterbuchmetadaten zu, um die Datenwörterbuchinstanzen (DDI) zu erstellen. Weitere Informationen zur Datenwörterbuchlaufzeit finden Sie unter Workflow der Datenwörterbuchlaufzeit.

10. Die Datenwörterbuchlaufzeit integriert nicht direkt mit älteren Back-End-Systemen.

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:

• ein Attribut

• ein Element

• ein Textkontext

• nichts (ein ignoriertes DDE)

Das nachstehende Beispiel zeigt ein einfaches Schema.

<?xml version="1.0" encoding="UTF-8"?> 
<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema"> 
  <xs:element name='age' type='integer'/> 
  <xs:element name='price' type='decimal'/> 
</xs:schema>

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

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.

Im folgenden XML-Schema wird ein Element mit den 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> 

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

Im folgenden Beispiel wird das Schema für ein Unternehmen gezeigt.

<?xml version="1.0" encoding="utf-8"?> 
<xs:schema xmlns="DCT" targetNamespace="DCT" xmlns:xs="http://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>

Das folgende Codebeispiel zeigt den FML-Export eines Datenwörterbuchs eines Unternehmens, wobei die Datenwörterbuchanmerkungen die DDS-Anmerkungen verwenden. Dieses Beispiel enthält außerdem zwei Anmerkungsgruppen: „Allgemein“ und „XmlBinding“. Die Beschreibung und XPath sind zwei entsprechende Anmerkungen, die als Teil dieser zwei Anmerkungsgruppen erfasst werden.

<model xmlns="http://ns.adobe.com/Fiber/1.0"> 
  <annotation name="DDS"> 
    <item name="name">Company</item> 
    <item name="displayName">Company</item> 
    <item name="version">1.0</item> 
    <item name="type">NONSYSTEM</item> 
    <item name="extended_k1">v1</item> 
    <item name="extended_k2">v2</item> 
  </annotation> 
  <annotation name="General"> 
    <item name="description"/> 
  </annotation> 
  <entity name="Company"> 
    <annotation name="DDS"> 
      <item name="setAsTopLevelWithName">Company</item> 
      <item name="displayName">Company</item> 
      <item name="extended_k3">v3</item> 
      <item name="extended_k4">v4</item> 
    </annotation> 
    <annotation name="General"> 
      <item name="description"/> 
    </annotation> 
    <annotation name="XMLBinding"> 
      <item name="xpath">/Company</item> 
    </annotation> 
    <annotation name="LiveCycleES"> 
      <item name="generate_type">true</item> 
    </annotation> 
    <property name="Name" required="true" type="string"> 
      <annotation name="DDS"> 
        <item name="displayName">Name</item> 
      </annotation> 
      <annotation name="General"> 
        <item name="description"/> 
      </annotation> 
      <annotation name="XMLBinding"> 
        <item name="xpath">/Name</item> 
      </annotation> 
    </property> 
    <property name="Type" required="true" type="string"> 
      <annotation name="DDS"> 
        <item name="displayName">Type</item> 
      </annotation> 
      <annotation name="General"> 
        <item name="description"/> 
      </annotation> 
      <annotation name="XMLBinding"> 
        <item name="xpath">/Type</item> 
      </annotation> 
    </property> 
    <property cardinality="one-to-one" name="HeadOfficeAddress" required="true" type="Address"> 
      <annotation name="DDS"> 
        <item name="displayName">HeadOfficeAddress</item> 
      </annotation> 
      <annotation name="General"> 
        <item name="description"/> 
      </annotation> 
      <annotation name="XMLBinding"> 
        <item name="xpath">/HeadOfficeAddress</item> 
      </annotation> 
    </property> 
    <property cardinality="one-to-one" name="SalesOfficeAddress" required="false" type="Address"> 
      <annotation name="DDS"> 
        <item name="displayName">SalesOfficeAddress</item> 
      </annotation> 
      <annotation name="General"> 
        <item name="description"/> 
      </annotation> 
      <annotation name="XMLBinding"> 
        <item name="xpath">/SalesOfficeAddress</item> 
      </annotation> 
    </property> 
    <property name="HeadCount" required="true" type="double"> 
      <annotation name="DDS"> 
        <item name="displayName">HeadCount</item> 
      </annotation> 
      <annotation name="General"> 
        <item name="description"/> 
      </annotation> 
      <annotation name="XMLBinding"> 
        <item name="xpath">/HeadCount</item> 
      </annotation> 
    </property> 
    <property cardinality="one-to-one" name="CEO" required="true" type="Employee"> 
      <annotation name="DDS"> 
        <item name="displayName">CEO</item> 
      </annotation> 
      <annotation name="General"> 
        <item name="description"/> 
      </annotation> 
      <annotation name="XMLBinding"> 
        <item name="xpath">/CEO</item> 
      </annotation> 
    </property> 
    <property cardinality="one-to-many" name="Workers" required="true" type="Employee[]"> 
      <annotation name="DDS"> 
        <item name="displayName">Workers</item> 
      </annotation> 
      <annotation name="General"> 
        <item name="description"/> 
      </annotation> 
      <annotation name="XMLBinding"> 
        <item name="xpath">/Workers</item> 
      </annotation> 
    </property> 
  </entity> 
  <entity name="Address"> 
    <annotation name="LiveCycleES"> 
      <item name="generate_type">true</item> 
    </annotation> 
    <property name="Street" required="true" type="string"> 
      <annotation name="DDS"> 
        <item name="displayName">Street</item> 
      </annotation> 
      <annotation name="General"> 
        <item name="description"/> 
      </annotation> 
      <annotation name="XMLBinding"> 
        <item name="xpath">/Street</item> 
      </annotation> 
    </property> 
    <property name="City" required="true" type="string"> 
      <annotation name="DDS"> 
        <item name="displayName">City</item> 
      </annotation> 
      <annotation name="General"> 
        <item name="description"/> 
      </annotation> 
      <annotation name="XMLBinding"> 
        <item name="xpath">/City</item> 
      </annotation> 
    </property> 
    <property name="State" required="true" type="string"> 
      <annotation name="DDS"> 
        <item name="displayName">State</item> 
      </annotation> 
      <annotation name="General"> 
        <item name="description"/> 
      </annotation> 
      <annotation name="XMLBinding"> 
        <item name="xpath">/State</item> 
      </annotation> 
    </property> 
    <property name="Zip" required="true" type="string"> 
      <annotation name="DDS"> 
        <item name="displayName">Zip</item> 
      </annotation> 
      <annotation name="General"> 
        <item name="description"/> 
      </annotation> 
      <annotation name="XMLBinding"> 
        <item name="xpath">/Zip</item> 
      </annotation> 
    </property> 
  </entity> 
  <entity name="Employee"> 
    <annotation name="LiveCycleES"> 
      <item name="generate_type">true</item> 
    </annotation> 
    <property cardinality="one-to-one" name="PersonName" required="true" type="Name"> 
      <annotation name="DDS"> 
        <item name="displayName">PersonName</item> 
      </annotation> 
      <annotation name="General"> 
        <item name="description"/> 
      </annotation> 
      <annotation name="XMLBinding"> 
        <item name="xpath">/PersonName</item> 
      </annotation> 
    </property> 
    <property name="DOB" required="true" type="string"> 
      <annotation name="DDS"> 
        <item name="displayName">DOB</item> 
      </annotation> 
      <annotation name="General"> 
        <item name="description"/> 
      </annotation> 
      <annotation name="XMLBinding"> 
        <item name="xpath">/DOB</item> 
      </annotation> 
    </property> 
    <property cardinality="one-to-one" name="CurrAddress" required="true" type="Address"> 
      <annotation name="DDS"> 
        <item name="displayName">CurrAddress</item> 
      </annotation> 
      <annotation name="General"> 
        <item name="description"/> 
      </annotation> 
      <annotation name="XMLBinding"> 
        <item name="xpath">/CurrAddress</item> 
      </annotation> 
    </property> 
    <property name="DOJ" required="true" type="date"> 
      <annotation name="DDS"> 
        <item name="displayName">DOJ</item> 
      </annotation> 
      <annotation name="General"> 
        <item name="description"/> 
      </annotation> 
      <annotation name="XMLBinding"> 
        <item name="xpath">/DOJ</item> 
      </annotation> 
    </property> 
    <property name="Phone" required="true" type="double"> 
      <annotation name="DDS"> 
        <item name="displayName">Phone</item> 
      </annotation> 
      <annotation name="General"> 
        <item name="description"/> 
      </annotation> 
      <annotation name="XMLBinding"> 
        <item name="xpath">/Phone</item> 
      </annotation> 
    </property> 
  </entity> 
  <entity name="Name"> 
    <annotation name="LiveCycleES"> 
      <item name="generate_type">true</item> 
    </annotation> 
    <property name="FirstName" required="true" type="string"> 
      <annotation name="DDS"> 
        <item name="displayName">FirstName</item> 
      </annotation> 
      <annotation name="General"> 
        <item name="description"/> 
      </annotation> 
      <annotation name="XMLBinding"> 
        <item name="xpath">/FirstName</item> 
      </annotation> 
    </property> 
    <property name="MiddleName" required="true" type="string"> 
      <annotation name="DDS"> 
        <item name="displayName">MiddleName</item> 
      </annotation> 
      <annotation name="General"> 
        <item name="description"/> 
      </annotation> 
      <annotation name="XMLBinding"> 
        <item name="xpath">/MiddleName</item> 
      </annotation> 
    </property> 
    <property name="LastName" required="true" type="string"> 
      <annotation name="DDS"> 
        <item name="displayName">LastName</item> 
      </annotation> 
      <annotation name="General"> 
        <item name="description"/> 
      </annotation> 
      <annotation name="XMLBinding"> 
        <item name="xpath">/LastName</item> 
      </annotation> 
    </property> 
  </entity> 
</model>

Um dieses Beispiel zu verwenden, fügen Sie adobe-dct-flex-services.swc dem Klassenpfad Ihres Flex-Projekts hinzu.

Rufen Sie die Singleton-Instanz des Datenwörterbuchdienstes auf.

 DataDictionaryUtilServiceImpl ddUtilService = DataDictionaryUtilServiceImpl.getInstance();

Starten Sie den Datenwörterbuch-Util-Dienst und übergeben Sie die Datenwörterbuch-ID als Parameter, um ein Datenwörterbuch als mit Anmerkungen versehene FML zu exportieren.

/** 
 *  Exporting Data Dictionary 
 */ 
private function exportAsFML(event:*):void 
{ 
  var ddId:String = //The id of an existing data dictionary. 
  ddUtilService.exportDataDictionaryAsFML(ddId, handleSuccess, handleFault); 
} 
/* Success Handler */ 
private function handleSuccess(event:DCTServiceEvent):void 
{ 
   var ddFML:String = event.data as String;         
} 
/* Fault Handler */ 
private function handleFaultevent:FaultEvent):void 
{ 
   trace("Error exporting DataDictionary"+ (event.message as ErrorMessage).faultCode );                  
}