Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Proposed solution discussions, in reverse chronological order

2019.1112.3015 Draft Inflection Spec: "?info"

The info inflection is a string, "?info", that may be added to an ARK before resolving it in order to request the return of human- and machine-readable metadata describing the identified object and the commitment made to it by its provider. A successful response returns metadata content as HTML intended for human consumption, along with embedded JSON -LD intended for machine consumption. Future extensions are expected that will permit the request and return of alternate formats. Embedded HTML meta tags that repeat some of the metadata using schema.org element names are recommended because not all processors recognize JSON -LD metadata. It is acceptable in the short term also to recognize the older "?" and "??" inflections and to treat them as synonymous with "?info", but their behavior may change in future versions of the ARK specification.

...

The object metadata returned in response to the info inflection depends not only on the object's immediate descriptive attributes but also on the object type and its place in a constituent cluster. For example, an ARK identifying a published article could have immediate attributes such as author (who), title (what), and date (when), but also, because it is a publication, additional core attributes such as publisher and length (number of pages). The article, one of eight in a particular issue of a journal, might also have multiple versions, in multiple formats, and might contain logical parts such as Abstract, Article, Appendices, and References. These represent its constituent cluster, which is a set of objects with which a given object has any of the following relationships: hasPart, isPartOf, isSiblingOf, HasFormat, hasVersion. For example, our article isPartOf a journal issue, hasPart References, and hasFormat(s) PDF and HTML. Because of its place in the cluster, the article's metadata should contain a link to the issue of which it is part. Note that link Link relationships within the constituent cluster exist independent of whether they are ARKs or whether they are ARKs that use the reserved '/' and '.' characters.

<script type="application/ld+json">
{
"@contextid_requested": "http://schema.org"...",
"id_normalized": "...",
"@typeid_surrogate": "Dataset",
"@id": "https://n2t.net/ark:/12345/x408001.v2",
"...", # (optional) different id for digital surrogate, implies requested id is about physical object
"id_up1": "...", # (optional) different id for 1st interesting landing page "above" this level
"id_up2": "...", # (optional) different id for 2nd interesting landing page "above" the up1 level
"report": {
"_comment": "The next 5 elements are for very broad cross-domain interoperation.",
"who": "National Cancer Institute; ICPSR - Interuniversity Consortium for Political and Social Research",
"what": "Cancer Surveillance and Epidemiology in the United States and Puerto Rico, 1973–1977",
"when": "1984-05-03",
"where": "https://n2t.net/ark:/12345/x408001.v2",
"how": "(:mtype data) Dataset",
"hasPartthumbnail": [
"https://n2t.net/ark:/12345/x408001.v2/file.xsl",

"_comment"https://n2t.net/ark:/12345/x408001.v2/file.csv: "metatype-dependent core",
"https://n2t.net/ark:/12345/x408001.v2/file.pdf"
],

"parentpersistence": "https://n2t.net/ark:/12345/x408001",
"cite-as": "https://n2t.net/ark:/12345/x408001.v2",
"stickiness": [
"_comment": "for these terms, see https://datascience.codata.org/articles/10.5334/dsj-2017-039/",
"indefinite", "keeping {
"object": [ "indefinite", "standard" ],
"content": [ "keeping", "waxing" ],
"identifier": [ "single_use", "opaque", "intraversioned", "standardunbranded" ],
"provider": [ "NRmission", "OPnonprofit"
],
]
},
"cite-as": "https://n2t.net/ark:/12345/x408001.v2",

"_comment": "The next 6 elements are for interoperation within the 'data' domain.domain-dependent metadata",
"name": "Cancer Surveillance and Epidemiology in the United States and Puerto Rico, 1973–1977",
"producer": "National Cancer Institute",
"archive": "ICPSR - Interuniversity Consortium for Political and Social Research",
"datePublished": "1984-05-03",
"dateModified": "2015-08-06T11:20:58Z",
"version": "v2",
}
</script>

<!-- why? because not everyone recognizes JSON script metadata -->
<meta name="DC.identifier" content="ark:/12345/x408001.v2" scheme="DCTERMS.URI"/>
<meta name="DC.title" content="Cancer Surveillance and Epidemiology in the United States and Puerto Rico, 1973–1977"/>
<meta name="DC.creator" content="National Cancer Institute"/>
<meta name="DC.publisher" content="ICPSR - Interuniversity Consortium for Political and Social Research"/>
<meta name="DC.date" content="1984-05-03" scheme="DCTERMS.W3CDTF"/>
<meta name="DC.type" content="Dataset"/>

...