@open-resource-discovery/specification 1.10.0 → 1.11.0

package/static/spec-v1/interfaces/Document.annotated.schema.json

@@ -2,6 +2,7 @@
   "description": "The [ORD Document](../index.md#ord-document) object serves as a wrapper for the **ORD resources** and **ORD taxonomy** and adds further top-level information\nthat are specific to the document/the service it describes.\n\nThe constraints and considerations on [ORD Documents](../index.md#ord-document) MUST be followed.",
   "$schema": "http://json-schema.org/draft-07/schema#",
   "$id": "https://open-resource-discovery.github.io/specification/spec-v1/interfaces/Document.schema.json#",
+  "title": "ORD Document",
   "x-property-order": [
     "Document",
     "ApiResource",
@@ -22,7 +23,8 @@
     "Package": {
       "type": "object",
       "title": "Package",
-      "description": "A [**Package**](../../details/articles/grouping-and-bundling#package) organizes a set of related resources together, by publishing and catalog presentation concerns.\n\nThe Package can also be used to indicate which products or vendors provided the packaged resources.\nFor partner or customer content, the package can indicate this via the `vendor` and `partOfProducts` assignments.\nIn any case, the Package `ordID` namespace MUST reflect the namespace of the providing application (which hosts the resource), not the resource definition owner, which could be a customer or partner.\n\nA package SHOULD contain at least one resource. Avoid empty packages.\n\nThe package assignment of a resource MAY change, so consumers MUST not rely on this to be stable.\n\nA package does not have a `visibility` property.\nWhether it is displayed is decided by the fact, whether it contains any visible resources according to the visibility role of the aggregator.\n\nTo learn more about the concept and further guidance, see [Package](../../details/articles/grouping-and-bundling#package).",
+      "x-ums-type": "root",
+      "description": "A [**Package**](../concepts/grouping-and-bundling#package) organizes a set of related resources together, by publishing and catalog presentation concerns.\n\nThe Package can also be used to indicate which products or vendors provided the packaged resources.\nFor partner or customer content, the package can indicate this via the `vendor` and `partOfProducts` assignments.\nIn any case, the Package `ordID` namespace MUST reflect the namespace of the providing application (which hosts the resource), not the resource definition owner, which could be a customer or partner.\n\nA package SHOULD contain at least one resource. Avoid empty packages.\n\nThe package assignment of a resource MAY change, so consumers MUST not rely on this to be stable.\n\nA package does not have a `visibility` property.\nWhether it is displayed is decided by the fact, whether it contains any visible resources according to the visibility role of the aggregator.\n\nTo learn more about the concept and further guidance, see [Package](../concepts/grouping-and-bundling#package).",
       "properties": {
         "ordId": {
           "type": "string",
@@ -36,7 +38,7 @@
         "localId": {
           "type": "string",
           "x-introduced-in-version": "1.2.1",
-          "description": "Local ID, as known by the described system.\n\nThis can be the `<resourceName>` fragment in the ORD ID. In this case, make sure it fits the length limits of the ORD ID. It might also be different if e.g. localIds have incompatible charset restrictions.",
+          "description": "The locally unique ID under which this resource can be looked up / resolved in the described system itself.\nUnlike the ORD ID it's not globally unique, but it may be useful to document the original ID / technical name.\n\nIt MAY also be used as the `<resourceName>` fragment in the ORD ID, IF it can fulfill the charset and length limitations within the ORD ID.\nBut since this is not always possible, no assumptions MUST be made about the local ID being the same as the `<resourceName>` fragment in the ORD ID.",
           "maxLength": 255,
           "examples": [
             "SuccessFactorsRecruiting",
@@ -81,7 +83,12 @@
         "policyLevel": {
           "type": "string",
           "description": "The [policy level](../../spec-extensions/policy-levels/) (aka. compliance level) that the described resources need to be compliant with.\nDepending on the chosen policy level, additional expectations and validations rules will be applied.\n\nThe policy level can be defined on ORD Document level, but also be overwritten on an individual package or resource level.\n",
-          "oneOf": [
+          "anyOf": [
+            {
+              "type": "string",
+              "pattern": "^([a-z0-9-]+(?:[.][a-z0-9-]+)*):([a-zA-Z0-9._\\-]+):(v0|v[1-9][0-9]*)$",
+              "description": "Any valid [Specification ID](../index.md#specification-id)."
+            },
             {
               "const": "none",
               "description": "No policy level chosen. Only the base rules on how to create correct ORD documents apply."
@@ -177,7 +184,7 @@
         },
         "partOfProducts": {
           "type": "array",
-          "description": "List of products this resource is a part of.\n\nMUST be a valid reference to a [Product](#product) ORD ID.\n\n`partOfProducts` that are assigned to a `Package` are inherited to all of the ORD resources it contains.",
+          "description": "List of products the resources of the package are a part of.\n\nMUST be a valid reference to a [Product](#product) ORD ID.\n\n`partOfProducts` that are assigned to a `Package` are inherited to all of the ORD resources it contains.",
           "items": {
             "type": "string",
             "pattern": "^([a-z0-9]+(?:[.][a-z0-9]+)*):(product):([a-zA-Z0-9._\\-]+):()$",
@@ -376,7 +383,7 @@
         "runtimeRestriction": {
           "x-introduced-in-version": "1.8.0",
           "x-feature-status": "alpha",
-          "description": "If provided, all resources that are part of this package can only run on the listed runtime.\n\nMUST be a valid [System Namespace](../index.md#system-namespace).",
+          "description": "If provided, all resources that are part of this package can only run on the listed runtime.\n\nMUST be a valid [system namespace](../index.md#system-namespace).",
           "type": "string",
           "pattern": "^[a-z0-9]+(?:[.][a-z0-9]+){1}$",
           "examples": [
@@ -420,7 +427,8 @@
     "ConsumptionBundle": {
       "type": "object",
       "title": "Consumption Bundle",
-      "description": "A [**Consumption Bundle**](../../details/articles/grouping-and-bundling#consumption-bundle) groups APIs and Events together that can be consumed with the credentials and auth mechanism.\nIdeally it also includes instructions and details how to request access and credentials for resources.\n\nFor more documentation and guidance how to correctly this correctly, see [Consumption Bundle details](../../details/articles/grouping-and-bundling#consumption-bundle).\n\nA consumption bundle SHOULD have at least one association with a resource (0..n). Avoid empty consumption bundles.\nA consumption bundle MUST NOT contain APIs and Events that are NOT defined in the ORD document(s) returned\nby the system instance that defines the consumption bundle.\n\nPlease note that some ORD consumer use cases MAY depend on consumption bundle assignments to work with the resources.\n\nTo learn more about the concept, see [Consumption Bundle](../../details/articles/grouping-and-bundling#consumption-bundle).",
+      "x-ums-type": "root",
+      "description": "A [**Consumption Bundle**](../concepts/grouping-and-bundling#consumption-bundle) groups APIs and Events together that can be consumed with the credentials and auth mechanism.\nIdeally it also includes instructions and details how to request access and credentials for resources.\n\nFor more documentation and guidance how to correctly this correctly, see [Consumption Bundle details](../concepts/grouping-and-bundling#consumption-bundle).\n\nA consumption bundle SHOULD have at least one association with a resource (0..n). Avoid empty consumption bundles.\nA consumption bundle MUST NOT contain APIs and Events that are NOT defined in the ORD document(s) returned\nby the system instance that defines the consumption bundle.\n\nPlease note that some ORD consumer use cases MAY depend on consumption bundle assignments to work with the resources.\n\nTo learn more about the concept, see [Consumption Bundle](../concepts/grouping-and-bundling#consumption-bundle).",
       "properties": {
         "ordId": {
           "type": "string",
@@ -434,7 +442,7 @@
         "localId": {
           "type": "string",
           "x-introduced-in-version": "1.2.1",
-          "description": "Local ID, as known by the described system.\n\nThis can be the `<resourceName>` fragment in the ORD ID. In this case, make sure it fits the length limits of the ORD ID. It might also be different if e.g. localIds have incompatible charset restrictions.",
+          "description": "The locally unique ID under which this resource can be looked up / resolved in the described system itself.\nUnlike the ORD ID it's not globally unique, but it may be useful to document the original ID / technical name.\n\nIt MAY also be used as the `<resourceName>` fragment in the ORD ID, IF it can fulfill the charset and length limitations within the ORD ID.\nBut since this is not always possible, no assumptions MUST be made about the local ID being the same as the `<resourceName>` fragment in the ORD ID.",
           "maxLength": 255,
           "examples": [
             "SuccessFactorsRecruiting",
@@ -570,6 +578,7 @@
     "ConsumptionBundleReference": {
       "type": "object",
       "title": "Consumption Bundle Reference",
+      "x-ums-type": "embedded",
       "description": "Reference to a Consumption bundle.\n\nThis is a complex object to allow additional properties / selections to be attached.",
       "properties": {
         "ordId": {
@@ -598,6 +607,8 @@
     "ApiResource": {
       "type": "object",
       "title": "API Resource",
+      "x-ums-type": "root",
+      "x-implements": "#/definitions/OrdResource",
       "description": "The API Resource provides a high-level description of an exposed API.\nYou can find more information, such as the API resource definitions, in the links in the table below.\n\nAn API Resource bundles multiple endpoints and resources together.\nThey share the same API namespace and lifecycle (API major version).\nHowever, the exact granularity of this is up to the implementer of the API.\nAs a consequence, an API resource MUST NOT bundle together endpoints from different API versions or namespaces.\n\nA common practice is to bundle endpoints that are based on the same domain or Business Object.\n\nPlease note that APIs can be described, but still be [`disabled`](#api-resource_disabled).\n\nIf the API is not created or owned by the user of the system or by third parties (like partners), it MUST be assigned to dedicated [Packages](#package) that state this the ownership via the `vendor` property.",
       "properties": {
         "ordId": {
@@ -612,7 +623,7 @@
         "localId": {
           "type": "string",
           "x-introduced-in-version": "1.2.1",
-          "description": "Local ID, as known by the described system.\n\nThis can be the `<resourceName>` fragment in the ORD ID. In this case, make sure it fits the length limits of the ORD ID. It might also be different if e.g. localIds have incompatible charset restrictions.",
+          "description": "The locally unique ID under which this resource can be looked up / resolved in the described system itself.\nUnlike the ORD ID it's not globally unique, but it may be useful to document the original ID / technical name.\n\nIt MAY also be used as the `<resourceName>` fragment in the ORD ID, IF it can fulfill the charset and length limitations within the ORD ID.\nBut since this is not always possible, no assumptions MUST be made about the local ID being the same as the `<resourceName>` fragment in the ORD ID.",
           "maxLength": 255,
           "examples": [
             "API_BILL_OF_MATERIAL_SRV"
@@ -664,6 +675,12 @@
           "x-association-target": [
             "#/definitions/Package/ordId"
           ],
+          "x-reverse-relationship": {
+            "propertyName": "apiResources",
+            "description": "The API resources that are part the given Package.",
+            "min": 0,
+            "max": "*"
+          },
           "maxLength": 255,
           "description": "Defines which Package the resource is part of.\n\nMUST be a valid reference to a [Package](#package) ORD ID.\n\nEvery resource MUST be part of one package.",
           "examples": [
@@ -679,6 +696,12 @@
               "#/definitions/Group/groupId"
             ]
           },
+          "x-reverse-relationship": {
+            "propertyName": "apiResourceMembers",
+            "description": "The API resources that are part the given Group.",
+            "min": 0,
+            "max": "*"
+          },
           "description": "Defines which groups the resource is assigned to.\n\nThe property is optional, but if given the value MUST be an array of valid Group IDs.\n\nGroups are a lightweight custom taxonomy concept.\nThey express a \"part of\" relationship to the chosen group concept.\nIf an \"identity / equals\" relationship needs to be expressed, use the `correlationIds` instead.\n\nAll resources that share the same group ID assignment are effectively grouped together."
         },
         "partOfConsumptionBundles": {
@@ -709,7 +732,7 @@
         },
         "partOfProducts": {
           "type": "array",
-          "description": "List of products this resource is a part of.\n\nMUST be a valid reference to a [Product](#product) ORD ID.\n\n`partOfProducts` that are assigned to a `Package` are inherited to all of the ORD resources it contains.",
+          "description": "List of products the resources of the package are a part of.\n\nMUST be a valid reference to a [Product](#product) ORD ID.\n\n`partOfProducts` that are assigned to a `Package` are inherited to all of the ORD resources it contains.",
           "items": {
             "type": "string",
             "pattern": "^([a-z0-9]+(?:[.][a-z0-9]+)*):(product):([a-zA-Z0-9._\\-]+):()$",
@@ -867,7 +890,12 @@
         "apiProtocol": {
           "type": "string",
           "description": "API Protocol including the protocol version if applicable",
-          "oneOf": [
+          "anyOf": [
+            {
+              "type": "string",
+              "pattern": "^([a-z0-9-]+(?:[.][a-z0-9-]+)*):([a-zA-Z0-9._\\-]+):(v0|v[1-9][0-9]*)$",
+              "description": "Any valid [Specification ID](../index.md#specification-id)."
+            },
             {
               "const": "odata-v2",
               "description": "[OData Version 2.0](https://www.odata.org/documentation/odata-version-2-0/) API.\nAn API Resource definition of type `edmx` MUST be provided.\nFor each API Resource definition: `type` MUST ONLY be set to `edmx`, `csdl-json`, `openapi-v2`, `openapi-v3`, `sap-csn-interop-effective-v1` or `custom`."
@@ -929,10 +957,15 @@
         "implementationStandard": {
           "type": "string",
           "description": "Declares this API to be a valid implementation of an externally standardized API contract, sub-protocol or protocol variant.\n\nAll APIs that share the same implementation standard MAY be treated the same or similar by a consumer client.",
-          "oneOf": [
+          "anyOf": [
+            {
+              "type": "string",
+              "pattern": "^([a-z0-9-]+(?:[.][a-z0-9-]+)*):([a-zA-Z0-9._\\-]+):(v0|v[1-9][0-9]*)$",
+              "description": "Any valid [Specification ID](../index.md#specification-id).\nIf chosen, `customImplementationStandardDescription` SHOULD be provided."
+            },
             {
               "const": "sap:ord-document-api:v1",
-              "description": "API follows the Open Resource Discovery v1 [Document API](../index.md#ord-document-api) contract."
+              "description": "API follows the Open Resource Discovery v1 [Document API](../index.md#ord-provider-api) contract."
             },
             {
               "const": "cff:open-service-broker:v2",
@@ -1020,7 +1053,12 @@
           "x-feature-status": "beta",
           "items": {
             "type": "string",
-            "oneOf": [
+            "anyOf": [
+              {
+                "type": "string",
+                "pattern": "^([a-z0-9-]+(?:[.][a-z0-9-]+)*):([a-zA-Z0-9._\\-]+):(v0|v[1-9][0-9]*)$",
+                "description": "Any valid [Specification ID](../index.md#specification-id)."
+              },
               {
                 "const": "data-federation",
                 "description": "Resources are designed to support [data federation](https://en.wikipedia.org/wiki/Federated_database_system). This goes beyond plain queries, but typically allowing connections on the data base level, in the context of a business user.\nAs consumers will directly access data, performance of the system must support these use cases."
@@ -1066,11 +1104,36 @@
         "entityTypeMappings": {
           "type": "array",
           "x-introduced-in-version": "1.6.0",
+          "x-deprecated-in-version": "1.11.0",
+          "x-deprecated": "Use the simplified `exposedEntityTypes` instead.",
           "description": "Describes mappings between the API Models of the described resource to the underlying, conceptual entity types.",
           "items": {
             "$ref": "#/definitions/EntityTypeMapping"
           }
         },
+        "exposedEntityTypes": {
+          "type": "array",
+          "x-introduced-in-version": "1.11.0",
+          "description": "Optional list of [entity types](#entity-type) that are exposed by the resource.\n\nThis replaces `entityTypeMappings`. If both is given, the `exposedEntityTypes` wins.\n\nMUST be a valid reference to an [EntityType](#entity-type) ORD ID.",
+          "items": {
+            "$ref": "#/definitions/ExposedEntityType"
+          },
+          "examples": [
+            [
+              {
+                "ordId": "sap.odm:entityType:WorkforcePerson:v1"
+              }
+            ],
+            [
+              {
+                "ordId": "sap.sm:entityType:PurchaseOrderItem:v1"
+              },
+              {
+                "ordId": "sap.sm:entityType:BusinessPartner:v1"
+              }
+            ]
+          ]
+        },
         "apiResourceLinks": {
           "type": "array",
           "description": "Links with semantic meaning that are specific to API Resources.",
@@ -1295,7 +1358,12 @@
         "policyLevel": {
           "type": "string",
           "description": "The [policy level](../../spec-extensions/policy-levels/) (aka. compliance level) that the described resources need to be compliant with.\nDepending on the chosen policy level, additional expectations and validations rules will be applied.\n\nThe policy level can be defined on ORD Document level, but also be overwritten on an individual package or resource level.\n",
-          "oneOf": [
+          "anyOf": [
+            {
+              "type": "string",
+              "pattern": "^([a-z0-9-]+(?:[.][a-z0-9-]+)*):([a-zA-Z0-9._\\-]+):(v0|v[1-9][0-9]*)$",
+              "description": "Any valid [Specification ID](../index.md#specification-id)."
+            },
             {
               "const": "none",
               "description": "No policy level chosen. Only the base rules on how to create correct ORD documents apply."
@@ -1375,6 +1443,8 @@
     "EventResource": {
       "type": "object",
       "title": "Event Resource",
+      "x-ums-type": "root",
+      "x-implements": "#/definitions/OrdResource",
       "description": "The event resource provides a high-level description of a collection of related Events. More detailed information, such as the event resource definitions, are provided in links in the table below.\nWhich events are considered \"related\" is up to the implementer. A common practice is to bundle events that are based on the same resource/Business Object. It is also an option to bundle all available events into a single event resource/event catalog.\nPlease note that event resources can be described, but still be [`disabled`](#event-resource_disabled).\nIf the event resource is not created or owned by the user / customer of the system or by partners / third parties, it MUST be assigned to dedicated [Packages](#package) that state this the ownership via the `vendor` property.",
       "properties": {
         "ordId": {
@@ -1390,7 +1460,7 @@
         "localId": {
           "type": "string",
           "x-introduced-in-version": "1.2.1",
-          "description": "Local ID, as known by the described system.\n\nThis can be the `<resourceName>` fragment in the ORD ID. In this case, make sure it fits the length limits of the ORD ID. It might also be different if e.g. localIds have incompatible charset restrictions.",
+          "description": "The locally unique ID under which this resource can be looked up / resolved in the described system itself.\nUnlike the ORD ID it's not globally unique, but it may be useful to document the original ID / technical name.\n\nIt MAY also be used as the `<resourceName>` fragment in the ORD ID, IF it can fulfill the charset and length limitations within the ORD ID.\nBut since this is not always possible, no assumptions MUST be made about the local ID being the same as the `<resourceName>` fragment in the ORD ID.",
           "maxLength": 255,
           "examples": [
             "BusinessEvents_SubscriptionEvents"
@@ -1443,6 +1513,12 @@
           "x-association-target": [
             "#/definitions/Package/ordId"
           ],
+          "x-reverse-relationship": {
+            "propertyName": "eventResources",
+            "description": "The event resources that are part the given Package.",
+            "min": 0,
+            "max": "*"
+          },
           "maxLength": 255,
           "description": "Defines which Package the resource is part of.\n\nMUST be a valid reference to a [Package](#package) ORD ID.\n\nEvery resource MUST be part of one package.",
           "examples": [
@@ -1458,6 +1534,10 @@
               "#/definitions/Group/groupId"
             ]
           },
+          "x-reverse-relationship": {
+            "propertyName": "eventResourceMembers",
+            "description": "The event resources that are part the given Group."
+          },
           "description": "Defines which groups the resource is assigned to.\n\nThe property is optional, but if given the value MUST be an array of valid Group IDs.\n\nGroups are a lightweight custom taxonomy concept.\nThey express a \"part of\" relationship to the chosen group concept.\nIf an \"identity / equals\" relationship needs to be expressed, use the `correlationIds` instead.\n\nAll resources that share the same group ID assignment are effectively grouped together."
         },
         "partOfConsumptionBundles": {
@@ -1488,7 +1568,7 @@
         },
         "partOfProducts": {
           "type": "array",
-          "description": "List of products this resource is a part of.\n\nMUST be a valid reference to a [Product](#product) ORD ID.\n\n`partOfProducts` that are assigned to a `Package` are inherited to all of the ORD resources it contains.",
+          "description": "List of products the resources of the package are a part of.\n\nMUST be a valid reference to a [Product](#product) ORD ID.\n\n`partOfProducts` that are assigned to a `Package` are inherited to all of the ORD resources it contains.",
           "items": {
             "type": "string",
             "pattern": "^([a-z0-9]+(?:[.][a-z0-9]+)*):(product):([a-zA-Z0-9._\\-]+):()$",
@@ -1620,7 +1700,17 @@
         "implementationStandard": {
           "type": "string",
           "description": "Declares this EventResource to be a valid implementation of a standardized or shared contract.\n\nAll implementations of the same implementation standard MAY be treated the same by a consumer.\nHowever, there MAY be differences in the access strategy, and compatible customizations by the implementer.\nThe implementation standard MAY define the role of the implementor (producer, consumer, both) and how it is determined.\n\nAs of now, only custom implementation standards are supported.",
-          "oneOf": [
+          "anyOf": [
+            {
+              "type": "string",
+              "pattern": "^([a-z0-9]+(?:[.][a-z0-9]+)*):(apiResource):([a-zA-Z0-9._\\-]+):(v0|v[1-9][0-9]*)$",
+              "description": "Any valid [API Resource ORD ID](../index.md#api-resource_ordid).\n\nRECOMMENDED to use if the contract is published via ORD and has an ORD ID."
+            },
+            {
+              "type": "string",
+              "pattern": "^([a-z0-9-]+(?:[.][a-z0-9-]+)*):([a-zA-Z0-9._\\-]+):(v0|v[1-9][0-9]*)$",
+              "description": "Any valid [Specification ID](../index.md#specification-id).\nIf chosen, `customImplementationStandardDescription` SHOULD be provided."
+            },
             {
               "const": "custom",
               "description": "If chosen, a custom implementation standard MUST be provided via `customImplementationStandard` and SHOULD be described via `customImplementationStandardDescription`"
@@ -1672,11 +1762,36 @@
         "entityTypeMappings": {
           "type": "array",
           "x-introduced-in-version": "1.6.0",
+          "x-deprecated-in-version": "1.11.0",
+          "x-deprecated": "Use the simplified `exposedEntityTypes` instead.",
           "description": "Describes mappings between the API Models of the described resource to the underlying, conceptual entity types.",
           "items": {
             "$ref": "#/definitions/EntityTypeMapping"
           }
         },
+        "exposedEntityTypes": {
+          "type": "array",
+          "x-introduced-in-version": "1.11.0",
+          "description": "Optional list of [entity types](#entity-type) that are exposed by the resource.\n\nThis replaces `entityTypeMappings`. If both is given, the `exposedEntityTypes` wins.\n\nMUST be a valid reference to an [EntityType](#entity-type) ORD ID.",
+          "items": {
+            "$ref": "#/definitions/ExposedEntityType"
+          },
+          "examples": [
+            [
+              {
+                "ordId": "sap.odm:entityType:WorkforcePerson:v1"
+              }
+            ],
+            [
+              {
+                "ordId": "sap.sm:entityType:PurchaseOrderItem:v1"
+              },
+              {
+                "ordId": "sap.sm:entityType:BusinessPartner:v1"
+              }
+            ]
+          ]
+        },
         "eventResourceLinks": {
           "type": "array",
           "x-introduced-in-version": "1.7.1",
@@ -1902,7 +2017,12 @@
         "policyLevel": {
           "type": "string",
           "description": "The [policy level](../../spec-extensions/policy-levels/) (aka. compliance level) that the described resources need to be compliant with.\nDepending on the chosen policy level, additional expectations and validations rules will be applied.\n\nThe policy level can be defined on ORD Document level, but also be overwritten on an individual package or resource level.\n",
-          "oneOf": [
+          "anyOf": [
+            {
+              "type": "string",
+              "pattern": "^([a-z0-9-]+(?:[.][a-z0-9-]+)*):([a-zA-Z0-9._\\-]+):(v0|v[1-9][0-9]*)$",
+              "description": "Any valid [Specification ID](../index.md#specification-id)."
+            },
             {
               "const": "none",
               "description": "No policy level chosen. Only the base rules on how to create correct ORD documents apply."
@@ -1984,7 +2104,8 @@
     "EntityType": {
       "type": "object",
       "title": "Entity Type",
-      "description": "An [**Entity Type**](../../details/articles/grouping-and-bundling#entity-type) describes either a business concept / term or an underlying conceptual model.\nThe same entity type can be exposed through one or multiple API and events resources.\n\nTo learn more about the concept, see [Entity Type](../../details/articles/grouping-and-bundling#entity-type).",
+      "x-ums-type": "root",
+      "description": "An [**Entity Type**](../concepts/grouping-and-bundling#entity-type) describes either a business concept / term or an underlying conceptual model.\nThe same entity type can be exposed through one or multiple API and events resources.\n\nTo learn more about the concept, see [Entity Type](../concepts/grouping-and-bundling#entity-type).",
       "x-introduced-in-version": "1.8.0",
       "properties": {
         "ordId": {
@@ -2001,7 +2122,7 @@
         "localId": {
           "type": "string",
           "x-introduced-in-version": "1.2.1",
-          "description": "Local ID, as known by the described system.\n\nThis can be the `<resourceName>` fragment in the ORD ID. In this case, make sure it fits the length limits of the ORD ID. It might also be different if e.g. localIds have incompatible charset restrictions.",
+          "description": "The locally unique ID under which this resource can be looked up / resolved in the described system itself.\nUnlike the ORD ID it's not globally unique, but it may be useful to document the original ID / technical name.\n\nIt MAY also be used as the `<resourceName>` fragment in the ORD ID, IF it can fulfill the charset and length limitations within the ORD ID.\nBut since this is not always possible, no assumptions MUST be made about the local ID being the same as the `<resourceName>` fragment in the ORD ID.",
           "maxLength": 255,
           "examples": [
             "BusinessPartner",
@@ -2067,6 +2188,12 @@
           "x-association-target": [
             "#/definitions/Package/ordId"
           ],
+          "x-reverse-relationship": {
+            "propertyName": "entityTypes",
+            "description": "The entity types that are part the given Package.",
+            "min": 0,
+            "max": "*"
+          },
           "maxLength": 255,
           "description": "Defines which Package the resource is part of.\n\nMUST be a valid reference to a [Package](#package) ORD ID.\n\nEvery resource MUST be part of one package.",
           "examples": [
@@ -2082,11 +2209,15 @@
               "#/definitions/Group/groupId"
             ]
           },
+          "x-reverse-relationship": {
+            "propertyName": "entityTypeMembers",
+            "description": "The entity types that are part the given Group."
+          },
           "description": "Defines which groups the resource is assigned to.\n\nThe property is optional, but if given the value MUST be an array of valid Group IDs.\n\nGroups are a lightweight custom taxonomy concept.\nThey express a \"part of\" relationship to the chosen group concept.\nIf an \"identity / equals\" relationship needs to be expressed, use the `correlationIds` instead.\n\nAll resources that share the same group ID assignment are effectively grouped together."
         },
         "partOfProducts": {
           "type": "array",
-          "description": "List of products this resource is a part of.\n\nMUST be a valid reference to a [Product](#product) ORD ID.\n\n`partOfProducts` that are assigned to a `Package` are inherited to all of the ORD resources it contains.",
+          "description": "List of products the resources of the package are a part of.\n\nMUST be a valid reference to a [Product](#product) ORD ID.\n\n`partOfProducts` that are assigned to a `Package` are inherited to all of the ORD resources it contains.",
           "items": {
             "type": "string",
             "pattern": "^([a-z0-9]+(?:[.][a-z0-9]+)*):(product):([a-zA-Z0-9._\\-]+):()$",
@@ -2207,7 +2338,7 @@
         },
         "level": {
           "type": "string",
-          "description": "Defining the abstraction level of the entity type using the DDD terminology.\n\nIn Domain-Driven Design, there is a concept of entities and aggregates.\nThere are root entities which may contain further sub entities by composition.\nThe complete “package” is then called an aggregate, which gets its name and identity from the root entity.\nAn aggregate is a cluster of domain objects that can be treated as a single unit.\nThe root is the entity that is referenced from outside the aggregate. There must be only one root per aggregate.\nThe root ensures the integrity of the aggregate. A sub entity is any other non-root entity in the aggregate.\n\nSource, see [Martin Fowler on DDD Aggregate](https://martinfowler.com/bliki/DDD_Aggregate.html)",
+          "description": "Defining the abstraction level of the entity type using the DDD terminology.\n\nIn Domain-Driven Design, there is a concept of entities and aggregates.\nThere are root entities which may contain further sub entities by composition.\nThe complete \"package\" is then called an aggregate, which gets its name and identity from the root entity.\nAn aggregate is a cluster of domain objects that can be treated as a single unit.\nThe root is the entity that is referenced from outside the aggregate. There must be only one root per aggregate.\nThe root ensures the integrity of the aggregate. A sub entity is any other non-root entity in the aggregate.\n\nSource, see [Martin Fowler on DDD Aggregate](https://martinfowler.com/bliki/DDD_Aggregate.html)",
           "oneOf": [
             {
               "const": "aggregate",
@@ -2232,7 +2363,14 @@
           "description": "States that this Entity Type is related to another Entity Type.\n\nUsually this happens if there are similar conceptual entity types across different namespaces.",
           "items": {
             "$ref": "#/definitions/RelatedEntityType"
-          }
+          },
+          "examples": [
+            [
+              {
+                "ordId": "sap.odm:entityType:WorkforcePerson:v1"
+              }
+            ]
+          ]
         },
         "links": {
           "type": "array",
@@ -2271,7 +2409,12 @@
         "policyLevel": {
           "type": "string",
           "description": "The [policy level](../../spec-extensions/policy-levels/) (aka. compliance level) that the described resources need to be compliant with.\nDepending on the chosen policy level, additional expectations and validations rules will be applied.\n\nThe policy level can be defined on ORD Document level, but also be overwritten on an individual package or resource level.\n",
-          "oneOf": [
+          "anyOf": [
+            {
+              "type": "string",
+              "pattern": "^([a-z0-9-]+(?:[.][a-z0-9-]+)*):([a-zA-Z0-9._\\-]+):(v0|v[1-9][0-9]*)$",
+              "description": "Any valid [Specification ID](../index.md#specification-id)."
+            },
             {
               "const": "none",
               "description": "No policy level chosen. Only the base rules on how to create correct ORD documents apply."
@@ -2353,8 +2496,10 @@
     "DataProduct": {
       "type": "object",
       "title": "Data Product",
+      "x-ums-type": "root",
       "x-introduced-in-version": "1.8.0",
-      "description": "A [Data Product](../../details/articles/data-product) is a data set exposed for consumption outside the boundaries of the producing application via APIs and described by high quality metadata that can be accessed through the [ORD Aggregator](../../spec-v1/#ord-aggregator).\n\nPlease note that this concept is in beta, see [Data Product - Beta Status](../../details/articles/data-product#beta-status).",
+      "x-implements": "#/definitions/OrdResource",
+      "description": "A [Data Product](../concepts/data-product) is a data set exposed for consumption outside the boundaries of the producing application via APIs and described by high quality metadata that can be accessed through the [ORD Aggregator](../../spec-v1/#ord-aggregator).\n\nPlease note that this concept is in beta, see [Data Product - Beta Status](../concepts/data-product#beta-status).",
       "properties": {
         "ordId": {
           "type": "string",
@@ -2368,7 +2513,7 @@
         "localId": {
           "type": "string",
           "x-introduced-in-version": "1.2.1",
-          "description": "Local ID, as known by the described system.\n\nThis can be the `<resourceName>` fragment in the ORD ID. In this case, make sure it fits the length limits of the ORD ID. It might also be different if e.g. localIds have incompatible charset restrictions.",
+          "description": "The locally unique ID under which this resource can be looked up / resolved in the described system itself.\nUnlike the ORD ID it's not globally unique, but it may be useful to document the original ID / technical name.\n\nIt MAY also be used as the `<resourceName>` fragment in the ORD ID, IF it can fulfill the charset and length limitations within the ORD ID.\nBut since this is not always possible, no assumptions MUST be made about the local ID being the same as the `<resourceName>` fragment in the ORD ID.",
           "maxLength": 255,
           "examples": [
             "CustomerOrder"
@@ -2421,6 +2566,12 @@
           "x-association-target": [
             "#/definitions/Package/ordId"
           ],
+          "x-reverse-relationship": {
+            "propertyName": "dataProducts",
+            "description": "The data products that are part the given Package.",
+            "min": 0,
+            "max": "*"
+          },
           "maxLength": 255,
           "description": "Defines which Package the resource is part of.\n\nMUST be a valid reference to a [Package](#package) ORD ID.\n\nEvery resource MUST be part of one package.",
           "examples": [
@@ -2428,7 +2579,6 @@
           ]
         },
         "partOfGroups": {
-          "x-feature-status": "beta",
           "type": "array",
           "items": {
             "type": "string",
@@ -2437,7 +2587,30 @@
               "#/definitions/Group/groupId"
             ]
           },
-          "description": "Defines which groups the resource is assigned to.\n\nThe property is optional, but if given the value MUST be an array of valid Group IDs.\n\nGroups are a lightweight custom taxonomy concept.\nThey express a \"part of\" relationship to the chosen group concept.\nIf an \"identity / equals\" relationship needs to be expressed, use the `correlationIds` instead.\n\nAll resources that share the same group ID assignment are effectively grouped together."
+          "x-reverse-relationship": {
+            "propertyName": "dataProductMembers",
+            "description": "The data products that are part the given Group."
+          },
+          "description": "Defines which groups the resource is assigned to.\n\nThe property is optional, but if given the value MUST be an array of valid Group IDs.\n\nGroups are a lightweight custom taxonomy concept.\nThey express a \"part of\" relationship to the chosen group concept.\nIf an \"identity / equals\" relationship needs to be expressed, use the `correlationIds` instead.\n\nAll resources that share the same group ID assignment are effectively grouped together.",
+          "x-feature-status": "beta"
+        },
+        "partOfProducts": {
+          "type": "array",
+          "description": "List of products this Data Product is a part of or is related to, its e.g. data source systems.\n\nMUST be a valid reference to a [Product](#product) ORD ID.\n\n`partOfProducts` that are assigned to a `Package` are inherited to all of the ORD resources it contains.",
+          "items": {
+            "type": "string",
+            "pattern": "^([a-z0-9]+(?:[.][a-z0-9]+)*):(product):([a-zA-Z0-9._\\-]+):()$",
+            "maxLength": 255,
+            "x-association-target": [
+              "#/definitions/Product/ordId"
+            ]
+          },
+          "minItems": 0,
+          "examples": [
+            [
+              "sap:product:S4HANA_OD:"
+            ]
+          ]
         },
         "version": {
           "type": "string",
@@ -2606,9 +2779,14 @@
           ]
         },
         "category": {
-          "description": "Category of the data-set within data product. Based on its definition, a data product is a “data set” - which can include on the values below.\nBased on the type some properties of a data product may become optional/mandatory.\nConsumers might still do analytics on business object like data products.",
+          "description": "Category of the data-set within data product. Based on its definition, a data product is a \"data set\" - which can include on the values below.\nBased on the type some properties of a data product may become optional/mandatory.\nConsumers might still do analytics on business object like data products.",
           "type": "string",
-          "oneOf": [
+          "anyOf": [
+            {
+              "type": "string",
+              "pattern": "^([a-z0-9-]+(?:[.][a-z0-9-]+)*):([a-zA-Z0-9._\\-]+):(v0|v[1-9][0-9]*)$",
+              "description": "Any valid [Specification ID](../index.md#specification-id)."
+            },
             {
               "const": "business-object",
               "description": "Business Objects: master data, transaction data"
@@ -2638,6 +2816,12 @@
               "#/definitions/EntityType/ordId"
             ]
           },
+          "x-reverse-relationship": {
+            "propertyName": "dataProducts",
+            "description": "Data Products associated to the Entity Type.",
+            "min": 0,
+            "max": "*"
+          },
           "examples": [
             [
               "sap.odm:entityType:CustomerOrder:v1",
@@ -2918,7 +3102,12 @@
           "x-feature-status": "beta",
           "type": "string",
           "description": "The [policy level](../../spec-extensions/policy-levels/) (aka. compliance level) that the described resources need to be compliant with.\nDepending on the chosen policy level, additional expectations and validations rules will be applied.\n\nThe policy level can be defined on ORD Document level, but also be overwritten on an individual package or resource level.\n",
-          "oneOf": [
+          "anyOf": [
+            {
+              "type": "string",
+              "pattern": "^([a-z0-9-]+(?:[.][a-z0-9-]+)*):([a-zA-Z0-9._\\-]+):(v0|v[1-9][0-9]*)$",
+              "description": "Any valid [Specification ID](../index.md#specification-id)."
+            },
             {
               "const": "none",
               "description": "No policy level chosen. Only the base rules on how to create correct ORD documents apply."
@@ -3006,6 +3195,7 @@
     "DataProductInputPort": {
       "type": "object",
       "title": "Data Product Input Port",
+      "x-ums-type": "embedded",
       "description": "An input port of a data product states where it retrieves its data inputs from.\n\nIt is described as via an ORD Integration Dependency.",
       "properties": {
         "ordId": {
@@ -3029,6 +3219,7 @@
     "DataProductOutputPort": {
       "type": "object",
       "title": "Data Product Output Port",
+      "x-ums-type": "embedded",
       "description": "A data product output port references the APIs or Events that can be used to access the data-set.\nIt MAY provide full access to the complete data set, but can also just expose a subset of it - if other output ports cover the missing parts.\n\nReferenced API or Event ORD resources don't need to be provided within the same ORD document.\nIf a data product is built against a specific API contract of another application or data product, this API resource should be referred to.\nIn this case the other application is responsible for the lifecycle of the API contract and will update its ORD description independently.",
       "properties": {
         "ordId": {
@@ -3055,11 +3246,17 @@
       "type": "object",
       "title": "API Resource Definition",
       "description": "Link and categorization of a machine-readable API definition.\nFor example, OpenAPI definition, OData Metadata, etc.",
+      "x-ums-type": "custom",
       "properties": {
         "type": {
           "description": "Type of the API Resource Definition\nIf \"custom\" is chosen, a customType MUST be provided",
           "type": "string",
-          "oneOf": [
+          "anyOf": [
+            {
+              "type": "string",
+              "pattern": "^([a-z0-9-]+(?:[.][a-z0-9-]+)*):([a-zA-Z0-9._\\-]+):(v0|v[1-9][0-9]*)$",
+              "description": "Any valid [Specification ID](../index.md#specification-id)."
+            },
             {
               "const": "openapi-v2",
               "description": "[OpenAPI 2 / Swagger 2](https://swagger.io/specification/v2/) API Definition for [REST](https://en.wikipedia.org/wiki/Representational_state_transfer) APIs.\nThe `mediaType` MUST be be set to either `application/json` or `text/yaml`."
@@ -3185,12 +3382,18 @@
     "EventResourceDefinition": {
       "type": "object",
       "title": "Event Resource Definition",
+      "x-ums-type": "custom",
       "description": "Link and categorization of a machine-readable API definition.\nFor example, AsyncAPI or OpenAPI with callbacks, etc.",
       "properties": {
         "type": {
           "description": "Type of the event resource definition",
           "type": "string",
-          "oneOf": [
+          "anyOf": [
+            {
+              "type": "string",
+              "pattern": "^([a-z0-9-]+(?:[.][a-z0-9-]+)*):([a-zA-Z0-9._\\-]+):(v0|v[1-9][0-9]*)$",
+              "description": "Any valid [Specification ID](../index.md#specification-id)."
+            },
             {
               "const": "asyncapi-v2",
               "description": "[AsyncAPI 2](https://www.asyncapi.com/docs/specifications/2.0.0) API definition for events.\nThe SAP Event Catalog Specification also falls under this category, as it is a valid AsyncAPI definition."
@@ -3277,6 +3480,7 @@
     "Product": {
       "type": "object",
       "title": "Product",
+      "x-ums-type": "root",
       "description": "A **product** in ORD is understood as a commercial product or service.\n\nIt is a high-level entity for structuring the software portfolio from a sales / software logistics perspective.\nWhile **system type** is a technical concept, **product** covers the commercial and marketing view.\n\nPlease note that the ORD concept of a product is very simple on purpose.\nThere is no distinction between products and services and concepts like product versions, variants, etc.\n\nORD assumes that this is handled by specialized systems and that ORD only provides the means to correlate to them.",
       "properties": {
         "ordId": {
@@ -3386,7 +3590,9 @@
     "Capability": {
       "type": "object",
       "title": "Capability",
+      "x-ums-type": "root",
       "x-introduced-in-version": "1.4.0",
+      "x-implements": "#/definitions/OrdResource",
       "description": "Capabilities can be used to describe use case specific capabilities, most notably supported features or additional information (like configuration) that needs to be understood from outside.\nThis is a generic ORD concept that aims to cover many different capability discovery use cases that would otherwise need be implemented as individual service provider interfaces (SPIs).\n\nIf a capability needs to expose more information than possible with generic capability properties, a custom capability definition can be defined and referenced in ORD.\nThis is the same idea and mechanism as with API resources and their resource definition formats.",
       "properties": {
         "ordId": {
@@ -3401,7 +3607,7 @@
         "localId": {
           "type": "string",
           "x-introduced-in-version": "1.2.1",
-          "description": "Local ID, as known by the described system.\n\nThis can be the `<resourceName>` fragment in the ORD ID. In this case, make sure it fits the length limits of the ORD ID. It might also be different if e.g. localIds have incompatible charset restrictions.",
+          "description": "The locally unique ID under which this resource can be looked up / resolved in the described system itself.\nUnlike the ORD ID it's not globally unique, but it may be useful to document the original ID / technical name.\n\nIt MAY also be used as the `<resourceName>` fragment in the ORD ID, IF it can fulfill the charset and length limitations within the ORD ID.\nBut since this is not always possible, no assumptions MUST be made about the local ID being the same as the `<resourceName>` fragment in the ORD ID.",
           "maxLength": 255,
           "examples": [
             "SuccessFactorsRecruiting",
@@ -3425,14 +3631,19 @@
         "type": {
           "description": "Type of the Capability",
           "type": "string",
-          "oneOf": [
+          "anyOf": [
             {
-              "const": "custom",
-              "description": "If chosen, `customType` MUST be provided."
+              "type": "string",
+              "pattern": "^([a-z0-9-]+(?:[.][a-z0-9-]+)*):([a-zA-Z0-9._\\-]+):(v0|v[1-9][0-9]*)$",
+              "description": "Any valid [Specification ID](../index.md#specification-id)."
             },
             {
               "const": "sap.mdo:mdi-capability:v1",
               "description": "Capability for SAP Master Data Integration (MDI).\n\nFor the capability definitions: `type` MUST ONLY be set to `sap.mdo:mdi-capability-definition:v1`."
+            },
+            {
+              "const": "custom",
+              "description": "If chosen, `customType` MUST be provided."
             }
           ],
           "examples": [
@@ -3480,6 +3691,12 @@
           "x-association-target": [
             "#/definitions/Package/ordId"
           ],
+          "x-reverse-relationship": {
+            "propertyName": "capabilities",
+            "description": "The capabilities that are part the given Package.",
+            "min": 0,
+            "max": "*"
+          },
           "maxLength": 255,
           "description": "Defines which Package the resource is part of.\n\nMUST be a valid reference to a [Package](#package) ORD ID.\n\nEvery resource MUST be part of one package.",
           "examples": [
@@ -3495,6 +3712,10 @@
               "#/definitions/Group/groupId"
             ]
           },
+          "x-reverse-relationship": {
+            "propertyName": "capabilityMembers",
+            "description": "The Capabilities that are part the given Group."
+          },
           "description": "Defines which groups the resource is assigned to.\n\nThe property is optional, but if given the value MUST be an array of valid Group IDs.\n\nGroups are a lightweight custom taxonomy concept.\nThey express a \"part of\" relationship to the chosen group concept.\nIf an \"identity / equals\" relationship needs to be expressed, use the `correlationIds` instead.\n\nAll resources that share the same group ID assignment are effectively grouped together."
         },
         "version": {
@@ -3565,7 +3786,7 @@
         },
         "relatedEntityTypes": {
           "type": "array",
-          "description": "Optional list of related EntityType Resources.\n\nMUST be a valid reference to an [EntityType Resource](#entity-type) ORD ID.",
+          "description": "Optional list of related EntityType Resources.\nMUST be a valid reference to an [EntityType Resource](#entity-type) ORD ID.",
           "items": {
             "type": "string",
             "pattern": "^([a-z0-9]+(?:[.][a-z0-9]+)*):(entityType):([a-zA-Z0-9._\\-]+):(v0|v[1-9][0-9]*)$",
@@ -3573,6 +3794,12 @@
               "#/definitions/EntityType/ordId"
             ]
           },
+          "x-reverse-relationship": {
+            "propertyName": "capabilities",
+            "description": "Capabilities associated to the Entity Type.",
+            "min": 0,
+            "max": "*"
+          },
           "examples": [
             [
               "sap.odm:entityType:WorkforcePerson:v1"
@@ -3643,19 +3870,25 @@
       "type": "object",
       "title": "Capability Definition",
       "x-introduced-in-version": "1.4.0",
+      "x-ums-type": "custom",
       "description": "Link and categorization of a machine-readable capability definition.",
       "properties": {
         "type": {
           "description": "Type of the capability resource definition",
           "type": "string",
-          "oneOf": [
+          "anyOf": [
             {
-              "const": "custom",
-              "description": "If chosen, a custom type MUST be provided via `customType`"
+              "type": "string",
+              "pattern": "^([a-z0-9-]+(?:[.][a-z0-9-]+)*):([a-zA-Z0-9._\\-]+):(v0|v[1-9][0-9]*)$",
+              "description": "Any valid [Specification ID](../index.md#specification-id)."
             },
             {
               "const": "sap.mdo:mdi-capability-definition:v1",
               "description": "Specification for describing master data integration capabilities for Master Data Orchestration (MDO).\n\nThe `mediaType` MUST be set to `application/json`.\nThe capability `type` MUST be set to `sap.mdo:mdi-capability:v1`."
+            },
+            {
+              "const": "custom",
+              "description": "If chosen, a custom type MUST be provided via `customType`"
             }
           ],
           "examples": [
@@ -3731,8 +3964,9 @@
     "IntegrationDependency": {
       "type": "object",
       "title": "Integration Dependency",
+      "x-ums-type": "root",
       "x-introduced-in-version": "1.7.0",
-      "description": "An [Integration Dependency](../../details/articles/integration-dependency) states that the described system (self) can integrate with external systems (integration target) to achieve an integration purpose.\nThe purpose could be to enable a certain feature or integration scenario, but it could also be a mandatory prerequisite for the described system to work.\n\nThe integration dependency includes a list of individual **aspects** that the integration consists of.\nAspects are an \"ingredient\" for the integration scenario (and are logically combined with AND condition).\nEach aspect can express alternatives (OR condition) on what API and event resources can be used to achieve the same outcome.\n\nThe direction of connection establishment, data flow is not directly implied and needs to be inferred from the referenced resources.\n\nIt is not in scope for the Integration Dependency to describe scenarios that external consumers have with the own exposed resources.\nThis would overstep the boundary of self-description.\n\nIf an integration scenario consists of two sides integration with each other, each need to describe its own part in it as an Integration Dependency.\nTherefore, if an integration with multiple types of systems need to be setup, this SHOULD be separated into distinct Integration Dependencies.\n\nAn integration dependency is also not meant to describe a bigger process.\nInstead it focuses on the technical necessaries to create an integration for one particular purpose.\n\nTo learn more about the concept, see [Integration Dependency](../../details/articles/integration-dependency).",
+      "description": "An [Integration Dependency](../concepts/integration-dependency) states that the described system (self) can integrate with external systems (integration target) to achieve an integration purpose.\nThe purpose could be to enable a certain feature or integration scenario, but it could also be a mandatory prerequisite for the described system to work.\n\nThe integration dependency includes a list of individual **aspects** that the integration consists of.\nAspects are an \"ingredient\" for the integration scenario (and are logically combined with AND condition).\nEach aspect can express alternatives (OR condition) on what API and event resources can be used to achieve the same outcome.\n\nThe direction of connection establishment, data flow is not directly implied and needs to be inferred from the referenced resources.\n\nIt is not in scope for the Integration Dependency to describe scenarios that external consumers have with the own exposed resources.\nThis would overstep the boundary of self-description.\n\nIf an integration scenario consists of two sides integration with each other, each need to describe its own part in it as an Integration Dependency.\nTherefore, if an integration with multiple types of systems need to be setup, this SHOULD be separated into distinct Integration Dependencies.\n\nAn integration dependency is also not meant to describe a bigger process.\nInstead it focuses on the technical necessaries to create an integration for one particular purpose.\n\nTo learn more about the concept, see [Integration Dependency](../concepts/integration-dependency).",
       "properties": {
         "ordId": {
           "type": "string",
@@ -3746,7 +3980,7 @@
         "localId": {
           "type": "string",
           "x-introduced-in-version": "1.2.1",
-          "description": "Local ID, as known by the described system.\n\nThis can be the `<resourceName>` fragment in the ORD ID. In this case, make sure it fits the length limits of the ORD ID. It might also be different if e.g. localIds have incompatible charset restrictions.",
+          "description": "The locally unique ID under which this resource can be looked up / resolved in the described system itself.\nUnlike the ORD ID it's not globally unique, but it may be useful to document the original ID / technical name.\n\nIt MAY also be used as the `<resourceName>` fragment in the ORD ID, IF it can fulfill the charset and length limitations within the ORD ID.\nBut since this is not always possible, no assumptions MUST be made about the local ID being the same as the `<resourceName>` fragment in the ORD ID.",
           "maxLength": 255,
           "examples": [
             "SuccessFactorsRecruiting",
@@ -3799,6 +4033,12 @@
           "x-association-target": [
             "#/definitions/Package/ordId"
           ],
+          "x-reverse-relationship": {
+            "propertyName": "integrationDependencies",
+            "description": "The integration dependencies that are part the given Package.",
+            "min": 0,
+            "max": "*"
+          },
           "maxLength": 255,
           "description": "Defines which Package the resource is part of.\n\nMUST be a valid reference to a [Package](#package) ORD ID.\n\nEvery resource MUST be part of one package.",
           "examples": [
@@ -3814,6 +4054,10 @@
               "#/definitions/Group/groupId"
             ]
           },
+          "x-reverse-relationship": {
+            "propertyName": "integrationDependencyMembers",
+            "description": "The Integration Dependencies that are part the given Group."
+          },
           "description": "Defines which groups the resource is assigned to.\n\nThe property is optional, but if given the value MUST be an array of valid Group IDs.\n\nGroups are a lightweight custom taxonomy concept.\nThey express a \"part of\" relationship to the chosen group concept.\nIf an \"identity / equals\" relationship needs to be expressed, use the `correlationIds` instead.\n\nAll resources that share the same group ID assignment are effectively grouped together."
         },
         "version": {
@@ -3971,6 +4215,7 @@
       "type": "object",
       "title": "Aspect",
       "x-introduced-in-version": "1.7.0",
+      "x-ums-type": "custom",
       "description": "An (integration) aspect is the constituent part that makes up an Integration Dependency.\n\nEach aspect can list references to resources, which could be owned and defined by the integration target or by the described system itself.\nIn case the reference links to own resources, it is implied that they are to be used by the integration target to fulfill the Integration Dependency.\n\nIf multiple resources are given within an aspect, they are considered alternatives to each other (OR condition).\nIn case an AND condition is needed, multiple aspects need to be added to the Integration Dependency.",
       "properties": {
         "title": {
@@ -4023,6 +4268,7 @@
       "type": "object",
       "title": "API Resource Integration Aspect",
       "x-introduced-in-version": "1.7.0",
+      "x-ums-type": "custom",
       "description": "API resource related integration aspect",
       "properties": {
         "ordId": {
@@ -4053,6 +4299,7 @@
       "type": "object",
       "title": "Event Resource Integration Aspect",
       "x-introduced-in-version": "1.7.0",
+      "x-ums-type": "custom",
       "description": "Event resource related integration aspect",
       "properties": {
         "ordId": {
@@ -4105,6 +4352,7 @@
       "type": "object",
       "title": "Event Resource Integration Aspect Subset",
       "x-introduced-in-version": "1.7.0",
+      "x-ums-type": "custom",
       "description": "Defines that Event Resource Integration Aspect only requires a subset of the referenced contract.\n\nFor events, this could be a list of the events that need to be subscribed in order to make the integration work.\nThis information helps to narrow down what is really necessary and can help optimize the integration, e.g. by only publishing the events that are really needed.",
       "properties": {
         "eventType": {
@@ -4123,6 +4371,7 @@
     "Vendor": {
       "type": "object",
       "title": "Vendor",
+      "x-ums-type": "root",
       "description": "The vendor of a product or a package, usually a corporation or a customer / user.\n\nThe vendor of a `Package` is the owner or creator of the content of the package.\nThe vendor of a `Product` is the owner of the product.\n\nIf the resources are created by the customer / user of the described system, `customer:vendor:Customer:` MUST be used as vendor.\n\nBoth have already a [vendor namespace](../index.md#vendor-namespace) within their ORD ID.\nThe `Vendor` entity is giving more details on the vendor namespace.\nFor one vendor namespace there MUST only be exactly one `Vendor` ORD entity describing it.\n\nFor example: The only correct value for a SAP vendor reference is `sap:vendor:SAP:`.",
       "properties": {
         "ordId": {
@@ -4195,6 +4444,7 @@
       "type": "object",
       "title": "Changelog Entry",
       "description": "A changelog entry can be used to indicate changes.\nUsually they lead to a change of the version number or the release status.",
+      "x-ums-type": "custom",
       "properties": {
         "version": {
           "type": "string",
@@ -4258,6 +4508,7 @@
       "type": "object",
       "title": "Link",
       "description": "Link that can be attached to packages or Open Resource Discovery resources.\n",
+      "x-ums-type": "custom",
       "properties": {
         "title": {
           "type": "string",
@@ -4299,11 +4550,17 @@
     "PackageLink": {
       "type": "object",
       "title": "Package Link",
+      "x-ums-type": "custom",
       "description": "Links with specific semantic meaning that are related to `Package`.\n\nIf a generic [Link](#link) can also be expressed via a Package Link, the latter MUST be chosen.",
       "properties": {
         "type": {
           "type": "string",
-          "oneOf": [
+          "anyOf": [
+            {
+              "type": "string",
+              "pattern": "^([a-z0-9-]+(?:[.][a-z0-9-]+)*):([a-zA-Z0-9._\\-]+):(v0|v[1-9][0-9]*)$",
+              "description": "Any valid [Specification ID](../index.md#specification-id)."
+            },
             {
               "const": "terms-of-service",
               "description": "Link to human-readable terms of service / use documentation."
@@ -4373,12 +4630,18 @@
     "APIEventResourceLink": {
       "type": "object",
       "title": "API and Event Resource Link",
+      "x-ums-type": "custom",
       "description": "Links with specific semantic meaning that are related to API or event resources.\n\nIf a generic [Link](#link) can also be expressed via an API / Event Resource Link, the latter MUST be chosen.",
       "properties": {
         "type": {
           "type": "string",
           "description": "See also: [WADG0001 WebAPI type extension](https://webapi-discovery.github.io/rfcs/rfc0001.html#webapiactions)",
-          "oneOf": [
+          "anyOf": [
+            {
+              "type": "string",
+              "pattern": "^([a-z0-9-]+(?:[.][a-z0-9-]+)*):([a-zA-Z0-9._\\-]+):(v0|v[1-9][0-9]*)$",
+              "description": "Any valid [Specification ID](../index.md#specification-id)."
+            },
             {
               "const": "api-documentation",
               "description": "Link to human-readable documentation describing the API or event resource in more detail."
@@ -4450,11 +4713,17 @@
     "DataProductLink": {
       "type": "object",
       "title": "Data Product Link",
+      "x-ums-type": "custom",
       "description": "Links with specific semantic meaning that are related to Data Product resources.\nIf a generic [Link](#link) can also be expressed via Data Product Link, the latter MUST be chosen.",
       "properties": {
         "type": {
           "type": "string",
-          "oneOf": [
+          "anyOf": [
+            {
+              "type": "string",
+              "pattern": "^([a-z0-9-]+(?:[.][a-z0-9-]+)*):([a-zA-Z0-9._\\-]+):(v0|v[1-9][0-9]*)$",
+              "description": "Any valid [Specification ID](../index.md#specification-id)."
+            },
             {
               "const": "payment",
               "description": "Links to a resource detailing pricing details of the data product."
@@ -4513,6 +4782,7 @@
     "SystemInstance": {
       "type": "object",
       "title": "System Instance",
+      "x-ums-type": "ignore",
       "description": "A [system instance](../index.md#def-system-instance) is a concrete, running instance of a system type.\nIn a multi-tenant system, it corresponds to a tenant.\nIn a single-tenant system, it corresponds to the [system installation](../index.md#def-system-deployment) itself.",
       "properties": {
         "baseUrl": {
@@ -4579,6 +4849,7 @@
       "type": "object",
       "title": "System Type",
       "description": "A [system type](../index.md#def-system-type) is the abstract type of an application or service, from operational perspective.",
+      "x-ums-type": "ignore",
       "properties": {
         "systemNamespace": {
           "type": "string",
@@ -4634,6 +4905,7 @@
       "type": "object",
       "title": "System Version",
       "description": "A [system version](../index.md#def-system-version) states the design-time version / release of a [system instance](../index.md#def-system-instance).\nIt provides versioning for operational purposes for the [system type](../index.md#def-system-type).",
+      "x-ums-type": "ignore",
       "properties": {
         "version": {
           "type": "string",
@@ -4693,11 +4965,17 @@
       "type": "object",
       "title": "Access Strategy",
       "description": "Defines the [access strategy](../../spec-extensions/access-strategies/) for accessing the resource definitions.",
+      "x-ums-type": "custom",
       "properties": {
         "type": {
           "type": "string",
           "description": "Defines the authentication/authorization strategy through which the referenced `resourceDefinitions` are accessible.",
-          "oneOf": [
+          "anyOf": [
+            {
+              "type": "string",
+              "pattern": "^([a-z0-9-]+(?:[.][a-z0-9-]+)*):([a-zA-Z0-9._\\-]+):(v0|v[1-9][0-9]*)$",
+              "description": "Any valid [Specification ID](../index.md#specification-id).\nIf chosen, `customDescription` SHOULD be provided."
+            },
             {
               "const": "open",
               "description": "The resource definitions are openly accessible and not protected via authentication or authorization.\nPlease find a more detailed documentation [here](../../spec-extensions/access-strategies/open)."
@@ -4760,12 +5038,18 @@
       "type": "object",
       "title": "Credential Exchange Strategy",
       "x-feature-status": "alpha",
+      "x-ums-type": "custom",
       "description": "The credential exchange strategy specifies how a set of credentials for a particular usage\nof the APIs in the consumption bundle can be obtained.\nUntil a SAP-wide strategy for obtaining such credentials exists and is agreed upon,\nboth LoBs and aggregators (namely Unified Customer Landscape) can define their own strategy specifications.\n\nWhile the actual flow in term of API calls can differ between the different strategies,\nthe end goal would always be the possibility for automatically obtaining credentials for each client\nthat would like to use the APIs from a particular bundle.",
       "properties": {
         "type": {
           "type": "string",
           "description": "The type of credential exchange strategy.",
-          "oneOf": [
+          "anyOf": [
+            {
+              "type": "string",
+              "pattern": "^([a-z0-9-]+(?:[.][a-z0-9-]+)*):([a-zA-Z0-9._\\-]+):(v0|v[1-9][0-9]*)$",
+              "description": "Any valid [Specification ID](../index.md#specification-id).\nIf chosen, `customDescription` SHOULD be provided."
+            },
             {
               "const": "custom",
               "description": "If chosen, `customType` MUST be provided.\nIf chosen, `customDescription` SHOULD be provided."
@@ -4805,6 +5089,7 @@
       "title": "Labels",
       "type": "object",
       "description": "Generic labels that can be applied to most ORD information.\nThey are defined as an object that may have arbitrary keys.\nThe value of a key is an array of strings.\n\nLabels can be used to attach technical information that cannot be expressed natively in ORD.\nAn ORD aggregator should allow to categorize and query information based on the labels provided.\n\nIf multiple parties rely on the existence of certain label information,\nstandardization through ORD SHOULD be preferred.\n\nAll labels attached to a `Package` will be inherited to the resources they contain.\nDuplicate labels will be merged by the ORD aggregator according to the following rules:\n* Values of the same label key will be merged.\n* Duplicate values of the same label key will be removed.",
+      "x-ums-type": "custom",
       "patternProperties": {
         "^[a-zA-Z0-9-_.]*$": {
           "type": "array",
@@ -4826,7 +5111,8 @@
     "GroupType": {
       "title": "Group Type",
       "type": "object",
-      "description": "A Group Type defines the semantics of [group assignments](#group).\nWhat the Group Type means and how it is to be used correctly SHOULD be described in the `description` (which may include markdown links).\n\nGroup Types can be defined centrally (ownership by authority namespace) or decentrally (defined by application / service itself).\n\nTo learn more about the concept, see [Group Concept Documentation](../../details/articles/grouping-and-bundling#Groups).",
+      "x-ums-type": "root",
+      "description": "A Group Type defines the semantics of [group assignments](#group).\nWhat the Group Type means and how it is to be used correctly SHOULD be described in the `description` (which may include markdown links).\n\nGroup Types can be defined centrally (ownership by authority namespace) or decentrally (defined by application / service itself).\n\nTo learn more about the concept, see [Group Concept Documentation](../concepts/grouping-and-bundling#Groups).",
       "x-introduced-in-version": "1.9.0",
       "properties": {
         "groupTypeId": {
@@ -4871,7 +5157,8 @@
     "Group": {
       "title": "Group",
       "type": "object",
-      "description": "Group (instance) that resources can be assigned to.\n\nGroups are a lightweight custom taxonomy concept.\nThey express a \"part of\" relationship to the chosen group concept.\nIf an \"identity / equals\" relationship needs to be expressed, use the `correlationIds` instead.\n\nTo learn more about the concept, see [Group Concept Documentation](../../details/articles/grouping-and-bundling#Groups).",
+      "x-ums-type": "root",
+      "description": "Group (instance) that resources can be assigned to.\n\nGroups are a lightweight custom taxonomy concept.\nThey express a \"part of\" relationship to the chosen group concept.\nIf an \"identity / equals\" relationship needs to be expressed, use the `correlationIds` instead.\n\nTo learn more about the concept, see [Group Concept Documentation](../concepts/grouping-and-bundling#Groups).",
       "x-introduced-in-version": "1.9.0",
       "properties": {
         "groupId": {
@@ -4892,7 +5179,13 @@
           ],
           "x-association-target": [
             "#/definitions/GroupType/groupTypeId"
-          ]
+          ],
+          "x-reverse-relationship": {
+            "propertyName": "groups",
+            "description": "Group instances of the group type.",
+            "min": 0,
+            "max": "*"
+          }
         },
         "title": {
           "type": "string",
@@ -4930,6 +5223,7 @@
       "type": "object",
       "description": "Generic documentation labels that can be applied to most ORD information.\nThey are defined as an object that may have arbitrary keys.\nThe value of a key is an array of [CommonMark](https://spec.commonmark.org/) (Markdown) text.\n\nDocumentation Labels can be used to attach human readable documentation that cannot be expressed natively in ORD.\nA documentation tool (like an API Catalog) can use the documentation labels to provide generic documentation \"snippets\".\nDue to the given structure they can be displayed e.g. as tables.\n\nThe key of the documentation Label is plain-text (MUST not contain line breaks) and denotes the subject matter that is described.\nThe values (multiple can be provided for the same key) are [CommonMark](https://spec.commonmark.org/) (Markdown) text\nwhich describes the subject matter or lists options for the key.\n\nIn contrast to regular labels, documentation labels are not meant to be used to categorize or query information.",
       "x-introduced-in-version": "1.1.0",
+      "x-ums-type": "custom",
       "patternProperties": {
         "^.*$": {
           "type": "array",
@@ -4950,6 +5244,7 @@
     "Extensible": {
       "title": "Extensible",
       "type": "object",
+      "x-ums-type": "embedded",
       "description": "Contains information about the extensibility of this resource.\n\nIf applicable, a description and further resources about extending this resource are provided.",
       "properties": {
         "supported": {
@@ -4983,9 +5278,12 @@
     },
     "EntityTypeMapping": {
       "title": "Entity Type Mapping",
-      "x-introduced-in-version": "1.6.0",
       "type": "object",
-      "description": "An API or Event resource may optionally define its `entityTypeMappings`.\nThis is used to map and correlate the API models to the underlying, conceptual **entity types**.\n\nIf the mapping from API resource to entity types is not defined,\ncertain use-cases that rely on this explicit connection will not be possible.\n\nThis mapping is meant to be rather fine granular.\nTherefore, the mapping needs to be done on basis of one of the referenced resource definitions,\nas only there we know the details and the actual contents of the API Model of the API resource.\n\nFor the various resource definition formats the selection of API models may need to be expressed differently.\nAs a consequence, there are different types of selectors that are specialized toward certain resource definition formats.\n\nThe target of the mapping is a correlation to an entity type via a [Correlation ID](../../#/v1/README?id=correlation-id)\nor to an [ORD ID](../../spec-v1/#ord-id) of an entity type.\nIt is assumed that the entity types are described in more detail or on a different abstraction level via metadata.\nWhen the correlation ID is used, an ORD consumer may need to know how to access the entity type metadata through conventions.\nThis can be determined either by the namespace of the correlation ID,\nor through a defined and known `implementationStandard` that can resolve the `localId` fragment of the correlation ID .\n\nAt SAP, the metadata about entity types could be retrieved via the CSN_EXPOSURE service.\nTo indicate this, the service needs to be implemented and described in ORD with `implementationStandard` set to `sap:csn-exposure:v1`).\n\nODM 2.0 relies on the entity type mappings and uses the the mapping to express the relationship of an API to the\ncorresponding ODM entity. ORD consumers like SAP Business Accelerator Hub consume the mapping to make the relationships navigatable for customers.",
+      "x-introduced-in-version": "1.6.0",
+      "x-deprecated-in-version": "1.11.0",
+      "x-deprecated": "Use the simplified `relatedEntityTypes` instead.",
+      "x-ums-type": "custom",
+      "description": "An API or Event resource may optionally define its `entityTypeMappings`.\nThis is used to map and correlate the API models to the underlying, conceptual **entity types**.\n\nIf the mapping from API resource to entity types is not defined,\ncertain use-cases that rely on this explicit connection will not be possible.\n\nThis mapping is meant to be rather fine granular.\nTherefore, the mapping needs to be done on basis of one of the referenced resource definitions,\nas only there we know the details and the actual contents of the API Model of the API resource.\n\nFor the various resource definition formats the selection of API models may need to be expressed differently.\nAs a consequence, there are different types of selectors that are specialized toward certain resource definition formats.\n\nThe target of the mapping is a correlation to an entity type via a [Correlation ID](../../#/v1/README?id=correlation-id)\nor to an [ORD ID](../../spec-v1/#ord-id) of an entity type.\nIt is assumed that the entity types are described in more detail or on a different abstraction level via metadata.\nWhen the correlation ID is used, an ORD consumer may need to know how to access the entity type metadata through conventions.\nThis can be determined either by the namespace of the correlation ID,\nor through a defined and known `implementationStandard` that can resolve the `localId` fragment of the correlation ID .\n\nAt SAP, the metadata about entity types could be retrieved via the CSN_EXPOSURE service.\nTo indicate this, the service needs to be implemented and described in ORD with `implementationStandard` set to `sap:csn-exposure:v1`).\n\nODM 2.0 relies on the entity type mappings and uses the the mapping to express the relationship of an API to the\ncorresponding ODM entity. ORD consumers like SAP Business Accelerator Hub consume the mapping to make the relationships navigate-able for customers.",
       "properties": {
         "apiModelSelectors": {
           "type": "array",
@@ -5025,6 +5323,9 @@
     "ApiModelSelectorOData": {
       "title": "API Model Selector (OData)",
       "x-introduced-in-version": "1.6.0",
+      "x-deprecated-in-version": "1.11.0",
+      "x-deprecated": "Use the simplified `relatedEntityTypes` instead.\n\nFor creating a mapping from API model to Entity Types, consider using the [Entity Relationship](https://sap.github.io/csn-interop-specification/annotations/entity-relationship) annotations.",
+      "x-ums-type": "custom",
       "type": "object",
       "description": "API Model Selector for OData, using entity set names for the selection.\n\nMUST only be used if the API Resource provides an API Resource Definition of type `edmx`.",
       "properties": {
@@ -5059,6 +5360,9 @@
     "ApiModelSelectorJsonPointer": {
       "title": "API Model Selector (JSON Pointer)",
       "x-introduced-in-version": "1.6.0",
+      "x-deprecated-in-version": "1.11.0",
+      "x-deprecated": "Use the simplified `relatedEntityTypes` instead.\n\nFor creating a mapping from API model to Entity Types, consider using the [Entity Relationship](https://sap.github.io/csn-interop-specification/annotations/entity-relationship) annotations.",
+      "x-ums-type": "custom",
       "type": "object",
       "description": "Generic API Model Selector for JSON / YAML based resource definitions.\nIt uses a [JSON Pointer](https://datatracker.ietf.org/doc/html/rfc6901) that points to the\nentity type description within the resource definition.\n\nThe JSON Pointer always to refer to the structure of the document as originally provided, before further post-processing like resolving $ref properties.\n\nMUST only be used if the API Resource provides an API Resource Definition of media type `application/json` or `text/yaml`.",
       "properties": {
@@ -5092,11 +5396,14 @@
         }
       ]
     },
-    "RelatedEntityType": {
-      "title": "Related Entity Type",
-      "x-introduced-in-version": "1.9.0",
+    "EntityTypeOrdIdTarget": {
+      "title": "Entity Type Target (ORD ID)",
+      "x-introduced-in-version": "1.6.0",
+      "x-deprecated-in-version": "1.11.0",
+      "x-deprecated": "Use the simplified `relatedEntityTypes` instead.",
+      "x-ums-type": "custom",
       "type": "object",
-      "description": "Defines which Entity Type is related (via its ORD ID).\nIn the future, this could include stating the relationship type, too.",
+      "description": "Define which entity type is the target of an entity type mapping\n\nEntity types can be referenced using a [ORD ID](../../spec-v1/#ord-id) of an entity type.",
       "properties": {
         "ordId": {
           "type": "string",
@@ -5116,11 +5423,35 @@
       ],
       "additionalProperties": false
     },
-    "EntityTypeOrdIdTarget": {
-      "title": "Entity Type Target (ORD ID)",
+    "EntityTypeCorrelationIdTarget": {
+      "title": "Entity Type Target (Correlation ID)",
+      "type": "object",
+      "description": "Define which entity type is the target of an entity type mapping\n\nEntity types can be referenced using a [Correlation ID](../../spec-v1/#correlation-id).",
       "x-introduced-in-version": "1.6.0",
+      "x-deprecated-in-version": "1.11.0",
+      "x-deprecated": "Use the simplified `relatedEntityTypes` instead.",
+      "x-ums-type": "custom",
+      "properties": {
+        "correlationId": {
+          "type": "string",
+          "pattern": "^([a-z0-9]+(?:[.][a-z0-9]+)*):([a-zA-Z0-9._\\-\\/]+):([a-zA-Z0-9._\\-\\/]+)$",
+          "maxLength": 255,
+          "examples": [
+            "sap.csnexposure:entity:Attachment"
+          ]
+        }
+      },
+      "required": [
+        "correlationId"
+      ],
+      "additionalProperties": false
+    },
+    "RelatedEntityType": {
+      "title": "Related Entity Type",
+      "x-introduced-in-version": "1.9.0",
+      "x-ums-type": "embedded",
       "type": "object",
-      "description": "Define which entity type is the target of an entity type mapping\n\nEntity types can be referenced using a [ORD ID](../../spec-v1/#ord-id) of an entity type.",
+      "description": "Defines which Entity Type is related (via its ORD ID).\nIn the future, this could include stating the relationship type, too.",
       "properties": {
         "ordId": {
           "type": "string",
@@ -5140,29 +5471,35 @@
       ],
       "additionalProperties": false
     },
-    "EntityTypeCorrelationIdTarget": {
-      "title": "Entity Type Target (Correlation ID)",
-      "x-introduced-in-version": "1.6.0",
+    "ExposedEntityType": {
+      "title": "Exposed Entity Type",
       "type": "object",
-      "description": "Define which entity type is the target of an entity type mapping\n\nEntity types can be referenced using a [Correlation ID](../../spec-v1/#correlation-id).",
+      "description": "Defines which Entity Type is exposed through  (via its ORD ID).",
+      "x-introduced-in-version": "1.11.0",
+      "x-ums-type": "embedded",
       "properties": {
-        "correlationId": {
+        "ordId": {
           "type": "string",
-          "pattern": "^([a-z0-9]+(?:[.][a-z0-9]+)*):([a-zA-Z0-9._\\-\\/]+):([a-zA-Z0-9._\\-\\/]+)$",
+          "description": "The ORD ID is a stable, globally unique ID for ORD resources or taxonomy.\n\nIt MUST be a valid [ORD ID](../index.md#ord-id) of the appropriate ORD type.",
+          "pattern": "^([a-z0-9]+(?:[.][a-z0-9]+)*):(entityType):([a-zA-Z0-9._\\-]+):(v0|v[1-9][0-9]*)$",
           "maxLength": 255,
           "examples": [
-            "sap.csnexposure:entity:Attachment"
+            "sap.s4.sot:entityType:BusinessPartner:v1"
+          ],
+          "x-association-target": [
+            "#/definitions/EntityType/ordId"
           ]
         }
       },
       "required": [
-        "correlationId"
+        "ordId"
       ],
       "additionalProperties": false
     },
     "Tombstone": {
       "type": "object",
       "title": "Tombstone",
+      "x-ums-type": "ignore",
       "description": "A tombstone indicates that a previously published ORD resource or taxonomy has been removed / decommissioned.\nThis MUST be indicated explicitly, so ORD aggregators and consumers can learn about the removal.\n\nExactly one of the IDs MUST be provided to state which ORD resource or taxonomy item the Tombstone addresses.\n\nIt MUST be kept sufficiently long so that all ORD aggregators can learn about the tombstone.\nAfter that it MAY be removed.",
       "properties": {
         "ordId": {
@@ -5239,10 +5576,189 @@
           "removalDate": "2020-12-02T14:12:59Z"
         }
       ]
+    },
+    "OrdResource": {
+      "type": "object",
+      "title": "ORD Resource (abstract)",
+      "x-abstract": true,
+      "x-ums-type": "root",
+      "description": "Abstract definition of shared properties across ORD Resources.",
+      "properties": {
+        "ordId": {
+          "type": "string",
+          "description": "The ORD ID is a stable, globally unique ID for ORD resources or taxonomy.\n\nIt MUST be a valid [ORD ID](../index.md#ord-id) of the appropriate ORD type.",
+          "pattern": "^([a-z0-9-]+(?:[.][a-z0-9-]+)*):(apiResource|eventResource|capability|dataProduct):([a-zA-Z0-9._\\-]+):(v0|v[1-9][0-9]*|)$",
+          "maxLength": 255,
+          "examples": []
+        },
+        "localId": {
+          "type": "string",
+          "x-introduced-in-version": "1.2.1",
+          "description": "The locally unique ID under which this resource can be looked up / resolved in the described system itself.\nUnlike the ORD ID it's not globally unique, but it may be useful to document the original ID / technical name.\n\nIt MAY also be used as the `<resourceName>` fragment in the ORD ID, IF it can fulfill the charset and length limitations within the ORD ID.\nBut since this is not always possible, no assumptions MUST be made about the local ID being the same as the `<resourceName>` fragment in the ORD ID.",
+          "maxLength": 255,
+          "examples": []
+        },
+        "correlationIds": {
+          "type": "array",
+          "description": "Correlation IDs can be used to create a reference to related data in other repositories (especially to the system of record).\n\nThey express an \"identity\" / \"equals\" / \"mappable\" relationship to the target ID.\n\nIf a \"part of\" relationship needs to be expressed, use the `partOfGroups` assignment instead.\n\nMUST be a valid [Correlation ID](../index.md#correlation-id).",
+          "items": {
+            "type": "string",
+            "pattern": "^([a-z0-9]+(?:[.][a-z0-9]+)*):([a-zA-Z0-9._\\-\\/]+):([a-zA-Z0-9._\\-\\/]+)$",
+            "maxLength": 255
+          },
+          "examples": []
+        },
+        "title": {
+          "type": "string",
+          "description": "Human-readable title.\n\nMUST NOT exceed 255 chars.\nMUST NOT contain line breaks.",
+          "minLength": 1,
+          "maxLength": 255,
+          "examples": []
+        },
+        "shortDescription": {
+          "type": "string",
+          "description": "Plain text short description.\n\nMUST NOT exceed 255 chars.\nMUST NOT contain line breaks.",
+          "minLength": 1,
+          "maxLength": 255,
+          "examples": []
+        },
+        "description": {
+          "type": "string",
+          "minLength": 1,
+          "description": "Full description, notated in [CommonMark](https://spec.commonmark.org/) (Markdown).\n\nThe description SHOULD not be excessive in length and is not meant to provide full documentation.\nDetailed documentation SHOULD be attached as (typed) links.",
+          "examples": []
+        },
+        "partOfPackage": {
+          "type": "string",
+          "pattern": "^([a-z0-9]+(?:[.][a-z0-9]+)*):(package):([a-zA-Z0-9._\\-]+):(v0|v[1-9][0-9]*)$",
+          "x-association-target": [
+            "#/definitions/Package/ordId"
+          ],
+          "x-reverse-relationship": null,
+          "maxLength": 255,
+          "description": "Defines which Package the resource is part of.\n\nMUST be a valid reference to a [Package](#package) ORD ID.\n\nEvery resource MUST be part of one package.",
+          "examples": []
+        },
+        "partOfGroups": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "pattern": "^([a-z0-9-]+(?:[.][a-z0-9-]+)*):([a-zA-Z0-9._\\-\\/]+):([a-z0-9-]+(?:[.][a-z0-9-]+)*):([a-zA-Z0-9._\\-\\/]+)$",
+            "x-association-target": [
+              "#/definitions/Group/groupId"
+            ]
+          },
+          "x-reverse-relationship": {
+            "propertyName": "ordResourceMembers",
+            "description": "The ORD resources that are part the given Group.",
+            "min": 0,
+            "max": "*"
+          },
+          "description": "Defines which groups the resource is assigned to.\n\nThe property is optional, but if given the value MUST be an array of valid Group IDs.\n\nGroups are a lightweight custom taxonomy concept.\nThey express a \"part of\" relationship to the chosen group concept.\nIf an \"identity / equals\" relationship needs to be expressed, use the `correlationIds` instead.\n\nAll resources that share the same group ID assignment are effectively grouped together.",
+          "examples": []
+        },
+        "version": {
+          "type": "string",
+          "description": "The complete [SemVer](https://semver.org/) version string.\n\nIt MUST follow the [Semantic Versioning 2.0.0](https://semver.org/) standard.\nIt SHOULD be changed if the ORD information or referenced resource definitions changed.\nIt SHOULD express minor and patch changes that don't lead to incompatible changes.\n\nWhen the `version` major version changes, the [ORD ID](../index.md#ord-id) `<majorVersion>` fragment MUST be updated to be identical.\nIn case that a resource definition file also contains a version number (e.g. [OpenAPI `info`.`version`](https://swagger.io/specification/#info-object)), it MUST be equal with the resource `version` to avoid inconsistencies.\n\nIf the resource has been extended by the user, the change MUST be indicated via `lastUpdate`.\nThe `version` MUST not be bumped for changes in extensions.\n\nThe general [Version and Lifecycle](../index.md#version-and-lifecycle) flow MUST be followed.\n\nNote: A change is only relevant for a version increment, if it affects the ORD resource or ORD taxonomy directly.\nFor example: If a resource within a `Package` changes, but the package itself did not, the package version does not need to be incremented.",
+          "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)\\.(0|[1-9]\\d*)(?:-((?:0|[1-9]\\d*|\\d*[a-zA-Z-][0-9a-zA-Z-]*)(?:\\.(?:0|[1-9]\\d*|\\d*[a-zA-Z-][0-9a-zA-Z-]*))*))?(?:\\+([0-9a-zA-Z-]+(?:\\.[0-9a-zA-Z-]+)*))?$",
+          "examples": [
+            "1.2.3",
+            "1.0.0-alpha.1"
+          ]
+        },
+        "lastUpdate": {
+          "type": "string",
+          "format": "date-time",
+          "x-introduced-in-version": "1.4.0",
+          "description": "Optional, but RECOMMENDED indicator when (date-time) the last change to the resource (including its definitions) happened.\n\nThe date format MUST comply with [RFC 3339, section 5.6](https://tools.ietf.org/html/rfc3339#section-5.6).\n\nWhen retrieved from an ORD aggregator, `lastUpdate` will be reliable there and reflect either the provider based update time or the aggregator processing time.\nTherefore consumers MAY rely on it to detect changes to the metadata and the attached resource definition files.\n\nIf the resource has attached definitions, either the `version` or `lastUpdate` property MUST be defined and updated to let the ORD aggregator know that they need to be fetched again.\n\nTogether with `systemInstanceAware`, this property SHOULD be used to optimize the metadata crawling process of the ORD aggregators.",
+          "examples": [
+            "2022-12-19T15:47:04+00:00"
+          ]
+        },
+        "visibility": {
+          "type": "string",
+          "description": "The visibility states who is allowed to \"see\" the described resource or capability.",
+          "oneOf": [
+            {
+              "const": "public",
+              "description": "Resources are publicly visible to customers and 3rd parties.\nUsually this includes an contract on the API stability, e.g. the [SAP API Deprecation Policy](https://help.sap.com/viewer/84b35b9c39b247e3ba2a31f02beee46d/Cloud/en-US/5cbfda5a9efe4e97a3e24ddaf7ec5c16.html)."
+            },
+            {
+              "const": "internal",
+              "description": "Resources are visible to other applications within the same [vendor](#vendor).\nHowever, they are not officially exposed and communicated to customers and 3rd parties.\nThey might not come with the same guarantees on API stability.\n\nInternal resources MUST NOT be made available to consumers without checking the necessary access permissions, e.g., a public API Catalog.\nInternal resources MAY be published through an internal API Catalog if the access permissions are ensured by it."
+            },
+            {
+              "const": "private",
+              "description": "Resources that are exclusive within an application or service.\nThis includes resources that may be called from outside but serve purely private purposes and are not supposed to be known by other outside parties.\nE.g., webhooks for provisioning callbacks or backing services.\n\nPrivate resources MUST NOT be made available to public consumers or consumers outside of the \"private\" scope or without the necessary access permissions."
+            }
+          ]
+        },
+        "releaseStatus": {
+          "type": "string",
+          "description": "The `releaseStatus` specifies the stability of the resource and its external contract.",
+          "oneOf": [
+            {
+              "const": "active",
+              "description": "Resource is meant for productive use and provides a stable API contract."
+            },
+            {
+              "const": "beta",
+              "description": "The contract for the resource is beta and MAY not be meant for productive use.\nIn the SAP context, `beta` APIs may be changed or deleted at SAPs discretion."
+            },
+            {
+              "const": "deprecated",
+              "description": "Resource has been deprecated.\n\nIf successor resources exist, they MUST be referenced through `successors`.\nIf it is deprecated without defining its `successors`, a `sunsetDate` SHOULD be provided.\n\nA deprecated resource MAY be decommissioned (removed) in the future, through setting a `Tombstone`.\nOnce the resource is decommissioned, it MUST be removed from ORD (which is why there is no release status for decommissioned)."
+            }
+          ],
+          "examples": [
+            "active"
+          ]
+        },
+        "links": {
+          "type": "array",
+          "description": "Generic links with arbitrary meaning and content.\n\n`packageLinks` MUST be preferred if applicable.",
+          "items": {
+            "$ref": "#/definitions/Link"
+          }
+        },
+        "tags": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "pattern": "^[a-zA-Z0-9-_.\\/ ]*$",
+            "minLength": 1
+          },
+          "description": "List of free text style tags.\nNo special characters are allowed except `-`, `_`, `.`, `/` and ` `.\n\nTags that are assigned to a `Package` are inherited to all of the ORD resources it contains.",
+          "examples": [
+            [
+              "storage",
+              "high-availability"
+            ]
+          ]
+        },
+        "labels": {
+          "$ref": "#/definitions/Labels",
+          "description": "Generic labels that can be applied to most ORD information."
+        },
+        "documentationLabels": {
+          "$ref": "#/definitions/DocumentationLabels",
+          "description": "Generic documentation labels that can be applied to most ORD information."
+        }
+      },
+      "required": [
+        "ordId",
+        "title",
+        "description",
+        "version",
+        "visibility",
+        "releaseStatus",
+        "partOfPackage"
+      ],
+      "additionalProperties": true
     }
   },
-  "title": "ORD Document",
   "type": "object",
+  "x-ums-type": "ignore",
   "properties": {
     "$schema": {
       "type": "string",
@@ -5272,10 +5788,11 @@
         "1.7",
         "1.8",
         "1.9",
-        "1.10"
+        "1.10",
+        "1.11"
       ],
       "examples": [
-        "1.10"
+        "1.11"
       ]
     },
     "description": {
@@ -5301,7 +5818,12 @@
     "policyLevel": {
       "type": "string",
       "description": "The [policy level](../../spec-extensions/policy-levels/) (aka. compliance level) that the described resources need to be compliant with.\nDepending on the chosen policy level, additional expectations and validations rules will be applied.\n\nThe policy level can be defined on ORD Document level, but also be overwritten on an individual package or resource level.\n",
-      "oneOf": [
+      "anyOf": [
+        {
+          "type": "string",
+          "pattern": "^([a-z0-9-]+(?:[.][a-z0-9-]+)*):([a-zA-Z0-9._\\-]+):(v0|v[1-9][0-9]*)$",
+          "description": "Any valid [Specification ID](../index.md#specification-id)."
+        },
         {
           "const": "none",
           "description": "No policy level chosen. Only the base rules on how to create correct ORD documents apply."
@@ -5433,6 +5955,7 @@
     "groups": {
       "type": "array",
       "description": "Array of all Groups that are described in this ORD document.",
+      "x-introduced-in-version": "1.9.0",
       "items": {
         "$ref": "#/definitions/Group"
       }
@@ -5440,6 +5963,7 @@
     "groupTypes": {
       "type": "array",
       "description": "Array of all Group Types that are described in this ORD document.",
+      "x-introduced-in-version": "1.9.0",
       "items": {
         "$ref": "#/definitions/GroupType"
       }