DaSCH Ark Resolver Data

This repository holds data for the DaSCH Ark Resolver service running at https://ark.dasch.swiss.

How to add a new project?

Create a branch and do the following:

Add the project to the data/shortcodes.md file with its shortcode, shortname, long name and old Salsah ID.
Add the project's shortcode to the data/dasch_ark_registry.ini file (data/dasch_ark_registry_test.ini or data/dasch_ark_registry_staging.ini if you want to add a configuration to test or staging). See example below or existing entries for guidance or see https://github.com/dasch-swiss/ark-resolver.
Add a new test to the tests/ directory with the name test_shortcode.tavern.yaml. See existing tests for guidance.
Create a new PR.

Example project configuration

An example project configuration in the data/dasch_ark_registry.ini file looks like this:

############################################################################
# Example Project

# The project's shortcode (`[...]`) and resources host (`Host`) are mandatory. All other parameters can be left out if 
# not used. A default value / template is used in this case. Default templates are defined in the top section of 
# dasch_ark_registry.ini. By setting the parameter in the project's section of the file, the default value / template is
# overwritten.

# The project's shortcode
[ABCD]

# The hostname to be used in redirect URLs for this project's resources.
Host: admin.dasch.swiss

# The hostname to be used in redirect URL for this project's metadata.
ProjectHost: project-metadata.dasch.swiss

# The template to be used for generating redirect URLs referring to DSP values.
DSPValueRedirectUrl : https://values.dasch.swiss/value/$resource_iri/$value_id

# true if the PHP-based server should be used for this project (i.e. if project is on Salsah)
UsePhp: true

# true if this project can accept version 0 ARK URLs
AllowVersion0: true

Examples of ARKs used in DSP

Example ARK of a resource with timestamp:

https://ark.dasch.swiss/ark:/72163/1/082B/SQkTPdHdTzq_gqbwj6QR=AR.20210712T074941501291Z
\_____________________/\___/\____/\/\___/\_____________________/\/\______________________/
     (replacable)        |     |   |   |              |         |          |
           |         ARK Label | DSP-internal    Resource ID    |   Timestamp (= Version)
           |                   | ARK Version                    |   of Resource (optional)
    Name Mapping               |       |                        |
    Authority Hostport         |    DSP Project               check
                               |    Shortcode                 digit
                               |
                        Name Assigning
                        Authority Number
                        (NAAN)

Example ARK of a resource without timestamp (points to resource's latest version):

https://ark.dasch.swiss/ark:/72163/1/082B/SQkTPdHdTzq_gqbwj6QR=AR

Example ARK of a value with timestamp:

https://ark.dasch.swiss/ark:/72163/1/082B/SQkTPdHdTzq_gqbwj6QR=AR/=SSbnPK3Q7WWxzBT1UPpRgo.20210712T074941501291Z

Example ARK of a value without timestamp (points to value's latest version):

https://ark.dasch.swiss/ark:/72163/1/082B/SQkTPdHdTzq_gqbwj6QR=AR/=SSbnPK3Q7WWxzBT1UPpRgo

Example ARK of a project with shortcode 082B:

https://ark.dasch.swiss/ark:/72163/1/082B

Example of an ARK redirect in DSP

The following ARK of a resource:

https://ark.dasch.swiss/ark:/72163/1/082B/0mqGISATQUC7ZWAZKyDcxQZ.20210712T074909165439Z

...interpreted as:

https://ark.dasch.swiss/ark:/72163/1/[$project_id]/[$resource_id][check digit].[$timestamp]

...is redirected to:

https://admin.dasch.swiss/resource/http:%2F%2Frdfh.ch%2F082B%2F0mqGISATQUC7ZWAZKyDcxQ?version=20210712T074909165439Z

...interpreted as:

https://admin.dasch.swiss/resource/http:%2F%2Frdfh.ch%[$project_id]%2F[$resource_id]?version=[$timestamp]

Example of a custom project ARK redirect pattern

The following example shows how to change the default behavior of project ARK redirects.

An ARK of a project looks like this: https://ark.dasch.swiss/ark:/72163/1/ABCD for project with short code ABCD. Per default, it is redirected to https://meta.dasch.swiss/projects/ABCD (as defined in data/dasch_ark_registry.ini).

This behavior can be changed for a project by either setting another host for the project ARK (variable ProjectHost in the file data/dasch_ark_registry.ini). For example:

[ABCD]
Host: admin.dasch.swiss
ProjectHost: meta.dasch.swiss

This would redirect the ARK https://ark.dasch.swiss/ark:/72163/1/ABCD to https://meta.dasch.swiss/projects/ABCD. So, only the host is changed.

Or you can set the variable DSPProjectRedirectUrl with your own pattern or a hard coded URL. For example:

[ABCD]
Host: admin.dasch.swiss
DSPProjectRedirectUrl: https://other/host/my/pattern/$project_ids

This would redirect the ARK https://ark.dasch.swiss/ark:/72163/1/ABCD to https://other/host/my/pattern/ABCD.

Requirements

To install the requirements:

pip3 install -r requirements.txt

To generate the requirements file (requirements.txt), that you commit with the project, do:

pip3 freeze > requirements.txt

dasch-swiss / ark-resolver-data