Uploaded image for project: 'OASIS Content Management Interoperability Services (CMIS) TC'
  1. OASIS Content Management Interoperability Services (CMIS) TC
  2. CMIS-565

3.3.3.1 getChildren orderBy Input needs significant clarification

    XMLWordPrintable

    Details

    • Type: Bug
    • Status: Closed
    • Priority: Major
    • Resolution: Applied
    • Affects Version/s: None
    • Fix Version/s: None
    • Component/s: Domain Model
    • Labels:
      None
    • Proposal:
      Hide

      The orderBy parameter is valid for a comma-separated list of query names and the ascending/descending modifier. Remove reference to query setion. A repository's handling of the orderBy input is repository-specific.

      Show
      The orderBy parameter is valid for a comma-separated list of query names and the ascending/descending modifier. Remove reference to query setion. A repository's handling of the orderBy input is repository-specific.
    • Resolution:
      Hide

      Fixed in 1.0

      Show
      Fixed in 1.0

      Description

      The orderBy parameter is not described except to say "see ORDER BY clause in query". The ORDER BY clause is defined in two places (it is not clear which is being referenced) - one is the BNF which simply defines its grammar, the other is section 2.10.2.5, which says:

      All column names referenced in this clause MUST be valid "queryName" or their aliased values for properties defined as orderable in the Object-type(s) whose Virtual Tables are listed in the FROM clause.
      Only columns in the SELECT clause MAY be in the ORDER BY clause.

      None of that applies to getChildren, because:
      o There is no FROM clause
      o Even ignoring that, there is no single Object-Type being returned here, as the children of a folder are of heterogeneous types (there is not even a cmis root type to capture them all)
      o There is no SELECT clause
      o Even ignoring that, there is no place where a list of usable property names can be obtained for ordering the results of the service
      o There are no aliases

      How does orderBy work?
      o What properties are allowed?
      o How are objects whose types don't define an orderBy property ordered (first? last? excluded?)

        Attachments

          Activity

            People

            • Assignee:
              ethang Ethan Gur-esh
              Reporter:
              ryan.mcveigh Ryan McVeigh (Inactive)
            • Watchers:
              0 Start watching this issue

              Dates

              • Created:
                Updated:
                Resolved: