{"type":"doc","content":[{"type":"paragraph","content":[{"text":"One of the features we offer to Europeana website users is the ability to browse our vast collection through providing organisations. For instance, if you are interested in materials from a specific research center, you can easily access all relevant records from its dedicated page. You can explore the list of contributing organisations sharing their data ","type":"text"},{"text":"here","type":"text","marks":[{"type":"link","attrs":{"href":"https://www.europeana.eu/en/collections/organisations"}}]},{"text":".","type":"text"}]},{"type":"expand","attrs":{"title":"Dedicated page for Naturalis Biodiversity Center"},"content":[{"type":"paragraph"},{"type":"mediaSingle","attrs":{"layout":"center","width":1069,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":3172,"alt":"Screenshot 2024-06-21 at 13.15.53.png","id":"a85d294b-d241-46d6-a840-a8d4c921d849","collection":"contentId-2617442393","type":"file","height":2164},"marks":[{"type":"border","attrs":{"size":3,"color":"#091e4224"}}]}]},{"type":"paragraph"},{"type":"paragraph"}]},{"type":"paragraph","content":[{"text":"Even if you choose not to browse by contributing organisations, you will still learn about them from the individual record pages. We enhance the provided data with Europeana entities for organisations, allowing you to learn about providers when viewing individual records. By clicking on the entity, you can access each organisation's dedicated page with additional information, including its location, website, and other provided records. This additional information is coming from Europeana’s customer relationship management tool, Zoho CRM.","type":"text"}]},{"type":"expand","attrs":{"title":"Record page for a preserved specimen provided by Naturalis Biodiversity Center"},"content":[{"type":"paragraph"},{"type":"mediaSingle","attrs":{"layout":"center","width":659,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":1916,"alt":"Screenshot 2024-06-24 at 10.50.55.png","id":"635fee1b-6f70-49ed-b0cd-b0adb0d62ba5","collection":"contentId-2617442393","type":"file","height":2198}}]},{"type":"paragraph"}]},{"type":"expand","attrs":{"title":"Screenshot of the Naturalis Biodiversity Center record in Zoho CRM"},"content":[{"type":"paragraph"},{"type":"mediaSingle","attrs":{"layout":"center","width":737,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":2952,"alt":"Screenshot 2024-06-21 at 13.53.26.png","id":"8dd5d0d0-3622-4881-8900-310e69c9461a","collection":"contentId-2617442393","type":"file","height":2308}}]}]},{"type":"paragraph","content":[{"text":"API users can retrieve specific organisation entities by referring to the ","type":"text"},{"text":"Entity API documentation","type":"text","marks":[{"type":"link","attrs":{"href":"https://europeana.atlassian.net/wiki/spaces/EF/pages/2324561923/Entity+API+Documentation#Organisation"}}]},{"text":" that specifies the request format.","type":"text"}]},{"type":"expand","attrs":{"title":"Example request and response to retrieve metadata available for Naturalis Biodiversity Center"},"content":[{"type":"paragraph","content":[{"text":"Request","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"GET https://api.europeana.eu/entity/organization/4513.json","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"Response","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","content":[{"text":"{\n@context: \"http://www.europeana.eu/schemas/context/entity.jsonld\",\nid: \"http://data.europeana.eu/organization/4513\",\ntype: \"Organization\",\nprefLabel: {\nen: \"Naturalis Biodiversity Center\"\n},\nhiddenLabel: [\n\"Library of the Netherlands Entomological Society, Naturalis Biodiversity Center\"\n],\ndescription: {\nde: \"Niederländisches Naturkundemuseum und Forschungsinstitut in Leiden\",\nru: \"Музей в Голландии\",\nen: \"Natural history museum and research center in the Leiden, The Netherlands\",\nit: \"Museo di storia naturale e centro di ricerca neerlandese\",\nfr: \"Musée et centre de recherche néerlandais\",\nda: \"Naturhistorisk museum og forskningscenter i Nederlandene\",\nnl: \"Museum en onderzoekscentrum in Leiden\",\nes: \"Museo de historia natural y centro de investigación neerlandés\"\n},\neuropeanaRole: [\n{\nid: \"http://data.europeana.eu/vocabulary/role/ProvidingInstitution\",\ntype: \"Concept\"\n}\n],\ncountry: {\nid: \"http://data.europeana.eu/place/106\",\ntype: \"Place\"\n},\nlanguage: [\n\"nl\"\n],\nhomepage: \"https://www.naturalis.nl/\",\nhasAddress: {\nid: \"https://crm.zoho.eu/crm/org20085137532/tab/Accounts/486281000000923816#address\",\ntype: \"Address\",\nlocality: \"Leiden\",\ncountryName: \"Netherlands\"\n},\nidentifier: [\n\"486281000000923816\"\n],\nsameAs: [\n\"https://crm.zoho.eu/crm/org20085137532/tab/Accounts/486281000000923816\",\n\"http://www.wikidata.org/entity/Q641676\",\n\"http://isni.org/isni/000000012159802X\",\n\"http://data.europeana.eu/organization/1482250000000370517\",\n\"http://viaf.org/viaf/132063008\",\n\"http://viaf.org/viaf/305227246\",\n\"http://d-nb.info/gnd/5025979-9\",\n\"http://id.loc.gov/authorities/names/n92025427\",\n\"http://www.idref.fr/157896315/id\",\n\"https://www.freebase.com/m/08jgn7\",\n\"https://g.co/kg/m/08jgn7\",\n\"https://livedata.bibsys.no/authority/90313667\",\n\"http://nlg.okfn.gr/resource/authority/record241821\",\n\"http://dbpedia.org/resource/Naturalis_Biodiversity_Center\"\n],\nisAggregatedBy: {\nid: \"http://data.europeana.eu/organization/4513#aggregation\",\ntype: \"Aggregation\",\ncreated: \"2024-02-22T17:19:25Z\",\nmodified: \"2024-05-23T13:17:13Z\",\npageRank: 22,\nrecordCount: 5200216,\nscore: 586313,\naggregates: [\n\"http://data.europeana.eu/organization/4513#aggr_europeana\",\n\"http://data.europeana.eu/organization/4513#aggr_source_1\",\n\"http://data.europeana.eu/organization/4513#aggr_source_2\"\n]\n}\n}","type":"text"}]},{"type":"paragraph","content":[{"text":"Note that the entity includes data from Zoho CRM, enriched with additional information available for this organisation in Wikidata.","type":"text","marks":[{"type":"em"}]}]}]},{"type":"rule"},{"type":"paragraph","content":[{"text":"Table of contents:","type":"text"}]},{"type":"extension","attrs":{"layout":"default","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"toc","parameters":{"macroParams":{"minLevel":{"value":"1"},"maxLevel":{"value":"6"},"outline":{"value":"false"},"style":{"value":"none"},"type":{"value":"list"},"printable":{"value":"true"}},"macroMetadata":{"macroId":{"value":"9c71620f-07cc-4ecc-95fc-caf4f31cf396"},"schemaVersion":{"value":"1"},"title":"Table of Contents"}},"localId":"e7f2998b-affb-4433-af3b-7f3de66f9f42"}},{"type":"rule"},{"type":"heading","attrs":{"level":1},"content":[{"text":"Europeana organisation entities","type":"text"}]},{"type":"paragraph","content":[{"text":"Over the years, we have created records in Zoho CRM for our existing data partners. These records include information such as the organisation's name in its original language and English translation, website, location, and more. Going forward, we aim to rely on aggregators for gathering information about new data providers. As you are in direct contact with your providers, you can ensure they are represented in Europeana with accurate and up-to-date information. We have included a spreadsheet in the ","type":"text"},{"text":"Jira submission form","type":"text","marks":[{"type":"link","attrs":{"href":"https://europeana.atlassian.net/servicedesk/customer/portal/5/group/11/create/72"}}]},{"text":" for new datasets, and we ask you to fill it in for all new providers. This will allow us to import information from the spreadsheet to the Zoho CRM and to create an entity for any new organisation based on the provided details.","type":"text"}]},{"type":"paragraph","content":[{"text":"The spreadsheet contains two tabs. In the first one, you will find descriptions of the information about providing organisations that we need. The second tab contains columns where we ask you to record the information.","type":"text"}]},{"type":"paragraph"},{"type":"panel","attrs":{"panelType":"warning"},"content":[{"type":"paragraph","content":[{"text":"If you come across any inaccurate or outdated information about organisations while browsing Europeana, please inform us directly by contacting the DPS team or using the feedback feature in the portal. We will promptly update the necessary information in Zoho CRM.","type":"text"}]},{"type":"paragraph","content":[{"text":"The feedback widget is located in the bottom right corner of your screen when using Europeana.","type":"text"}]}]},{"type":"paragraph"},{"type":"heading","attrs":{"level":1},"content":[{"text":"Enriching data with organisation entities","type":"text"}]},{"type":"paragraph","content":[{"text":"During the ingestion process, one of the steps involves semantic enrichment of provided data. As part of this process, a match between provided data and organisation entities is established. You can find more details about the process ","type":"text"},{"text":"here","type":"text","marks":[{"type":"link","attrs":{"href":"https://europeana.atlassian.net/wiki/x/AYDeiw"}}]},{"text":". ","type":"text"}]},{"type":"expand","attrs":{"title":"Excerpt from the record enriched with organisation entity"},"content":[{"type":"codeBlock","content":[{"text":"[...]\n\n \n \n [ other Provider’s Aggregation data ]\n \n[...]\n\n Naturalis Biodiversity Center\n [ other properties of Organisation entity]\n","type":"text"}]},{"type":"paragraph","content":[{"text":"Note the prefLabel from the contextual class is displayed on the record page as clickable entity.","type":"text","marks":[{"type":"em"}]}]}]},{"type":"paragraph"},{"type":"heading","attrs":{"level":1},"content":[{"text":"Providing information about organisations in EDM","type":"text"}]},{"type":"paragraph","content":[{"text":"To ensure successful enrichment, all providers should make sure to supply correct providing organisations in relevant EDM fields:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":" ","type":"text"},{"text":"edm:dataProvider","type":"text","marks":[{"type":"link","attrs":{"href":"https://europeana.atlassian.net/wiki/spaces/EF/pages/2106032160/ore+Aggregation#edm%3AdataProvider"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"edm:provider","type":"text","marks":[{"type":"link","attrs":{"href":"https://europeana.atlassian.net/wiki/spaces/EF/pages/2106032160/ore+Aggregation#edm%3Aprovider"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"edm:intermediateProvider","type":"text","marks":[{"type":"link","attrs":{"href":"https://europeana.atlassian.net/wiki/spaces/EF/pages/2106032160/ore+Aggregation#edm%3AintermediateProvider"}}]}]}]}]},{"type":"paragraph"},{"type":"paragraph","content":[{"text":"Organisation can either be provided as a literal value or URI:","type":"text"}]},{"type":"table","attrs":{"layout":"align-start","width":1800.0,"localId":"e60ffd29-0ff7-4b53-877a-33c9ba4d4822"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[358.0]},"content":[{"type":"paragraph","content":[{"text":"Datatype","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[756.0]},"content":[{"type":"paragraph","content":[{"text":"Example","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[671.0]},"content":[{"type":"paragraph","content":[{"text":"Keep in mind","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[358.0]},"content":[{"type":"paragraph","content":[{"text":"Literal value ","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"[Name of providing organisation in its original language or English, ","type":"text"}]},{"type":"paragraph","content":[{"text":"acronyms are also accepted]","type":"text"}]},{"type":"paragraph"},{"type":"paragraph"}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[756.0]},"content":[{"type":"paragraph","content":[{"text":"Naturalis Biodiversity Center","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[671.0]},"content":[{"type":"panel","attrs":{"panelType":"success"},"content":[{"type":"paragraph","content":[{"text":"Ensure that the values provided in the data match those supplied in the spreadsheet. ","type":"text"}]},{"type":"paragraph","content":[{"text":"When submitting multiple datasets from the same organisation, please maintain consistency by using the same names for the same organisations.","type":"text"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[358.0]},"content":[{"type":"paragraph","content":[{"text":"URI","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"[Vocabulary URIs and persistent identifiers (PID) for organisations, ","type":"text"}]},{"type":"paragraph","content":[{"text":"as well as Europeana organisation entity URI]","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[756.0]},"content":[{"type":"paragraph","content":[{"text":"","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"In addition to the Europeana organisation entity, other appropriate URIs include (note this list is not exhaustive):","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Virtual International Authority File (VIAF): ","type":"text"},{"text":"http://viaf.org/viaf/[ENTITY_ID]","type":"text","marks":[{"type":"code"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The Getty - Union List of Artist Names (ULAN): ","type":"text"},{"text":"http://vocab.getty.edu/ulan/[ENTITY_ID]","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Gemeinsame Normdatei (GND): ","type":"text"},{"text":"https://d-nb.info/gnd/[ENTITY_ID]","type":"text","marks":[{"type":"code"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"International Standard Name Identifier (ISNI): ","type":"text"},{"text":"https://isni.org/isni/[ENTITY_ID]","type":"text","marks":[{"type":"code"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Archival Resource Key (ARK): ","type":"text"},{"text":"https://[Name Mapping Authority]/ark:/[Name Assigning Authority Number]/[assigned Name with optional Qualifiers]","type":"text","marks":[{"type":"code"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The Research Organization Registry (ROR): ","type":"text"},{"text":"https://ror.org/[ENTITY_ID]","type":"text","marks":[{"type":"code"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Wikidata: ","type":"text"},{"text":"http://www.wikidata.org/entity/[ENTITY_ID]","type":"text","marks":[{"type":"code"}]}]}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[671.0]},"content":[{"type":"panel","attrs":{"panelType":"success"},"content":[{"type":"paragraph","content":[{"text":"Ensure you provide the correct URI pattern and notify Europeana by either recording the URI in the SameAs column of the spreadsheet or adding it to the Data Provider field in the Jira submission form. This allows us to record it in Zoho CRM.","type":"text"}]},{"type":"paragraph","content":[{"text":"Currently, you can only supply a Europeana entity URI for existing data providers. If you wish to do so, you will need to know the Europeana identifier for the organisation, which is the last part of the entity URI: ","type":"text"},{"text":"http://data.europeana.eu/organization/[ENTITY_ID]","type":"text","marks":[{"type":"code"}]}]}]}]}]}]},{"type":"panel","attrs":{"panelType":"success"},"content":[{"type":"paragraph","content":[{"text":"Europeana identifiers for organisations","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"expand","attrs":{"title":"Finding existing providing organisations"},"content":[{"type":"paragraph","content":[{"text":"To search for existing organisations that have already provided data to Europeana, you can use ","type":"text"},{"text":"this tool","type":"text","marks":[{"type":"link","attrs":{"href":"https://rnd-2.eanadev.org/share/entities/search.html"}}]},{"text":". Simply focus your search on organisation entities by ticking the \"Organisation\" option and add keywords in the search bar:","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center","width":1770,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":4020,"alt":"Screenshot 2024-06-21 at 18.40.05.png","id":"2bf1084f-68c8-49eb-8bca-6f79c78b902d","collection":"contentId-2617442393","type":"file","height":554}}]},{"type":"paragraph","content":[{"text":"When you click on one of the results, you will be taken to the entity page for this specific organisation on Europeana website: ","type":"text"},{"text":"https://www.europeana.eu/en/collections/organisation/4513-naturalis-biodiversity-center","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"The last segment of the URL after \"/organisation/\" contains the Europeana identifier for this specific organisation. In this case, the identifier is 4513. ","type":"text"}]},{"type":"paragraph","content":[{"text":"When submitting URIs in EDM, follow this pattern: ","type":"text"},{"text":"http://data.europeana.eu/organization/[ENTITY_ID]","type":"text","marks":[{"type":"code"}]}]}]},{"type":"paragraph"}],"version":1}