Import of Sisis SunRise Files
This is technical documentation for the plugin to import Sisis SunRise files to processes in Goobi workflow.

Introduction

This documentation describes the installation, configuration and use of the plugin to import Sisis SunRise files.
Details
Text
Identifier
intranda_import_sisis_sunrise_files
Licence
GPL 2.0 or newer
Compatibility
Goobi workflow 2021.01
Documentation date
16.07.2021

Installation

The plugin must be installed in the following folder:
1
/opt/digiverso/goobi/plugins/import/plugin_intranda_import_sisis_sunrise_file.jar
Copied!
There is also a configuration file, which must be located at the following location:
1
/opt/digiverso/goobi/config/plugin_intranda_import_sisis_sunrise_file.xml
Copied!
Additionally there is a tags file, whose location is specified in the configuration file:
1
<tags>/path/to/tags.txt</tags>
Copied!

Configuration

The configuration is done via the configuration file plugin_intranda_import_sisis_sunrise_file.xml and can be adapted during operation.
1
<config_plugin>
2
<config>
3
<!-- which workflow template shall be used -->
4
<template>*</template>
5
6
<!-- define if import shall use GoobiScript to run in the background -->
7
<runAsGoobiScript>true</runAsGoobiScript>
8
9
<!-- Ruleset for the MM files: -->
10
<rulesetPath>src/test/resources/ruleset.xml</rulesetPath>
11
12
<!-- Path to images: -->
13
<imagePathFile>/opt/digiverso/import/images</imagePathFile>
14
15
<!-- Ruleset for the MM files -->
16
<tags>/opt/digiverso/import/tags.txt</tags>
17
18
<!-- Use SGML files? -->
19
<withSGML>false</withSGML>
20
21
<!-- Path to SGML files, if withSGML -->
22
<sgmlPath></sgmlPath>
23
24
<!-- default publication type if it cannot be detected. If missing or empty, no record will be created -->
25
<defaultPublicationType>Monograph</defaultPublicationType>
26
27
<!-- Collection name -->
28
<collection>Disserationen</collection>
29
30
<!-- Prefix to add to every ID number -->
31
<idPrefix>mpilhlt_sisis_</idPrefix>
32
33
<!-- Remove the image files from their original folders -->
34
<moveFiles>false</moveFiles>
35
36
<!-- List of IDs to import. If empty, import all files -->
37
<listIDs></listIDs>
38
39
</config>
40
</config_plugin>
Copied!
The configuration allows different configurations for different process templates. For this purpose, only the name of the desired template must be entered in the template field. The entry with the value * is used for all templates for which no separate configuration exists.
Configuration Element
Use
rulesetPath
This is the path to the ruleset for the MetsMods files.
imagePathFile
This parameter defines the path to the image files, which are located either in the folder itself or in subfolders with the name of the Catalogue identifier.
tags
This parameter defines the translation file that translates the codes into metadata.
withSGML
If this parameter is set to true, then SGML files are used. Note that this is currently not in use, but intended for a later version.
sgmlPath
If SGML files are used, this is the folder in which they are found.
defaultPublicationType
With this parameter the Type of the document is defined if it has no children or parents. A document with children is imported as MultiVolumeWork, the children are imported as Volumes.
collection
This specifies the metadata singleDigCollection for the MetsMods files, the name of the collection to which the works belong.
listIDs
Here you define the path to a text file containing a list of Catalogue Identifiers. If this field is not empty, then only datasets with these Catalogue Identifiers will be imported from the Sisis SunRise file.

Tags

A tags file may look something like this:
1
0000 CatalogIDDigital
2
0014 shelfmarksource
3
0015 DocLanguage
4
0024 CurrentNoSorting
5
0025 CurrentNoSorting
6
0089 CurrentNo
7
0100 Author
8
0101 OtherPerson
9
0200 Corporation
10
0201 Corporation
11
0304 OtherTitle
12
0310 TitleDocMain
13
0331 TitleDocMain
14
0335 TitleDocSub1
15
0341 OtherTitle
16
0359 StatementOfResponsibility
17
0361 Note
18
0403 EditionStatement
19
0410 PlaceOfPublication
20
0412 PublisherName
21
0413 Printer
22
0425 PublicationYear
23
0432 Stock
24
0433 physicalDescriptionExtent
25
0440 PrintingLocation
26
0451 TitleDocMainSeries
27
0501 Note
28
0519 DissertationNote
29
0540 ISBN
30
0590 Resource
31
0655 URLbib
32
0902 SubjectTopic
33
0907 SubjectTopic
34
0912 SubjectTopic
35
0917 SubjectTopic
36
0922 SubjectTopic
37
0927 SubjectTopic
38
0932 SubjectTopic
39
0937 SubjectTopic
40
1371 OtherTitle
Copied!
Each line contains a code, followed by the name of the metadata which it should be translated to. Every metadata type in the list must be defined in the ruleset used for the project into which the file is to be imported, and the CatalogIDDigital must be defined, as it is used to create the process ID.

Usage

To use the import, the mass import area must be opened in the process templates and the intranda_import_sisis_sunrise_file plugin must be selected in the File upload import tab. A Sisis SunRise file can then be uploaded and imported.
The import takes place in several steps. First the whole file is read, and the maps child-parent and parent-children are created and saved (as JSON files) in the Goobi temp folder for the current user. These maps are used to create anchor files in the next step.
The Sisis SunRise file is then broken into individual records. For each record, the process title is generated from the Catalogue Identifier (and any prefix specified in the configuration file) and checked to see whether the process already exists in Goobi. If this is not the case, the process is created and the configured metadata for anchor and volume is saved temporarily in a folder in the output path specified in the configuration. Any images are copied into an ´images` subfolder.
In the next step all these folders, containing the MetsMods files and the images, are imported into Goobi workflow as processes, and moved to the appropriate folders in Goobi.
Last modified 1mo ago