Merge branch 'main' into Common.SecondaryKey

package.json

@@ -18,7 +18,7 @@
   },
   "devDependencies": {
     "eslint": "^8.56.0",
-    "express": "^4.19.2",
+    "express": "^4.20.0",
     "prettier": "^3.2.5"
   },
   "scripts": {

vocabularies/Common.json

@@ -59,6 +59,16 @@
       "@Core.Description": "A short, human-readable text suitable for tool tips in UIs",
       "@Core.IsLanguageDependent": true
     },
+    "DocumentationRef": {
+      "$Kind": "Term",
+      "@Common.Experimental": true,
+      "@Core.Description": "A URI referencing language-dependent documentation for the annotated model element",
+      "@Core.Example": {
+        "@odata.type": "https://oasis-tcs.github.io/odata-vocabularies/vocabularies/Org.OData.Core.V1.xml#Core.PrimitiveExampleValue",
+        "Description": "URN scheme to look up the documentation for an object with given type and id in a given system.\n              This example looks up the documentation for data element /iwbep/account in system G1Y_000.",
+        "Value": "urn:sap-com:documentation:key?=type=DTEL&id=%2fiwbep%2faccount&origin=G1Y_000"
+      }
+    },
     "Text": {
       "$Kind": "Term",
       "$Nullable": true,
@@ -236,20 +246,34 @@
     "SemanticObjectMapping": {
       "$Kind": "Term",
       "$Collection": true,
-      "$Type": "Common.SemanticObjectMappingType",
+      "$Type": "Common.SemanticObjectMappingAbstract",
       "$AppliesTo": ["EntitySet", "EntityType", "Property"],
       "$BaseTerm": "Common.SemanticObject",
       "@Core.Description": "Maps properties of the annotated entity type or sibling properties of the annotated property to properties of the Semantic Object",
       "@Core.LongDescription": "This allows \"renaming\" of properties in the current context to match property names of the Semantic Object, e.g. `SenderPartyID` to `PartyID`. Only properties explicitly listed in the mapping are renamed, all other properties are available for intent-based navigation with their \"local\" name."
     },
+    "SemanticObjectMappingAbstract": {
+      "$Kind": "ComplexType",
+      "$Abstract": true,
+      "@Core.Description": "Maps a property of the Semantic Object to a property of the annotated entity type or a sibling property of the annotated property or a constant value",
+      "SemanticObjectProperty": { "@Core.Description": "Name of the Semantic Object property" }
+    },
     "SemanticObjectMappingType": {
       "$Kind": "ComplexType",
-      "@Core.Description": "Maps a property of the annotated entity type or a sibling property of the annotated property to a property of the Semantic Object",
+      "$BaseType": "Common.SemanticObjectMappingAbstract",
       "LocalProperty": {
         "$Type": "Edm.PropertyPath",
         "@Core.Description": "Path to a local property that provides the value for the Semantic Object property"
-      },
-      "SemanticObjectProperty": { "@Core.Description": "Name of the Semantic Object property" }
+      }
+    },
+    "SemanticObjectMappingConstant": {
+      "$Kind": "ComplexType",
+      "$BaseType": "Common.SemanticObjectMappingAbstract",
+      "@Common.Experimental": true,
+      "Constant": {
+        "$Type": "Edm.PrimitiveType",
+        "@Core.Description": "Constant value for the Semantic Object property"
+      }
     },
     "SemanticObjectUnavailableActions": {
       "$Kind": "Term",