select parameter

[abierman]

o What syntax should be used for the "select" query parameter? The
current choices are "XPath" and "path-expr". Perhaps an
additional parameter to identify the select string format is
needed to allow extensibility?

Status: solution proposal added by Martin.

   leaf select {
     type string {
       length "1 .. max";
     }
     description
       "The 'select' query parameter is used to optionally identify
        data nodes within the target resource to be retrieved in a
        GET method.  The client can use this parameter to retrieve
        a subset of all nodes in a resource.

        A value of the 'select' query parameter matches the
        following rule:

          select-expr = path '(' select-expr / '*' ')' /
                        path ';' select-expr /
                        path
          path = api-identifier [ '/' path ]

        'api-identifier' is defined in section 5.3.1.1.

        ';' is used to select multiple nodes.  For example, to
        retreive only the 'genre' and 'year' of an album, use:
        'select=genre;year'.

        Parentheses are used to specify sub-selectors of a node.
        For example, to retreive only the 'label' and
        'catalogue-number' of an album, use:
        'select=admin(label;catalogue-number)'.

        '/' is used in a path to retreive a child node of a node.
        For example, to retreive only the 'label' of an album, use:
        'select=admin/label'.

        This parameter is only allowed for GET methods on api,
        datastore, and data resources.  A 400 Bad Request error
        is returned if used for other methods or resource types.";
   reference
     "RFC XXXX: [sec. 5.3.1.1 ABNF For Data Resource Identifiers]";
   }

[abierman]

No objections to this new syntax.
Will move to text section (not in YANG module)
Add some examples

[abierman]

No comment since added so accepting proposed syntax for select parameter.

[abierman]

select parameter is being renamed the fields parameter

[abierman]

Fixed in -04 release