ICAT to DOI Metadata Mapping

Below is a mapping of the DOI metadata key values and where they are sourced from.

Key	Source	Comments

Key	Source	Comments
`id`	Datacite	Returned from datacite when the draft is created. See here
`doi`	Datacite	Returned from datacite when the draft is created. See here
`url`	config + ICAT	A base url is set which the DP ID is added to.
`types`	Script	Based on values here
`creators`	`Investigation.investigationUsers.user`
`affiliation.name`	`Investigation.investigationUsers.user.affiliation`
`affiliation.affiliationIdentifier`	ror.org	Returned through the ROR API
`affiliation.affiliationIdentifierScheme`	Script	Hardcoded to ROR
`titles`
`publisher`	Script	Hardcoded to “Diamond Light Source”
`dates.date`	Script	Generated at the time of minting
`dates.dateType`	Script	Based on values here
`publicationYear`	Script	Generated at the time of minting
`descriptions`	`Investigation.summary`
`schemaVersion`	Datacite	Returned from datacite when the draft is created. See here
`providerId`	Datacite	Returned from datacite when the draft is created. See here
`clientId`	Datacite	Returned from datacite when the draft is created. See here

Below is an example set of metadata of a DOI created through the api.

{
  "id": "https://doi.org/10.5286/zq3m-b974", 
  "doi": "10.5286/ZQ3M-B974",
  "url": "https://example.stfc.ac.uk/2703900162",
  "types": {
    "ris": "DATA",
    "bibtex": "misc",
    "citeproc": "dataset",
    "schemaOrg": "Dataset",
    "resourceTypeGeneral": "Dataset"
  },
  "creators": [
    {
      "name": "Dr Caroline Kirk",
      "nameType": "Personal",
      "givenName": "Caroline",
      "familyName": "Kirk",
      "affiliation": {
        "name": "University of Edinburgh",
        "affiliationIdentifier": "https://ror.org/01nrxwf90",
        "affiliationIdentifierScheme": "ROR"
      }
    },
    {
      "name": "Dr Fred Mosselmans",
      "nameType": "Personal",
      "givenName": "Fred",
      "familyName": "Mosselmans",
      "affiliation": {
        "name": "Diamond Light Source",
        "affiliationIdentifier": "https://ror.org/05etxs293",
        "affiliationIdentifierScheme": "ROR"
      }
    },
    {
      "name": "Dr Paul Schofield",
      "nameType": "Personal",
      "givenName": "Paul",
      "familyName": "Schofield",
      "affiliation": {
        "name": "Natural History Museum",
        "affiliationIdentifier": "https://ror.org/039zvsn29",
        "affiliationIdentifierScheme": "ROR"
      }
    },
    {
      "name": "Dr Andy Smith",
      "nameType": "Personal",
      "givenName": "Andy",
      "familyName": "Smith",
      "affiliation": {
        "name": "University of Manchester",
        "affiliationIdentifier": "https://ror.org/027m9bs27",
        "affiliationIdentifierScheme": "ROR"
      }
    }
  ],
  "titles": [
    {
      "title": "SP73-1: Micro-Fluorescence  and Spectroscopic Characterisation of the 
      Santa Catharina Iron Meteorite"
    }
  ],
  "publisher": "Diamond Light Source",
  "container": {},
  "subjects": [],
  "contributors": [],
  "dates": [
    {
      "date": "2022-08-22"
    },
    {
      "dateType": "Created"
    }
  ],
  "publicationYear": 2022,
  "identifiers": [],
  "sizes": [],
  "formats": [],
  "rightsList": [],
  "descriptions": [
    {
      "description": "The Santa Catharina iron meteorite is unique in that the host metal phase has an 
      Fe:Ni ratio equivalent to that of an FeNi Invar alloy (~35 wt% Ni). Of particular interest is the 
      fact that the very slow cooling of the meteorite has resulted in the existence of equilibrium phases 
      that cannot be produced experimentally. Santa Catharina is also important due to its anomalously 
      high oxygen content (8-12 wt%) and the existence of the recently proposed phase antitaenite, 
      an atomically disordered, low-Ni, low-moment FeNi alloy. We request a total of 7 days of beamtime 
      on I18 to study the phases and textural relationships within the Santa Catharina meteorite. 2 days 
      will be dedicated to XRF mapping for which the beamline will be initially optimised and 5 days for 
      microXAS mapping at the Fe, Ni and P K-edges. These results will be ocmbined with our ongoing XPEEM 
      and SEM studies."
    }
  ],
  "geoLocations": [],
  "fundingReferences": [],
  "relatedIdentifiers": [],
  "schemaVersion": "http://datacite.org/schema/kernel-4",
  "providerId": "bl",
  "clientId": "bl.stfc",
  "agency": "datacite",
  "state": "findable"
}