Rephrase paragraphs 3 and 4 of section 10.4.2.3 Invoking an Action in the Protocol specification to be format-neutral:
If the invoke request contains any non-binding parameter values, the parameter values MUST be encoded in the format of a complex type instance in the request body.
Each non-binding parameter value specified MUST be encoded in the format of a property of a complex type instance. The name of the property is the name of the parameter. The value is the parameter value which is an instance of the type specified by the parameter in JSON format. Any parameter values not specified in the JSON object MUST be assumed to be null.
Add sections Action Parameters to the Atom and JSON format specification. For the new JSON specification the text will be
4.20 Action Parameters
Action parameter values MUST be encoded in a single JSON object in the request body.
Each non-binding parameter value specified MUST be encoded as a separate name/value pair in this JSON object. The name is the name of the parameter. The value is the parameter value in the JSON representation appropriate for its type.
Any parameter values not specified in the JSON object MUST be assumed to be null.
Example:
{
"param1": 42,
"param2":
{
"Street": "One Microsoft Way",
"Zip": 98052
}
,
"param3": [ 1, 42, 99 ]
}
The text for the Atom specification could be
15 Action Parameters
Action parameter values in the request body MUST be encoded as an individual complex scalar value (link to section 10) with the name parameters and no metadata:type attribute.
Each non-binding parameter value specified MUST be encoded as an individual primitive or complex scalar value. The name of the scalar value is the name of the parameter. The value is the parameter value in the XML representation appropriate for its type.
Any parameter values not specified in the request body MUST be assumed to be null.
Example:
<parameters>
<param1>42</param1>
<param2 metadata:type="Model.Address">
<Street>One Microsoft Way</Street>
<Zip>98052</Zip>
</param2>
<param3>
<element>1</element>
<element>42</element>
<element>99</element>
</param3>
<parameters>
Accepted: https://www.oasis-open.org/committees/download.php/48269/odata-meeting-25_on-20130214-minutes.html#odata-212
Improvement
Major