Sie zeigen eine alte Version dieser Seite an. Zeigen Sie die aktuelle Version an.

Unterschiede anzeigen Seitenhistorie anzeigen

« Vorherige Version anzeigen Version 7 Nächste Version anzeigen »

Dies ist die ursprüngliche xepicur Dokumentation. Bei dieser ist die aktuelle Umsetzung beim Ingest in den URN-Service nicht berücksichtigt.

Die ergänzte und kommentierte Referenzbeschreibung finden Sie hier.

 

Generelle Hinweise

Gültigkeit:

Für Datensätze zur Administration von URNs ist xepicur zukünftig nur mehr für die Übertragungsart OAI-PMH verbindlich.

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

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"

Bezeichnungepicur
Attributekeine
Unterelemente
  • "administrative_data"
  • "record"
Wiederholbarnein
Obligatorischja
BeschreibungDas Wurzelelement bildet die äußere Einheit eines XML-Dokumentes.
Syntax<epicur>
<administrative_data>
[...] </administrative_data>
<record> [...]
</record>
< /epicur>

Elementgruppe "administrative_data"

 Element "administrative_data"

Bezeichnungadministrative_data
Attributekeine
Unterelemente
  • "delivery"
Wiederholbarnein
Obligatorischja
BeschreibungDas Element dient der Kapselung von Legitimationsdaten, der Spezifizierung des URN-Meldeprozesses, der verwendeten Transferschnittstelle sowie der Art der Rückmeldung.
Syntax<administrativ_data>
 <delivery>
  [...]
 </delivery>
< /administrative_data>

 Element "authorization" 

Bezeichnungauthorizationwird nicht mehr ausgewertet. Bitte nicht mehr verwenden
Attributekeine 

Unterelemente

  • "person_id"
    Legitimations_ID einer Person.
  • "system_id"
    Alternative zu "person_id". Es kann eine ID sein, die nur in Zusammenhang mit maschinengesteuerter URN-Meldung erfolgt.

  • "urn_nid"

    Das Element beinhaltet den URN-Unternamensraum wie z. B. "urn:nbn:de".

  • "urn_snid"
    Das Element beinhaltet den NBN-Unternamensraum wie z. B. urn:nbn:de:gbv:089. Das Ziel ist das Ermitteln von Berechtigungen zur Administration des URN-Unternamensraumes.
 
Wiederholbarnein 
Obligatorischnein 
BeschreibungDie 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> <delivery>  <authorization>   <person_id>F6000123</person_id>   <urn_snid>urn:nbn:de:089</urn_snid>  </authorization> </delivery></administrative_data> 

Element "update_status"

Bezeichnungupdate_statuswird  nicht ausgewertet, da es aber obligatorisch ist, bitte mit beliebigem Attribut verwenden.
Attribute

"type" mit folgenden Inhalten:

  • "urn_new"
    Kennzeichnung der Meldung als "URN-Erstregistrierung". Bei Einbindung in OAI muss bei Neuerstellung von Records "urn_new" angegeben werden.
wird nicht ausgewertet
  • "urn_new_version"
wird nicht mehr ausgewertet.
  • "urn_alternative"
wird nicht mehr ausgewertet.
  • "url_update"
wird nicht mehr ausgewertet.
  • "url_update_general"
    Aktualisierung von URLs. Dieses Attribut muss angegeben, wenn der Record nur "neue" URLs beinhaltet. Es werden alle registrierten URLs gelöscht und mit den "neuen" URLs ersetzt.
wird nicht mehr ausgewertet.
  • "url_delete"
    Dieses Attribut wird gesetzt, wenn eine URL gelöscht werden soll.
wird nicht mehr ausgewertet.
  • "url_insert"
    Dieses Attribut wird gesetzt, wenn eine neue URL hinzugefügt (im Sinne eines URL-Nachmeldeprozesses) werden soll.
wird nicht mehr ausgewertet.
Unterelementekeine 
Wiederholbarnein 
Obligatorischja 
BeschreibungDas Element dient der Spezifizierung der Art des Meldeprozesses 
Syntax<update_status type="urn_new"/> 

Element "transfer"

Bezeichnungtransferwird nicht mehr ausgewertet. Bitte nicht mehr verwenden
Obligatorischnein 

Element "resupply"

Bezeichnungresupplywird nicht mehr ausgewertet. Bitte nicht mehr verwenden
Obligatorischnein 

Beispiel "administrative_data"

<epicur>
 <administrative_data>  
  <delivery> 
   <update_status type="urn_new"/>
  </delivery>
 </administrative_data>
[...]
<epicur>

Elementgruppe "record"

Element "record"

Bezeichnungrecordwird ausgewertet

Attribute

keine
Unterelemente
  • "identifier"
    Mit dem Element "identifier" werden URN und URL mit unterschiedlichen Attributen erfasst.
wird ausgewertet
 
  • "resource"
    Das Element "resource" mit den Unterelementen "identifier" und "format" dient der Abbildung der Zusammenhänge von URN und URL.
wird ausgewertet
 
  • "isPartOf"
    Das Element "isPartOf" dient der Erfassung von Informationen über URNs und URLs für Teildokumente.

URN und URLs werden registriert, die hierarische Struktur aber ignoriert.

 
  • "isVersionOf"
wird nicht mehr ausgewertet. Bitte nicht mehr verwenden
 
  • "hasVersion"
wird nicht mehr ausgewertet. Bitte nicht mehr verwenden
Wiederholbarja
Obligatorischja
BeschreibungDas Element "record" kapselt URN-URL-Beziehungen der Objekte.
Syntax<record>
  [...]
< /record>

Element "identifier"

Bezeichnungidentifierwird ausgewertet
Attribute    
  • "scheme"

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

Das Attribut zur Spezifizierung der URN kann folgende Werte annehmen:

  "urn"

  "urn:nbn"

  "urn:nbn:de"

  "urn:nbn:at"

  "urn:nbn:ch"

 

und zusätzlich folgende optionale Attribute:		wird ausgewertet
  • "type"
    Das optionale Attribut dient zur Kennzeichnung einer URL als Frontpage-URL (landing page) und hat den Wert
    • "frontpage".
wird zukünftig nicht mehr ausgewertet.
  •  "status"
wird nicht mehr ausgewertet. Bitte nicht mehr verwenden
  • "role"

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:

    •   "primary"
wird ausgewertet
 "origin"wird nicht mehr ausgewertet. Bitte nicht mehr verwenden
"target"wird nicht mehr ausgewertet. Bitte nicht mehr verwenden
Unterelementekeine
Wiederholbarja
Obligatorischja
BeschreibungDas 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"

BezeichnungisVersionOfwird nicht mehr ausgewertet. Bitte nicht mehr verwenden
Obligatorischnein

Element "hasVersion"

BezeichnunghasVersionwird nicht mehr ausgewertet. Bitte nicht mehr verwenden
Obligatorischnein

Element "resource"

Bezeichnungresourcewird ausgewertet
Attributekeine 
Unterelemente
  • "identifier"
    Mit dem Element "identifier" wird die URL des Objektes erfasst. Aus diesem Grund muss das Attribut scheme="url" verwendet werden. (s. Element "identifier")
wird ausgewertet
  • "format"
    Das Element "format" dient der Erfassung des MimeTypes des Objektes.
wird ausgewertet
Wiederholbarja
Obligatorischnein
BeschreibungDas 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"
Bezeichnungformatwird ausgewertet
Attribute

Das Element "format" hat folgendes Attribut:

  "imt", das als Wert den MimeType des Objektes enthält.

 
Unterelementekeine 
Wiederholbarnein 
Obligatorischnein 
Beschreibung Das Element "format" dient der Erfassung des MimeTypes (Dateiformates) eines Objektes.
Syntax<format scheme="imt">  [MimeType des Objektes]</format> 

Element "isPartOf"

BezeichnungisPartOfZukünftig werden URN und URL registriert, die hierarchische Struktur aber wird ignoriert.
Attributekeine
Unterelemente
  • "identifier"
  • "resource"
Wiederholbarja
Obligatorischnein
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>
  • Keine Stichwörter