[ https://issues.oasis-open.org/browse/ODATA-884?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]
Michael Pizzo updated ODATA-884:
--------------------------------
Proposal:
<Term Name="HttpResponses" Type="Collection(Core.HttpMethodResponse)" AppliesTo="EntitySet Singleton ActionImport FunctionImport Action Function">
<Annotation Term="Core.Description" String="Describes possible HTTP responses" />
<Annotation Term="Core.LongDescription" String="The list need not be complete. It may be used to generate API documentation, so restricting it to the most common and most important responses may increase readability." />
</Term>
<ComplexType Name="HttpMethodResponse">
<Property Name="Method" Type="Edm.String">
<Annotation Term="Core.Description" String="Request verb of the HTTP request, e.g. GET, POST, PATCH, DELETE" />
</Property>
<Property Name="HttpStatusCodes" Type="Collection(Core.HttpStatusCode)">
<Annotation Term="Core.Description" String="HTTP status codes of the response, e.g. 400, 403, 501" />
</Property>
</ComplexType>
<ComplexType Name="HttpStatusCode">
<Property Name="Code" Type="Edm.String">
<Annotation Term="Core.Description" String="HTTP status code of the response, e.g. 400, 403, 501" />
</Property>
<Property Name="Description" Type="Edm.String">
<Annotation Term="Core.Description" String="Human-readable description of the response code." />
</Property>
<Property Name="Conditions" Type="Collection(Core.HttpStatusCodeCondition)">
<Annotation Term="Core.Description" String="Descriptions of conditions resulting in the specified status code." />
</Property>
</ComplexType>
<ComplexType Name="HttpStatusCodeCondition">
<Property Name="ODataResponseCode" Type="Edm.String">
<Annotation Term="Core.Description" String="Language-independent, machine-readable OData response code" />
</Property>
<Property Name="Description" Type="Edm.String">
<Annotation Term="Core.Description" String="Human-readable description of the response situation" />
</Property>
</ComplexType>
> Add term ErrorCodes to describe possible codes in error messages (public comment c201510e00019)
> -----------------------------------------------------------------------------------------------
>
> Key: ODATA-884
> URL: https://issues.oasis-open.org/browse/ODATA-884
> Project: OASIS Open Data Protocol (OData) TC
> Issue Type: Bug
> Components: Vocabularies
> Affects Versions: V4.0_CSD01
> Reporter: Ralf Handl
> Assignee: Ralf Handl
> Fix For: V4.0_CSD02
>
>
> Jeff Wight proposes to add a term that allows describing possible code values in OData error responses, see https://lists.oasis-open.org/archives/odata-comment/201510/msg00019.html
> Example:
> <Annotation Term="Core.ErrorCodes">
> <Collection>
> <Record>
> <PropertyValue Property="HttpMethod" String="GET" />
> <PropertyValue Property="HttpStatusCode" String="400" />
> <PropertyValue Property="ODataErrorCode" String="QueryFilterFunctionNotSupported" />
> <PropertyValue Property="Description"
> String="This error indicates that a request was made with a filter function that isn’t supported on this entity set. Please refer to the Capabilities.FilterFunctions annotation on this entity set for a list of supported functions, and the exact error message for which function usage triggered this error." />
> </Record>
> </Collection>
> </Annotation>
> Definition
> <Term Name="ErrorCodes" Type="Collection(Core.ErrorCodeType)" AppliesTo="EntitySet Singleton ActionImport FunctionImport Action Function">
> <Annotation Term="Core.Description" String="Describes possible error codes in OData responses" />
> <Annotation Term="Core.LongDescription" String="The list need not be complete. It may be used to generate API documentation, so restricting it to the most common and most important errors may increase readability." /></Term>
> <ComplexType Name="ErrorCodeType">
> <Property Name="HttpMethod" Type="Edm.String">
> <Annotation Term="Core.Description" String="Request verb of the HTTP request, e.g. GET, POST, PATCH, DELETE" />
> </Property>
> <Property Name="HttpStatusCode" Type="Edm.String">
> <Annotation Term="Core.Description" String="HTTP status code of the response, e.g. 400, 403, 501" />
> </Property>
> <Property Name="ODataErrorCode" Type="Edm.String">
> <Annotation Term="Core.Description" String="Language-independent, machine-readable OData error code" />
> </Property>
> <Property Name="Description" Type="Edm.String">
> <Annotation Term="Core.Description" String="Human-readable description of the error situation" />
> </Property>
> </ComplexType>
--
This message was sent by Atlassian JIRA
(v6.2.2#6258)
