Mapping für die Transformation

Der https://ub-basel.atlassian.net/wiki/spaces/MEMOBASE/pages/29295472 wird mit einer Konfigurationsdatei konfiguriert. Diese Datei wird im YAML-Serialisierungsformat gespeichert. Dies Datei heisst immer mapping.yml und wird mit den restlichen Konfigurationsdateien dem Importprozess eingefügt.

Feldtypen

Field Type

Example

Remarks

Field Type

Example

Remarks

ConstantField

descriptiveNote: const: "Immer die gleiche Notiz!"

Adds the value “Immer die gleiche Notiz!" to every record as a rico:descriptiveNote.

DirectMapField

descriptiveNote: Notiz descriptiveNote: parentField: Parent field: Field

Adds the value from the field Notiz in the source JSON document to the record as a rico:descriptiveNote.

PrefixField

descriptiveNote: prefix: value: "Notiz: " field: Notiz descriptiveNote: parentField: Parent prefix: value: "Notiz: " field: Notiz

Adds the value from the field Notiz in the source JSON document to the record as a rico:descriptiveNote and adds the value Notiz: at the beginning of the text.

LanguageField

Only de, fr, it are accepted.

For each label of ConstantField, DirectMapField and PrefixField is accepted. However, no list is accepted.

Record

Dies ist der Hauptabschnitt und wird zwingend benötigt.

Field Name

Field Types

List?

Required?

RDF Property

RDF Type

Remarks

Field Name

Field Types

List?

Required?

RDF Property

RDF Type

Remarks

uri

DirectMapField

NO

YES

rico:hasOrHadIdentifier

rico:Identifier

Is used to generate the subject URI of the record and the instantiations and adds the main identifier resource.

See Identifier

type

DirectMapField
ConstantField

NO

YES

rico:type

xsd:string

Values must be one of these:

  • Film

  • Foto

  • Radio

  • Ton

  • Tonbildschau

  • TV

  • Video

scopeAndContent

DirectMapField
PrefixField
ConstantField
LanguageField

YES

NO

rico:scopeAndContent

xsd:string or rdf:langString

 

sameAs

DirectMapField
PrefixField
ConstantField

YES

NO

schema:sameAs

xsd:string

 

abstract

DirectMapField
PrefixField
ConstantField
LanguageField

YES

NO

dct:abstract

xsd:string or rdf:langString

 

source

DirectMapField
PrefixField
ConstantField
LanguageField

YES

NO

rico:source

xsd:string or rdf:langString

 

descriptiveNote

DirectMapField
PrefixField
ConstantField
LanguageField

YES

NO

rico:descriptiveNote

xsd:string or rdf:langString

 

relation

DirectMapField
PrefixField
ConstantField
LanguageField

YES

NO

dct:relation

xsd:string or rdf:langString

 

conditionsOfUse

DirectMapField
PrefixField
ConstantField
LanguageField

YES

NO

rico:conditionsOfUse

xsd:string or rdf:langString

Utility property: Use rights: usage on physical and digital object where possible

conditionsOfAccess

DirectMapField
PrefixField
ConstantField
LanguageField

YES

NO

rico:conditionsOfAccess

xsd:string or rdf:langString

Utility property: Use rights: access on physical and digital object where possible

isSponsoredByMemoriav

boolean

NO

NO

rdau:P60451

IRI Node

Only accepts true or false. False is the default if the field is omitted!

Links to the memoriav corporate body.

creationDate

DirectMapField

NO

NO

dct:created

rico:DateSet

The value is copied to rico:expressedDate inside of the rico:DateSet. Any other date types must be parsed in the normalization steps.

issuedDate

DirectMapField

NO

NO

dct:issued

rico:DateSet

The value is copied to rico:expressedDate inside of the rico:DateSet. Any other date types must be parsed in the normalization steps.

temporal

DirectMapField

NO

NO

dct:temporal

rico:DateSet

The value is copied to rico:expressedDate inside of the rico:DateSet. Any other date types must be parsed in the normalization steps.

rights.holder

DirectMapField
PrefixField
ConstantField
LanguageField

NO

NO

rico:isOrWasRegulatedBy

rico:Rule

 

languages

Language

NO

NO

rico:hasOrHadLanguage

rico:Language

 

subject

Subject

YES

NO

rico:hasOrHadSubject

skos:Concept

 

genre

Subject

YES

NO

ebucore:hasGenre

skos:Concept

 

placeOfCapture

Place

YES

NO

rdau:P60556

rico:Place

 

relatedPlaces

Place

YES

NO

dct:spatial

rico:Place

 

creators

Agent

YES

NO

rico:recordResourceOrInstantiationIsSourceOfCreationRelation

rico:CreationRelation

Adds the agent, person or corporate body as the target of the creation relation

contributors

Agent

YES

NO

rico:recordResourceOrInstantiationIsSourceOfCreationRelation

rico:CreationRelation

Adds the agent, person or corporate body as the target of the creation relation

producers

Agent

YES

NO

rdau:P60441

 

 

relatedAgents

Agent

YES

NO

rico:hasOrHadSubject

 

 

publishedBy

Agent

YES

NO

rico:hasPublisher

 

 

Title Field

Field Name

Field Types

List?

Required?

RDF Property

RDF Type

Remarks

Field Name

Field Types

List?

Required?

RDF Property

RDF Type

Remarks

main

DirectMapField
PrefixField
ConstantField
LanguageField

YES

NO

rico:hasOrHadTitle

rico:Title

 

series

DirectMapField
PrefixField
ConstantField
LanguageField

YES

NO

rico:hasOrHadTitle

rico:Title

 

broadcast

DirectMapField
PrefixField
ConstantField
LanguageField

YES

NO

rico:hasOrHadTitle

rico:Title

 

Identifier Field

Field Name

Field Types

List?

Required?

RDF Property

RDF Type

Remarks

Field Name

Field Types

List?

Required?

RDF Property

RDF Type

Remarks

original

DirectMapField

NO

YES

rico:identifier

xsd:string

 

oldMemobase

DirectMapField
PrefixField
ConstantField

NO

NO

rico:identifier

xsd:string

 

Language Field

Field Name

Field Types

List?

Required?

RDF Property

RDF Type

Remarks

Field Name

Field Types

List?

Required?

RDF Property

RDF Type

Remarks

content

DirectMapField
PrefixField
ConstantField
LanguageField

YES

NO

rico:name

xsd:string or rdf:langString

 

caption

DirectMapField
PrefixField
ConstantField
LanguageField

YES

NO

rico:identifier

xsd:string or rdf:langString

 

Subject Field

Field Name

Field Types

List?

Required?

RDF Property

RDF Type

Remarks

Field Name

Field Types

List?

Required?

RDF Property

RDF Type

Remarks

prefLabel

DirectMapField
PrefixField
ConstantField
LanguageField

YES

NO

skos:prefLabel

xsd:string or rdf:langString

 

Place Field

Field Name

Field Types

List?

Required?

RDF Property

RDF Type

Remarks

Field Name

Field Types

List?

Required?

RDF Property

RDF Type

Remarks

parentField

String

NO

NO

-

-

Use this field if the places are in a subfield on the source JSON Document

name

DirectMapField
PrefixField
ConstantField
LanguageField

YES

YES

rico:name

xsd:string or rdf:langString

 

sameAs

DirectMapField
PrefixField
ConstantField
LanguageField

YES

NO

schema:sameAs

xsd:string

 

coordinates

DirectMapField
PrefixField
ConstantField
LanguageField

YES

NO

wdt:P625

xsd:string

Will be normalized to geo:wktLabel.

Agent Field

For the RDF Property check the parent field in the Record map.

Field Name

Field Types

List?

Required?

RDF Property

RDF Type

Remarks

Field Name

Field Types

List?

Required?

RDF Property

RDF Type

Remarks

person

Agent Data

YES

NO

 

rico:Person

 

corporateBody

Agent Data

YES

NO

 

rico:corporateBody

 

agent

Agent Data

YES

NO

 

rico:Agent

 

Agent Data Field

Field Name

Field Types

List?

Required?

RDF Property

RDF Type

Remarks

Field Name

Field Types

List?

Required?

RDF Property

RDF Type

Remarks

parentField

String

NO

NO

-

-

Use this field if the places are in a subfield on the source JSON Document

name

DirectMapField
PrefixField
ConstantField
LanguageField

YES

YES

rico:name

xsd:string or rdf:langString

 

relationName

DirectMapField
PrefixField
ConstantField
LanguageField

YES

NO

rico:name

xsd:string or rdf:langString

This is added to the rico:CreationRelation resource.

sameAs

DirectMapField
PrefixField
ConstantField

YES

NO

schema:sameAs

xsd:string

 

hasVariantNameOfAgent

DirectMapField
PrefixField
ConstantField
LanguageField

YES

NO

rdau:P60119

xsd:string

 

history

DirectMapField
PrefixField
ConstantField
LanguageField

YES

NO

rico:history

xsd:string or rdf:langString

 

descriptiveNote

DirectMapField
PrefixField
ConstantField
LanguageField

YES

NO

rico:descriptiveNote

xsd:string or rdf:langString

 

gender

DirectMapField
PrefixField
ConstantField

NO

NO

foaf:gender

xsd:string

 

hasProfessionOrOccupation

DirectMapField
PrefixField
ConstantField
LanguageField

YES

NO

rdau:P60468

xsd:string or rdf:langString

 

isMemberOf

DirectMapField
PrefixField
ConstantField
LanguageField

YES

NO

rdau:P60648

xsd:string or rdf:langString

 

hasPeriodOfActivityOfAgent

DirectMapField

YES

NO

rdau:P60076

rico:DateSet

 

hasBirthDate

DirectMapField

NO

NO

rico:hasBirthDate

rico:DateSet

 

hasDeathDate

DirectMapField

NO

NO

rico:hasDeathDate

rico:DateSet

 

Physical Instantiation

The physical instantiation represents the first person

Field: physical

Field Name

Field Types

List?

Required?

RDF Property

RDF Type

Remarks

Field Name

Field Types

List?

Required?

RDF Property

RDF Type

Remarks

descriptiveNote

DirectMapField
PrefixField
ConstantField
LanguageField

YES

NO

rico:descriptiveNote

xsd:string or rdf:langString

 

duration

DirectMapField

NO

NO

ebucore:duration

xsd:string

 

physicalCharacteristics

DirectMapField
PrefixField
ConstantField
LanguageField

YES

NO

rico:physicalCharacteristics

xsd:string or rdf:langString

 

colour

DirectMapField
PrefixField
ConstantField
LanguageField

YES

NO

rdau:P60558

xsd:string or rdf:langString

 

conditionsOfUse

DirectMapField
PrefixField
ConstantField
LanguageField

YES

NO

rico:conditionsOfUse

xsd:string or rdf:langString

Utility property: Use rights: usage where possible

conditionsOfAccess

DirectMapField
PrefixField
ConstantField
LanguageField

YES

NO

rico:conditionsOfAccess

xsd:string or rdf:langString

Utility property: Use rights: access where possible

rights.access

DirectMapField
PrefixField
ConstantField
LanguageField

YES

NO

rico:regulatedBy

rico:Rule

The value is added to the property rico:name. If access is supplied with a list, multiple rules are created.

rights.usage

-

-

NO

rico:regulatedBy

rico:Rule

 

rights.usage.name

DirectMapField
PrefixField
ConstantField
LanguageField

NO

YES

 

rights.usage.sameAs

DirectMapField
PrefixField
ConstantField

NO

NO

 

identifiers.callNumber

DirectMapField
PrefixField
ConstantField

NO

NO

rico:identifiedBy

rico:Identifier

 

carrierType

DirectMapField
PrefixField
ConstantField
LanguageField

YES

NO

rico:hasCarrierType

rico:CarrierType

The carrier type value is written into the field rico:name.

Digital Instantiation

Create a digital instantiation for any digital resource that is part of this record. Should the source document not contain any of the mapped fields, then no digital instantiation is created. Currently only a single digital instantiation can be added to a record.

Field: digital

Field Name

Field Types

List?

Required?

RDF Property

RDF Type

Remarks

Field Name

Field Types

List?

Required?

RDF Property

RDF Type

Remarks

locator

DirectMapField
PrefixField
ConstantField

NO

NO

ebucore:locator

xsd:string

The target URL where the digital object can be found on the internet. Do not set this if the binary is hosted by Memobase. In that case the https://ub-basel.atlassian.net/wiki/spaces/MEMOBASE/pages/83984396/Service%3A+Media-Linker will add a locator to the file.

proxy

DirectMapField
ConstantField

NO

NO

internal:proxy

xsd:string

Values: proxy, proxydirect, redirect or file

Determines the proxy status of the media database. Default value is always assumed proxydirect when this field is missing.

duration

DirectMapField

NO

NO

ebucore:duration

xsd:string

 

descriptiveNote

DirectMapField
PrefixField
ConstantField
LanguageField

YES

NO

rico:descriptiveNote

xsd:string or rdf:langString

conditionsOfUse

DirectMapField
PrefixField
ConstantField
LanguageField

YES

NO

rico:conditionsOfUse

xsd:string or rdf:langString

Utility property: Use rights: usage where possible

conditionsOfAccess

DirectMapField
PrefixField
ConstantField
LanguageField

YES

NO

rico:conditionsOfAccess

xsd:string or rdf:langString

Utility property: Use rights: access where possible

rights.access

DirectMapField
PrefixField
ConstantField
LanguageField

YES

NO

rico:regulatedBy

rico:Rule

The value is added to the property rico:name. If access is supplied with a list, multiple rules are created.

rights.usage

-

-

NO

rico:regulatedBy

rico:Rule

 

rights.usage.name

DirectMapField
PrefixField
ConstantField
LanguageField

NO

YES

rights.usage.sameAs

DirectMapField
PrefixField
ConstantField

NO

NO

Thumbnail Instantiation

The thumbnail instantiation represents any digital resource that is used as a thumbnail and derived from a digital object. This object is only generated if the mapped field for locator exists and has a value.

Field: thumbnail

Field Name

Field Types

List?

Required?

RDF Property

RDF Type

Remarks

Field Name

Field Types

List?

Required?

RDF Property

RDF Type

Remarks

locator

DirectMapField

NO

NO

ebucore:locator

xsd:string

The URL of the thumbnail object for when the thumbnail is hosted by a third party provider.