Data Mapping Term
Open Digital Specimen List of Terms
Data Mapping List of Terms
Title : Data Mapping List of Terms
Date version issued : 2024-10-15
Date created : 2024-10-15
This version : 0.4.0
Latest version : 0.4.0
Abstract
: The Data Mapping Digital Object is created to contain the details necessary for mapping the data from the source system to the openDS data model.
It has space for some general information but its most important content are the two Mapping objects: DefaultMapping and FieldMapping.
The DefaultMapping can be used to set default values for the fields in the openDS data model.
When a value such as the ods:physicalSpecimenIDType
is not present in the dataset as field, a default for the entire dataset can be set in the DefaultMapping.
FieldMapping also impacts the full dataset. Within DiSSCo we try to set sensible defaults for the mapping to the openDS data model.
However, for certain fields in a dataset these sensible default might need to be overruled.
This is possible through the FieldMapping object, for each field in the openDS data model an explicit mapping can be set to a field in the source data.
For example, by default we will try to map the ods:physicalSpecimenID
to the dwc:occurrenceID
field in the source data.
However, sometimes it makes more sense to map the ods:physicalSpecimenID
to the dwc:catalogNumber
field in the source data.
This can be done through the FieldMapping.
The data mapping is decoupled from the Source System so that for institutions with multiple Source Systems, only one Data Mapping object needs to be created.
All Source Systems can then use the same Data Mapping object.
Main contributors : Sam Leeflang, Soulaine Theocharides, Tom Dijkema
Creator : Distributed Infrastructure for Scientific Collections (DiSSCo)
Bibliographic citation : Distributed Infrastructure for Scientific Collections. 2024. Data Mapping List of Terms.
1 Introduction
1.1 Status of the content of this document
The openDS data specification is in active development. This document is work in progres and might change until version 1.0.0 is released. Its main function at the moment is to inform the community about the current state of the data model and to gather feedback. We hope to include the feedback from the community and reach a first major version of the data model by the end of 2024.
1.2 RFC 2119 key words
The key words “MUST”, “MUST NOT”, “REQUIRED”, “SHALL”, “SHALL NOT”, “SHOULD”, “SHOULD NOT”, “RECOMMENDED”, “MAY”, and “OPTIONAL” in this document are to be interpreted as described in BCP 14 RFC 2119 and RFC 8174 when, and only when, they appear in all capitals, as shown here.
2 Borrowed Vocabulary
When terms are borrowed from other vocabularies, openDS uses the IRIs, common abbreviations, and namespace prefixes in use in those vocabularies. The IRIs are normative, but abbreviations and namespace prefixes have no impact except as an aid to reading the documentation.
Table 1. Vocabularies from which terms have been borrowed (non-normative)
Vocabulary | Abbreviation | Namespaces and abbreviations |
---|---|---|
Schema.org | Schema | schema: = https://schema.org/version/latest/schemaorg-current-https.rdf |
Activity Streams | AS | as: = https://www.w3.org/ns/activitystreams# |
3 Namespaces, Prefixes and Term Names
The namespace of terms borrowed from other vocabularies is that of the original. The namespace of de openDS terms is http://rs.dissco.eu/opends/terms/. In the table of terms, each term entry has a row with the term name. This term name is generally an “unqualified name” preceded by a widely accepted prefix designating an abbreviation for the namespace It is RECOMMENDED that implementers who need a namespace prefix for the openDS namespace use ods. In this web document, hovering over a term in the Index By Term Name list below will reveal a complete URL that can be used in other web documents to link to this document’s treatment of that term, even if it is from a borrowed vocabulary.
4 Term index
4.1 Index By Term Name
ods:Agent
ods:DataMapping
ods:Identifier
ods:RelatedPID
ods:TombstoneMetadata
5 Vocabulary
Term Name schema:email | |
---|---|
Qualified Term | schema:email |
Term IRI | http://schema.org/email |
Label | |
Definition | Email of the agent |
Examples |
|
Datatype | string |
Belongs to Class | ods:Agent |
Required | False |
Repeatable | False |
RDF Type | rdf:Property |
Term Name schema:name | |
---|---|
Qualified Term | schema:name |
Term IRI | http://schema.org/name |
Label | Name |
Definition | Full name of the agent |
Examples |
|
Datatype | string |
Belongs to Class | ods:Agent |
Required | False |
Repeatable | False |
RDF Type | rdf:Property |
Term Name schema:identifier | |
---|---|
Qualified Term | schema:identifier |
Term IRI | http://schema.org/identifier |
Label | Identifier |
Definition | The primary unique identifier of the Agent object. All identifiers will also be added to the ods:hasIdentifiers array |
Examples |
|
Datatype | string |
Belongs to Class | ods:Agent |
Required | False |
Repeatable | False |
RDF Type | rdf:Property |
Term Name Agent | |
---|---|
Qualified Term | ods:Agent |
Term IRI | http://rs.dissco.eu/opends/terms/Agent |
Label | Agent |
Definition | A generic agent class, containing information about the actor who performed an activity. This could be a person, an organization or a machine. |
Required | False |
Repeatable | True |
RDF Type | rdfs:Class |
Term Name schema:url | |
---|---|
Qualified Term | schema:url |
Term IRI | http://schema.org/url |
Label | URL |
Definition | URL to a website of the agent |
Examples |
|
Datatype | string |
Belongs to Class | ods:Agent |
Required | False |
Repeatable | False |
RDF Type | rdf:Property |
Term Name ods:hasIdentifiers | |
---|---|
Qualified Term | ods:hasIdentifiers |
Term IRI | http://rs.dissco.eu/opends/terms/hasIdentifiers |
Label | Has Identifiers |
Definition | Contains all identifiers associated with the agent |
Datatype | array<ods:Identifier> |
Belongs to Class | ods:Agent |
Required | False |
Repeatable | False |
RDF Type | rdf:Property |
Term Name ods:hasRoles | |
---|---|
Qualified Term | ods:hasRoles |
Term IRI | http://rs.dissco.eu/opends/terms/hasRoles |
Label | Has Roles |
Definition | Contains all roles associated with the agent in the context of the Digital Object. Should always contain at least one role |
Datatype | array<ods:Role> |
Belongs to Class | ods:Agent |
Required | False |
Repeatable | False |
RDF Type | rdf:Property |
Term Name ods:mappingDataStandard | |
---|---|
Qualified Term | ods:mappingDataStandard |
Term IRI | http://rs.dissco.eu/opends/terms/mappingDataStandard |
Label | Mapping Data Standard |
Definition | The data standard that is being mapped from |
Controlled Vocabulary |
|
Datatype | string |
Belongs to Class | ods:DataMapping |
Required | True |
Repeatable | False |
RDF Type | rdf:Property |
Term Name ods:hasTermMapping | |
---|---|
Qualified Term | ods:hasTermMapping |
Term IRI | http://rs.dissco.eu/opends/terms/hasTermMapping |
Label | Has Term Mapping |
Definition | Setting an explicit mapping for an ods term to a term from the incoming dataset. Key is the ods term, value the incoming data standard term |
Examples |
|
Datatype | array<ods:TermMapping> |
Belongs to Class | ods:DataMapping |
Required | False |
Repeatable | False |
RDF Type | rdf:Property |
Term Name ods:hasDefaultMapping | |
---|---|
Qualified Term | ods:hasDefaultMapping |
Term IRI | http://rs.dissco.eu/opends/terms/hasDefaultMapping |
Label | Has Default Mapping |
Definition | A mapping object setting default values for ods terms. These default mappings will be set for each record in the dataset. Key is the ods term, value the default value to use |
Examples |
|
Datatype | array<ods:DefaultMapping> |
Belongs to Class | ods:DataMapping |
Required | False |
Repeatable | False |
RDF Type | rdf:Property |
Term Name DataMapping | |
---|---|
Qualified Term | ods:DataMapping |
Term IRI | http://rs.dissco.eu/opends/terms/DataMapping |
Label | Data Mapping |
Definition | This object described the data mapping for used when ingesting the data. It can set default values or contain an explicit mapping between the local term and an openDS term. This object is attached to a source system object. |
Required | True |
Repeatable | True |
RDF Type | rdfs:Class |
Term Name schema:dateModified | |
---|---|
Qualified Term | schema:dateModified |
Term IRI | http://schema.org/dateModified |
Label | Date Modified |
Definition | Timestamp of last modification. Internally generated, follows the ISO Date Time Format yyyy-MM-dd'T'HH:mm:ss.SSSXXX |
Examples |
|
Datatype | string |
Belongs to Class | ods:DataMapping |
Required | True |
Repeatable | False |
RDF Type | rdf:Property |
Term Name schema:identifier | |
---|---|
Qualified Term | schema:identifier |
Term IRI | http://schema.org/identifier |
Label | Identifier |
Definition | The unique identifier (handle) of the Data Mapping object |
Examples |
|
Datatype | string |
Belongs to Class | ods:DataMapping |
Required | True |
Repeatable | False |
RDF Type | rdf:Property |
Term Name ods:fdoType | |
---|---|
Qualified Term | ods:fdoType |
Term IRI | http://rs.dissco.eu/opends/terms/fdoType |
Label | Fdo Type |
Definition | The DOI to the FDO type of the object |
Examples |
|
Datatype | string |
Belongs to Class | ods:DataMapping |
Required | True |
Repeatable | False |
RDF Type | rdf:Property |
Term Name ods:status | |
---|---|
Qualified Term | ods:status |
Term IRI | http://rs.dissco.eu/opends/terms/status |
Label | Status |
Definition | The status of the Digital Object. A digital object can be in Draft, when it is not published yet. Active when it is published and the object is active and Tombstone which means the object has been archived. |
Controlled Vocabulary |
|
Belongs to Class | ods:DataMapping |
Required | False |
Repeatable | False |
RDF Type | rdf:Property |
Term Name schema:version | |
---|---|
Qualified Term | schema:version |
Term IRI | http://schema.org/version |
Label | Version |
Definition | The version of the object, each change generates a new version. The version starts at 1 and each change will increment the version number with 1 |
Examples |
|
Datatype | integer |
Belongs to Class | ods:DataMapping |
Required | True |
Repeatable | False |
RDF Type | rdf:Property |
Term Name schema:name | |
---|---|
Qualified Term | schema:name |
Term IRI | http://schema.org/name |
Label | Name |
Definition | Name of the Mapping as provided by the user |
Examples |
|
Datatype | string |
Belongs to Class | ods:DataMapping |
Required | False |
Repeatable | False |
RDF Type | rdf:Property |
Term Name schema:creator | |
---|---|
Qualified Term | schema:creator |
Term IRI | http://schema.org/creator |
Label | Creator |
Definition | The creator of the Data Mapping, generally this will also be the only person able to change the data mapping |
Datatype | object |
Belongs to Class | ods:DataMapping |
Required | True |
Repeatable | False |
RDF Type | rdf:Property |
Term Name ods:hasTombstoneMetadata | |
---|---|
Qualified Term | ods:hasTombstoneMetadata |
Term IRI | http://rs.dissco.eu/opends/terms/hasTombstoneMetadata |
Label | Has Tombstone Metadata |
Definition | Object containing the tombstone metadata of the object. Only present when ods:status is ods:Tombstone |
Datatype | object |
Belongs to Class | ods:DataMapping |
Required | False |
Repeatable | False |
RDF Type | rdf:Property |
Term Name schema:description | |
---|---|
Qualified Term | schema:description |
Term IRI | http://schema.org/description |
Label | Description |
Definition | Description of the Mapping as provided by the user |
Examples |
|
Datatype | string |
Belongs to Class | ods:DataMapping |
Required | False |
Repeatable | False |
RDF Type | rdf:Property |
Term Name schema:dateCreated | |
---|---|
Qualified Term | schema:dateCreated |
Term IRI | http://schema.org/dateCreated |
Label | Date Created |
Definition | Timestamp of creation. Internally generated, follows the ISO Date Time Format yyyy-MM-dd'T'HH:mm:ss.SSSXXX |
Examples |
|
Datatype | string |
Belongs to Class | ods:DataMapping |
Required | True |
Repeatable | False |
RDF Type | rdf:Property |
Term Name dcterms:identifier | |
---|---|
Qualified Term | dcterms:identifier |
Term IRI | http://purl.org/dc/terms/identifier |
Label | Identifier |
Definition | The value for the identifier |
Examples |
|
Datatype | string |
Belongs to Class | ods:Identifier |
Required | False |
Repeatable | False |
RDF Type | rdf:Property |
Term Name Identifier | |
---|---|
Qualified Term | ods:Identifier |
Term IRI | http://rs.dissco.eu/opends/terms/Identifier |
Label | Identifier |
Definition | A generic Identifier class which can be attached to multiple classes. It captures information about any identifier of the class. |
Required | False |
Repeatable | True |
RDF Type | rdfs:Class |
Term Name dcterms:format | |
---|---|
Qualified Term | dcterms:format |
Term IRI | http://purl.org/dc/terms/format |
Label | Format |
Definition | All possible mime types of content that can be returned by identifier in case the identifier is resolvable. Plain UUIDs for example do not have a dc:format return type, as they are not resolvable on their own. For a list of MIME types see the list maintained by IANA: http://www.iana.org/assignments/media-types/index.html, in particular the text http://www.iana.org/assignments/media-types/text/ and application http://www.iana.org/assignments/media-types/application/ types. Frequently used values are text/html, text/xml, application/rdf+xml, application/json |
Examples |
|
Datatype | array<string> |
Belongs to Class | ods:Identifier |
Required | False |
Repeatable | False |
RDF Type | rdf:Property |
Term Name dcterms:subject | |
---|---|
Qualified Term | dcterms:subject |
Term IRI | http://purl.org/dc/terms/subject |
Label | Subject |
Definition | Additional keywords that the publisher may prefer to be attached to the identifier |
Examples |
|
Datatype | array<string> |
Belongs to Class | ods:Identifier |
Required | False |
Repeatable | False |
RDF Type | rdf:Property |
Term Name ods:isPartOfLabel | |
---|---|
Qualified Term | ods:isPartOfLabel |
Term IRI | http://rs.dissco.eu/opends/terms/isPartOfLabel |
Label | Is Part Of Label |
Definition | Indicates whether the identifier is part of the physical label |
Datatype | boolean |
Belongs to Class | ods:Identifier |
Required | False |
Repeatable | False |
RDF Type | rdf:Property |
Term Name dcterms:type | |
---|---|
Qualified Term | dcterms:type |
Term IRI | http://purl.org/dc/terms/type |
Label | Type |
Definition | The type of the value in the `dcterms:identifier` field |
Examples |
|
Controlled Vocabulary |
|
Datatype | string |
Belongs to Class | ods:Identifier |
Required | False |
Repeatable | False |
RDF Type | rdf:Property |
Term Name dcterms:title | |
---|---|
Qualified Term | dcterms:title |
Term IRI | http://purl.org/dc/terms/title |
Label | Title |
Definition | A name for the identifier |
Examples |
|
Datatype | string |
Belongs to Class | ods:Identifier |
Required | True |
Repeatable | False |
RDF Type | rdf:Property |
Term Name ods:identifierStatus | |
---|---|
Qualified Term | ods:identifierStatus |
Term IRI | http://rs.dissco.eu/opends/terms/identifierStatus |
Label | Identifier Status |
Definition | Indicates the status of the identifier |
Controlled Vocabulary |
|
Datatype | string |
Belongs to Class | ods:Identifier |
Required | False |
Repeatable | False |
RDF Type | rdf:Property |
Term Name ods:gupriLevel | |
---|---|
Qualified Term | ods:gupriLevel |
Term IRI | http://rs.dissco.eu/opends/terms/gupriLevel |
Label | GUPRI Level |
Definition | Indicates whether the identifier is a persistent identifier |
Controlled Vocabulary |
|
Datatype | string |
Belongs to Class | ods:Identifier |
Required | False |
Repeatable | False |
RDF Type | rdf:Property |
Term Name ods:relationshipType | |
---|---|
Qualified Term | ods:relationshipType |
Term IRI | http://rs.dissco.eu/opends/terms/relationshipType |
Label | Relationship Type |
Definition | The type of relationship between the tombstoned object and the related object |
Examples |
|
Datatype | string |
Belongs to Class | ods:RelatedPID |
Required | False |
Repeatable | False |
RDF Type | rdf:Property |
Term Name dcterms:identifier | |
---|---|
Qualified Term | dcterms:identifier |
Term IRI | http://purl.org/dc/terms/identifier |
Label | Identifier |
Definition | The PID of the related object, used in cases of `ods:Annotation`, `ods:DigitalMedia` and `ods:DigitalSpecimen` |
Examples |
|
Datatype | string |
Belongs to Class | ods:RelatedPID |
Required | True |
Repeatable | False |
RDF Type | rdf:Property |
Term Name RelatedPID | |
---|---|
Qualified Term | ods:RelatedPID |
Term IRI | http://rs.dissco.eu/opends/terms/RelatedPID |
Label | Related PID |
Definition | Indicates to which other Digital Object the tombstoned record is related to. This can be used when a digital object has been split or merged into other Digital Objects. |
Required | False |
Repeatable | True |
RDF Type | rdfs:Class |
Term Name schema:identifier | |
---|---|
Qualified Term | schema:identifier |
Term IRI | http://schema.org/identifier |
Label | Identifier |
Definition | The PID of the related object, used in cases of `ods:DataMapping`, `ods:SourceSystem` and `ods:MachineAnnotationService` |
Examples |
|
Datatype | string |
Belongs to Class | ods:RelatedPID |
Required | False |
Repeatable | False |
RDF Type | rdf:Property |
Term Name schema:startDate | |
---|---|
Qualified Term | schema:startDate |
Term IRI | http://schema.org/startDate |
Label | Start Date |
Definition | Date the agent began the role |
Examples |
|
Datatype | string |
Belongs to Class | ods:Role |
Required | False |
Repeatable | False |
RDF Type | rdf:Property |
Term Name schema:endDate | |
---|---|
Qualified Term | schema:endDate |
Term IRI | http://schema.org/endDate |
Label | End Date |
Definition | Date the agent ended the role |
Examples |
|
Datatype | string |
Belongs to Class | ods:Role |
Required | False |
Repeatable | False |
RDF Type | rdf:Property |
Term Name schema:position | |
---|---|
Qualified Term | schema:position |
Term IRI | http://schema.org/position |
Label | Position |
Definition | Can be used to indicate the order of importance when there are multiple agents with the same role. Lower order means higher importance. |
Examples |
|
Datatype | integer |
Belongs to Class | ods:Role |
Required | False |
Repeatable | False |
RDF Type | rdf:Property |
Term Name Role | |
---|---|
Qualified Term | ods:Role |
Term IRI | http://rs.dissco.eu/opends/terms/Role |
Label | Role |
Definition | A role is a named entity that can be assigned to an agent. It is used to describe the function of an agent in a specific context. |
Required | False |
Repeatable | True |
RDF Type | rdfs:Class |
Term Name schema:roleName | |
---|---|
Qualified Term | schema:roleName |
Term IRI | http://schema.org/roleName |
Label | Role Name |
Definition | The category that best matches the nature of a role of an Agent |
Examples |
|
Datatype | string |
Belongs to Class | ods:Role |
Required | False |
Repeatable | False |
RDF Type | rdf:Property |
Term Name ods:hasRelatedPIDs | |
---|---|
Qualified Term | ods:hasRelatedPIDs |
Term IRI | http://rs.dissco.eu/opends/terms/hasRelatedPIDs |
Label | Has Related Pi Ds |
Definition | The PIDs of the object the tombstoned object is related to |
Datatype | array<ods:RelatedPID> |
Belongs to Class | ods:TombstoneMetadata |
Required | False |
Repeatable | False |
RDF Type | rdf:Property |
Term Name ods:hasAgents | |
---|---|
Qualified Term | ods:hasAgents |
Term IRI | http://rs.dissco.eu/opends/terms/hasAgents |
Label | Has Agents |
Definition | The agent(s) who tombstoned the Digital Object, contains an ods:Agent object |
Datatype | object |
Belongs to Class | ods:TombstoneMetadata |
Required | True |
Repeatable | False |
RDF Type | rdf:Property |
Term Name ods:tombstoneText | |
---|---|
Qualified Term | ods:tombstoneText |
Term IRI | http://rs.dissco.eu/opends/terms/tombstoneText |
Label | Tombstone Text |
Definition | A reason why the Digital Object was tombstoned |
Examples |
|
Datatype | string |
Belongs to Class | ods:TombstoneMetadata |
Required | True |
Repeatable | False |
RDF Type | rdf:Property |
Term Name ods:tombstoneDate | |
---|---|
Qualified Term | ods:tombstoneDate |
Term IRI | http://rs.dissco.eu/opends/terms/tombstoneDate |
Label | Tombstone Date |
Definition | Timestamp the Digital Object was tombstoned and no longer active. Following the ISO Date Time Format yyyy-MM-dd'T'HH:mm:ss.SSSXXX |
Examples |
|
Datatype | string |
Belongs to Class | ods:TombstoneMetadata |
Required | True |
Repeatable | False |
RDF Type | rdf:Property |
Term Name TombstoneMetadata | |
---|---|
Qualified Term | ods:TombstoneMetadata |
Term IRI | http://rs.dissco.eu/opends/terms/TombstoneMetadata |
Label | Tombstone Metadata |
Definition | The tombstone metadata about the tombstoned digital object, including the what, who and when of the tombstoning. |
Required | False |
Repeatable | True |
RDF Type | rdfs:Class |