refactor!: change all project IRIs to contain UUID instead of shortco…

…de (DEV-1400) (#2255)
dasch-swiss · Oct 27, 2022 · f2b2584 · f2b2584
1 parent 3f77b6e
commit f2b2584
Show file tree

Hide file tree

Showing 308 changed files with 44,847 additions and 39,117 deletions.
diff --git a/docs/03-apis/api-admin/groups.md b/docs/03-apis/api-admin/groups.md
@@ -41,7 +41,7 @@
         {"value": "NewGroupDescription", "language": "en"},
         {"value": "NeueGruppenBeschreibung", "language": "de"}
       ],
-      "project": "http://rdfh.ch/projects/00FF",
+      "project": "http://rdfh.ch/projects/MTvoB0EJRrqovzRkWXqfkA",
       "status": true,
       "selfjoin": false
     }
@@ -55,7 +55,7 @@ specified by the `id` in the request body as below:
       "id": "http://rdfh.ch/groups/00FF/a95UWs71KUklnFOe1rcw1w",  
       "name": "GroupWithCustomIRI",
       "descriptions": [{"value": "A new group with a custom IRI", "language": "en"}],
-      "project": "http://rdfh.ch/projects/00FF",
+      "project": "http://rdfh.ch/projects/MTvoB0EJRrqovzRkWXqfkA",
       "status": true,
       "selfjoin": false
     }

diff --git a/docs/03-apis/api-admin/lists.md b/docs/03-apis/api-admin/lists.md
@@ -99,7 +99,7 @@ Additionally, each list can have an optional custom IRI (of [Knora IRI](../api-v
 ```json
   {
     "id": "http://rdfh.ch/lists/0001/yWQEGXl53Z4C4DYJ-S2c5A",
-    "projectIri": "http://rdfh.ch/projects/0001",
+    "projectIri": "http://rdfh.ch/projects/Lw3FC39BSzCwvmdOaTyLqQ",
     "name": "a new list",
     "labels": [{ "value": "New list with IRI", "language": "en"}],
     "comments": [{ "value": "New comment", "language": "en"}]
@@ -122,7 +122,7 @@ The response will contain the basic information of the list, `listinfo` and an e
                 }
             ],
             "name": "a new list",
-            "projectIri": "http://rdfh.ch/projects/0001"
+            "projectIri": "http://rdfh.ch/projects/Lw3FC39BSzCwvmdOaTyLqQ"
         }
     }
 }
@@ -142,7 +142,7 @@ The response will contain the basic information of the list, `listinfo` and an e
 ```json
      {   
          "parentNodeIri": "http://rdfh.ch/lists/0001/yWQEGXl53Z4C4DYJ-S2c5A",
-         "projectIri": "http://rdfh.ch/projects/0001",
+         "projectIri": "http://rdfh.ch/projects/Lw3FC39BSzCwvmdOaTyLqQ",
          "name": "a child",
          "labels": [{ "value": "New List Node", "language": "en"}]
     }
@@ -153,7 +153,7 @@ Additionally, each child node can have an optional custom IRI (of [Knora IRI](..
 ```json
 {    "id": "http://rdfh.ch/lists/0001/8u37MxBVMbX3XQ8-d31x6w",
      "parentNodeIri": "http://rdfh.ch/lists/0001/yWQEGXl53Z4C4DYJ-S2c5A",
-     "projectIri": "http://rdfh.ch/projects/0001",
+     "projectIri": "http://rdfh.ch/projects/Lw3FC39BSzCwvmdOaTyLqQ",
      "name": "a child",
      "labels": [{ "value": "New List Node", "language": "en"}]
 }
@@ -183,7 +183,7 @@ number of existing children.
 
 ```json
 {   "parentNodeIri": "http://rdfh.ch/lists/0001/yWQEGXl53Z4C4DYJ-S2c5A",
-    "projectIri": "http://rdfh.ch/projects/0001",
+    "projectIri": "http://rdfh.ch/projects/Lw3FC39BSzCwvmdOaTyLqQ",
     "name": "Inserted new child",
     "position": 0,
     "labels": [{ "value": "New List Node", "language": "en"}]
@@ -206,7 +206,7 @@ list and the IRI of the project it belongs to.
 
 ```json
  {   "listIri": "http://rdfh.ch/lists/0001/yWQEGXl53Z4C4DYJ-S2c5A",
-      "projectIri": "http://rdfh.ch/projects/0001",
+      "projectIri": "http://rdfh.ch/projects/Lw3FC39BSzCwvmdOaTyLqQ",
       "name": "new name for the list",
       "labels": [{ "value": "a new label for the list", "language": "en"}],
       "comments": [{ "value": "a new comment for the list", "language": "en"}]
@@ -232,7 +232,7 @@ The response will contain the basic information of the list, `listinfo` (or `nod
             }
         ],
         "name": "new name for the list",
-        "projectIri": "http://rdfh.ch/projects/0001"
+        "projectIri": "http://rdfh.ch/projects/Lw3FC39BSzCwvmdOaTyLqQ"
     }
 }
 ```

diff --git a/docs/03-apis/api-admin/permissions.md b/docs/03-apis/api-admin/permissions.md
@@ -34,7 +34,7 @@ included in the request body, for example:
 ```json
 {
     "forGroup":"http://rdfh.ch/groups/0001/thing-searcher", 
-    "forProject":"http://rdfh.ch/projects/0001", 
+    "forProject":"http://rdfh.ch/projects/Lw3FC39BSzCwvmdOaTyLqQ", 
     "hasPermissions":[
       {
         "additionalInformation":null,
@@ -60,7 +60,7 @@ As a response, the created administrative permission and its IRI are returned as
 {
     "administrative_permission": {
         "forGroup": "http://rdfh.ch/groups/0001/thing-searcher",
-        "forProject": "http://rdfh.ch/projects/0001",
+        "forProject": "http://rdfh.ch/projects/Lw3FC39BSzCwvmdOaTyLqQ",
         "hasPermissions": [
             {
                 "additionalInformation": null,
@@ -118,7 +118,7 @@ default object access permission for a group of a project the request body would
 ```json
 {
     "forGroup":"http://rdfh.ch/groups/0001/thing-searcher",
-    "forProject":"http://rdfh.ch/projects/0001",
+    "forProject":"http://rdfh.ch/projects/Lw3FC39BSzCwvmdOaTyLqQ",
     "forProperty":null,
     "forResourceClass":null,
     "hasPermissions":[
@@ -160,7 +160,7 @@ a resource class of a specific project:
 {
     "id": "http://rdfh.ch/permissions/00FF/fSw7w1sI5IwDjEfFi1jOeQ",
     "forGroup":null,
-    "forProject":"http://rdfh.ch/projects/00FF",
+    "forProject":"http://rdfh.ch/projects/MTvoB0EJRrqovzRkWXqfkA",
     "forProperty":null,
     "forResourceClass":"http://www.knora.org/ontology/00FF/images#bild",
     "hasPermissions":[
@@ -179,7 +179,7 @@ The response contains the newly created permission and its IRI, as:
 {
     "default_object_access_permission": {
         "forGroup": null,
-        "forProject": "http://rdfh.ch/projects/00FF",
+        "forProject": "http://rdfh.ch/projects/MTvoB0EJRrqovzRkWXqfkA",
         "forProperty": null,
         "forResourceClass": "http://www.knora.org/ontology/00FF/images#bild",
         "hasPermissions": [

diff --git a/docs/03-apis/api-admin/projects.md b/docs/03-apis/api-admin/projects.md
@@ -187,7 +187,7 @@ Operates on the following properties:
 The following is an example for project information stored in the `admin` named graph:
 
 ```
-<http://rdfh.ch/projects/00FF>
+<http://rdfh.ch/projects/MTvoB0EJRrqovzRkWXqfkA>
     rdf:type knora-admin:knoraProject ;
     knora-admin:projectShortname "images"^^xsd:string ;
     knora-admin:projectShortcode "00FF"^^xsd:string ;

diff --git a/docs/03-apis/api-admin/users.md b/docs/03-apis/api-admin/users.md
@@ -223,7 +223,7 @@ The following is an example for user information stored in the `admin` named gra
     knora-admin:password "$e0801$FGl9FDIWw+D83OeNPGmD9u2VTqIkJopIQECgmb2DSWQLS0TeKSvYoWAkbEv6KxePPlCI3CP9MmVHuvnWv8/kag==$mlegCYdGXt+ghuo8i0rLjgOiNnGDW604Q5g/v7zwBPU="^^xsd:string ;
     knora-admin:preferredLanguage "de"^^xsd:string ;
     knora-admin:status "true"^^xsd:boolean ;
-    knora-admin:isInProject <http://rdfh.ch/projects/00FF> ;
+    knora-admin:isInProject <http://rdfh.ch/projects/MTvoB0EJRrqovzRkWXqfkA> ;
     knora-admin:isInSystemAdminGroup "false"^^xsd:boolean ;
-    knora-admin:isInProjectAdminGroup <http://rdfh.ch/projects/00FF> .
+    knora-admin:isInProjectAdminGroup <http://rdfh.ch/projects/MTvoB0EJRrqovzRkWXqfkA> .
 ```
diff --git a/docs/03-apis/api-v2/editing-resources.md b/docs/03-apis/api-v2/editing-resources.md
@@ -107,7 +107,7 @@ For example, here is a request to create a resource with various value types:
     }
   },
   "knora-api:attachedToProject" : {
-    "@id" : "http://rdfh.ch/projects/0001"
+    "@id" : "http://rdfh.ch/projects/Lw3FC39BSzCwvmdOaTyLqQ"
   },
   "rdfs:label" : "test thing",
   "@context" : {
@@ -133,7 +133,7 @@ by adding `knora-api:attachedToUser`. For example:
     "knora-api:booleanValueAsBoolean" : true
   },
   "knora-api:attachedToProject" : {
-    "@id" : "http://rdfh.ch/projects/0001"
+    "@id" : "http://rdfh.ch/projects/Lw3FC39BSzCwvmdOaTyLqQ"
   },
   "knora-api:attachedToUser" : {
     "@id" : "http://rdfh.ch/users/9XBCrDV3SRa7kS1WwynB4Q"
@@ -189,7 +189,7 @@ can also have a custom creation date specified by adding `knora-api:creationDate
    "@id" : "http://rdfh.ch/0001/oveR1dQltEUwNrls9Lu5Rw",
    "@type" : "anything:Thing",
    "knora-api:attachedToProject" : {
-     "@id" : "http://rdfh.ch/projects/0001"
+     "@id" : "http://rdfh.ch/projects/Lw3FC39BSzCwvmdOaTyLqQ"
    },
    "anything:hasInteger" : {
        "@id" : "http://rdfh.ch/0001/oveR1dQltEUwNrls9Lu5Rw/values/IN4R19yYR0ygi3K2VEHpUQ",
@@ -352,7 +352,7 @@ The response to requesting a deleted resource will look as the following example
         "@type": "xsd:anyURI"
     },
     "knora-api:attachedToProject": {
-        "@id": "http://rdfh.ch/projects/0001"
+        "@id": "http://rdfh.ch/projects/Lw3FC39BSzCwvmdOaTyLqQ"
     },
     "knora-api:userHasPermission": "CR",
     "knora-api:attachedToUser": {

diff --git a/docs/03-apis/api-v2/editing-values.md b/docs/03-apis/api-v2/editing-values.md
@@ -311,7 +311,7 @@ Sipi. Here is an example of a request to create a resource of class `anything:Th
     "knora-api:fileValueHasFilename": "3UIsXH9bP0j-BV0D4sN51Xz.jp2"
   },
   "knora-api:attachedToProject": {
-    "@id": "http://rdfh.ch/projects/0001"
+    "@id": "http://rdfh.ch/projects/Lw3FC39BSzCwvmdOaTyLqQ"
   },
   "rdfs:label": "test thing",
   "@context": {

diff --git a/docs/03-apis/api-v2/knora-iris.md b/docs/03-apis/api-v2/knora-iris.md
@@ -16,8 +16,6 @@ Knora project regardless of where it is hosted. The IRIs of ontologies that
 are built into Knora do not contain shortcodes; these ontologies implicitly
 belong to the Knora system project.
 
-A user-created ontology IRI must always include its project shortcode.
-
 Project ID `0000` is reserved for shared ontologies
 (see [Shared Ontologies](../../02-knora-ontologies/introduction.md#shared-ontologies)).
 
@@ -188,7 +186,7 @@ Knora generates IRIs for data that it creates in the triplestore. Each
 generated data IRI contains one or more [UUID](https://tools.ietf.org/html/rfc4122)
 identifiers to make it unique. To keep data IRIs relatively short, each UUID is
 [base64url-encoded](https://tools.ietf.org/html/rfc4648#section-5), without padding;
-thus each UUID is a 22-character string.
+thus each UUID is a 22-character string. DSP-API supports UUID version 4 or 5.
 
 Data IRIs are not currently intended to be dereferenced as URLs.
 Instead, each Knora resource has a separate [permalink](permalinks.md).
@@ -208,10 +206,10 @@ follows:
   - Standoff tag:
     `http://rdfh.ch/PROJECT_SHORTCODE/RESOURCE_UUID/values/VALUE_UUID/STANDOFF_UUID`
   - XML-to-standoff mapping:
-    `http://rdfh.ch/PROJECT_SHORTCODE/mappings/MAPPING_NAME`
+    `http://rdfh.ch/projects/PROJECT_SHORTCODE/mappings/MAPPING_NAME`
   - XML-to-standoff mapping element:
-    `http://rdfh.ch/PROJECT_SHORTCODE/mappings/MAPPING_NAME/elements/MAPPING_ELEMENT_UUID`
-  - Project: `http://rdfh.ch/projects/PROJECT_SHORTCODE` (or `http://rdfh.ch/projects/PROJECT_UUID`)
+    `http://rdfh.ch/projects/PROJECT_SHORTCODE/mappings/MAPPING_NAME/elements/MAPPING_ELEMENT_UUID`
+  - Project: `http://rdfh.ch/projects/PROJECT_UUID`
   - Group: `http://rdfh.ch/groups/PROJECT_SHORTCODE/GROUP_UUID`
   - Permission:
     `http://rdfh.ch/permissions/PROJECT_SHORTCODE/PERMISSION_UUID`

diff --git a/docs/03-apis/api-v2/ontology-information.md b/docs/03-apis/api-v2/ontology-information.md
@@ -48,7 +48,7 @@ The response is in the complex API v2 schema. Sample response:
       },
       "rdfs:label": "The anything ontology",
       "knora-api:attachedToProject": {
-        "@id": "http://rdfh.ch/projects/0001"
+        "@id": "http://rdfh.ch/projects/Lw3FC39BSzCwvmdOaTyLqQ"
       },
       "@type": "owl:Ontology",
       "@id": "http://0.0.0.0:3333/ontology/0001/anything/v2"
@@ -60,7 +60,7 @@ The response is in the complex API v2 schema. Sample response:
       },
       "rdfs:label": "The something ontology",
       "knora-api:attachedToProject": {
-        "@id": "http://rdfh.ch/projects/0001"
+        "@id": "http://rdfh.ch/projects/Lw3FC39BSzCwvmdOaTyLqQ"
       },
       "@type": "owl:Ontology",
       "@id": "http://0.0.0.0:3333/ontology/0001/something/v2"
@@ -72,7 +72,7 @@ The response is in the complex API v2 schema. Sample response:
       },
       "rdfs:label": "The images demo ontology",
       "knora-api:attachedToProject": {
-        "@id": "http://rdfh.ch/projects/00FF" 
+        "@id": "http://rdfh.ch/projects/MTvoB0EJRrqovzRkWXqfkA" 
       },
       "@type": "owl:Ontology",
       "@id": "http://0.0.0.0:3333/ontology/00FF/images/v2"
@@ -84,7 +84,7 @@ The response is in the complex API v2 schema. Sample response:
       },
       "rdfs:label": "The BEOL ontology",
       "knora-api:attachedToProject": {
-        "@id": "http://rdfh.ch/projects/yTerZGyxjZVqFMNNKXCDPF"
+        "@id": "http://rdfh.ch/projects/bL0y8GRuTUiFmvF1oXbeFQ"
       },
       "@type": "owl:Ontology",
       "@id": "http://0.0.0.0:3333/ontology/0801/beol/v2"
@@ -96,7 +96,7 @@ The response is in the complex API v2 schema. Sample response:
       },
       "rdfs:label": "The Biblio ontology",
       "knora-api:attachedToProject": {
-        "@id": "http://rdfh.ch/projects/yTerZGyxjZVqFMNNKXCDPF"
+        "@id": "http://rdfh.ch/projects/bL0y8GRuTUiFmvF1oXbeFQ"
       },
       "@type": "owl:Ontology",
       "@id": "http://0.0.0.0:3333/ontology/0801/biblio/v2"
@@ -108,7 +108,7 @@ The response is in the complex API v2 schema. Sample response:
       },
       "rdfs:label": "The Newton-Project ontology",
       "knora-api:attachedToProject": {
-        "@id": "http://rdfh.ch/projects/yTerZGyxjZVqFMNNKXCDPF"
+        "@id": "http://rdfh.ch/projects/bL0y8GRuTUiFmvF1oXbeFQ"
       },
       "@type": "owl:Ontology",
       "@id": "http://0.0.0.0:3333/ontology/0801/newton/v2"
@@ -120,7 +120,7 @@ The response is in the complex API v2 schema. Sample response:
       },
       "rdfs:label": "The incunabula ontology",
       "knora-api:attachedToProject": {
-        "@id": "http://rdfh.ch/projects/0803"
+        "@id": "http://rdfh.ch/projects/yISnUYe6SYmoyuqeMdW39w"
       },
       "@type": "owl:Ontology",
       "@id": "http://0.0.0.0:3333/ontology/0803/incunabula/v2"
@@ -132,7 +132,7 @@ The response is in the complex API v2 schema. Sample response:
       },
       "rdfs:label": "The dokubib ontology",
       "knora-api:attachedToProject": {
-        "@id": "http://rdfh.ch/projects/0804"
+        "@id": "http://rdfh.ch/projects/oIjhUsZmQLuJ0VMGvJ2pfg"
       },
       "@type": "owl:Ontology",
       "@id": "http://0.0.0.0:3333/ontology/0804/dokubib/v2"
@@ -144,7 +144,7 @@ The response is in the complex API v2 schema. Sample response:
       },
       "rdfs:label": "The Anton Webern project ontology",
       "knora-api:attachedToProject": {
-        "@id": "http://rdfh.ch/projects/08AE"
+        "@id": "http://rdfh.ch/projects/NeWmPqGNQ5KVMAG6L8AjNA"
       },
       "@type": "owl:Ontology",
       "@id": "http://0.0.0.0:3333/ontology/08AE/webern/v2"
@@ -205,14 +205,14 @@ HTTP GET to http://host/v2/ontologies/metadata/PROJECT_IRI[/PROJECT_IRI...]
 The project IRIs must be URL-encoded.
 
 Example response for the `anything` test project
-(project IRI `http://rdfh.ch/projects/0001`):
+(project IRI `http://rdfh.ch/projects/Lw3FC39BSzCwvmdOaTyLqQ`):
 
 ```json
 {
   "@id" : "http://0.0.0.0:3333/ontology/0001/anything/v2",
   "@type" : "owl:Ontology",
   "knora-api:attachedToProject" : {
-    "@id" : "http://rdfh.ch/projects/0001"
+    "@id" : "http://rdfh.ch/projects/Lw3FC39BSzCwvmdOaTyLqQ"
   },
   "knora-api:lastModificationDate": "2017-12-19T15:23:42.166Z",
   "rdfs:label" : "The anything ontology",
@@ -601,7 +601,7 @@ sample ontology in the complex schema, `http://0.0.0.0:3333/ontology/00FF/images
   "@id" : "http://0.0.0.0:3333/ontology/00FF/images/v2",
   "@type" : "owl:Ontology",
   "knora-api:attachedToProject" : {
-    "@id" : "http://rdfh.ch/projects/00FF"
+    "@id" : "http://rdfh.ch/projects/MTvoB0EJRrqovzRkWXqfkA"
   },
   "rdfs:label" : "The images demo ontology",
   "@graph" : [ {

diff --git a/docs/03-apis/api-v2/permalinks.md b/docs/03-apis/api-v2/permalinks.md
@@ -54,7 +54,7 @@ For example:
     "@value" : "http://ark.dasch.swiss/ark:/72163/1/0803/2a6221216701W.20160302T150521Z"
   },
   "knora-api:attachedToProject" : {
-    "@id" : "http://rdfh.ch/projects/0803"
+    "@id" : "http://rdfh.ch/projects/yISnUYe6SYmoyuqeMdW39w"
   },
   "knora-api:attachedToUser" : {
     "@id" : "http://rdfh.ch/users/91e19f1e01"

diff --git a/docs/03-apis/api-v2/reading-and-searching-resources.md b/docs/03-apis/api-v2/reading-and-searching-resources.md
@@ -636,7 +636,7 @@ For example, the following response contains the list of events describing the v
                     "@type": "xsd:dateTimeStamp"
                 },
                 "knora-api:attachedToProject": {
-                    "@id": "http://rdfh.ch/projects/0001"
+                    "@id": "http://rdfh.ch/projects/Lw3FC39BSzCwvmdOaTyLqQ"
                 }
             },
             "knora-api:versionDate": {

diff --git a/docs/05-internals/design/api-admin/administration.md b/docs/05-internals/design/api-admin/administration.md
@@ -244,7 +244,7 @@ permission object with the compact form literal would be: :
 ```
 <http://rdfh.ch/permissions/001
         rdf:type knora-admin:AdministrativePermission ;
-        knora-admin:forProject <http://rdfh.ch/projects/00FF>;
+        knora-admin:forProject <http://rdfh.ch/projects/MTvoB0EJRrqovzRkWXqfkA>;
         knora-admin:forGroup knora-admin:ProjectMember ;
         knora-base:hasPermissions "ProjectResourceCreateAllPermission"^^xsd:string .
 ```
@@ -311,7 +311,7 @@ Example default object access permission instance:
 ```
 <http://rdfh.ch/permissions/002
         rdf:type knora-admin:DefaultObjectAccessPermission ;
-        knora-admin:forProject <http://rdfh.ch/projects/00FF>;
+        knora-admin:forProject <http://rdfh.ch/projects/MTvoB0EJRrqovzRkWXqfkA>;
         knora-admin:forGroup knora-admin:ProjectMember ;
         knora-base:hasPermissions "CR knora-admin:Creator|M knora-admin:ProjectMember|V knora-admin:KnownUser"^^xsd:string .
 ```
@@ -529,7 +529,7 @@ either *knora-admin:forGroup*, *knora-admin:forResourceClass*, or
 
 ```
 <http://rdfh.ch/permissions/[UUID]> rdf:type knora-admin:AdministrativePermission ;
-     knora-admin:forProject <http://rdfh.ch/projects/00FF> ;
+     knora-admin:forProject <http://rdfh.ch/projects/MTvoB0EJRrqovzRkWXqfkA> ;
      knora-admin:forGroup knora-admin:ProjectAdmin ;
      knora-base:hasPermissions "ProjectResourceCreateAllPermission|
                                 ProjectAdminAllPermission"^^xsd:string .
@@ -539,7 +539,7 @@ either *knora-admin:forGroup*, *knora-admin:forResourceClass*, or
 
 ```
 <http://rdfh.ch/permissions/[UUID]> rdf:type knora-admin:AdministrativePermission ;
-     knora-admin:forProject <http://rdfh.ch/projects/00FF> ;
+     knora-admin:forProject <http://rdfh.ch/projects/MTvoB0EJRrqovzRkWXqfkA> ;
      knora-admin:forGroup knora-admin:ProjectMember ;
      knora-base:hasPermissions "ProjectResourceCreateAllPermission"^^xsd:string .
 ```
@@ -565,7 +565,7 @@ either *knora-admin:forGroup*, *knora-admin:forResourceClass*, or
 
 ```
 <http://rdfh.ch/permissions/[UUID]> rdf:type knora-admin:DefaultObjectAccessPermission ;
-     knora-admin:forProject <http://rdfh.ch/projects/00FF> ;
+     knora-admin:forProject <http://rdfh.ch/projects/MTvoB0EJRrqovzRkWXqfkA> ;
      knora-admin:forGroup knora-admin:ProjectMember ;
      knora-base:hasPermissions "CR knora-admin:Creator|
                                  M <http://rdfh.ch/groups/[shortcode]/[UUID]>|