Nachrichtenmodell konfigurieren

In diesem Abschnitt wird die Konfiguration des Nachrichtenmodells erläutert; der Abschnitt umfasst folgende Unterabschnitte:

Eigenschaften der Nachrichtendefinition 'Address' konfigurieren

Einige Objekte (beispielsweise Elemente) haben sowohl Eigenschaften, die ihnen als eigenständige Objekte zugeordnet sind, als auch Eigenschaften, die ihnen als Mitglieder eines anderen Objekts (wie beispielsweise Typ oder Gruppe) zugeordnet sind. In diesem Thema sind diese Eigenschaften in zwei Tabellen aufgeführt:

In den Tabellen sind nur die Eigenschaften aufgeführt, die in diesem Beispiel festgelegt wurden. Es stehen zahlreiche weitere Eigenschaften zur Verfügung, in diesem Beispiel wurden jedoch für die meisten Eigenschaften die Standardwerte übernommen.

Eigenschaften von Objekten als eigenständige Objekte konfigurieren

Wenn Sie die Eigenschaften der Objekte als eigenständige Objekte (wie beispielsweise Elemente) konfigurieren möchten, müssen Sie die Eigenschaften wie in der unten stehenden Tabelle angegeben festlegen:

  1. Wechseln Sie in die Perspektive 'Brokeranwendungsentwicklung'.
  2. Klicken Sie in der Ansicht 'Ressourcennavigator' doppelt auf Address.mxsd, um diese Ressource zu öffnen.
  3. Erweitern Sie in der Entwurfsansicht die Ordner, bis Sie das gewünschte Objekt sehen, und klicken Sie darauf, um es zu markieren. Im Fall von ANONYM müssten Sie beispielsweise auf folgende Einträge klicken: Elemente und Attribute > Address > ANONYM.
  4. Klicken Sie im Nachrichtendefinitionseditor auf die Registerkarte Eigenschaften.
  5. Suchen Sie in der Eigenschaftenhierarchie die zu konfigurierenden Eigenschaften. Wenn Sie beispielsweise die TDS-Eigenschaften für ANONYM konfigurieren möchten, klicken Sie auf Physische Eigenschaften > TDS1 > Komplexer Typ. Wenn Sie die Eigenschaften eines lokalen Elements, globalen Elements, eines Elementverweises oder eines Gruppenverweises konfigurieren möchten, klicken Sie auf Physische Eigenschaften > TDS1 > Lokales Element/Globales Element/Elementverweis/Gruppenverweis.
  6. Definieren Sie die Eigenschaften wie in der Tabelle unten angegeben.
    Objekt Logische Eigenschaften CWF-Eigenschaften XML-Eigenschaften TDS-Eigenschaften
    Town        
    Street        
    HouseNo        
    ANONYM Zusammensetzung = Elemente in angegebener Folge     Trennzeichen für Datenelemente = Mit Kennung/mit Begrenzer
    Gruppenanzeiger = [
    Gruppenbegrenzer = ]
    Begrenzer = :
    Trennzeichen für Kennung/Daten = *

Als Zusammensetzung für ANONYMOUS wird Elemente in angegebener Folge gesetzt, da die Elemente eine bestimmte Reihenfolge haben müssen. Sie können 'Zusammensetzung' auch auf Folge setzen. Wird Elemente in angegebener Folge für 'Zusammensetzung' angegeben, werden die Elemente in der richtigen Reihenfolge angezeigt; sie können nicht dupliziert werden. Wird als 'Zusammensetzung' dagegen Folge angegeben, haben die Elemente zwar auch die korrekte Reihenfolge, sie können aber dupliziert werden. Ein dupliziertes Element ist ein Element, das mehr als einmal innerhalb des komplexen Typs vorkommt.

Für die anderen logischen Eigenschaften von ANONYM werden die jeweiligen Standardwerte übernommen. Die Standardeinstellung für 'Inhaltsauswertung' ist Geschlossen, d. h. der komplexe Typ ANONYMOUS kann nur Elemente enthalten, die ihm zugehörig sind. Wurde 'Inhaltsauswertung' auf Offen gesetzt, kann dieser komplexe Typ beliebige Elemente, nicht nur die in dieser Nachrichtengruppe definierten Elemente, enthalten.

'Trennzeichen für Datenelemente' wird auf Mit Kennung/Begrenzer gesetzt, um verschiedene Arten der Trennung von Datenelementen zu demonstrieren. Wenn Sie weitere Informationen zu den verschiedenen Einstellungen für die Trennzeichen von Datenelementen aufrufen möchten, klicken Sie auf die Links am Ende dieses Themas.

Eigenschaften von Objekten als Mitglieder anderer Objekte konfigurieren

Wenn Sie die Eigenschaften der Objekte als Mitglieder anderer Objekte (wie beispielsweise Typen oder Gruppen) konfigurieren möchten, müssen Sie die Eigenschaften wie in der unten stehenden Tabelle angegeben festlegen:

  1. Wechseln Sie in die Perspektive 'Brokeranwendungsentwicklung'.
  2. Klicken Sie in der Ansicht 'Ressourcennavigator' doppelt auf Address.mxsd, um diese Ressource zu öffnen.
  3. Erweitern Sie in der Entwurfsansicht die Navigationsstruktur, bis Sie das gewünschte Objekt sehen, und klicken Sie darauf, um es zu markieren. Wählen Sie in der Baumstruktur das Objekt unterhalb des Objekts aus, zu dem es gehört. Im Fall von 'Town' müssten Sie beispielsweise auf folgende Einträge klicken: Elemente und Attribute > Address > ANONYM > Town.
  4. Klicken Sie im Nachrichtendefinitionseditor auf die Registerkarte Eigenschaften.
  5. Suchen Sie in der Eigenschaftenhierarchie die zu konfigurierenden Eigenschaften. Wenn Sie beispielsweise die TDS-Eigenschaften für 'Town' konfigurieren möchten, klicken Sie auf Physische Eigenschaften > TDS1 > Lokales Element.
  6. Definieren Sie die Eigenschaften wie in der Tabelle unten angegeben:
    Objekt Mitglied von Logische Eigenschaften CWF-Eigenschaften XML-Eigenschaften TDS-Eigenschaften
    Town Address > ANONYM   Längenzähler = 20    
    Street Address > ANONYM   Längenzähler = 20    
    HouseNo Address > ANONYM   Längenzähler = 4
    Physischer Typ = Extern dezimal
    Markierungsfeld 'Mit Vorzeichen' = nicht ausgewählt
    Zeichenfolgeausrichtung = Linksbündig ausrichten
    Auffüllzeichen = SPACE
       
    ANONYM Address        

 

Eigenschaften der Nachrichtendefinition 'Borrowed' konfigurieren

Einige Objekte (beispielsweise Elemente) verfügen über zwei Gruppen von Eigenschaften, nämlich einmal Eigenschaften, die den Objekten als eigenständige Objekte zugeordnet sind, und zum andern Eigenschaften, die Objekten als Mitglieder anderer Objekte (beispielweise Typ oder Gruppe) zugeordnet sind. In diesem Thema sind diese Eigenschaften in zwei Tabellen aufgeführt:

In den Tabellen sind nur die Eigenschaften aufgeführt, die in diesem Beispiel festgelegt wurden. Es stehen noch zahlreiche weitere Eigenschaften zur Verfügung, doch für die meisten wird in diesem Beispielprogramm der Standardwert übernommen.

Eigenschaften von Objekten als eigenständige Objekte konfigurieren

Um die Eigenschaften der Objekte als eigenständige Objekte (beispielsweise Elemente) zu konfigurieren, müssen Sie die Eigenschaften wie in der Tabelle unten setzen. Gehen Sie wie im vorherigen Abschnitt ('Eigenschaften der Nachrichtendefinition 'Address'') beschrieben vor.

Objekt Logische Eigenschaften CWF-Eigenschaften XML-Eigenschaften TDS-Eigenschaften
VideoTitle        
DueDate        
Cost        
ANONYM    

 

Trennzeichen für Datenelemente = Alle Elemente mit Begrenzer
Gruppenanzeiger = [
Gruppenbegrenzer = ]
Begrenzer = +

Für ANONYM müssen Sie keine logischen Eigenschaften setzen, da für diese die jeweiligen Standardwerte übernommen werden. 'Trennzeichen für Datenelemente' wird auf Alle Elemente mit Begrenzer gesetzt, um verschiedene Arten der Trennung von Datenelementen zu demonstrieren. Klicken Sie auf die Links am Ende dieses Abschnitts, wenn Sie etwas über die Unterschieden zwischen Alle Elemente mit Begrenzer und Mit Kennung/Begrenzer erfahren möchten.

Eigenschaften von Objekten als Mitglieder anderer Objekte konfigurieren

Um die Eigenschaften der Objekte als Mitglieder anderer Objekte (beispielsweise Typen oder Gruppen) zu konfigurieren, müssen Sie die Eigenschaften wie in der Tabelle unten setzen. Gehen Sie wie im vorherigen Abschnitt ('Eigenschaften der Nachrichtendefinition 'Address'') beschrieben vor.

Objekt Mitglied von Logische Eigenschaften CWF-Eigenschaften XML-Eigenschaften TDS-Eigenschaften
VideoTitle Borrowed > Anonym   Längenzähler = 20 Wiedergabe = XMLAttribute  
DueDate Borrowed > Anonym   Längenzähler = 10
Datums-/Zeitformat = jjjj-MM-tt
  Datums-/Zeitformat = jjjj-MM-tt
Cost Borrowed > Anonym   Längenzähler = 4    
ANONYM Borrowed        

Die Wiedergabeoption für 'VideoTitle' ist auf XMLAttribute gesetzt, um verschiedene Arten der Konfiguration des Nachrichtenmodells zu demonstrieren. Die Erstellung von 'VideoTitle' als Element und dessen Wiedergabe als Attribut stellt lediglich eine von mehreren Arten dar, wie das Objekt konfiguriert werden kann. VideoTitle kann auf jede der folgenden Arten konfiguriert werden:

Bei den letzten beiden Optionen wird 'VideoTitle' in der Nachricht genau in derselben Form angezeigt. D. h., durch die Konfiguration des Objekts als Attribut oder als Element, das als Attribut wiedergegeben wird, erzielen Sie genau dasselbe Ergebnis. Die Wiedergabeoptionen können beispielsweise verwendet werden, wenn Sie nach der Objekterstellung ein Element in ein Attribut (oder umgekehrt) ändern müssen. Es gibt jedoch noch andere Gründe, die für die Verwendung von Wiedergabeoptionen sprechen. Aus geschäftlichen Gründen kann es beispielsweise sinnvoll sein, mehrere Elemente mit demselben Namen zu erstellen, und diesen anschließend mit den Wiedergabeoptionen verschiedene IDs zuzuweisen.

Eigenschaften der Nachrichtendefinition 'Customer' konfigurieren

Einige Objekte (beispielsweise Elemente) verfügen über zwei Gruppen von Eigenschaften, nämlich einmal Eigenschaften, die den Objekten als eigenständige Objekte zugeordnet sind, und zum andern Eigenschaften, die Objekten als Mitglieder anderer Objekte (beispielweise Typ oder Gruppe) zugeordnet sind. In diesem Thema sind diese Eigenschaften in zwei Tabellen aufgeführt:

In den Tabellen sind nur die Eigenschaften aufgeführt, die in diesem Beispiel festgelegt wurden. Es stehen noch zahlreiche weitere Eigenschaften zur Verfügung, doch für die meisten wird in diesem Beispielprogramm der Standardwert übernommen. Wenn Sie weitere Informationen hierzu aufrufen möchten, klicken Sie auf die Links am Ende dieses Themas.

Eigenschaften von Objekten als eigenständige Objekte konfigurieren

Um die Eigenschaften der Objekte als eigenständige Objekte (beispielsweise Elemente) zu konfigurieren, müssen Sie die Eigenschaften wie in der Tabelle unten setzen. Gehen Sie wie im vorherigen Abschnitt ('Eigenschaften der Nachrichtendefinition 'Address'') beschrieben vor.

Objekt Logische Eigenschaften CWF-Eigenschaften XML-Eigenschaften TDS-Eigenschaften
FirstName (Vorname)       Tag = FirstName
LastName (Nachname)       Tag = LastName
Title       Tag = Title
NameType Zusammensetzung = Elemente in angegebener Folge
Inhaltsauswertung = Offen
   

Trennzeichen für Datenelemente = Mit Kennung/mit Begrenzer
Gruppenanzeiger = [
Gruppenbegrenzer = ]
Begrenzer = *
Trennzeichen für Kennung/Daten = :

ID       Tag = ID
CreditCardNo (Kreditkarten-Nr.)       Tag = CreditCardNo
DrivingLicenseNo (Führerschein-Nr.)       Tag = DrivingLicenseNo
PassportNo (Reisepass-Nr.)       Tag = PassportNo
IdGroup Zusammensetzung = Auswahl
Inhaltsauswertung = Geschlossen
    Trennzeichen für Datenelemente = Mit Kennung/mit Begrenzer
Begrenzer = &
Trennzeichen für Kennung/Daten = :
brw:Borrowed        
Magazine       Tag = Magazine
CustomerType Zusammensetzung = Folge
Inhaltsauswertung = Offen
    Trennzeichen für Datenelemente = Mit Kennung/mit Begrenzer
Gruppenanzeiger = {
Gruppenbegrenzer = }
Begrenzer = &
Trennzeichen für Kennung/Daten = :

Wird die Inhaltsauswertung von NameType auf Offen gesetzt, sind keine duplizierten Elemente, wohl aber andere, nicht in diesem Typ definierte Elemente erlaubt. Ein dupliziertes Element ist ein Element, das mehr als einmal innerhalb des komplexen Typs vorkommt. Die Inhaltsauswertung für NameType wurde auf Offen gesetzt, um eine weitere Option der Inhaltsauswertung zu veranschaulichen.

Als Zusammensetzung für 'NameType' wird Elemente in angegebener Folge gesetzt, da die Elemente eine bestimmte Reihenfolge haben müssen. Sie können 'Zusammensetzung' auch auf Folge setzen. Der Standardwert für die Zusammensetzung ist Folge und wird beispielsweise für 'CustomerType' verwendet. Wird Elemente in angegebener Folge für 'Zusammensetzung' angegeben, werden die Elemente in der richtigen Reihenfolge angezeigt; sie können nicht dupliziert werden. Wird als 'Zusammensetzung' dagegen Folge angegeben, haben die Elemente zwar auch die korrekte Reihenfolge, sie können aber dupliziert werden.

Wird die Zusammensetzung von 'IdGroup' auf Auswahl gesetzt, kann bei der Eröffnung eines Kundenkontos im Video-Laden nur 'PassportNo', 'DrivingLicenseNo' oder 'CreditCardNo' als Ausweisart angegeben werden. Wird die Inhaltsauswertung auf Geschlossen gesetzt, kann nur eine dieser drei Optionen gewählt werden. Wurde die Inhaltsauswertung dagegen auf Offen/Definiert gesetzt, können auch andere, in Ihrer Nachrichtengruppe definierte Elemente ausgewählt werden.

Wenn Sie weitere Informationen zu diesem Thema aufrufen möchten, klicken Sie auf die Links am Ende dieses Themas.

Eigenschaften von Objekten als Mitglieder anderer Objekte konfigurieren

Um die Eigenschaften der Objekte als Mitglieder anderer Objekte (beispielsweise Typen oder Gruppen) zu konfigurieren, müssen Sie die Eigenschaften wie in der Tabelle unten setzen. Sie müssen in der Nachrichtendefinitionsdatei Customer.mxsd alle Konfigurationsschritte ausführen, die in der unten stehenden Tabelle aufgeführt sind. Denken Sie daran, dass Sie das Objekt unterhalb des Objekts auswählen müssen, zu dem es gehört. Gehen Sie wie im vorherigen Abschnitt ('Eigenschaften der Nachrichtendefinition 'Address'') beschrieben vor.

Objekt Mitglied von Logische Eigenschaften CWF-Eigenschaften XML-Eigenschaften TDS-Eigenschaften
FirstName (Vorname) NameType   Längenzähler = 20 Wiederholungszähler = 1    
LastName (Nachname) NameType   Längenzähler = 20 Wiedergabe = XMLAttribute  
Title NameType   Längenzähler = 3 Wiederholungszähler = 1    
NameType Customer        
ID CustomerType   Längenzähler = 1
Wiederholungszähler = 1
   
CreditCardNo (Kreditkarten-Nr.) IdGroup Mindestanzahl = 0 Längenzähler = 20  

 

DrivingLicenseNo (Führerschein-Nr.) IdGroup Mindestanzahl = 0 Längenzähler = 20    
PassportNo (Reisepass-Nr.) IdGroup Mindestanzahl = 0 Längenzähler = 20    
IdGroup          
brw: Borrowed CustomerType Mindestanzahl = 0
Maximale Anzahl = 3
Wiederholungszähler = 2   Begrenzer für Wiederholelemente = *
Magazine CustomerType Mindestanzahl = 0      
CustomerType          

Die Wiedergabeoption für 'LastName' ist auf XMLAttribute gesetzt, um verschiedene Arten der Konfiguration des Nachrichtenmodells zu demonstrieren. Dies gilt auch für 'VideoTitle' im vorherigen Abschnitt (Eigenschaften der Nachrichtendefinition 'Borrowed' konfigurieren.

Für das Objekt 'brw:Borrowed' ist der Wiederholungszähler für CWF auf 2 gesetzt, um die Anzahl der ausgeliehenen Videos widerzuspiegeln (wie in der Eingabenachricht angegeben). Da in den XML- und TDS-Formaten Begrenzungs-Tags verwendet werden, um anzugeben, an welcher Stelle die einzelnen Wiederholungen beginnen und aufhören, müssen Sie für XML und TDS keinen Wiederholungszähler angeben. Wenn Sie nicht im Voraus wissen, wie oft sich ein Wiederholungselement wiederholen wird, müssen Sie ein zusätzliches Integer-Feld im Nachrichtenmodell einfügen, dieses unter Verwendung von ESQL dynamisch mit der Anzahl der Wiederholungen füllen, 'Wiederholungszähler' in Wiederholungsverweis ändern und einen Verweis auf den Wert dieses Integer-Felds erstellen.

Die Booleschen Werte für 'Magazine' konfigurieren

Da dem Element 'Magazine' der Typ 'Boolesch' zugeordnet ist, müssen Sie auch die Booleschen Werte konfigurieren, die in der gesamten Nachrichtengruppe verwendet werden. Gehen Sie folgendermaßen vor, um die Booleschen Werte zu setzen:

  1. Wechseln Sie in die Perspektive 'Brokeranwendungsentwicklung'.
  2. Klicken Sie in der Ansicht 'Ressourcennavigator' doppelt auf messageSet.mset. Diese Datei enthält die Standardwerte, die in der gesamten Nachrichtengruppe verwendet werden.
  3. Klicken Sie in der Ansicht 'Nachrichtengruppeneditor' unter 'Physische Eigenschaften' auf CWF1.
  4. Setzen Sie die Booleschen Werte unter der Booleschen Wertedarstellung 'Binär' wie in der folgenden Tabelle angegeben.
    Eigenschaft Wert
    Boolescher Wert TRUE 31
    Boolescher Wert FALSE 30
    Boolescher Nullwert 00

 

Symbol für die Hauptseite   Zurück zum Beginn des Beispielprogramms