XML-Mapper

Nach oben zu Grafik-Hilfsprogramme - Index

Tools > XML-Mapper

Verwenden Sie das XML-Mapper, um während des Entwurfs Datenpakete, die von Client-Datenmengen verwendet werden, generischen XML-Dokumenten und umgekehrt zuzuordnen. Jede Zuordnung beschreibt die Entsprechungen zwischen den Knoten eines XML-Dokuments und den Feldern in einem Datenpaket.

Sie können Zuordnungen von einem vorhandenen XML-Schema (oder -Dokument) zu einer Client-Datenmenge, die Sie definieren, von einem vorhandenen Datenpaket zu einem neuen XML-Schema, das Sie definieren, oder zwischen einem vorhandenen XML-Schema und einem vorhandenen Datenpaket definieren.

Seite Dokumentansicht

Diese Seite zeigt den Inhalt des aktuell geladenen XML-Dokuments als hierarchische Baumstruktur. Jeder Knoten der Hierarchie repräsentiert ein Tag oder ein Tag-Attribut in dem XML-Dokument. Neben jedem Knoten befindet sich ein Symbol, das den Typ des Tags angibt.

Element	Beschreibung
	Repräsentiert einen Elementknoten. Das ist ein Tag, das anderen Knoten (Tags) übergeordnet ist, aber keinen Wert besitzt. Der Name des Knotens ist der Tag-Name. Typischerweise werden Elementknoten Datenmengen zugeordnet (dem Datenpaket selbst oder einer verschachtelten Detailmenge), obwohl sie auch Feldern zugeordnet werden können, deren Werte aus den Werten der untergeordneten Knoten zusammengesetzt werden.
	Repräsentiert einen Textknoten. Textknoten repräsentieren getaggte Elemente mit Textwerten. In der Hierarchie haben sie die Form Knotenname="TextWert", wobei Knotenname der Tag-Name und TextWert der Text ist, der zwischen dem öffnenden und dem schließenden Tag steht. Typischerweise werden Textknoten Feldern im Datenpaket zugeordnet.
	Repräsentiert einen Attributknoten. Attributknoten entsprechen den Attributen der Tags des übergeordneten Elements in dem XML-Dokument. In der Hierarchie haben Sie die Form Knotenname="AttributWert", wobei Knotenname der Name des Attributs und AttributWert dessen Wert ist. Typischerweise werden Attributknoten Feldern im Datenpaket zugeordnet, wobei das Element, dem sie als Attribut dienen, einem Datensatz zugeordnet ist.
	Repräsentiert einen verschachtelten Knoten. Verschachtelte Knoten sind Elementknoten, die fortlaufend in einem XML-Dokument wiederholt werden können. Typischerweise werden verschachtelte Knoten Datensätzen im Datenpaket zugeordnet.
Datenansicht	Ist diese Option nicht markiert, werden nur die Namen und Typen der Knoten angezeigt. Es werden für Text- oder Attributknoten keine Werte angezeigt und für jeden verschachtelten Knoten wird nur eine einzelne Instanz angezeigt. Ist diese Option markiert, werden für Text- oder Attributknoten Beispielwerte und Wiederholungen für verschachtelte Knoten angezeigt. Wenn Sie eine XML-Beispieldatei laden, zeigt Datenansicht die in dieser Datei gespeicherten Werte. Wenn das Dokument aus einem Schema oder Datenpaket generiert wurde, werden Beispielwerte für die Knoten erzeugt. Bei großen XML-Dokumenten ist es manchmal einfacher die Option Datenansicht zu deaktivieren, weil ohne die Einzelheiten die logische Struktur deutlicher wird.

Seite Schema-Ansicht

Diese Seite zeigt die XML-Schemainformationen. Die Seite enthält drei Registerkarten, die die verschiedenen vom XML-Zuordnungs-Tool unterstützten Schemaformate repräsentieren. Die Formate sind DTD, XDR (Reduced XMLData) und XSD (XML-Schema). Die Informationen auf der Seite Schema-Ansicht können aus einer Datei eingelesen oder aus der aktuellen XML-Dokument erschlossen werden.

Seite Knoteneigenschaften

Auf dieser Seite können Sie dem im XML-Dokument markierten Knoten Eigenschaften zuweisen. Mit diesen Eigenschaften wird bei der Erzeugung einer Umwandlungsdatei sicher gestellt, dass aus XML-Dokumenten erzeugte Datenpakete die korrekten Feldtypen und aus Datenpaketen erzeugte XML-Dokumente die korrekten Knoten besitzen. Die Umwandlungsdatei enthält die Werte, auf der Seite Knoteneigenschaften aktuell festgelegt sind.

Element	Beschreibung
UTF-8 codiert	Steuert, ob Zeichen des erweiterten Zeichensatzes mit UFT-8 (wenn markiert) oder mit einer Escape-Sequenz (wenn nicht markiert) im XML codiert werden. Wenn die Option markiert ist, ändert sich die Eigenschaft Data Format für Strings, Memos und WideStrings von ANSI in UTF-8.
Benutzerdefinierte Übersetzung	Steuert, ob der markierte Knoten automatisch umgewandelt werden soll. Diese Option ermöglicht Umwandlungen, die über einfache 1:1-Zuordnungen hinausgehen, und für die ein Datentyp angegeben werden kann. Sie können beispielsweise einen benutzerdefinierten Knoten anlegen, um einen Elementknoten mit untergeordneten Knoten für Vorname und Nachname in ein einziges "Namen"-Feld in dem Datenpaket zu konvertieren. Wenn Sie die Option Benutzerdefinierte Übersetzung aktivieren, müssen Sie zur Repräsentation des Knotens einen ID-String zuweisen. Dieser ID-String wird an die Ereignisbehandlungsroutine OnTranslate von TXMLTransform übergeben, damit die Übersetzung im Code durchgeführt werden kann. Wenn ein Knoten nicht als benutzerdefiniert gekennzeichnet wird, wird das Ereignis OnTranslate für diesen Knoten nicht ausgelöst.
Knotenbeschreibung	Optional. Geben Sie eine Beschreibung für den Knoten ein. Diese Beschreibung wird weder dem XML-Dokument noch dem Datenpaket hinzugefügt, erleichtert aber die Identifizierung des Zwecks einer Basiselementmenge, wenn Sie Eigenschaftsmengen in einer Knotenablagedatei speichern.

Tipp: Um die aktuellen Knoteneinstellungen in einer Knotenablagedatei zu speichern, klicken Sie mit der rechten Maustaste und wählen Ablage speichern >. Um die aktuellen Knoteneinstellungen aus einer Knotenablagedatei zu laden, klicken Sie mit der rechten Maustaste und wählen Ablage öffnen >. Um alle auf der Seite Knoteneigenschaften vorgenommenen Änderungen rückgängig zu machen und zu den Werten zurückzukehren, die aus dem XML-Dokument erschlossen wurden, klicken Sie mit der rechten Maustaste und wählen Entfernen.

Seite Zuordnung

Auf dieser Seite lassen sich Zuordnungen zwischen Feldern in dem Datenpaket und Knoten in dem XML-Dokument festlegen, eine Umwandlungsdatei erstellen und speichern.

Im oberen Bereich der Seite wird eine zweispaltige Tabelle angezeigt, die die Knoten aus dem XML-Dokument und die entsprechenden Felder aus dem Datenpaket enthält. Bei der ersten Anzeige der Seite Zuordnung ist die Tabelle leer. Um eine Zuordnung zu definieren, muss die Tabelle gefüllt werden.

Hinweis: Es können nur Knoten mit Werten (Text- und Attributknoten) oder Knoten, die auf der Seite Knoteneigenschaften als benutzerdefiniert gekennzeichnet wurden, hinzugefügt werden.

Seite Felderansicht

Diese Seite zeigt die Feldattribute für alle Felder in dem Datenpaket an. Jeder Knoten in der Hierarchie repräsentiert eine Datenmenge, ein Feld oder ein Feldattribut.

Element	Beschreibung
	Repräsentiert das gesamte Datenpaket oder ein Datenmengenfeld. Die einem Datenmengenknoten untergeordneten Knoten repräsentieren die Felder in dieser Datenmenge.
	Repräsentiert ein Feld, das kein Datenmengenfeld ist. Die einem Feldknoten untergeordneten Knoten repräsentieren die Attribute des Feldes.
	Repräsentiert ein Feldattribut, wie Datentyp, Maximallänge usw. Der Knoten trägt eine Bezeichnung in der Form AttributName=Wert, wobei AttributName der Name des Attributs und Wert dessen Wert ist.

Seite Datenpaketansicht

Diese Seite zeigt die Struktur des Datenpakets an. Die Symbole in dieser Ansicht entsprechen denjenigen in der Dokumentansicht, weil Datenpakete als spezielle Typen von XML-Dokumenten behandelt werden können.

Element	Beschreibung
	Repräsentiert einen Elementknoten. Elementknoten in Datenpaketen repräsentieren Datenmengen oder Datenmengenfelder.
	Repräsentiert einen Attributknoten. Attributknoten in Datenpaketen repräsentieren Felder (keine Datenmengenfelder).
	Repräsentiert einen verschachtelten Knoten. Verschachtelte Knoten in Datenpaketen repräsentieren Datensätze.

Hinweis: Das XML-Zuordnungs-Tool kann sowohl binäre Datenpakete (.cds-Dateien) als auch Datenpakete, die als XML gespeichert wurden, verwenden. Wenn Sie ein Datenpaket im binären Format verwenden, wird es von dem XML-Zuordnungs-Tool in das XML-Format konvertiert.

Siehe auch

• XMLMapper verwenden
• XML in Datenbankanwendungen verwenden