Add IGSN IDs to your Inventory Items 🧪

For instructions on setting up the integration, see Configure DataCite IGSN IDs in Inventory (for System Administrators).

Introduction

IGSN IDs

IGSN IDs are persistent and unique identifiers ("PIDs") for physical samples. By associating an IGSN ID with a sample, you enable transparency and traceability between research objects. This is achieved by providing a publicly accessible web page that contains the sample metadata, serving as a unique "source of truth" when referencing the sample in research outputs.

The IGSN ID metadata also describes relationships between the resource and other related materials, such as projects, institutions, people, and research outputs; it can also be used to identify an individual sample, a group of samples, or to a feature-of-interest (a collection site for samples). To learn more, see About IGSN IDs for Material Samples.

DataCite Integration

Research Space is now a DataCite Registered Service Provider, and the first to provide IGSN ID creation and registration services! DataCite provides a IGSN ID registration service through their DOI infrastructure, and a global PID Graph search interface through DataCite Commons. By integrating seamlessly with the DataCite API, we provide support for IGSN IDs and enable institutions to create, publish and update the IGSN ID metadata all without leaving RSpace Inventory.

By connecting to an existing institutional DataCite repository through the DataCite API, we ensure that the institution retains full ownership and control over their repositories: the repository is always managed by the institution, with RSpace Inventory only accessing the repository to perform IGSN-related actions.

Try it out

If you are a Team or Enterprise customer, you can use the integration after becoming a DataCite member and configuring the integration. See Configure DataCite IGSN IDs in Inventory (for System Administrators).

You can request credentials for test servers from DataCite, if you wish to try the integration out on your own RSpace server first. Alternatively, you can use the shared Inventory Test Server to preview the functionality provided.

Features

Overview

The DataCite documentation provides extensive information on the functionality, metadata format, and use cases of IGSN IDs. We recommend reviewing DataCite's Getting Started with IGSN IDs guide to start.

The following describes how we've implemented the integration.

IGSN identifiers can be in one of three states, which correspond to DataCite DOI states:

  • Draft: a newly created IGSN ID without any public metadata
    • An Inventory item will start without any PIDs.
    • When a user reserves an IGSN ID for an item, DataCite provides a IGSN ID for the item in Draft state, but no metadata about the item is sent from RSpace to DataCite.
    • Reserving an IGSN ID enables the metadata entry section, where users can fill in IGSN ID metadata fields they intend to make public.
    • A Draft IGSN ID can be deleted, as it's not yet part of the global handle system.
    • The preview page of a Draft IGSN will display any currently set ROR data
  • Findable: a published, searchable IGSN ID with a public landing page
    • After all mandatory IGSN ID fields have been completed, the user can publish the IGSN ID to make the metadata publicly accessible and searchable.
    • RSpace generates a persistent landing page for the sample that includes all IGSN ID metadata for the item, and sends the metadata and landing page URL to DataCite.
    • DataCite registers the IGSN ID with the global handle system, indexes the IGSN ID in DataCite Commons and the DataCite APIs, and sets the IGSN ID to resolve to the RSpace landing page.
    • This IGSN ID is the unique and persistent identifier for this item, and can be used in citations to reliably reference the item.
    • Any ROR data currently set on the RSpace instance is sent to DataCite as part of publication. ROR data does not change for published IGSNs, even if the RSpace instance changes its ROR settings.
  • Registered: an IGSN ID that has been retracted from public access
    • An IGSN ID that is Findable can be set to Registered to hide the item and its associated metadata from public access, in case the wrong item was published.
    • Note that the Members API can still be used to access this item, so please take care before publishing that all the information is to be made public.
    • Rectracting an IGSN removes any ROR data from DataCite. Current ROR data will be available on the preview page for the IGSN in RSpace.

Available features

We focus on providing support for the core DataCite IGSN ID lifecycle:

  • Create Draft IGSN ID
  • Populate mandatory metadata
  • Populate recommended fields:
    • Subject
    • Description
    • Date
    • Alternate Identifier
    • Geolocation
  • Publish & generate persistent landing page
  • Make metadata updates and publish again
  • Retract a published IGSN ID
  • Delete an IGSN ID draft
  • Preview landing page
  • Associate a ROR ID

Create an IGSN ID

RSpace can reserve an IGSN ID in Draft state to be associated with an individual RSpace Inventory item. IGSN ID metadata will be available to fill out in RSpace, but the metadata and identifier are not made public at this stage.

The Draft IGSN ID can be deleted, or published to explicitly make the metadata publicly accessible.

To create an IGSN ID:

  1. Open the Identifiers section on a sample, subsample, or container
  2. Press the + icon to create an IGSN ID. Each Inventory item can only be assigned 1 IGSN ID. Note that if you are in the process of creating a new item, you will need to save the item first before being able to create an IGSN ID for it.
    If you get a "The Identifier could not be created. IGSN integration is not enabled on this RSpace instance." error, please contact your System Administrator.
  3. The identifier section now shows the Draft IGSN ID and its metadata fields. Required fields have been prepopulated with default values.
    RSpace does not send metadata to DataCite when an IGSN ID is in Draft state, the metadata is only made public when publishing the IGSN ID.

Edit IGSN ID metadata

  1. Click on Edit when viewing an item
  2. Scroll to the Identifiers section, and make the required edits, or add recommended fields.
  3. Save to confirm the changes.
Saving a sample does not send the updated IGSN ID in DataCite or on the landing page, it enables you to save any in-progress changes to the metadata without making them public. To make the changes public, you need to explicitly Publish the IGSN.

Geolocations

You can associate various geolocation data with each IGSN. The specification for how this data is captured is quite complex, so here's an overview.

Format options

First, each geolocation can be described using one or more methods: as a point, a description, a box, and/or a polygon.

All longitudes and latitudes use decimal degrees rather than minutes and seconds, so any decimal value between -90.0 and 90.0 inclusively for latitudes, and -180.0 and 180.0 inclusively for longitudes, is valid.

  • The point is a single longitude and latitude pair. Both values need to be set to define a point.
  • The description is a textual description of the place. A sample may have been collected at a particular site, with the site's location described by the other geolocation properties, while the address is included here.
  • The box is a region defined by four bounds, in each of the cardinal directions. This is useful for describing approximate regions, again, using decimal degrees.
  • The polygon method provides a mechanism for accurately describing a region based on a series of vertices. The first and last points are always the same, enclosing an area. For the avoidance of any ambiguity, an additional point within the enclosed region can also be specified, but this is only really necessary when it may not be obvious whether the region is the area inside the points, or the rest of the Earth.
Preview map

The point, box, and polygon are shown on a map both in Inventory and on the public page, alongside the numerical coordinates, to make it easier to visualise the location being described. Points are shown as a blue circle, with the precise point being at the circle's center. Boxes are shown as red rectangles, and the polygons are shown in orange.

The partial screenshot below shows a point at the Royal Observatory and a region of Greenwich park by means of a bounding box.

Note that you can pan the map by clicking and dragging, and use the plus and minus icons to zoom in/out. You can also temporarily toggle the visibility of various data on the map, by using the toggles below it (the selection resets once you refresh a page).

Publishing geolocations

Each geolocation entry needs to be defined by at least one of these methods, but can also be described by all four. Multiple geolocation entries can be added to the same IGSN, and the methods they use to describe a location can be different.

Once one or more of these methods of defining geolocation data have been specified, for as many locations as desired, the IGSN can be published. Whilst the Inventory item with the IGSN can be saved at any time, if the geolocation data is invalid, e.g. a coordinate is missing or outside of the valid range, then the IGSN cannot be published.

Include Inventory metadata

Various metadata associated with the item in Inventory, but not part of the IGSN schema, can be included on the IGSN landing page to provide a comprehensive, domain-specific record of the item. This includes description, tags, the custom fields as populated from the template, and any extra fields that have been added to the item.

Make sure that there isn't any sensitive information stored on the item record in Inventory, as this data will now be accessible to the wider Internet.
  1. To include these fields on the public page, simply check the box labelled "Include custom fields and general item metadata on landing page?".
  2. To set these changes live, Preview the updated landing page to make sure you are happy with the fields that will be made public, then Publish or Republish the item.
  3. The fields will now be visible on the public page, and within the preview dialog going forward. Note that any updates to these fields will not automatically show on the public page, as the IGSN must be republished first.

Publish an IGSN ID

Publishing sets the IGSN ID state to Findable on DataCite. The IGSN ID and its metadata, alongside a landing page generated by RSpace, will be made publicly accessible through DataCite Commons and DataCite APIs. A persistent, citable IGSN ID URL will be created, pointing to the landing page.

After publishing, the IGSN ID cannot be returned to a Draft state. Changing the state to Registered keeps the metadata visible to other DataCite Members via the Member API.

See DataCite DOI States for more information.

Before publishing, please ensure the IGSN ID metadata provided does not contain any information you do not want to make public, as this action cannot be fully undone.

To publish an IGSN ID:

  1. Click on Publish in the Identifiers section. The button is only enabled if all required fields are filled in.
  2. The state of the IGSN ID changes to Findable. A persistent and public landing page is generated and hosted by RSpace. The IGSN ID redirects to this landing page, providing a stable URL that can be used to share and reference this item.
    A direct link to the RSpace landing page is also provided for convenience, but the IGSN ID should be used in public references to the item.

Update an IGSN ID

Any IGSN ID metadata changes you make in RSpace are not made public until you explicitly publish them. We recommend only updating an IGSN to provide additional metadata, or to correct any errors.

If the item has been modified significantly enough to exhibit different properties, you need to decide whether it is important for you that an IGSN ID always points to a specific version of the item, e.g. if the IGSN ID is going to be referenced in a paper. If so, we recommend creating a separate item in RSpace, assigning it a new IGSN ID, and clearly indicating the link between the historical and new item in their metadata.

To update an IGSN ID:

  1. Make required changes to the IGSN ID metadata fields
  2. Click on Republish
  3. The landing page will now reflect the latest version of the metadata

Delete an IGSN ID

Deleting removes the IGSN ID and its association with this item.

Only Draft IGSN IDs can be deleted. For hiding Findable IGSN IDs from public access, see the Retract an IGSN ID section below.

To delete an IGSN ID:

  1. Click on Delete in the Identifiers section.
  2. The IGSN ID is deleted and removed from the section.
    A new Draft IGSN ID can be created and associated with the item in the future, whether the item had a Draft IGSN ID previously or not. However, only one IGSN ID can be associated with an item at any one time.
    Deleting an IGSN ID also removes all metadata you might have filled in, therefore we recommend only deleting an IGSN ID if you are confident this item will not require one for the time being.

Retract an IGSN ID

Click on Retract to change a Findable IGSN ID into a Registered IGSN ID. This will remove the IGSN ID from DataCite Commons and the DataCite Public API, as well as display no metadata on the landing page. Keep in mind the Member API can still be used to access historical metadata about the item.

If you wish to have the sample be public again, you can publish it to turn it back to Findable.


How did we do?


Powered by HelpDocs (opens in a new tab)