tainacan/docs/mapping-standards.md

80 lines
1.8 KiB
Markdown
Raw Normal View History

2018-03-15 21:35:09 +00:00
# Mapping Standards
Mapping Standards are declarations of standards of metadata. Once they are available and activated in your repository, you can map the fields of your collections to them.
## Structure
A Mapping Standard has the following attributes.
### Name
The name of the Mapping Standard.
### Fields
A list of fields, terms or attributes that this mapping have. These are the element you will be able to map your Collection's Fields.
Each field has the following attributes:
* Name - The field name, that refers to the name of the attribute in the origin vocabulary or ontology (e.g. title)
* Label - The human readable name
* URI - The URI of this term/attribute in the origin Ontoloy/Vocabulary
### Allow additional custom fields
Boolen indicating wether this mapping allows additional custom fields to be added.
### Context URL / Vocab URL
The URL of the Ontology or vocabulary. For example `http://schema.org` or `http://dublincore.org/documents/dcmi-terms/`
### Type
The Class of the ontology that this mapping refers to. For example `CreativeWork`, which is a class of Schema.org.
## Examples
```
{
'name': 'Dublin Core',
'fields': {
{
'name': 'title',
'label': 'Title',
'URI': 'http://purl.org/dc/terms/title'
},
{
'name': 'publisher',
'label': 'Publisher',
'URI': 'http://dublincore.org/documents/dcmi-terms/'
},
... And so on...
},
'allow_extra_fields': true,
'context_url': ''
}
```
```
{
'name': 'Schema.org Creative Works',
'fields': {
{
'name': 'name',
'label': 'Name',
'URI': 'http://schema.org/name'
},
{
'name': 'alternativeHeadline',
'label': 'Alternative Headline',
'URI': 'http://schema.org/alternativeHeadline'
},
... And so on...
},
'allow_extra_fields': false,
'context_url': 'http://schema.org',
'type': 'CreativeWork'
}
```