{"type":"doc","content":[{"type":"extension","attrs":{"layout":"default","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"toc","parameters":{"macroParams":{"minLevel":{"value":"1"},"maxLevel":{"value":"6"},"outline":{"value":"false"},"type":{"value":"list"},"printable":{"value":"false"}},"macroMetadata":{"macroId":{"value":"cc0c2011-457f-4736-bd4a-cd899918cf97"},"schemaVersion":{"value":"1"},"title":"Table of Contents"}},"localId":"ca3df64b-b942-4327-94ca-7311845cd48c"}},{"type":"heading","attrs":{"level":1},"content":[{"text":"Introduction","type":"text"}]},{"type":"paragraph","content":[{"text":"As part of the aggregation process, Europeana automatically enriches metadata by matching provided values to contextual resources from Europeana entity collection. This process, known as automatic semantic enrichment, enhances records by adding additional information beyond the original data. ","type":"text"}]},{"type":"paragraph"},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"paragraph","content":[{"text":"What is the Europeana entity collection? ","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"It is a curated reference point that aggregates information from several controlled vocabularies such as Wikidata, Geonames, AAT, VIAF and others. ","type":"text"}]}]},{"type":"paragraph"},{"type":"paragraph","content":[{"text":"The enrichment process can be summarised into two main steps:","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Values of provided metadata fields are automatically matched to Europeana contextual entities and links to these resources are added to metadata. The matching process follows predefined rules that determine how a provided metadata value corresponds to a specific contextual entity. ","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Added links point to data from the Europeana entity collection. Each linked Europeana entity is an instance of a contextual class as defined in the EDM for representing people (edm:Agent), places (edm:Place), concepts (skos:Concept), time periods (edm:Timespan) or organisations (foaf:Organization). Data available for the specific entity includes multilingual synonyms of an enriched term, hierarchical relationships (broader concepts) and links to equivalent entities in other vocabularies. ","type":"text"},{"type":"hardBreak"}]}]}]},{"type":"expand","attrs":{"title":"Example: Enrichment with the Europeana entity for wig"},"content":[{"type":"paragraph","content":[{"text":"The following example demonstrates how semantic enrichment is applied to a record containing the term","type":"text"},{"text":" wig","type":"text","marks":[{"type":"em"}]},{"text":" in dc:subject. Based on predefined rules, the provided subject is linked to the Europeana entity for ","type":"text"},{"text":"wig","type":"text","marks":[{"type":"em"}]},{"text":". The link to the Europeana ","type":"text"},{"text":"wig","type":"text","marks":[{"type":"em"}]},{"text":" entity is stored in Europeana’s proxy class, ensuring that enrichment remains separate from the source metadata in the provider’s proxy class. Additionally, a contextual entity is created as an instance of the appropriate contextual class defined in the Europeana Data Model (EDM), in this case skos:Concept, which holds additional metadata associated with the ","type":"text"},{"text":"wig","type":"text","marks":[{"type":"em"}]},{"text":" entity, such as translated labels, hierarchical relationships and references to other (external) vocabularies.","type":"text"}]},{"type":"paragraph"},{"type":"paragraph","content":[{"text":"Before","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","content":[{"text":"\n...\n Wig\n...\n","type":"text"}]},{"type":"paragraph"},{"type":"paragraph","content":[{"text":"After","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","content":[{"text":"\n...\n true\n \n...\n\n\n\n Wig\n Perücke\n περούκα\n Lasulja\n \n \n \n \n \n...\n","type":"text"}]},{"type":"paragraph"},{"type":"paragraph","content":[{"text":"Providers should note that for organisations, the enrichment process differs slightly. After finding a match, the source value is replaced with the corresponding Europeana entity for the organisation instead of being retained. More details on this process can be found ","type":"text"},{"text":"here","type":"text","marks":[{"type":"link","attrs":{"href":"https://europeana.atlassian.net/wiki/x/AYDeiw?atlOrigin=eyJpIjoiMjY5ZTU1NGMyOTFmNDJkN2E1MDAwMmU0YmJmZGMyZTYiLCJwIjoiYyJ9"}}]},{"text":".","type":"text"}]}]},{"type":"paragraph"},{"type":"heading","attrs":{"level":1},"content":[{"text":"Why is semantic enrichment important?","type":"text"}]},{"type":"paragraph","content":[{"text":"The primary goal of semantic enrichment is to enhance the interlinking of the data, adding more context to provided objects and improving the user experience in the Europeana portal by offering additional ways to search and navigate collections. ","type":"text"}]},{"type":"paragraph"},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Enhanced exploration ","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"paragraph","content":[{"text":"Semantic enrichment creates connections between provided objects and contextual entities, enabling users to explore relationships between them. For example, if a cultural heritage object in Europeana is attributed to Claude Monet, users can discover it through Monet’s entity page or navigate from the object’s page to learn more about Monet and related works. Similarly, a user searching for ","type":"text"},{"text":"Impressionism","type":"text","marks":[{"type":"em"}]},{"text":" can access a collection of objects linked to the movement, including artworks by associated artists like Monet.","type":"text"}]},{"type":"paragraph"},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Expanded multilinguality","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"paragraph","content":[{"text":"Through enrichment, multilingual terms are added to records, allowing Europeana to adapt to the language of the user. Since most entities have labels in multiple languages, the Europeana website displays the label that best matches the user’s preferred language.","type":"text"}]},{"type":"paragraph"},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Improved findability","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"paragraph","content":[{"text":"Enrichments can improve search recall and precision by adding more searchable content to records. This enables users to find records even if their search term does not exactly match the original metadata. For instance, if a provided object lists its creator as ","type":"text"},{"text":"Raffaello Sanzi","type":"text","marks":[{"type":"em"}]},{"text":"o in the source data, enrichment can link it to his more widely recognised name, ","type":"text"},{"text":"Raphael","type":"text","marks":[{"type":"em"}]},{"text":", ensuring that searches for either name return relevant results. Entities with multilingual labels also aid cross-lingual retrieval by allowing users to search in their preferred language while still retrieving relevant records. For example, a French user searching for ","type":"text"},{"text":"Londres","type":"text","marks":[{"type":"em"}]},{"text":" (London) will also find records tagged with the English equivalent, ","type":"text"},{"text":"London","type":"text","marks":[{"type":"em"}]},{"text":", broadening access across different languages.","type":"text"}]},{"type":"paragraph"},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":" Contextualisation and disambiguation of terms ","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"paragraph","content":[{"text":"Enrichments add contextual information to provided objects, helping eliminate ambiguity and can, for example, reduce confusion caused by terms that have multiple meanings (polysemy). For example, the term ","type":"text"},{"text":"Paris","type":"text","marks":[{"type":"em"}]},{"text":" could refer to the capital of France or Paris, a character from Greek mythology. By linking terms to Europeana entities, we ensure that Paris (city) is distinct from Paris (mythological figure). ","type":"text"}]},{"type":"paragraph"},{"type":"heading","attrs":{"level":1},"content":[{"text":"Where is semantic enrichment applied?","type":"text"}]},{"type":"paragraph","content":[{"text":"The enrichment process links values in the source metadata fields to target fields of Europeana entities:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Source fields","type":"text","marks":[{"type":"strong"}]},{"text":" are the metadata fields that describe the provided cultural heritage object, for example, the creator’s name, place of creation, subjects, etc. These fields are used to find a corresponding contextual entity. ","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Target fields","type":"text","marks":[{"type":"strong"}]},{"text":" are fields in an external dataset (in our case, this is Europeana entity collection) that contain structured information about entities. ","type":"text"}]}]}]},{"type":"paragraph"},{"type":"paragraph","content":[{"text":"The process of matching source and target fields follows predefined rules that determine when a source field value corresponds to a target field value. To reduce errors and ensure contextually relevant enrichments, Europeana applies the following rules:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Case insensitivity: matches are found regardless of letter casing, so ","type":"text"},{"text":"paris","type":"text","marks":[{"type":"em"}]},{"text":" and ","type":"text"},{"text":"Paris","type":"text","marks":[{"type":"em"}]},{"text":" are treated as the same value.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Consideration of language tags: When language tags are present in the source fields, the system prioritises matches where both the source and target fields share the same value and language tag. If no language tags are available, matching solely relies on the text label within the field.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Field-specific enrichment rules: certain metadata fields can only be enriched with a specific type of entity. For example, a ","type":"text"},{"text":"creator","type":"text","marks":[{"type":"em"}]},{"text":" field can only be linked to an entity classified as an Agent (edm:Agent) rather than a place or concept.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Multiple entity enrichment: matches are established based on direct equivalence, meaning identical values in both fields. However, matches can sometimes go beyond a direct one-to-one match by accounting for hierarchical relationships. For instance, a term may be linked to both its specific entity and a broader entity within the same hierarchy, such as a city being enriched with both its specific entity and the entity for the country it belongs to.","type":"text"}]}]}]},{"type":"paragraph"},{"type":"paragraph","content":[{"text":"The following table lists source and target fields for different Europeana entity types:","type":"text"}]},{"type":"table","attrs":{"layout":"center","width":770.0,"localId":"458132a9-f074-42cf-9e5e-a5b1c974c4dc","displayMode":"fixed"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"background":"#f4f5f7","rowspan":1,"colwidth":[141.0]},"content":[{"type":"paragraph","content":[{"text":"Entity type","type":"text"}]}]},{"type":"tableHeader","attrs":{"colspan":1,"background":"#f4f5f7","rowspan":1,"colwidth":[347.0]},"content":[{"type":"paragraph","content":[{"text":"Source fields","type":"text"}]}]},{"type":"tableHeader","attrs":{"colspan":1,"background":"#f4f5f7","rowspan":1,"colwidth":[282.0]},"content":[{"type":"paragraph","content":[{"text":"Target fields","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[141.0]},"content":[{"type":"paragraph","content":[{"text":"Agent","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[347.0]},"content":[{"type":"paragraph","content":[{"text":"In edm:ProvidedCHO class:","type":"text","marks":[{"type":"em"}]}]},{"type":"paragraph","content":[{"text":"dc:creator, ","type":"text"}]},{"type":"paragraph","content":[{"text":"dc:contributor.","type":"text"}]},{"type":"paragraph"},{"type":"paragraph","content":[{"text":"In (provided or dereferenced) edm:Agent contextual class:","type":"text","marks":[{"type":"em"}]}]},{"type":"paragraph","content":[{"text":"owl:sameAs.","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[282.0]},"content":[{"type":"paragraph","content":[{"text":"skos:prefLabel,","type":"text"}]},{"type":"paragraph","content":[{"text":"skos:altLabel","type":"text"}]},{"type":"paragraph","content":[{"text":"owl:sameAs.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[141.0]},"content":[{"type":"paragraph","content":[{"text":"Place","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[347.0]},"content":[{"type":"paragraph","content":[{"text":"In edm:ProvidedCHO class:","type":"text","marks":[{"type":"em"}]}]},{"type":"paragraph","content":[{"text":"dcterms:spatial,","type":"text"}]},{"type":"paragraph","content":[{"text":"dc:coverage.","type":"text"}]},{"type":"paragraph"},{"type":"paragraph","content":[{"text":"In (provided or dereferenced) edm:Place contextual class:","type":"text","marks":[{"type":"em"}]}]},{"type":"paragraph","content":[{"text":"owl:sameAs.","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[282.0]},"content":[{"type":"paragraph","content":[{"text":"skos:prefLabel,","type":"text"}]},{"type":"paragraph","content":[{"text":"skos:altLabel,","type":"text"}]},{"type":"paragraph","content":[{"text":"owl:sameAs.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[141.0]},"content":[{"type":"paragraph","content":[{"text":"Time Periods","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[347.0]},"content":[{"type":"paragraph","content":[{"text":"In edm:ProvidedCHO class:","type":"text","marks":[{"type":"em"}]}]},{"type":"paragraph","content":[{"text":"dc:date, ","type":"text"}]},{"type":"paragraph","content":[{"text":"dcterms:temporal,","type":"text"}]},{"type":"paragraph","content":[{"text":"dcterms:created, ","type":"text"}]},{"type":"paragraph","content":[{"text":"dcterms:issued.","type":"text"}]},{"type":"paragraph"},{"type":"paragraph","content":[{"text":"In (provided or dereferenced) edm:TimeSpan contextual class:","type":"text","marks":[{"type":"em"}]}]},{"type":"paragraph","content":[{"text":"owl:sameAs.","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[282.0]},"content":[{"type":"paragraph","content":[{"text":"skos:prefLabel,","type":"text"}]},{"type":"paragraph","content":[{"text":"skos:altLabel,","type":"text"}]},{"type":"paragraph","content":[{"text":"owl:sameAs.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[141.0]},"content":[{"type":"paragraph","content":[{"text":"Concept","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[347.0]},"content":[{"type":"paragraph","content":[{"text":"In edm:ProvidedCHO class:","type":"text","marks":[{"type":"em"}]}]},{"type":"paragraph","content":[{"text":"dc:subject,","type":"text"}]},{"type":"paragraph","content":[{"text":"dc:type,","type":"text"}]},{"type":"paragraph","content":[{"text":"dc:format,","type":"text"}]},{"type":"paragraph","content":[{"text":"dcterms:medium.","type":"text"}]},{"type":"paragraph"},{"type":"paragraph","content":[{"text":"In (provided or dereferenced) skos:Concept contextual class:","type":"text","marks":[{"type":"em"}]}]},{"type":"paragraph","content":[{"text":"skos:exactMatch.","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[282.0]},"content":[{"type":"paragraph","content":[{"text":"skos:prefLabel,","type":"text"}]},{"type":"paragraph","content":[{"text":"skos:exactMatch.","type":"text"}]}]}]}]},{"type":"paragraph"},{"type":"heading","attrs":{"level":1},"content":[{"text":"Semantic enrichment - use cases ","type":"text"}]},{"type":"paragraph","content":[{"text":"Building on the concepts of source and target fields discussed in the previous section, the following use cases illustrate how matches are established between the source metadata and Europeana entities during the enrichment process. Each case highlights the specific matching mechanism applied, whether based on textual labels or co-references (URIs) and provides examples to clarify how the process works in practice.","type":"text"}]},{"type":"paragraph","content":[{"text":"These use cases are categorised into two groups: ","type":"text"},{"text":"matching based on text labels","type":"text","marks":[{"type":"strong"}]},{"text":" and ","type":"text"},{"text":"matching based on URI (co-)references","type":"text","marks":[{"type":"strong"}]},{"text":", which together describe the diverse ways in which metadata can be enriched by Europeana:","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Text labels based matching","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Case 1: Plain literal enrichment","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"When the source field describing the cultural heritage object contains a textual value (literal), the process attempts to find a corresponding Europeana entity with the same text in one of the target fields (skos:prefLabel or skos:altLabel).","type":"text"}]},{"type":"paragraph","content":[{"text":"Example:","type":"text"}]},{"type":"layoutSection","content":[{"type":"layoutColumn","attrs":{"width":50.0},"content":[{"type":"paragraph","content":[{"text":"Before","type":"text","marks":[{"type":"em"}]}]},{"type":"codeBlock","content":[{"text":"\n...\n Pablo Picasso\n...\n","type":"text"}]},{"type":"paragraph"},{"type":"paragraph"},{"type":"paragraph"},{"type":"paragraph"}]},{"type":"layoutColumn","attrs":{"width":50.0},"content":[{"type":"paragraph","content":[{"text":"After","type":"text","marks":[{"type":"em"}]}]},{"type":"codeBlock","content":[{"text":"\n...\n true\n \n...\n\n\n\n\n...\n Pablo Picasso\n \n...\n","type":"text"}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"URI (co-)references based matching","type":"text","marks":[{"type":"strong"}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Case 2: Coreference enrichment","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"When the source field describing the cultural heritage object contains a reference (URI), the process attempts to find a corresponding contextual entity with the same URI in one of the target fields (owl:sameAs or skos:exactMatch).","type":"text"}]},{"type":"paragraph","content":[{"text":"Example:","type":"text"}]},{"type":"layoutSection","content":[{"type":"layoutColumn","attrs":{"width":50.0},"content":[{"type":"paragraph","content":[{"text":"Before","type":"text","marks":[{"type":"em"}]}]},{"type":"codeBlock","content":[{"text":"\n...\n \n...\n","type":"text"}]}]},{"type":"layoutColumn","attrs":{"width":50.0},"content":[{"type":"paragraph","content":[{"text":"After","type":"text","marks":[{"type":"em"}]}]},{"type":"codeBlock","content":[{"text":"\n...\n true\n \n...\n\n\n\n\n...\n Folklore\n \n...\n","type":"text"}]}]}]},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"paragraph","content":[{"text":"Providers should note it is irrelevant whether the URI is dereferenceable or not.","type":"text"}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Case 3: Using coreferences in entity data","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"This scenario applies to co-references (URIs) within a given contextual entity, which can either be a contextual class supplied by the data provider in the original EDM record or created by Europeana when a dereferenceable URI is supplied. The process attempts to find a match by comparing a reference (URI) in owl:sameAs or skos:exactMatch of either the provided or dereferenced contextual class with an identical URI in owl:sameAs or skos:exactMatch of the Europeana entity. ","type":"text"}]},{"type":"paragraph","content":[{"text":"Example:","type":"text"}]},{"type":"layoutSection","content":[{"type":"layoutColumn","attrs":{"width":50.0},"content":[{"type":"paragraph","content":[{"text":"Before","type":"text","marks":[{"type":"em"}]}]},{"type":"codeBlock","content":[{"text":"\n...\n \n...\n\n\n\n\n...\n \n...\n","type":"text"}]}]},{"type":"layoutColumn","attrs":{"width":50.0},"content":[{"type":"paragraph","content":[{"text":"After ","type":"text","marks":[{"type":"em"}]}]},{"type":"codeBlock","content":[{"text":"\n...\n true\n \n...\n\n\n\n\n...\n Folklore\n \n...\n","type":"text"}]}]}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Credits and edit history","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"type":"date","attrs":{"timestamp":"1742428800000"}},{"text":" documentation updated by Maša Škrinjar in collaboration with Hugo Manguinhas","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"type":"date","attrs":{"timestamp":"1742947200000"}},{"text":" final page edits by Adina Ciocoiu","type":"text"}]}]}]}],"version":1}

Browser not supported