Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

This page describes how Europeana links information about providing organisations to Europeana entities for organisations.

Table of Contents
minLevel1
maxLevel6
include
outlinefalse
indent
exclude
typelist
class
printablefalse

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.

Where is Semantic enrichment applied?

Semantic enrichment is applied by linking 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

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 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.json">
        <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 properties of Organization entity]
  </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 properties of Organization entity]
</foaf:Organization>

Use case 2: Matching based on URI (co-)references

Enrichment process looks for URI mapped to the source field and matches it against the coreference 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
titleExample URIs for National Library of France:

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
https://d-nb.info/gnd/5156217-0

International Standard Name Identifier (ISNI)

Code Block
https://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

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://isni.org/isni/0000000123531945"/>
        <owl:sameAs rdf:resource="http://viaf.org/viaf/137156173"/>
        <owl:sameAs  rdf:resource="http://id.loc.gov/authorities/names/no95028191"/>
        <owl:sameAs rdf:resource="https://data.bnf.fr/ark:/12148/cb12381002j"/>
       [ other properties of Organization entity]
</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 (foaf:Organization) is added to the record:

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>