{"type":"doc","content":[{"type":"extension","attrs":{"layout":"default","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"toc","parameters":{"macroParams":{},"macroMetadata":{"macroId":{"value":"eee8e1c5-0659-461a-bcc5-7ed3392c2777"},"schemaVersion":{"value":"1"},"title":"Table of Contents"}},"localId":"27d1f4e2-9297-47cc-851d-b8dfee9ca7ae"}},{"type":"heading","attrs":{"level":3},"content":[{"text":"Identifiers for resources in the data","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Datasets will be provided to Europeana in an RDF/XML structure and will contain metadata descriptions for many cultural heritage objects. ","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The metadata description for one cultural heritage object is made up of several “sections”.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Each section corresponds to an instance of one of the classes described above and contains the properties and values associated with that class.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Each of these sections of metadata can be regarded as a “resource”in its own right because it will have a have a unique identifier andone or more properties associated to that particular class. The term “resource” is used for these sections of metadata in the remainder of this part of the document.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Each resource must have its own unique identifier (URI) so that all the resourcesin one description can be linked together internally. For more information on providing URI's consult the document '","type":"text"},{"text":"URIs in the context of the Europeana Data Model","type":"text","marks":[{"type":"link","attrs":{"href":"https://pro.europeana.eu/files/Europeana_Professional/Share_your_data/Technical_requirements/FAQs/URIs%20in%20EDM_pro.pdf"}}]},{"text":"'","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The identifier for the resource is given in the “rdf:about” statement at the start of the section of metadata for the resource.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The link from a referring resource (a) to another resource (b) is made by putting the identifier of (b) in one of the properties of (a) as an “rdf:resource”. See examples below.","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"Each resource (section of metadata) starts with the “rdf:about” statement containing the identifier of the resource. For example:","type":"text"}]},{"type":"paragraph","content":[{"text":"Identifier for the resource representing the Provided CHO","type":"text","marks":[{"type":"em"}]}]},{"type":"codeBlock","content":[{"text":"","type":"text"}]},{"type":"paragraph","content":[{"text":"Identifier for resource representing the WebResource","type":"text","marks":[{"type":"em"}]}]},{"type":"codeBlock","content":[{"text":"","type":"text"}]},{"type":"paragraph","content":[{"text":"Identifier for resource representing the Aggregation","type":"text","marks":[{"type":"em"}]}]},{"type":"codeBlock","content":[{"text":"","type":"text"}]},{"type":"paragraph","content":[{"text":"The resources are then linked using those identifiers in the “rdf:resource “ statement.","type":"text"},{"type":"hardBreak"},{"text":"The Aggregation resource is linked to the ProvidedCHO resource using its ID in the rdf:resource statement","type":"text","marks":[{"type":"em"}]}]},{"type":"codeBlock","content":[{"text":"\n\n...\n","type":"text"}]},{"type":"paragraph","content":[{"text":"The Aggregation is linked to the WebResource resource using its ID in the rdf:resource statement","type":"text","marks":[{"type":"em"}]}]},{"type":"codeBlock","content":[{"text":"\n\n...\n","type":"text"}]},{"type":"paragraph","content":[{"text":"Contextual resources are linked in a similar fashion. A property in the metadata of one of the core class resources will contain the ID of the contextual resource. In this example the edm:ProvidedCHO has a dc:type property which contains the HTTP URI which is the identifier for the skos:Concept resource.","type":"text"}]},{"type":"codeBlock","content":[{"text":"\n ...\n\n\n\n423.22 Labrosones with slides\n","type":"text"}]},{"type":"paragraph","content":[{"text":"In the example identifiers above you will see that the URIs are not of the same sort.","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The ID of the ProvidedCHO resource is an internal identifier (a record identifier in fact) used here simply to allow other resources to refer to it.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The ID of the WebResource resource is a real HTTP URI that will resolve to an external resource.","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"There ","type":"text"},{"text":"are four types of identifier","type":"text","marks":[{"type":"strong"}]},{"text":" that can be used in this context:","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"1. an HTTP URI that references a linked open data resource external to the data submitted to Europeana","type":"text"},{"type":"hardBreak"},{"text":"(","type":"text","marks":[{"type":"annotation","attrs":{"annotationType":"inlineComment","id":"692f8b66-3ee8-4e4c-b665-08718f1296a1"}}]},{"text":"A dereferenceable Uniform Resource Identifier uses HTTP to obtain a copy or representation of the resource it identifies, see ","type":"text","marks":[{"type":"annotation","attrs":{"annotationType":"inlineComment","id":"692f8b66-3ee8-4e4c-b665-08718f1296a1"}},{"type":"em"}]},{"type":"inlineCard","attrs":{"url":"https://en.wikipedia.org/wiki/Linked_data"}},{"text":" ","type":"text"},{"text":")","type":"text","marks":[{"type":"annotation","attrs":{"annotationType":"inlineComment","id":"692f8b66-3ee8-4e4c-b665-08718f1296a1"}}]},{"type":"hardBreak"},{"text":"2. an HTTP URI that references another resource inside the same metadata description submitted to Europeana","type":"text"},{"type":"hardBreak"},{"text":"3. a local URI that is not ","type":"text"},{"text":"dereferenceable ","type":"text","marks":[{"type":"annotation","attrs":{"annotationType":"inlineComment","id":"692f8b66-3ee8-4e4c-b665-08718f1296a1"}}]},{"text":"but that refers to another resource inside the same metadata description (e.g. an identifier internal to the provider infrastructure)","type":"text"},{"type":"hardBreak"},{"text":"4. an identifier that is not dereferenceable but that refers to another resource inside the same metadata description (any string used to identify a resource, such as an inventory number)","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Language aspects of the data","type":"text"}]},{"type":"paragraph","content":[{"text":"There are two language aspects to the data in Europeana that are relevant for providers: ","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"the language of the values in the properties ","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"the language of the object being described","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"paragraph","content":[{"text":"In the ISO 639-2 standard widely-known languages have both a two letter code (e.g. “fr” for French and “it” for Italian) and a three letter code (“eng” for English “fre” for French). Less widely used languages may only have the three letter code. Providers are recommended to use the two letter code wherever possible, as per the table at ","type":"text"},{"type":"inlineCard","attrs":{"url":"https://www.loc.gov/standards/iso639-2/php/code_list.php"}},{"text":" ","type":"text"}]},{"type":"paragraph","content":[{"text":"IANA has created a registry rationalising the codes","type":"text","marks":[{"type":"annotation","attrs":{"annotationType":"inlineComment","id":"9d36bb2a-6bc6-4ed8-a757-5eaffa59bbbb"}},{"type":"link","attrs":{"href":"https://www.iana.org/assignments/language-subtag-registry/language-subtag-registry"}}]},{"text":". It clarifies which languages are recommended to use the two letter code and which must use the three letter code. Providers are recommended to consult this registry. ","type":"text"}]},{"type":"paragraph","content":[{"text":"A useful explanation of this can be found at ","type":"text"},{"type":"inlineCard","attrs":{"url":"https://www.w3.org/International/articles/language-tags/index.en"}},{"text":" .","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"The language of the values given in the metadata properties","type":"text"}]},{"type":"paragraph","content":[{"text":"The language of the values given in the properties should be declared using the xml:lang attribute with the appropriate language code. For example, a description in ","type":"text"},{"text":"French","type":"text","marks":[{"type":"annotation","attrs":{"annotationType":"inlineComment","id":"95063cde-8fa7-4d65-85b1-3e8cfd2b5750"}}]},{"text":" can be:","type":"text"}]},{"type":"codeBlock","content":[{"text":"Trois boutons en argent","type":"text"}]},{"type":"paragraph","content":[{"text":"If that description is also available in English the property can be repeated","type":"text"}]},{"type":"codeBlock","content":[{"text":"Three silver buttons","type":"text"}]},{"type":"paragraph","content":[{"text":"Note that when the value of a property is a reference to a resource (i.e., with the attribute “rdf:resource”) the use of “xml:lang” is not allowed.","type":"text"},{"type":"hardBreak"},{"text":"It is also important to note that for Europeana there are specific rules for translations of titles that apply to dc:title and dcterms:alternative. These are given in the property description tables in the next sections.","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"The language of the object being described","type":"text"}]},{"type":"paragraph","content":[{"text":"Where there is a language aspect to the object being described, providers are asked to indicate the language of the object using the dc:language property. For objects with the edm:type of TEXT it is mandatory and for other types (for example, a voice recording or an image with some text on it) it is recommended. We also recommend the use of the ISO 639-‐2 code ZXX for no linguistic content. It is recommended to use a language code for the value:","type":"text"}]},{"type":"codeBlock","content":[{"text":"it","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"General mapping rules","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Providers are encouraged to provide as many properties as they can from their existing data to create a full description. It is not necessary to use all the available EDM properties, but those that are marked as mandatory must be provided.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Provide the properties inthe record in the same order given in this document.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"If the same contextual class applies to multiple ProvidedCHOs then it should be repeated for each ProvidedCHO. I.e. it cannot just be provided once in the data file. ","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The values provided for properties will either be a referenceor a literal. Most properties can have either type of value but for some, one or the other is specified. ","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Provide only a reference or a literal value to avoid duplicating data. ","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Properties used in combination with (i.e. which link to) contextual resources are recommended. ","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Whenever a literal value is used an xml:lang tag should be employed to indicate the language of the value. It is recommended to use them wherever appropriate. ","type":"text"},{"type":"hardBreak"},{"text":"Note that when the value of a property is a reference to a resource (i.e., with the attribute “rdf:resource”) the use of “xml:lang” is not allowed.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Try to find the most precise property that is available. For example, use the sub-properties dcterms:spatial or dcterms:temporal instead of the more general dc:coverage.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"All classes and other resources represented in an EDM record should have an identifier as ","type":"text"},{"text":"described in the above ","type":"text","marks":[{"type":"annotation","attrs":{"annotationType":"inlineComment","id":"567ad237-6b19-4a39-922c-f93d37ae5aa4"}}]},{"text":" section ","type":"text"},{"text":"(Identifiers for resources in the data)","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Do not use HTMLmark-‐up in property values as it may distort the portal display and the API data output.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Ensure the mandatory or alternative mandatory properties are included. ","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The properties dc:type and edm:type should have different values.","type":"text"}]}]}]},{"type":"paragraph"}],"version":1}