Data Model Project anlegen

So legen Sie ein neues Data Model Project an:

Klicken Sie im X4 Designer in der Sicht Projects mit der rechten Maustaste, und wählen Sie im Kontextmenü den Eintrag New.
Wählen Sie Data Model Project.

Alternativ können Sie im Menü File auf New klicken und Data Model Project auswählen.
Geben Sie im Dialogfenster Project Creation Wizard einen Namen für Ihr Projekt ein.
Wählen Sie Finish.

Data Model Projects haben eine vordefinierte Ordnerstruktur, die beim Anlegen eines neuen Data Model Projects automatisch angelegt wird.

`Entities`	Dieser Ordner ist beim Anlegen eines Projekts leer. Sie können 1 bis n Entitäten hinzufügen. Der automatisch angelegte Ordner Entities kann nicht gelöscht, verschoben oder umbenannt werden.
`<Projekt>.datamodel`	Projektbezogene Datei, die die Definition des Data Models enthält. In dieser Datei legen Sie die Beziehungen zwischen den von Ihnen angelegten Entitäten fest, die im Data Model dargestellt werden. Alle Verknüpfungen, die Sie festlegen, führen zu einer Hierarchie. Wie Sie Entitäten anlegen, erfahren Sie im Abschnitt Entitäten anlegen.

Entitätsbeziehungen in der Design-Ansicht festlegen

Sie können Beziehungen zwischen Entitäten im grafischen Editor in der .datamodel-Datei anlegen. Um den Editor zu öffnen, wählen Sie am unteren Rand des Fensters Entity Relationships die Registerkarte Design.

So legen Sie Beziehungen zwischen Entitäten in der Design-Ansicht fest:

Wählen Sie Add, um eine neue Entitätsbeziehung hinzuzufügen.
Wählen Sie in den Dropdown-Listen From Entity, To Entity und Cardinality die gewünschten Werte für die Ausgangsentität, die Zielentität und die Kardinalität aus.

Die Dropdown-Listen From Entity und To Entity enthalten alle im Projekt verfügbaren Entitäten. Wenn Sie Entitäten im Projekt anlegen oder löschen, werden die Werte in beiden Dropdown-Listen automatisch aktualisiert, ohne dass Sie den Editor schließen müssen.
In der Dropdown-Liste Cardinality können Sie zwischen den Kardinalitätswerten OneToOne, OneToMany und ManyToOne wählen.
Geben Sie im Feld Relation Property die gewünschte Property für die Beziehung zwischen den Entitäten an. Dieses Feld ist ein Freitextfeld.

Beispielhaft kann ein Aufbau von Entitätsbeziehungen wie hier gezeigt aussehen:

Hinweis

Beachten Sie beim Festlegen der Entitätsbeziehungen Folgendes:

Die Werte für From Entity und To Entity dürfen nicht identisch sein.
Die Kombination aus From Entity, To Entity und Relation Property muss eindeutig sein. Es ist nicht zulässig, doppelte Beziehungen anzulegen.
Wenn Sie dieselbe Kombination aus Ausgangsentität und Zielentität verwenden, müssen Sie jeweils eine andere Beziehungseigenschaft im Feld Relation Property angeben.

Wenn Sie eine fehlerhafte Beziehung festlegen, wird eine Fehlermeldung angezeigt, und Sie können Ihr Data Model nicht speichern.

Entitätsbeziehungen in der Source-Ansicht festlegen

Beim Anlegen eines neuen Data Model Projects sieht die Datei <Projekt>.datamodel in der XML-Ansicht, die Sie über die Registerkarte Source am unteren Fensterrand öffnen, wie folgt aus:

CODE

<DataModel xmlns="http://softproject.de/datamodel/1.0">
	<EntityRelationships>
	</EntityRelationships>
</DataModel>

Das Element EntityRelationships kann folgende Elemente enthalten:

OneToOne
OneToMany
ManyToOne

Innerhalb dieser drei Elemente können Sie über folgende Attribute Beziehungen zwischen den Entitäten festlegen:

Attribut	Beschreibung
`entity`	Mit diesem Attribut geben Sie die Ausgangsentität der Verknüpfung an.
`toEntity`	Mit diesem Attribut geben Sie die Zielentität der Verknüpfung an.
`property`	Mit diesem Attribut geben Sie den Namen an, unter dem die in `toEntity` angegebene Entität bei der weiteren Verwendung des Data Models für die `entity` referenziert wird. Sie können z. B. für eine 1:1-Verknüpfung aus Kunde und Adresse als `property` eine Lieferadresse angeben, wie im folgenden Beispiel gezeigt.

Beispiel

CODE

<DataModel xmlns="http://softproject.de/datamodel/1.0">
	<EntityRelationships>
    <OneToOne entity="Customer.entity" toEntity="Address.entity" property="DeliveryAddress"/>
    <OneToMany entity="Customer.entity" toEntity="Order.entity" property="Order"/>
    <ManyToOne entity="Order.entity" toEntity="Customer.entity" property="Customer"/>
	</EntityRelationships>
</DataModel>

Zur Veranschaulichung finden Sie im Folgenden die Abbildung einer OneToOne-Verknüpfung im XML-Format:

CODE

<?xml version="1.0" encoding="UTF-8"?>
<Customer>
 <Name>Doe</Name>
 <Firstname>John</Firstname>
 <DeliveryAddress>
   <City>Exampletown</City>
   <Zip>1234</Zip>
   <Street>Mainstreet</Street>
 </DeliveryAddress>
</Customer>