Overview

If you are a DiVA Portal customer and are using our OAI-PMH integration with the swepub_mods metadata prefix we’re able to configure your Explorer For Institutions integration to support reading a CSV file from an external service giving you the freedom and control to see your department names exactly how you want and in the way that makes the most sense. 


It might be that you want to translate your department names from Swedish to English or simplify certain department names so that they’re more easily identifiable for Explorer users. 


Using this documentation as a guide, you’ll just need to create a CSV file that matches our specification below and then have it hosted somewhere publicly accessible ready for our system to consume.


The integration supports any HTTPS service which means that you’ll be able to use popular services like Dropbox, Google Drive or your own hosting infrastructure.


The OAI-PMH feed sync is scheduled to run weekly which means that we’ll update your department names at the same time as your research outputs and authors. Any changes to the file will automatically be processed by us and appear within the Explorer the next day.


That’s it - when you’re ready for us to start consuming this new endpoint please contact us at support@altmetric.com to let us know. We’ll then perform a few checks to get things tested before making the changes live.


So whether you are a new client currently in the onboarding stage or you’re an existing one looking to make some changes to your OAI-PMH feed - we’re here to help. If using a CSV file to translate/rename departments in the Explorer is something that you are interested in please feel free to reach out to us at support@altmetric.com and we’ll be happy to answer any questions.


Schema

CSV

Column header

Required

Description

name

Yes

This is the current name as it appears on the research output in the feed. This can be found under the XML tag name within record > metadata. The element will have name of name and the attribute type set to “corporate” - see example below.

rename

Yes

This is the new name for the department that you want to show within the Explorer.


Notes
  • All headers are required
  • All headers must appear in the exact order case as described
  • Only department names that require translating/renaming are required
  • We recommend quoting values to ensure that the column count remains consistent


Example

Below is an example of how a research output might look in your repository.

<name type="corporate" authority="lu" xlink:href="123">
    <namePart>Lilliput universitet</namePart>
    <namePart>Samhällsvetenskapliga fakulteten</namePart>
    <namePart>Sociologiska institutionen</namePart>
    <role>
        <roleTerm type="code" authority="marcrelator">pbl</roleTerm>
    </role>
</name>


Here we're translating the department name from Swedish to English but you could easily use this feature to rename departments to an alternative Swedish name.


CSV


name,rename
"Lilliput universitet","Lilliput University"
"Samhällsvetenskapliga fakulteten","The social science faculty"
"Sociologiska institutionen","Department of Sociology"
"Institutionen för etnologi, religionshistoria och genusstudier","Department of Ethnology, History of Religions and Gender Studies"
"Institutionen för geologi och geokemi","Department of Geology and Geochemistry"