Versionen im Vergleich

Alte Version 7

changes.mady.by.user Ackermann, Uta

Gespeichert am

verglichen mit

Neue Version 8

changes.mady.by.user Ackermann, Uta

Gespeichert am

Schlüssel

  • Diese Zeile wurde hinzugefügt.
  • Diese Zeile wurde entfernt.
  • Formatierung wurde geändert.



Dies ist die Die ursprüngliche xepicur Dokumentation . Bei dieser ist die aktuelle Umsetzung beim Ingest in den URN-Service nicht berücksichtigt.wird ergänzt mit den Hinweisen, welche Elemente aktuell und in Zukunft tatsächlich ausgewertet werden.

 Die ergänzte und kommentierte Referenzbeschreibung finden Sie hier.

Inhalt
indent12px

 

Generelle Hinweise

...

Für Datensätze zur Administration von URNs ist 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

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"

Bezeichnungepicurwird ausgewertet
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"

...

Bezeichnungadministrative_datawird ausgewertet
Attributekeine 
Unterelemente
  • "delivery"
 
Wiederholbarnein 
Obligatorischja 
Beschreibung

Das 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" 

 data> <delivery>  <authorization>   <personid>   <urnsnid>  </authorization> </delivery><
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"

nicht nicht mehr nicht mehr
Bezeichnungupdate_statuswird  wird zukünftig nicht mehr 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 aktuell noch ausgewertet
  • "urn_new_version"
wird nicht mehr ausgewertet.
  • "urn_alternative"
wird nicht mehr ausgewertet.
  • "url_update"
wird nicht mehr aktuell 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 aktuell noch ausgewertet.
  • "url_insert"
    Dieses Attribut wird gesetzt, wenn eine neue URL hinzugefügt (im Sinne eines URL-Nachmeldeprozesses) werden soll.
wird aktuell noch 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 

...

Beispiel "administrative_data"

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

Elementgruppe "record"

Element "record"

...