IQSS/8533 Update Internal Semantic Mappings

doc/release-notes/8533_semantic-api-updates.md

@@ -0,0 +1,14 @@
+
+## Notes for Developers and Integrators
+
+This release include an update to the experimental semantic API and the underlying assignment of URIs to metadatablock termshat are not explicitly mapped to terms in community vocabularies. The change affects the output of the OAI_ORE metadata export, the OAI_ORE file in archival bags, and the input/out allowed for those terms in the semantic api. For those updating integrating code or existing files intended for input into this release of Dataverse: URIs of the form:
+  https://dataverse.org/schema/<block name>/<parentField name>#<childField title>, and
+  https://dataverse.org/schema/<block name>/<Field title>
+  are both replaced with URIs of the form:
+  https://dataverse.org/schema/<block name>/<Field name>
+
+## Additional Release Steps
+
+Upgrade should include re-export of metadata files (only the OAI_ORE is affected).
+
+For this PR and other changes coming from DataCommons, it will also be advisable for people archiving Bags to re-archive. More detail on the overall set if changes in those tbd PRs.

doc/sphinx-guides/source/_static/api/dataset-create.jsonld

@@ -2,14 +2,14 @@
   "http://purl.org/dc/terms/title": "Darwin's Finches",
   "http://purl.org/dc/terms/subject": "Medicine, Health and Life Sciences",
   "http://purl.org/dc/terms/creator": {
-      "https://dataverse.org/schema/citation/author#Name": "Finch, Fiona",
-      "https://dataverse.org/schema/citation/author#Affiliation": "Birds Inc."
+      "https://dataverse.org/schema/citation/authorName": "Finch, Fiona",
+      "https://dataverse.org/schema/citation/authorAffiliation": "Birds Inc."
   },
-  "https://dataverse.org/schema/citation/Contact": {
-    "https://dataverse.org/schema/citation/datasetContact#E-mail": "[email protected]",
-    "https://dataverse.org/schema/citation/datasetContact#Name": "Finch, Fiona"
+  "https://dataverse.org/schema/citation/datasetContact": {
+    "https://dataverse.org/schema/citation/datasetContactEmail": "[email protected]",
+    "https://dataverse.org/schema/citation/datasetContactName": "Finch, Fiona"
   },
-  "https://dataverse.org/schema/citation/Description": {
-    "https://dataverse.org/schema/citation/dsDescription#Text": "Darwin's finches (also known as the Galápagos finches) are a group of about fifteen species of passerine birds."
+  "https://dataverse.org/schema/citation/dsDescription": {
+    "https://dataverse.org/schema/citation/dsDescriptionValue": "Darwin's finches (also known as the Galápagos finches) are a group of about fifteen species of passerine birds."
   }
 }

doc/sphinx-guides/source/_static/api/dataset-migrate.jsonld

@@ -1,25 +1,25 @@
 {
-"citation:Depositor": "Admin, Dataverse",
-"Title": "Test Dataset",
-"Subject": "Computer and Information Science",
-"Creator": {
-  "author:Name": "Admin, Dataverse",
-  "author:Affiliation": "GDCC"
+"citation:depositor": "Admin, Dataverse",
+"title": "Test Dataset",
+"subject": "Computer and Information Science",
+"author": {
+  "citation:authorName": "Admin, Dataverse",
+  "citation:authorAffiliation": "GDCC"
 },
-"Deposit Date": "2020-10-08",
-"citation:Distributor": {
-  "distributor:Name": "Demo Dataverse Repository",
-  "distributor:Affiliation": "Dataverse Community",
-  "distributor:Abbreviation": "GDCC",
-  "distributor:URL": "https://dataverse.org/global-dataverse-community-consortium"
+"dateOfDeposit": "2020-10-08",
+"citation:distributor": {
+  "citation:distributorName": "Demo Dataverse Repository",
+  "citation:distributorAffiliation": "Dataverse Community",
+  "citation:distributorAbbreviation": "GDCC",
+  "citation:distributorURL": "https://dataverse.org/global-dataverse-community-consortium"
 },
-"citation:Contact": {
-"datasetContact:Name": "Admin, Dataverse",
-"datasetContact:Affiliation": "GDCC",
-"datasetContact:E-mail": "[email protected]"
+"citation:datasetContact": {
+"citation:datasetContactName": "Admin, Dataverse",
+"citation:datasetContactAffiliation": "GDCC",
+"citation:datasetContactEmail": "[email protected]"
 },
-"citation:Description": {
-  "dsDescription:Text": "A short description"
+"citation:dsDescription": {
+  "citation:dsDescriptionValue": "A short description"
 },
 "@id": "doi:10.33564/FK27U7YBV",
 "schema:version": "1.0",
@@ -29,15 +29,11 @@
 "dvcore:fileRequestAccess": false
 },
 "@context": {
-  "Creator": "http://purl.org/dc/terms/creator",
-  "Deposit Date": "http://purl.org/dc/terms/dateSubmitted",
-  "Subject": "http://purl.org/dc/terms/subject",
-  "Title": "http://purl.org/dc/terms/title",
-  "author": "https://dataverse.org/schema/citation/author#",
+  "author": "http://purl.org/dc/terms/creator",
+  "dateOfDeposit": "http://purl.org/dc/terms/dateSubmitted",
+  "subject": "http://purl.org/dc/terms/subject",
+  "title": "http://purl.org/dc/terms/title",
   "citation": "https://dataverse.org/schema/citation/",
-  "datasetContact": "https://dataverse.org/schema/citation/datasetContact#",
-  "distributor": "https://dataverse.org/schema/citation/distributor#",
-  "dsDescription": "https://dataverse.org/schema/citation/dsDescription#",
   "dvcore": "https://dataverse.org/schema/core#",
   "schema": "http://schema.org/"
 }}