Quelltext der Seite kuniweb:Dokumentation des LIDO-Exportformats für kuniweb

<div style="float:right;">__TOC__</div>

'''!!! Die Beschreibung befindet sich im Aufbau !!!'''

Zum Verlinken dieser Seite folgende URL verwenden: [http://hdl.handle.net/428894.vzg/4fd5051b-d2a4-47a6-9656-bc1c342d0df4 http://hdl.handle.net/428894.vzg/4fd5051b-d2a4-47a6-9656-bc1c342d0df4]

Diese Seite beschreibt das LIDO-Exportformat aus der Datenbank [https://www.gbv.de/Verbundzentrale/serviceangebote/kuniweb kuniweb] für museale Sammlungsobjekte. Es basiert auf [http://network.icom.museum/cidoc/working-groups/data-harvesting-and-interchange/what-is-lido/ LIDO]. Im folgenden werden die verwendeten Elemente und über das Format hinausgehende Pflichtelemente und Abhängigkeiten beschrieben.

Die Beschreibung der Elemente und Attribute wird durch Beispiele veranschaulicht deren Werte teilweise konstruiert sind. Beispielcode kann zur besseren Lesbarkeit auch innerhalb von Werten zusätzliche Zeilenumbrüche und Einrückungen enthalten.

Die Metadaten in kuniweb sind grundsätzlich in deutsch. Kuniweb unterstützt in der Erfassung in einigen Feldern Mehrsprachigkeit. Bei den entsprechenden LIDO-Elementen wird in dieser Dokumentation explizit auf die Verwendung des Attributs xml:lang hingewiesen. Darüber hinaus enthält das kuniweb-LIDO an verschiedenen  Stellen englische Begriffe, die beim beim Export automatisch generiert werden (z. B. Typisierungen). Diese nicht vom Erfasser eingegebenen Begriffe werden in dieser Dokumentation nicht explizit erwähnt, sind aber in den Beispielen enthalten.


'''Legende'''

Ein Element ist auf die folgende Art beschrieben:

: '''Bezeichnung des Elements'''
: <hr />
: [[#symbole|Symbol(e)]] | '''Vorkommen'''

: Informationen zum Element, ggf. zu seinen Attributen.

:: '''<span style="letter-spacing: 2px;">Attribute</span>'''<br/>
:: <hr style="width: 550px; margin-top: -2px;">
::: '''Bezeichnung des Attributs'''
::: [[#symbole|Symbol(e)]]
::: Informationen zum Attribut, ggf. zu seinem(n) Wert(en)


'''Symbole'''

Für einen schnellen Überblick sind einige Eigenschaften von Elementen und Attributen durch Symbole gekennzeichnet.

[[File:p.png|Pflichtelement / Pflichtattribut: Elemente, Attribute und Werte mit diesem Symbol sind für die Aufnahme des Digitalisats im Portal zwingend erforderlich.]] '''''Pflichtelement / Pflichtattribut'''''<br />
Elemente, Attribute und Werte mit diesem Symbol sind in jedem Datensatz vorhanden.<br />
Zum Beispiel:
* Das Element ''lidoRecID'' mit dem Attribut ''type''.

[[File:pg.png|Pflichtelement im übergeordneten Element / Pflichtattribut im übergeordneten Element : Elemente, Attribute und Werte mit diesem Symbol sind zwingend erforderlich wenn das übergeordnete Element verwendet wird.]] '''''Pflichtelement im übergeordneten Element / Pflichtattribut im übergeordneten Element '''''<br />
Elemente und Attribute mit diesem Symbol sind zwingend erforderlich wenn das übergeordnete Element verwendet wird.<br />
Zum Beispiel:
* Die Angabe des Elements ''objectDescriptionSet'' ist bei der Verwendung des übergeordneten Elements ''objectDescriptionWrap'' zwingend erforderlich.

[[File:w.png|Wiederholbar: Dieses Element ist wiederholbar.]] '''''Wiederholbar'''''<br />
Dieses Element ist wiederholbar.<br />
Zum Beispiel:
* Wiederholung des Elements ''subjectSet'', falls ein Objekt von mehrere Schlagwörter beschrieben wird.

== lidoRecID ==
[[File:p.png|Pflichtelement / Pflichtattribut]] <span style="vertical-align:middle;">| '''1'''</span>

Dieses Element enthält den Identifier für den Datensatz. Er setzt sich aus den folgenden Elementen zusammen: 

* Präfix "record_"
* String "_kuniweb_"
* ID des Datensatzes in kuniweb (eine Zahl)

: '''<span style="letter-spacing: 2px;">Attribut</span>'''<br/>
: <hr style="width: 550px; margin-top: -2px;">
:: '''type'''
:: [[File:p.png|Pflichtelement / Pflichtattribut]]
:: Spezifiziert den Inhalt des Elements ''lidoRecID''. Die Angabe des ''type'' ist zwingend erforderlich und enthält immer folgenden Wert:
::: '''http://terminology.lido-schema.org/identifier_type/local_identifier'''
:::: local

'''Beispiele'''
<syntaxhighlight lang="xml"><lido:lidoRecID lido:type="http://terminology.lido-schema.org/identifier_type/local_identifier">
   record_kuniweb_123456
</lido:lidoRecID></syntaxhighlight>


<syntaxhighlight lang="xml"><lido:lidoRecID lido:type="http://terminology.lido-schema.org/identifier_type/local_identifier">
   record_kuniweb_654321
</lido:lidoRecID></syntaxhighlight>

== objectPublishedID ==
[[File:p.png|Pflichtelement / Pflichtattribut]] <span style="vertical-align:middle;">| '''2'''</span>

Dieses Element enthält sowohl den Objekt-Identifier als auch den Handle jeweils in Form einer URL. Jeder Datensatz verfügt über einen Objekt-Identifier und ein Handle.

: '''<span style="letter-spacing: 2px;">Attribut</span>'''<br/>
: <hr style="width: 550px; margin-top: -2px;">
:: '''type'''
:: [[File:p.png|Pflichtelement / Pflichtattribut]]
:: Spezifiziert den Inhalt des Elements ''objectPublishedID ''. Die Angabe des ''type'' ist zwingend erforderlich und enthält immer folgenden Wert:
::: '''http://terminology.lido-schema.org/identifier_type/uri'''
:::: uri

'''Beispiele'''
<syntaxhighlight lang="xml"><lido:objectPublishedID lido:type="http://terminology.lido-schema.org/identifier_type/uri">
   http://%URL%/id/record_kuniweb_123456
</lido:objectPublishedID>
<lido:objectPublishedID lido:type="http://terminology.lido-schema.org/identifier_type/uri">
   http://hdl.handle.net/428894.vzg/550e8400-e29b-11d4-a716-446655440000
</lido:objectPublishedID></syntaxhighlight>

== category ==
[[File:p.png|Pflichtelement / Pflichtattribut]] <span style="vertical-align:middle;">| '''1'''</span>

Bestimmt grob die "Kategorie" des Objekts aus den CIDOC-CRM concept definitions. Das Element ist für alle Datensätze gleich aufgebaut. Der Inhalt von ''category'' wird nicht direkt in kuniweb erfasst sondern beim Export von anderen kontrollierten Pflichtangaben abgeleitet.

=== conceptID ===
[[File:p.png|Pflichtelement / Pflichtattribut]] <span style="vertical-align:middle;">| '''1'''</span>

Enthält die URI des CIDOC-CRM concept. Folgende Werte sind möglich

* http://www.cidoc-crm.org/crm-concepts/#E22
* http://www.cidoc-crm.org/crm-concepts/#E20
* http://www.cidoc-crm.org/crm-concepts/#E19

: '''<span style="letter-spacing: 2px;">Attribut</span>'''<br/>
: <hr style="width: 550px; margin-top: -2px;">
:: '''type'''
:: [[File:p.png|Pflichtelement / Pflichtattribut]]
:: Spezifiziert den Inhalt des Elements ''conceptID''. Die Angabe des ''type'' ist zwingend erforderlich und enthält immer folgenden Wert:
::: '''http://terminology.lido-schema.org/identifier_type/uri'''
:::: uri

=== term ===
[[File:p.png|Pflichtelement / Pflichtattribut]] <span style="vertical-align:middle;">| '''1'''</span>

Enthält die textliche Bezeichnung des CIDOC-CRM concept. Für Objekte aus sind folgende Werte möglich:

* Man-Made Object
* Biological Object
* Physical Object


'''Beispiele'''
<syntaxhighlight lang="xml"><lido:category>
   <lido:conceptID lido:type="http://terminology.lido-schema.org/identifier_type/uri">
      http://www.cidoc-crm.org/crm-concepts/#E22
   </lido:conceptID>
   <lido:term xml:lang="en">Man-Made Object</lido:term>
</lido:category></syntaxhighlight>


<syntaxhighlight lang="xml"><lido:category>
   <lido:conceptID lido:type="http://terminology.lido-schema.org/identifier_type/uri">
      http://www.cidoc-crm.org/crm-concepts/#E20
   </lido:conceptID>
   <lido:term xml:lang="en">Biological Object</lido:term>
</lido:category></syntaxhighlight>

== descriptiveMetadata ==
[[File:p.png|Pflichtelement / Pflichtattribut]] <span style="vertical-align:middle;">| '''1'''</span>

Dieses Element enthält die beschreibenden Metadaten zu einem Objekt. Zur besseren Übersicht werden die Unterlemente auf einer eigenen Seite beschrieben

* [[kuniweb:Kuniweb Export Format LIDO - descriptiveMetadata|descriptiveMetadata]]

== administrativeMetadata ==
[[File:p.png|Pflichtelement / Pflichtattribut]] <span style="vertical-align:middle;">| '''1'''</span>

Dieses Element enthält administrative Metadaten zum Objekt. Zur besseren Übersicht werden die Unterlemente auf einer eigenen Seite beschrieben

* [[kuniweb:Kuniweb Export Format LIDO - administrativeMetadata|administrativeMetadata]]