ARK Persistent Identifier#

Archival Resource Key (ARK) is a multi-purpose, general identifier which can be used as references for information objects. depositar assigns ARKs as persistent identifiers (PID) to datasets via the ckanext-ark extension, just like the Digital Object Identifier (DOI).

Note

This feature is a work in process. If you have any comment or feedback, please contact us.

depositar assigns ARKs followed by ark: (e.g. ark:37281/k5c8w2q9c) using the following rules:

  • 37281: The NAAN (Name Assigning Authority Number) registered on N2T.net to identify the organization that assigns ARKs.

  • k5: The fixed and dedicated sub-namespace (shoulder in the ARK) for datasets on the depositar.

  • A unique identifier (blade in the ARK): The identifier is seven characters long and coded using the redededk template:

    • r means that the seven-character-long identifier is quasi-randomly generated.

    • e means that the character is one of the extended digits {0123456789bcdfghjkmnpqrstvwxz}.

    • d means that the character is one of the pure digits {0123456789}.

    • k is the final check character.

For the technical specification of the ARK, please refer to the IETF Internet Draft.

The Criteria for Assigning ARKs#

To ensure that the ARKs are shared broadly and fulfill the metadata requirements, a public dataset will acquire an ARK identifier if it has the following fields:

  • Title

  • Start Time and/or End Time

  • Creator

Note

  • Please refer to Metadata.

  • Please also refer to Editing a dataset to learn more about public and private datasets. Make a private dataset public will acquire an ARK identifier, too.

  • If the above fields are removed after an ARK identifier is assigned, the ARK identifier will still be active, and its metadata (ERC) will contain the above fields.

Linking to Dataset via ARK#

You can get the ARK identifier followed by ark: and its URL using the ARK Identifier widget in the bottom left corner of the dataset page:

../_images/ark_1.png

The ARK URL will lead you to the target dataset.

The Name Mapping Authority (NMA) of depositar is https://pid.depositar.io/. You can also use the NMA provided by N2T.net, just replace the https://pid.depositar.io/ part in the URL with https://n2t.net/.

Note

The NMA of the demo system (https://demo.depositar.io/) is https://demo.depositar.io/. And there is neither N2T.net support nor a commitment about the persistent access of ARKs for the demo system.

ARK Identifier Metadata (ERC)#

With the ?info inflection appended to the ARK URL, you can get the simple metadata of the identifier.

Note

The metadata is called Electronic Resource Citation (ERC). depositar uses ERC to briefly describe dataset.

The ERC record is a JSON file with the erc attribute including the following information:

Field

Description

From Metadata

what

Title

Title

when

Temporal Information

Start Time and End Time (in YYYYMMDD-YYYYMMDD)

where

URL of ARK

N/A (generated automatically)

who

Creator

Creator

Defunct ARK Identifier#

The ARK identifier will be defunct under the following circumstances:

  • Make a public dataset private, then access the ARK URL without read permission of the dataset.

  • Remove a dataset, then access the ARK URL without logging in as the creator of the dataset.

  • Purge a dataset, then access the ARK URL (only sysadmin has the right to purge a dataset).

You will see the Defunct ARK page as follows:

../_images/ark_2.png

For the first two cases aforementioned, the defunct ARK identifier still partially works as follows:

  • Make a public dataset private, then access the ARK URL with logging in as user with read permission of the dataset.

  • Remove a dataset, then access the ARK URL with logging in as the creator of the dataset.

Note

  • If you make the private dataset public or restore the deleted dataset, the defunct ARK identifier will be active again.

  • The metadata (ERC) of the defunct ARK identifier remains available.
https://docs.depositar.io/en/6.6.5/user-guide/ark-identifier.html
docs.depositar.io
CC-MAIN-2024-22
29559
application/http; msgtype=response
sha1:BTWIO7HVGRQDFJ4WVMQZKW5OYUWGHEWV
<urn:uuid:02b477d1-285e-4687-ae8a-f9ab63df5e22>
2024-05-23T16:08:44Z
104.17.32.82
text/html
sha1:2A7ISAP4YVK2EWSCFZEHZAITQDDEPTRC
<urn:uuid:de5df052-9e19-41d3-b741-134af5955987>
https://docs.depositar.io/en/6.6.5/user-guide/ark-identifier.html
response
<urn:uuid:d27fff94-187a-481d-bdb0-00be1d3ada06>
isPartOf: CC-MAIN-2024-22
publisher: Common Crawl
description: Wide crawl of the web for May 2024
operator: Common Crawl Admin (info@commoncrawl.org)
hostname: ip-10-67-67-22
software: Apache Nutch 1.19 (modified, https://github.com/commoncrawl/nutch/)
robots: checked via crawler-commons 1.5-SNAPSHOT (https://github.com/crawler-commons/crawler-commons)
format: WARC File Format 1.1
conformsTo: https://iipc.github.io/warc-specifications/specifications/warc-format/warc-1.1/