Annotate constructor/factory actions

[ralfhandl]

In 11.5.4.1 Invoking an Action we define that

Actions that create and return a single entity follow the rules for entity creation and return a Location header that contains the edit URL or read URL of the created entity.

Currently there's no way for clients and generic tools to recognize such "constructor" or "factory" actions. Annotating these actions would be helpful for e.g. OpenAPI generation from $metadata.

Proposal

Add tagging term Core.Constructor

<Term Name="Constructor" Type="Core.Tag" Nullable="false" DefaultValue="true" AppliesTo="Action">
  <Annotation Term="Core.Description" String="The annotated action constructs new entities" />
</Term>

Imported from ODATA-1214

[ralfhandl]

Both related pull requests have been merged, the only left-over is merging PR oasis-tcs/odata-vocabularies#239 once V4.02 CS01 is published

[mikepizzo]

Closed 2024-3-4 as PRs have been created.