DSPACE: Importing Entities

For this, you will need python, poetry shell, and a code editor.

Clone relevant git repository

New .yml

Go to default-config.yml. The code should look like the following:

Copy default-config.yml and rename the new copy config.yml.

Then, log into OJS and get an API key. To do this, go to Edit Profile > API key. Copy the key.

Inside config.yml, paste the API key for token.

Fill in journal_title, url, oai_endpoint, title, default_thumbnail, date, description, subjects, and alternative. default_thumbnail should be a link to an image. subjects should come from Library of Congress subject headings. alternative should only be used for an alternative title.

Creating .csv file

Under ojs-to-oaktrust, create a new directory called output.

On the command line, write:

articles.csv, issues.csv, title.csv, and volumes.csv should have saved under ojs-to-oaktrust/output/journal_title folder.

Creating Simple Archive Format (SAF) Files

Run Java in terminal.

This should open a dialogue box called DSpace Simple Archive Format Creator.

You need a folder for the SAF output. Because there will be four folders created per journal, it is recommended you first make a folder called oaktrust-batches. Then create the folder for output from a single execution of SAF. An easy naming convention is “journal_name-unit”. “unit” can be articles, issues, volumes, or title. You will do this process four times per journal.

In the dialogue box:

  • Select one of the .csv files. The unit of the .csv file should match the unit of the folder you just created for output.

  • Select source files directory. This can be any directory that is not involved with this transfer process (such as the /Desktop). It doesn’t really matter.

  • Select SAF output directory. Select the new folder you just created called “journal_name-unit”

  • Click “Load specified batch now!”

  • Go to Batch Verification across the top and click “Verify Batch.”

  • Create SAF file (rightmost button under Batch Details).

Importing SAF Files

Create a zip file. When using a Mac, this must be done through command line or else it will give errors later.

Go to * Oaktrust Log in with Shibboleth. On the sidebar, go to Import > Batch Import. When asked for a collection, select “Journals”. Upload zip file.

Note: Sometimes “Import” does not appear as an option in the sidebar, in which case you must wait/reload the page until it appears.

Creating Child Unit of Parent Unit

This will follow mostly the same process as before. However, once the csv files generate, you will need to go to the websites for the parent unit and copy all characters in the url after the last slash. Then go to the child unit’s .csv and add that string at the end of each line after the last comma (creating another column). Make sure all children with the same url are from the same parent. This will link the child to the parent.