Die ursprüngliche xepicur Dokumentation wird ergänzt mit den Hinweisen, welche Elemente aktuell und in Zukunft tatsächlich ausgewertet werden.
Generelle Hinweise
Gültigkeit:
Für Datensätze zur Administration von URNs wird xepicur zukünftig nur mehr für die Übertragungsart OAI-PMH verbindlich sein.
Hinweise zu Datenstruktur und Syntax
Für den Datensatz ist als Dokumentformat XML verbindlich.
- Elementtypen
- Der Metadatensatz enthält Datenelemente, die nach Elementtypen differenziert in strukturierter Form angegeben sind. Jedes Datenelement wird durch einen Elementbezeichner (tag) eingeleitet, der den Elementnamen angibt.
Beispiel: <identifier>
- Attribute
- Elementbezeichner werden durch Attribute spezifiziert. Es wurden obligatorische Attribute ("type", "scheme", "imt") und optionale Attribute ("role", "status" oder "type") definiert.
- Beispiel: <identifier scheme="url" role="primary">
Beschreibung des Datenformates, Reihenfolge und Struktur der Elemente
Generelle Struktur
Ein XML-Datensatz besteht aus einem Wurzelelement
<epicur>
und zwei hierarchisch untergeordneten Elementen
<administrative_data>
<record>
Wurzelelement "epciur"
Bezeichnung | epicur | wird ausgewertet |
---|---|---|
Attribute | keine | |
Unterelemente |
| |
Wiederholbar | nein | |
Obligatorisch | ja | |
Beschreibung | Das Wurzelelement bildet die äußere Einheit eines XML-Dokumentes. | |
Syntax | <epicur> <administrative_data> [...] </administrative_data> <record> [...] </record> < /epicur> |
Elementgruppe "administrative_data"
Element "administrative_data"
Bezeichnung | administrative_data | wird zukünftig nicht mehr ausgewertet, da es aber obligatorisch ist, bitte dennoch liefern. |
---|---|---|
Attribute | keine | |
Unterelemente |
| |
Wiederholbar | nein | |
Obligatorisch | ja | |
Beschreibung | Das Element dient der Kapselung von Legitimationsdaten, der Spezifizierung des URN-Meldeprozesses, | |
Syntax | <administrativ_data> <delivery> [...] </delivery> < /administrative_data> |
Element "authorization"
Bezeichnung | authorization | wird nicht mehr ausgewertet. Bitte nicht mehr verwenden |
---|---|---|
Attribute | keine | |
Unterelemente |
| |
Wiederholbar | nein | |
Obligatorisch | nein | |
Beschreibung | Die Informationen dienen der Spezifizierung des URN-Meldeprozesses wie z.B. URN-Erstmeldung oder URL-Aktualisierung, der verwendeten Transferschnittstelle oder der Art der Rückmeldung. | |
Syntax | <administrative_data> |
Element "update_status"
Bezeichnung | update_status | wird zukünftig nicht mehr ausgewertet, da es aber obligatorisch ist, bitte mit beliebigem Attribut verwenden. |
---|---|---|
Attribute | "type" mit folgenden Inhalten: | |
| wird aktuell noch ausgewertet | |
| wird nicht mehr ausgewertet. | |
| wird nicht mehr ausgewertet. | |
| wird aktuell ausgewertet. | |
| wird nicht mehr ausgewertet. | |
| wird aktuell noch ausgewertet. | |
| wird aktuell noch ausgewertet. | |
Unterelemente | keine | |
Wiederholbar | nein | |
Obligatorisch | ja | |
Beschreibung | Das Element dient der Spezifizierung der Art des Meldeprozesses | |
Syntax | <update_status type="urn_new"/> |
Element "transfer"
Bezeichnung | transfer | wird nicht mehr ausgewertet. Bitte nicht mehr verwenden |
---|---|---|
Obligatorisch | nein |
Element "resupply"
Bezeichnung | resupply | wird nicht mehr ausgewertet. Bitte nicht mehr verwenden |
---|---|---|
Obligatorisch | nein |
Beispiel "administrative_data"
<epicur> | |||||
<administrative_data> | |||||
<delivery> | |||||
<update_status type="urn_new"/> | |||||
</delivery> | |||||
</administrative_data> | |||||
[...] | |||||
<epicur> |
Elementgruppe "record"
Element "record"
Bezeichnung | record | wird ausgewertet |
---|---|---|
Attribute | keine | |
Unterelemente |
| wird ausgewertet |
| wird ausgewertet | |
| URN und URLs werden registriert, die hierarische Struktur aber ignoriert. | |
| wird nicht mehr ausgewertet. Bitte nicht mehr verwenden | |
| wird nicht mehr ausgewertet. Bitte nicht mehr verwenden | |
Wiederholbar | ja, aber Bei Einbindung des Schemas in OAI 2.0 ist die Kardinalität des Elements "record" auf 1 begrentzt. | |
Obligatorisch | ja | |
Beschreibung | Das Element "record" kapselt URN-URL-Beziehungen der Objekte. Das Element record ist dem Wurzelelement "epicur" direkt untergeordnet. Es ist wiederholbar, um Sammelmeldungen zu generieren. Dieser Fall kann bei der Implementation des URN-Melde- und Updateprozesses ueber eine separate URN-Schnittstelle eintreten. Bei Einbindung des Schemas in OAI 2.0 ist die Kardinalität des Elements "record" auf 1 begrentzt. | |
Syntax | <record> [...] < /record> |
Element "identifier"
Bezeichnung | identifier | wird ausgewertet |
---|---|---|
Attribute |
Mit dem Attribut "scheme" wird URN bzw. URL des Objektes erfasst. Das Attribut zur Spezifizierung der URN kann folgende Werte annehmen: "urn" "urn:nbn" "urn:nbn:de" "urn:nbn:at" "urn:nbn:ch" Das Attribut zur Spezifizierung der URL hat folgenden obligatorischen Wert: "url" und zusätzlich folgende optionale Attribute: | wird ausgewertet |
| wird zukünftig nicht mehr ausgewertet. | |
| wird nicht mehr ausgewertet. Bitte nicht mehr verwenden | |
Das optionale Attribut kennzeichnet eine URL als "Master-URL", die beim Resolving zuerst ausgewiesen werden soll. Dieser Fall tritt ein, wenn mehr als eine URL zu einer URN registriert ist. Das Attribut hat folgenden Wert:
| wird ausgewertet | |
"origin" | wird nicht mehr ausgewertet. Bitte nicht mehr verwenden | |
"target" | wird nicht mehr ausgewertet. Bitte nicht mehr verwenden | |
Unterelemente | keine | |
Wiederholbar | ja | |
Obligatorisch | ja | |
Beschreibung | Das Element "identifier" enthält Informationen über eine URN und URL. Es wird durch obligatorische sowie mehrere optionale Attribute näher spezifiziert. | |
Syntax (Auswahl) | <identifier scheme="urn:nbn:de"> [...] < /identifier> oder < identifier scheme="url"> [...] < /identifier> oder < identifier scheme="url" type="frontpage" role="primary"> [...] < /identifier> |
Element "isVersionOf"
Bezeichnung | isVersionOf | wird nicht mehr ausgewertet. Bitte nicht mehr verwenden |
---|---|---|
Obligatorisch | nein |
Element "hasVersion"
Bezeichnung | hasVersion | wird nicht mehr ausgewertet. Bitte nicht mehr verwenden |
---|---|---|
Obligatorisch | nein |
Element "resource"
Bezeichnung | resource | wird ausgewertet |
---|---|---|
Attribute | keine | |
Unterelemente |
| wird ausgewertet |
| wird ausgewertet | |
Wiederholbar | ja | |
Obligatorisch | nein | |
Beschreibung | Das Element "resource" kapselt die Unterelemente "identifier" mit dem Attribut scheme="url" und "format" dient der Erfassung der URL und des MimeTypes (Dateiformat) des Objektes. | |
Syntax | <resource> <identifier scheme="url"> [URL des Objektes] </identifier> <format scheme="imt"> [MimeType des Objektes] </format> </resource> |
Element "format"
Bezeichnung | format | wird ausgewertet |
---|---|---|
Attribute | Das Element "format" hat folgendes Attribut: "imt", das als Wert den MimeType des Objektes enthält. | |
Unterelemente | keine | |
Wiederholbar | nein | |
Obligatorisch | nein | |
Beschreibung | Das Element "format" dient der Erfassung des MimeTypes (Dateiformates) eines Objektes | . |
Syntax | <format scheme="imt"> [MimeType des Objektes]</format> |
Element "isPartOf"
Bezeichnung | isPartOf | Zukünftig werden URN und URL registriert, die hierarchische Struktur aber wird ignoriert. |
---|---|---|
Attribute | keine | |
Unterelemente |
| |
Wiederholbar | ja | |
Obligatorisch | nein | |
Beschreibung | Das Element "isPartOf" kapselt Informationen zu URNs und URLs von Teilobjekten. | |
Syntax | <isPartOf> [...]</isPartOf> |
Beispiel "record"
<epicur> | |||||
<administrative_data> [...] | |||||
<update_status type="urn_new"/> | |||||
[...] </administrative_data> | |||||
<record> | |||||
<identifier scheme="urn:nbn:de">urn:nbn:de:gbv:089-3321752945</identifier> | |||||
<resource> | |||||
<identifier scheme="url" type="frontpage">http://edok01.tib.uni-hannover.de/edoks/e01dh01/</identifier> | |||||
<format scheme="imt">text/html</format> | |||||
</resource> | |||||
</record> | |||||
</epicur> |