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.

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:

  1. If source data is not language tagged, language tags of target fields are disregarded and matching relies solely on textual values.

  2. 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
languagexml

...

<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
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://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

...