This page describes how Europeana links information about providing organisations to Europeana entities for organisations.
Table of Contents | ||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
Europeana
...
organisation entities
Data partners include information about organisations involved in the aggregation chain in the metadata, like so:
Code Block |
---|
<ore:Aggregation rdf:about="#Example_01Aggregation">
<edm:aggregatedCHO rdf:resource="#Example_01"/>
<edm:dataProvider>Bibliothèque nationale de France</edm:dataProvider>
<edm:intermediateProvider>The European Library</edm:intermediateProvider>
<edm:provider>Gallica</edm:provider>
[ other Aggregation data ]
</ore:Aggregation> |
Organisations are recorded in the Europeana customer relationship management system (CRM), where we store the main information related to them, such as, among others, the officialname and English translation, acronym, country of location, and website. Each Europeana organisation entity contains information extracted from the CRM that is augmented with organisation data available in Wikidata. You can retrieve an entity by making the following request:
Code Block |
---|
https://api.europeana.eu/entity/ |
...
organization/[IDENTIFIER] Accept: [ACCEPT] |
Code Block |
---|
https://api.europeana.eu/entity/ |
...
organization/[IDENTIFIER].[FORMAT] |
Example:
Code Block |
---|
https://api.europeana.eu/entity/organization/4373.json |
More information about metadata included in the organisation entity is available here.
Semantic enrichment process
...
Where is semantic enrichment applied?
Semantic enrichment links values in source metadata fields to corresponding Europeana entities for organisations. This process follows a structured approach, where specific metadata fields (source fields) are matched against predefined reference points (target fields) to establish meaningful connections. The enrichment process adheres to a set of rules that define how matches are determined, ensuring consistency and reliability.
Contextual Entity Type | Source fields | Target fields |
---|---|---|
Organisations | edm:dataProvider edm:intermediateProvider edm:provider |
...
skos:prefLabel skos: |
...
altLabel skos: |
...
hiddenLabel edm:acronym owl:sameAs |
Matching rules
Matching follows a specific set of rules that specify how a match is obtained between the source and target values. It is case insensitive and takes into account language tags of textual values when available:
If source data is not language tagged, language tags of target fields are disregarded and matching relies solely on textual values.
If source data is language tagged, language tags of the source and target fields must be the same for matching to be successful.
Use cases
The following use cases demonstrate how matches are established between source metadata and Europeana entity metadata for organisations. Each case outlines the specific matching mechanism used, whether based on textual values or URI (co-)references, and includes an example to illustrate the process in practice.
Use case 1: Matching based on textual values
...
Enrichment process looks for a textual reference (label) mapped to the source field and finds an organisation entity with the same label in the target field.
Info |
---|
Data partners can provide |
...
organisation names in their original language |
...
, an English translation, |
...
or acronyms, as long as |
...
these are recorded in the CRM |
...
. |
...
...
Before enrichment:
Code Block | ||
---|---|---|
|
...
<ore:Aggregation rdf:about="#Example_01Aggregation"> <edm:aggregatedCHO rdf:resource="#Example_01"/> <edm:dataProvider>Bibliothèque nationale de France</edm:dataProvider> [ other Aggregation data ] </ore:Aggregation> |
...
Source data in provided ore:Aggregation class
Code Block |
---|
<foaf:Organization rdf:about="http://data.europeana.eu/organization/4373 |
...
">
<skos:prefLabel xml:lang="en">National Library of France</skos:prefLabel>
<skos:prefLabel xml:lang="fr">Bibliothèque nationale de France</skos:prefLabel> |
...
<edm:acronym xml:lang="fr">BnF</edm:acronym>
[ other |
...
information |
...
about |
...
organisation |
...
] |
...
</foaf:Organization> |
Target data in Europeana entity for organisation
After enrichment:
When
...
a match is found, the source value is replaced with the Europeana organisation entity URI and the entity is added to the record. Each entity is an instance of a contextual class as defined in the EDM for representing organisations (foaf:Organization).
...
Including the foaf:Organization class
...
in the metadata enables the use of additional contextual information while keeping it separate from the Aggregation class
...
.
Code Block |
---|
<ore:Aggregation rdf:about="/aggregation/provider/Example_01Aggregation">
<edm:aggregatedCHO rdf:resource="#Example_01"/>
<edm:dataProvider rdf:resource="http://data.europeana.eu/organization/4373"/>
[ other Provider’s Aggregation data ]
</ore:Aggregation>
<foaf:Organization rdf:about="http://data.europeana.eu/organization/4373">
<skos:prefLabel xml:lang="en">National Library of France</skos:prefLabel>
<skos:prefLabel xml:lang="fr">Bibliothèque nationale de France</skos:prefLabel>
[ other |
...
information |
...
about |
...
organisation |
...
]
</foaf:Organization> |
Use case 2: Matching based on URI (co-)references
...
Enrichment process looks for a URI mapped to the source field and matches it against the
...
co-reference link (indicated by owl:sameAs relation) available for the organisation entity.
...
Info |
---|
Data partners can provide URIs from external vocabularies or persistent identifiers for organisations. We list some examples below. To ensure proper enrichment, partners should notify us about the URIs they wish to use so we can record them in our CRM. |
Expand | ||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||||||||||
|
Before enrichment:
Code Block |
---|
<ore:Aggregation rdf:about="#Example_02Aggregation">
<edm:aggregatedCHO rdf:resource="#Example_02"/>
<edm:dataProvider rdf:resource="https://data.bnf.fr/ark:/12148/cb12381002j"/> |
...
[ other Aggregation data ]
</ore:Aggregation> |
...
Source data in provided ore:Aggregation class
Code Block |
---|
<foaf:Organization rdf:about="http://data.europeana.eu/organization/4373">
<skos:prefLabel xml:lang="en">National Library of France</skos:prefLabel>
<skos:prefLabel xml:lang="fr">Bibliothèque nationale de France</skos:prefLabel>
<edm:acronym xml:lang="fr">BnF</edm:acronym>
<owl:sameAs rdf:resource="http://www.wikidata.org/entity/Q193563 |
...
"/>
<owl:sameAs rdf:resource="http://viaf.org/viaf/137156173 |
...
"/> <owl:sameAs rdf:resource="https://data.bnf.fr/ark:/12148/cb12381002j"/> [ other |
...
information |
...
about |
...
organisation |
...
]
</foaf:Organization> |
...
Target data in Europeana entity for organisation
After enrichment:
When a match is found, the source value is replaced with the Europeana organisation entity URI and the entity is added to the record as foaf:Organization contextual class.
Code Block |
---|
<ore:Aggregation rdf:about="/aggregation/provider/Example_02Aggregation">
<edm:aggregatedCHO rdf:resource="#Example_02"/>
<edm:dataProvider rdf:resource="http://data.europeana.eu/organization/4373"/>
[ other Provider’s Aggregation data ]
</ore:Aggregation>
<foaf:Organization rdf:about="http://data.europeana.eu/organization/4373">
<skos:prefLabel xml:lang="en">National Library of France</skos:prefLabel>
<skos:prefLabel xml:lang="fr">Bibliothèque nationale de France</skos:prefLabel>
[ other properties of Organization entity]
</foaf:Organization> |
...
Data partners can provide a range of different persistent identifiers (PI) for organisations, including those listed below (note this list is not exhaustive):
...
Vocabulary / PI system name
...
Example URI
...
Wikidata
...
Code Block |
---|
http://www.wikidata.org/entity/Q193563 |
...
Virtual International Authority File (VIAF)
...
Code Block |
---|
http://viaf.org/viaf/137156173 |
...
The Getty - Union List of Artist Names (ULAN)
...
Code Block |
---|
http://vocab.getty.edu/ulan/500309981 |
...
Gemeinsame Normdatei (GND)
...
Code Block |
---|
http://d-nb.info/gnd/5156217-0 |
...
International Standard Name Identifier (ISNI)
...
Code Block |
---|
http://isni.org/isni/0000000123531945 |
...
Archival Resource Key (ARK)
...
Code Block |
---|
https://data.bnf.fr/ark:/12148/cb12381002j |
...
The Research Organization Registry (ROR)
...
Code Block |
---|
https://ror.org/04v1bf639 |
...