Draft for #513: Update of Actors, ResearchProducts,ResearchProductVersions, DigitalIdentifiers and their relationships.

schemas/actors/affiliation.schema.tpl.json

@@ -1,29 +1,24 @@
 {
   "_type": "core:Affiliation",
   "required": [
-    "memberOf"
+    "person",
+    "organization"
   ],
   "properties": {
-    "endDate": {
-      "type": "string",
-      "_formats": [
-        "date"
-      ],
-      "_instruction": "Enter the end date of this affiliation, formatted as 'YYYY-MM-DD'. Leave blank if this affiliation is still current."
+    "person": {
+      "_instruction": "Add the individual to whom this affiliation belongs.",
+      "_linkedTypes": [
+        "core:Person"
+      ]
     },
-    "memberOf": {
-      "_instruction": "Add the organization or consortium another party was or still is a member of.",
-      "_linkedTypes": [        
-        "core:Consortium",
+    "organization": {
+      "type": "array",
+      "minItems": 1,
+      "uniqueItems": true,
+      "_instruction": "Add all organizations (in display order) with which the specified individual is affiliated.",
+      "_linkedTypes": [
         "core:Organization"
       ]
-    },    
-    "startDate": {
-      "type": "string",
-      "_formats": [
-        "date"
-      ],
-      "_instruction": "Enter the start date of this affiliation, formatted as 'YYYY-MM-DD'."
     }
   }
 }

schemas/actors/consortium.schema.tpl.json

@@ -1,7 +1,7 @@
 {
   "_type": "core:Consortium",
   "_categories": [
-    "legalPerson"
+    "actor"
   ],
   "required": [
     "fullName"

schemas/actors/contactInformation.schema.tpl.json

@@ -5,11 +5,16 @@
   ],
   "properties": {
     "email": {
-      "type": "string",
-      "_formats": [
-        "email"
-      ],
-      "_instruction": "Enter the email address of the party (e.g., of the person)."
+      "type": "array",
+      "items": {
+        "type": "string",
+        "_formats": [
+          "email"
+        ]
+      },
+      "minItems": 1,
+      "uniqueItems": true,
+      "_instruction": "Enter all relevant contact email addresses."
     }
   }
 }

schemas/actors/contribution.schema.tpl.json

@@ -6,16 +6,16 @@
   ],
    "properties": {
      "contributor": {
-       "_instruction": "Add all types of contribution made by the stated 'contributor'.",
+       "type": "array",
+       "minItems": 1,
+       "uniqueItems": true,
+       "_instruction": "Add all contributors who performed this contribution.",
        "_linkedCategories": [
          "legalPerson"
        ]
-     },     
+     },
      "type": {
-       "type": "array",
-       "minItems": 1,
-       "uniqueItems": true,
-       "_instruction": "Add the party that performed the contribution.",
+       "_instruction": "Add the type of contribution.",
        "_linkedTypes": [
          "controlledTerms:ContributionType"
        ]

schemas/actors/organization.schema.tpl.json

@@ -1,35 +1,48 @@
 {
   "_type": "core:Organization",
   "_categories": [
+    "actor",
     "legalPerson"
   ],
   "required": [
-    "fullName"
+    "countryOfFormation",
+    "fullName",
+    "type"
   ],
   "properties": {
-    "affiliation": {
+    "acronym": {
+      "type": "string",
+      "_instruction": "Enter the acronym of this organization."
+    },
+    "alternateName": {
       "type": "array",
+      "items": {
+        "type": "string"
+      },
       "minItems": 1,
       "uniqueItems": true,
-      "_instruction": "Enter all current and, if necessary, past affiliations of this organization.",
-      "_embeddedTypes": [
-        "core:Affiliation"
+      "_instruction": "Enter any other known name or acronym of this organization."
+    },
+    "countryOfFormation": {
+      "_instruction": "Add the country where the organization was formed.",
+      "_linkedTypes": [
+        "controlledTerms:SovereignState"
       ]
     },
     "digitalIdentifier": {
       "type": "array",
       "minItems": 1,
       "uniqueItems": true,
       "_instruction": "Add all globally unique and persistent digital identifier of this organization.",
-      "_linkedTypes": [
-        "core:GRIDID",
-        "core:RORID",
-        "core:RRID"
+      "_linkedCategories": [
+        "organizationIdentifier"
       ]
     },
-    "fullName": {
-      "type": "string",
-      "_instruction": "Enter the full name of this organization."
+    "location": {
+      "_instruction": "Add the headquarters location of this organization.",
+      "_embeddedTypes": [
+        "core:Location"
+      ]
     },
     "hasParent": {
       "type": "array",
@@ -47,9 +60,22 @@
       ],
       "_instruction": "Enter the internationalized resource identifier (IRI) to the homepage of this organization."
     },
-    "shortName": {
+    "jurisdiction": {
+      "_instruction": "Add the jurisdiction under which the organization operates.",
+      "_linkedCategories": [
+        "jurisdiction"
+      ]
+    },
+    "name": {
       "type": "string",
-      "_instruction": "Enter a short name (or alias) for this organization that could be used as a shortened display title (e.g., for web services with too little space to display the full name)."
+      "_instruction": "Enter the organization’s preferred name for use in international contexts."
+    },
+    "type": {
+      "type": "string",
+      "_instruction": "Add the type of this organization (e.g., company, non-profit organization, government).",
+      "_embeddedTypes": [
+        "controlledTerms:OrganizationType"
+      ]
     }
   }
 }

schemas/actors/person.schema.tpl.json

@@ -1,22 +1,14 @@
 {
   "_type": "core:Person",
   "_categories": [
+    "actor",
     "agent",
     "legalPerson"
   ],
   "required": [
-    "givenName"
+    "preferredName"
   ],
-  "properties": {    
-    "affiliation": {
-      "type": "array",
-      "minItems": 1,
-      "uniqueItems": true,
-      "_instruction": "Enter all current and, if desired, past affiliations of this person.",
-      "_embeddedTypes": [
-        "core:Affiliation"
-      ]
-    },
+  "properties": {
     "alternateName": {
       "type": "array",
       "items": {
@@ -52,11 +44,15 @@
     },
     "familyName": {
       "type": "string",
-      "_instruction": "Enter the family name of this person."
+      "_instruction": "Enter the family name, surname, or equivalent of this person."
     },
     "givenName": {
       "type": "string",
-      "_instruction": "Enter the given name of this person."
+      "_instruction": "Enter the given name(s) of this person, or a name chosen in place of the given name. At least one of the names should be spelled out in full; initials may be used for the others."
+    },
+    "preferredName": {
+      "type": "string",
+      "_instruction": "Enter the person’s preferred way to write their name in a professional context. It is recommended to place given before family name separated by space."
     }
   }
 }

schemas/data/serviceLink.schema.tpl.json

@@ -14,7 +14,7 @@
         "core:FileBundle",
         "core:ModelVersion",        
         "publications:LivePaperResourceItem",
-        "https://openminds.ebrains.eu/sands/ParcellationEntityVersion"
+        "sands:ParcellationEntityVersion"
       ]
     },
     "displayLabel": {

schemas/digitalIdentifier/GRIDID.schema.tpl.json

@@ -1,5 +1,8 @@
 {
   "_type": "core:GRIDID",
+  "_category": [
+    "organizationIdentifier"
+  ],
   "required": [
     "identifier"
   ],

schemas/digitalIdentifier/ISNI.schema.tpl.json

@@ -0,0 +1,16 @@
+{
+  "_type": "core:ISNI",
+  "_category": [
+    "organizationIdentifier"
+  ],
+  "required": [
+    "identifier"
+  ],
+  "properties": {
+    "identifier": {
+      "type": "string",
+      "pattern": "^https?://(www.)?isni.org/(isni/)?\\d{15}[\\dX]$)",
+      "_instruction": "Enter the identifier for legal entities provided by the International Standard Name Identifier Assignment Agency ('International Standard Name Identifier'; ISNI) as an internationalized resource identifier (IRI) following the defined pattern (i.e., 'https://isni.org/' + ISNI)."
+    }
+  }
+}

schemas/digitalIdentifier/LEI.schema.tpl.json

@@ -0,0 +1,16 @@
+{
+  "_type": "core:LEI",
+  "_category": [
+    "organizationIdentifier"
+  ],
+  "required": [
+    "identifier"
+  ],
+  "properties": {
+    "identifier": {
+      "type": "string",
+      "pattern": "^https://lei.global/LEI/[A-Z0-9]{18}\\d{2}$",
+      "_instruction": "Enter the identifier for legal entities provided by a local operating unit delegated by the Global Legal Entity Identifier Foundation ('Legal Entity Identifier'; LEI) as an internationalized resource identifier (IRI) following the defined pattern (i.e., 'https://lei.global/LEI/' + LEI)."
+    }
+  }
+}

schemas/digitalIdentifier/RORID.schema.tpl.json

@@ -1,5 +1,8 @@
 {
   "_type": "core:RORID",
+  "_category": [
+    "organizationIdentifier"
+  ],
   "required": [
     "identifier"
   ],

schemas/digitalIdentifier/RRID.schema.tpl.json

@@ -1,5 +1,8 @@
 {
   "_type": "core:RRID",
+  "_category": [
+    "organizationIdentifier"
+  ],
   "required": [
     "identifier"
   ],

schemas/digitalIdentifier/genericIdentifier.tpl.json

@@ -7,7 +7,9 @@
   "properties": {
     "emitter": {
       "_instruction": "Add the organization that governs and/or emits the identifier.",
-      "_linkedTypes": ["core:Organization"]
+      "_linkedTypes": [
+        "core:Organization"
+      ]
     },
     "identifier": {
       "type": "string",

schemas/products/dataset.schema.tpl.json

@@ -1,19 +1,7 @@
 {
   "_type": "core:Dataset",
   "_extends": "products/researchProduct.schema.tpl.json",
-  "required": [
-    "author"
-  ],
   "properties": {
-    "author": {
-      "type": "array",
-      "minItems": 1,
-      "uniqueItems": true,
-      "_instruction": "Add all parties that contributed to this dataset as authors.",
-      "_linkedCategories": [
-        "legalPerson"
-      ]
-    },
     "digitalIdentifier": {
       "_instruction": "Add the globally unique and persistent digital identifier of this research product. Note that this digital identifier will be used to reference all attached research product versions.",
       "_linkedTypes": [

schemas/products/datasetVersion.schema.tpl.json

@@ -10,15 +10,6 @@
     "technique"
   ],
   "properties": {
-    "author": {
-      "type": "array",
-      "minItems": 1,
-      "uniqueItems": true,
-      "_instruction": "Add all parties that contributed to this dataset version as authors. Note that these authors will overwrite the author list provided for the overarching dataset.",
-      "_linkedCategories": [
-        "legalPerson"
-      ]
-    },
     "behavioralProtocol": {
       "type": "array",
       "minItems": 1,
@@ -69,10 +60,10 @@
         "core:File",
         "core:FileBundle",
         "core:WebResource",
-        "https://openminds.ebrains.eu/sands/BrainAtlas",
-        "https://openminds.ebrains.eu/sands/BrainAtlasVersion",
-        "https://openminds.ebrains.eu/sands/CommonCoordinateSpace",
-        "https://openminds.ebrains.eu/sands/CommonCoordinateSpaceVersion"
+        "sands:BrainAtlas",
+        "sands:BrainAtlasVersion",
+        "sands:CommonCoordinateSpace",
+        "sands:CommonCoordinateSpaceVersion"
       ]
     },
     "isPrecededBy": {

schemas/products/metaDataModel.schema.tpl.json

@@ -1,19 +1,7 @@
 {
   "_type": "core:MetaDataModel",
   "_extends": "products/researchProduct.schema.tpl.json",
-  "required": [
-    "developer"
-  ],
   "properties": {
-    "developer": {
-      "type": "array",
-      "minItems": 1,
-      "uniqueItems": true,
-      "_instruction": "Add all parties that developed this (meta)data model.",
-      "_linkedCategories": [
-        "legalPerson"
-      ]
-    },
     "digitalIdentifier": {
       "_instruction": "Add the globally unique and persistent digital identifier of this research product. Note that this digital identifier will be used to reference all attached research product versions.",
       "_linkedTypes": [

schemas/products/metaDataModelVersion.schema.tpl.json

@@ -6,15 +6,6 @@
     "type"
   ],
   "properties": {
-    "developer": {
-      "type": "array",
-      "minItems": 1,
-      "uniqueItems": true,
-      "_instruction": "Add all parties that developed this (meta)data model version. Note that these developers will overwrite the developer list provided for the overarching (meta)data model.",
-      "_linkedCategories": [
-        "legalPerson"
-      ]
-    },
     "digitalIdentifier": {
       "_instruction": "Add the globally unique and persistent digital identifier of this research product version.",
       "_linkedTypes": [