Re: Request for status re: NEW PREFERENCE - allow-entityreferences, callback, continue-on-error, include-annotations, maxpagesize, omit-values, and track-changes

Thank you Mike. That is why I asked. I don't mind sending the request on to
IANA but the process I saw was that the Designated Expert was to do it.

/chet

On Thu, Dec 6, 2018 at 2:01 PM Mike Bishop <mbishop@evequefou.be> wrote:

> Hm, actually – looking closer, it does say to e-mail the WG list and the
> Designated Expert will pick it up from there.  That’s… interesting.
>
>
>
> *From:* Mike Bishop
> *Sent:* Thursday, December 6, 2018 11:00 AM
> *To:* 'Chet Ensign' <chet.ensign@oasis-open.org>; ietf-http-wg@w3.org
> *Cc:* Mark Biamonte (Progress) <Mark.Biamonte@progress.com>; Ralf Handl
> (SAP) <ralf.handl@sap.com>
> *Subject:* RE: Request for status re: NEW PREFERENCE -
> allow-entityreferences, callback, continue-on-error, include-annotations,
> maxpagesize, omit-values, and track-changes
>
>
>
> That registry is Specification Required, so you don’t need approval from
> the working group to register something.  Just send the request to IANA
> <https://www.iana.org/form/protocol-assignment>.  They’ll ask the
> Designated Expert to review.
>
>
>
> *From:* Chet Ensign <chet.ensign@oasis-open.org>
> *Sent:* Thursday, December 6, 2018 10:50 AM
> *To:* ietf-http-wg@w3.org
> *Cc:* Mark Biamonte (Progress) <Mark.Biamonte@progress.com>; Ralf Handl
> (SAP) <ralf.handl@sap.com>
> *Subject:* Request for status re: NEW PREFERENCE -
> allow-entityreferences, callback, continue-on-error, include-annotations,
> maxpagesize, omit-values, and track-changes
>
>
>
> This message refers to the New Preference submission on August 29, 2018 in
> https://lists.w3.org/Archives/Public/ietf-http-wg/2018JulSep/0277.html.
>
>
>
> We have not seen any discussion, approval, or denial so I'm writing to ask
> if anything further is needed from the members of the Technical Committee.
>
>
>
> Thanks very much for clarifying,
>
>
>
> /chet ensign
>
> On Wed, Aug 29, 2018 at 2:33 PM Chet Ensign <chet.ensign@oasis-open.org>
> wrote:
>
> This message contains the information needed for Registration of the OData
> specific Prefer Header Preferences with IANA as called out in RFC 7240 -
> Prefer Header for HTTP.
>
>
>
>
>
> The OData Prefer Header Preferences requested to be registered are
>
>
>
> allow-entityreferences
>
> callback
>
> continue-on-error
>
> include-annotations
>
> maxpagesize
>
> omit-values
>
> track-changes
>
>
>
> The details as required by RFC 7240 for registering these preferences
> follow:
>
>
>
> ####
>
>
>
> Preference:
>
>
>
>     allow-entityreferences
>
>
>
> Value:
>
>
>
>     <none>
>
> Optional Parameters:
>
>
>
>    <none>
>
> Description:
>
>
>
>     Indicates that the service is allowed to return references in place of
> resources that have previously been returned, with at least the properties
> requested, in the same response.
>
>
>
> Reference:
>
>
>
>     OData Version 4.01 Part 1: Protocol –
>
>
> http://docs.oasis-open.org/odata/odata/v4.01/odata-v4.01-part1-protocol.html#sec_Preferenceallowentityreferencesodata
>
>
>
> Notes: [optional]
>
>
>
>     The allow-entityreferences preference was named
> odata.allow-entityreferences in OData version 4.0.
>
>
>
> ####
>
>
>
> Preference:
>
>
>
>     callback
>
>
>
> Value:
>
>
>
>     <none>
>
> Optional Parameters:
>
>
>
>     url - The URL of a callback endpoint to be invoked by the service when
> data is available.  The URL parameter is required
>
> Description:
>
>
>
>     Requests that the service invoke the specified URL to signal some
> service state, such as the completion of an asynchronous result or
> availability of new or modified information. The service state that
> triggers the change is dependent upon the request
>
>
>
> Reference:
>
>
>
>     OData Version 4.01 Part 1: Protocol –
>
>
> http://docs.oasis-open.org/odata/odata/v4.01/odata-v4.01-part1-protocol.html#sec_Preferencecallbackodatacallback
>
>
>
> Notes: [optional]
>
>
>
>     The callback preference was named odata.callback in OData version 4.0.
>
>
>
> ####
>
>
>
> Preference:
>
>
>
>     continue-on-error
>
>
>
> Value:
>
>
>
>     <none>
>
> Optional Parameters:
>
>
>
>     <none>
>
> Description:
>
>
>
>     Requests that the service attempt to continue processing a request
> that encounters non-fatal errors, for example in a multi-part request. The
> response SHOULD indicate what portions of the request were and were not
> able to be successfully handled.
>
> Reference:
>
>
>
>     OData Version 4.01 Part 1: Protocol –
>
>
> http://docs.oasis-open.org/odata/odata/v4.01/odata-v4.01-part1-protocol.html#sec_Preferencecontinueonerrorodatacontin
>
>
>
> Notes: [optional]
>
>     The continue-on-error preference was named odata.continue-on-error in
> OData version 4.0.
>
>
>
> ####
>
>
>
> Preference:
>
>
>
>     include-annotations
>
>
>
> Value:
>
>
>
>     Comma-separated list of terms to include or, when prefixed with a
> minus sign (-), exclude from the response. Terms MUST be
> namespace-qualified and MAY specify just a namespace to include or exclude
> all terms within that namespace. The special value "*" matches all
> annotations.
>
>
>
> Optional Parameters:
>
>
>
>     <none>
>
> Description:
>
>
>
>     Specifies the set of annotations the client requests to be included,
> where applicable, or excluded in the response.
>
> Reference:
>
>
>
>     OData Version 4.01 Part 1: Protocol –
>
>
> http://docs.oasis-open.org/odata/odata/v4.01/odata-v4.01-part1-protocol.html#sec_Preferenceincludeannotationsodatainc
>
>
>
> Notes: [optional]
>
>
>
>     The include-annotations preference was named odata.include-annotations
> in OData version 4.0.
>
>
>
> ####
>
>
>
> Preference:
>
>
>
>     maxpagesize
>
>
>
> Value:
>
>
>
>     a positive integer that represents the maximum number of items each
> collection in a response SHOULD contain
>
> Optional Parameters:
>
>
>
>     <none>
>
> Description:
>
>
>
>     Requests that each collection within the response contain no more than
> the number of items specified as the positive integer value of this
> preference.
>
> Reference:
>
>
>
>     OData Version 4.01 Part 1: Protocol –
>
>
> http://docs.oasis-open.org/odata/odata/v4.01/odata-v4.01-part1-protocol.html#sec_Preferencemaxpagesizeodatamaxpagesiz
>
>
>
> Notes: [optional]
>
>     The maxpagesize preference was named odata.maxpagesize in OData
> version 4.0.
>
>
>
> ####
>
>
>
> Preference:
>
>
>
>     Omit-values
>
>
>
> Value:
>
>
>
>     One of
>
>        nulls - properties containing null values may be omitted from the
> response
>
>        defaults - properties containing the property default value may be
> omitted from the response
>
> Optional Parameters:
>
>
>
>     <none>
>
> Description:
>
>
>
>     Specifies whether a server can omit properties with a null value or
> properties set to their default value from a response
>
> Reference:
>
>
>
>     OData Version 4.01 Part 1: Protocol –
>
>
> http://docs.oasis-open.org/odata/odata/v4.01/odata-v4.01-part1-protocol.html#sec_Preferenceomitvalues
>
>
>
> Notes: [optional]
>
>     <none>
>
>
>
> ####
>
>
>
> Preference:
>
>
>
>     track-changes
>
>
>
> Value:
>
>
>
>     <none>
>
> Optional Parameters:
>
>
>
>     <none>
>
> Description:
>
>
>
>     Requests that the service initiate change tracking on the result of
> this request, according to the underlying protocol.
>
>
>
> Reference:
>
>
>
>     OData Version 4.01 Part 1: Protocol –
>
>
> http://docs.oasis-open.org/odata/odata/v4.01/odata-v4.01-part1-protocol.html#sec_Preferencetrackchangesodatatrackchan
>
>
>
> Notes: [optional]
>
>     The track-changes preference was named odata.track-changes in OData
> version 4.0.
>
>
>
> ---
>
> /chet
> ----------------
>
> Chet Ensign
>
> Chief Technical Community Steward
> OASIS: Advancing open standards for the information society
> http://www.oasis-open.org
>
> Primary: +1 973-996-2298
> Mobile: +1 201-341-1393
>
>
>
>
> --
>
>
> /chet
> ----------------
>
> Chet Ensign
>
> Chief Technical Community Steward
> OASIS: Advancing open standards for the information society
> http://www.oasis-open.org
>
> Primary: +1 973-996-2298
> Mobile: +1 201-341-1393
>


-- 

/chet
----------------
Chet Ensign
Chief Technical Community Steward
OASIS: Advancing open standards for the information society
http://www.oasis-open.org

Primary: +1 973-996-2298
Mobile: +1 201-341-1393