Definieren von Entities
Entities
Unabhängig davon, ob Ihr Dokument auf einer DTD oder einem XML-Schema basiert, können Sie für die Verwendung in der Authentic-Ansicht Entities definieren. Diese Entities werden anschließend in der Entities-Eingabehilfe und im Kontextmenü-Untermenü von Entity einfügen angezeigt. Wenn Sie in der Entities-Eingabehilfe auf eine Entity doppelklicken, wird diese an der Cursorposition eingefügt.
Eine Entity eignet sich v.a. dann, wenn Sie einen Textstring, ein XML-Fragment oder einige andere externe Ressourcen an mehreren Stellen in Ihrem Dokument verwenden möchten. Die Entity, bei der es sich im Grunde um eine Kurzbezeichnung für die benötigten Daten handelt, wird im Dialogfeld "Entities definieren" definiert. Nachdem Sie die Entity definiert haben, können Sie diese an mehreren Stellen in Ihrem Dokument verwenden und dadurch Zeit sparen und effizienter arbeiten.
Entity-Arten
Sie können in Ihrem Dokument zwei grundlegende Arten von Entities verwenden: geparste Entities, wobei es sich um XML-Daten handelt (entweder einen Textstring oder ein Fragment aus einem XML-Dokument) oder ungeparste Entities, wobei es sich um nicht-XML-Daten handelt wie z.B. eine Binärdatei (normalerweise eine Grafik, Ton oder ein Multimedia-Objekt). Jede Entity hat einen Namen und einen Wert. Im Fall von geparsten Entities ist die Entity ein Platzhalter für die XML-Daten. Der Wert der Entity sind entweder die XML-Daten selbst oder eine URI, die auf eine .xml-Datei verweist, die die XML-Daten enthält. Bei ungeparsten Entities ist der Wert der Entity eine URI, die auf eine nicht-XML-Datei verweist.
Definieren von Entities
So definieren Sie eine Entity:
| 1. | Klicken Sie auf Authentic | XML-Entities definieren. Daraufhin wird das Dialogfeld "Entities definieren" geöffnet. (Abbildung unten) |
| 2. | Geben Sie den Namen Ihrer Entity im Feld "Name" ein. Dies ist der Name, der in der Entities-Eingabehilfe angezeigt werden wird. |
| 3. | Wählen Sie den Typ der Entity aus der Dropdown-Liste im Feld "Type" aus. Es stehen die folgenden Typen zur Auswahl. Eine interne (internal) Entity ist eine Entity, für die der zu verwendende Text im XML-Dokument selbst gespeichert ist. Wenn Sie PUBLIC oder SYSTEM auswählen, wird angegeben, dass sich die Ressource außerhalb der XML-Datei befindet und mittels eines "Public Identifier" oder eines "System Identifier" gefunden wird. Ein System Identifier ist eine URI, die den Pfad der Ressource definiert. Ein Public Identifier ist ein pfadunabhängiger Identifier, der es manchen Prozessoren ermöglicht, die Ressource zu identifizieren. Wenn Sie sowohl einen Public als auch einen System Identifier angeben, wird der Public Identifier zum System Identifier aufgelöst und es wird der System Identifier verwendet. |
| 4. | Wenn Sie als Type PUBLIC ausgewählt haben, geben Sie den Public Identifier der Ressource im Feld PUBLIC ein. Wenn Sie Internal oder SYSTEM als Type ausgewählt haben, ist das Feld PUBLIC deaktiviert. |
| 5. | Im Feld "Value/Path" haben Sie folgende Eingabemöglichkeiten: |
•Wenn die Entity "Internal" ist, geben Sie den Textstring ein, der als Wert der Entity verwendet werden soll. Setzen Sie den Textstring nicht in Anführungszeichen. Alle Anführungszeichen werden als Teil des Textstrings behandelt.
•Wenn der Entity-Typ SYSTEM ist, geben Sie die URI der Ressource ein oder wählen Sie mit Hilfe der Durchsuchen-Schaltfläche eine Ressource auf Ihrem lokalen Netzwerk aus. Wenn die Ressource geparste Daten enthält, muss es sich um eine XML-Datei handeln (d.h. die Datei muss die Erweiterung .xml haben). Als Alternative dazu kann die Ressource eine Binärdatei sein, z.B. eine GIF-Datei.
•Wenn der Entity-Typ PUBLIC ist, müssen Sie zusätzlich einen System Identifier in dieses Feld eingeben.
| 6. | Der Eintrag NDATA sagt dem Prozessor, dass diese Entity nicht geparst, sondern an den entsprechenden Prozessor gesendet werden soll. Das Feld "NDATA" muss daher einen Wert enthalten, der angibt, dass es sich um eine ungeparste Entity handelt. |
Dialogfeldfunktionen
Im Dialogfeld "Entities definieren" können Sie Folgendes tun:
•Entities anhängen
•Entities einfügen
•Entities löschen
•Entities spaltenweise alphabetisch sortieren, indem Sie auf die entsprechende Spaltenüberschrift klicken; bei einem einmaligen Klick wird aufsteigend sortiert, bei zweimaligem Klick absteigend
•die Größe des Dialogfelds und die Spaltenbreite anpassen.
•Sperren. Sobald eine Entity im XML-Dokument verwendet wird, ist sie gesperrt und kann im Dialogfeld "Entities definieren" nicht bearbeitet werden. Gesperrte Entities werden durch das Schlosssymbol in der ersten Spalte gekennzeichnet. Durch das Sperren einer Entity wird sichergestellt, dass das Dokument in Bezug auf Entities gültig ist. (Das Dokument wäre ungültig, wenn eine Entity referenziert aber nicht definiert ist.)
•Doppelt vorhandene Entities werden markiert.
Einschränkungen für Entities
•Eine Entity innerhalb einer anderen Entity wird nicht aufgelöst - weder im Dialogfeld, noch in der Authentic-Ansicht, noch in der XSLT-Ausgabe, und das kaufmännische Und-Zeichen einer derartigen Entity wird in seiner Escape-Form, also & angezeigt.
•Externe ungeparste Entities, bei denen es sich nicht um Bilddateien handelt, werden in der Authentic-Ansicht nicht aufgelöst. Wenn für ein Bild im Design definiert ist, dass eine externe ungeparste Entity gelesen werden soll und wenn als URI ein Entity-Name (z.B. 'logo') definiert ist, so kann dieser Entity-Name im Dialogfeld "Entities definieren" (siehe Abbildung oben) als externe ungeparste Entity mit einem Wert, der zur URI der Bilddatei aufgelöst wird (wie diese für die Entity logo in der Abbildung oben geschehen ist), definiert werden.