New instance annotation @Core.changed for delta messages

vocabularies/Org.OData.Core.V1.json

@@ -726,6 +726,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

@@ -50,6 +50,7 @@ Term|Type|Description
 [ExplicitOperationBindings](./Org.OData.Core.V1.xml#L527:~:text=<Term%20Name="-,ExplicitOperationBindings,-")|\[[QualifiedBoundOperationName](#QualifiedBoundOperationName)\]|<a name="ExplicitOperationBindings"></a>The qualified names of explicitly bound operations that are supported on the target model element. These operations are in addition to any operations not annotated with RequiresExplicitBinding that are bound to the type of the target model element.
 [SymbolicName](./Org.OData.Core.V1.xml#L536:~:text=<Term%20Name="-,SymbolicName,-")|[SimpleIdentifier](#SimpleIdentifier)|<a name="SymbolicName"></a>A symbolic name for a model element
 [GeometryFeature](./Org.OData.Core.V1.xml#L545:~: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#L561:~: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,-")
@@ -323,3 +324,13 @@ Property|Type|Description
 [geometry](./Org.OData.Core.V1.xml#L550:~:text=<ComplexType%20Name="-,GeometryFeatureType,-")|Geometry?|Location of the Feature
 [properties](./Org.OData.Core.V1.xml#L553:~:text=<ComplexType%20Name="-,GeometryFeatureType,-")|[Dictionary?](#Dictionary)|Properties of the Feature
 [id](./Org.OData.Core.V1.xml#L556:~:text=<ComplexType%20Name="-,GeometryFeatureType,-")|String?|Commonly used identifer for a Feature
+
+<a name="PreviousStateType"></a>
+## [PreviousStateType](./Org.OData.Core.V1.xml#L570:~: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#L573:~: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#L576:~: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#L579:~: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

@@ -558,6 +558,29 @@ 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>