OASIS Mailing List ArchivesView the OASIS mailing list archive below
or browse/search using MarkMail.

 


Help: OASIS Mailing Lists Help | MarkMail Help

odata message

[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]


Subject: [OASIS Issue Tracker] (ODATA-644) Example 18 should use "Orders" instead of "Items"


    [ https://tools.oasis-open.org/issues/browse/ODATA-644?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=37355#comment-37355 ] 

Michael Pizzo commented on ODATA-644:
-------------------------------------

Note that the previous example was correct, it was just confusing. The example was inserting an Order, and a nested Customer, and several order items, each of which was bound to a product. The fact that so much of the example was missing (represented by ellipses) made it hard to read. Re-ordered and added some properties to make the example easier to understand.

Considered (but did not implement) changing "Items" to "OrderLines" everywhere to further improve readability; would have to change in [Protocol], [JSON] and [Atom] to make sure examples were consistent.

> Example 18 should use "Orders" instead of "Items"
> -------------------------------------------------
>
>                 Key: ODATA-644
>                 URL: https://tools.oasis-open.org/issues/browse/ODATA-644
>             Project: OASIS Open Data Protocol (OData) TC
>          Issue Type: Bug
>          Components: OData JSON Format
>    Affects Versions: V4.0_OS
>         Environment: [Applied]
>            Reporter: Michael Pizzo
>            Assignee: Michael Pizzo
>            Priority: Minor
>             Fix For: V4.0_ERRATA01
>
>
> Example 18 of the JSON document shows a sample payload for a deep insert of Customers with nested Items.
> For the rest of the examples we use a schema where orders are nested within customers; for consistency and to avoid confusion we should show a nested collection of orders rather than "Items"



--
This message was sent by Atlassian JIRA
(v6.2.2#6258)


[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]