New instance annotation @Core.changed for delta messages

vocabularies/Org.OData.Core.V1.json

@@ -703,6 +703,22 @@
                 "$Nullable": true,
                 "@Core.Description": "Commonly used identifer for a Feature"
             }
+        },
+        "PreviousState": {
+            "$Kind": "Term",
+            "$Type": "Core.PreviousStateType",
+            "@Core.Description": "Previous state of a resource whose changes are described by the [added/changed entity in a delta message](https://docs.oasis-open.org/odata/odata-json-format/v4.01/odata-json-format-v4.01.html#sec_AddedChangedEntity) or a [nested entity in a deep-update request ](https://docs.oasis-open.org/odata/odata/v4.01/odata-v4.01-part1-protocol.html#sec_UpdateRelatedEntitiesWhenUpdatinganE) carrying this instance annotation",
+            "@Core.LongDescription": "The presence or absence of this instance annotation does not alter the idempotent nature of a delta or deep-update message, nor does it alter the UPSERT nature of an added/changed or nested entity.\n\nThe recipient of a delta message MAY use the instance annotation for optimization only; ultimately any received added/changed entity MUST be processed as an UPSERT."
+        },
+        "PreviousStateType": {
+            "$Kind": "EnumType",
+            "@Core.Description": "Previous state of a resource whose changes are described by an [added/changed entity in a delta message](https://docs.oasis-open.org/odata/odata-json-format/v4.01/odata-json-format-v4.01.html#sec_AddedChangedEntity) or a [nested entity in a deep-update request ](https://docs.oasis-open.org/odata/odata/v4.01/odata-v4.01-part1-protocol.html#sec_UpdateRelatedEntitiesWhenUpdatinganE)",
+            "Absent": 2,
+            "[email protected]": "The annotated entity describes changes to a resource that did not exist prior to capturing these changes",
+            "Existed": 1,
+            "[email protected]": "The annotated entity describes changes to a resource that already existed prior to capturing these changes",
+            "Unknown": 0,
+            "[email protected]": "The sender does not know whether the resource already existed prior to capturing these changes"
         }
     }
 }

vocabularies/Org.OData.Core.V1.md

@@ -48,6 +48,7 @@ Term|Type|Description
 [OperationAvailable](./Org.OData.Core.V1.xml#L507:~:text=<Term%20Name="-,OperationAvailable,-")|Boolean?|<a name="OperationAvailable"></a>Action or function is available<br>The annotation value will usually be an expression, e.g. using properties of the binding parameter type for instance-dependent availability, or using properties of a singleton for global availability. The static value `null` means that availability cannot be determined upfront and is instead expressed as an operation advertisement.
 [SymbolicName](./Org.OData.Core.V1.xml#L518:~:text=<Term%20Name="-,SymbolicName,-")|[SimpleIdentifier](#SimpleIdentifier)|<a name="SymbolicName"></a>A symbolic name for a model element
 [GeometryFeature](./Org.OData.Core.V1.xml#L526:~:text=<Term%20Name="-,GeometryFeature,-")|[GeometryFeatureType?](#GeometryFeatureType)|<a name="GeometryFeature"></a>A [Feature Object](https://datatracker.ietf.org/doc/html/rfc7946#section-3.2) represents a spatially bounded thing
+[PreviousState](./Org.OData.Core.V1.xml#L542:~:text=<Term%20Name="-,PreviousState,-")|[PreviousStateType](#PreviousStateType)|<a name="PreviousState"></a>Previous state of a resource whose changes are described by the [added/changed entity in a delta message](https://docs.oasis-open.org/odata/odata-json-format/v4.01/odata-json-format-v4.01.html#sec_AddedChangedEntity) or a [nested entity in a deep-update request ](https://docs.oasis-open.org/odata/odata/v4.01/odata-v4.01-part1-protocol.html#sec_UpdateRelatedEntitiesWhenUpdatinganE) carrying this instance annotation<br>The presence or absence of this instance annotation does not alter the idempotent nature of a delta or deep-update message, nor does it alter the UPSERT nature of an added/changed or nested entity.<br/>The recipient of a delta message MAY use the instance annotation for optimization only; ultimately any received added/changed entity MUST be processed as an UPSERT.
 
 ## <a name="RevisionType"></a>[RevisionType](./Org.OData.Core.V1.xml#L80:~:text=<ComplexType%20Name="-,RevisionType,-")
 
@@ -281,3 +282,12 @@ Property|Type|Description
 [geometry](./Org.OData.Core.V1.xml#L531:~:text=<ComplexType%20Name="-,GeometryFeatureType,-")|Geometry?|Location of the Feature
 [properties](./Org.OData.Core.V1.xml#L534:~:text=<ComplexType%20Name="-,GeometryFeatureType,-")|[Dictionary?](#Dictionary)|Properties of the Feature
 [id](./Org.OData.Core.V1.xml#L537:~:text=<ComplexType%20Name="-,GeometryFeatureType,-")|String?|Commonly used identifer for a Feature
+
+## <a name="PreviousStateType"></a>[PreviousStateType](./Org.OData.Core.V1.xml#L550:~:text=<EnumType%20Name="-,PreviousStateType,-")
+Previous state of a resource whose changes are described by an [added/changed entity in a delta message](https://docs.oasis-open.org/odata/odata-json-format/v4.01/odata-json-format-v4.01.html#sec_AddedChangedEntity) or a [nested entity in a deep-update request ](https://docs.oasis-open.org/odata/odata/v4.01/odata-v4.01-part1-protocol.html#sec_UpdateRelatedEntitiesWhenUpdatinganE)
+
+Member|Value|Description
+:-----|----:|:----------
+[Absent](./Org.OData.Core.V1.xml#L552:~:text=<EnumType%20Name="-,PreviousStateType,-")|2|The annotated entity describes changes to a resource that did not exist prior to capturing these changes
+[Existed](./Org.OData.Core.V1.xml#L555:~:text=<EnumType%20Name="-,PreviousStateType,-")|1|The annotated entity describes changes to a resource that already existed prior to capturing these changes
+[Unknown](./Org.OData.Core.V1.xml#L558:~:text=<EnumType%20Name="-,PreviousStateType,-")|0|The sender does not know whether the resource already existed prior to capturing these changes

vocabularies/Org.OData.Core.V1.xml

@@ -539,6 +539,27 @@ Any simple identifier | Any type listed in `Validation.OpenPropertyTypeConstrain
         </Property>
       </ComplexType>
 
+      <Term Name="PreviousState" Type="Core.PreviousStateType" Nullable="false">
+        <Annotation Term="Core.Description" String="Previous state of a resource whose changes are described by the [added/changed entity in a delta message](https://docs.oasis-open.org/odata/odata-json-format/v4.01/odata-json-format-v4.01.html#sec_AddedChangedEntity) or a [nested entity in a deep-update request ](https://docs.oasis-open.org/odata/odata/v4.01/odata-v4.01-part1-protocol.html#sec_UpdateRelatedEntitiesWhenUpdatinganE) carrying this instance annotation" />
+        <Annotation Term="Core.LongDescription">
+          <String>The presence or absence of this instance annotation does not alter the idempotent nature of a delta or deep-update message, nor does it alter the UPSERT nature of an added/changed or nested entity.
+
+The recipient of a delta message MAY use the instance annotation for optimization only; ultimately any received added/changed entity MUST be processed as an UPSERT.</String>
+        </Annotation>
+      </Term>
+      <EnumType Name="PreviousStateType">
+        <Annotation Term="Core.Description" String="Previous state of a resource whose changes are described by an [added/changed entity in a delta message](https://docs.oasis-open.org/odata/odata-json-format/v4.01/odata-json-format-v4.01.html#sec_AddedChangedEntity) or a [nested entity in a deep-update request ](https://docs.oasis-open.org/odata/odata/v4.01/odata-v4.01-part1-protocol.html#sec_UpdateRelatedEntitiesWhenUpdatinganE)" />
+        <Member Name="Absent" Value="2">
+          <Annotation Term="Core.Description" String="The annotated entity describes changes to a resource that did not exist prior to capturing these changes" />
+        </Member>
+        <Member Name="Existed" Value="1">
+          <Annotation Term="Core.Description" String="The annotated entity describes changes to a resource that already existed prior to capturing these changes" />
+        </Member>
+        <Member Name="Unknown" Value="0">
+          <Annotation Term="Core.Description" String="The sender does not know whether the resource already existed prior to capturing these changes" />
+        </Member>
+      </EnumType>
+
     </Schema>
   </edmx:DataServices>
 </edmx:Edmx>