Difference: UWS11RFC (4 vs. 5)

Revision 52015-08-14 - WalterLandry

 
META TOPICPARENT name="IvoaGridAndWebServices"

UWS v1.1 Proposed Recommendation: Request for Comments

Public discussion page for the IVOA UWS 1.1 Proposed Recommendation.

The latest version of the UWS Specification can be found at:

Reference Interoperable Implementations

Would the implementors of the UWS 1.1 specification please add details. Or, please remove your implementation from this list if not correct.

Astrogrid Implementation (Paul Harrison)

CDS / GAVO Implementation (Gregory Mantelet)

VO Paris Implementation (Mathieu Servillat)

CADC Implementation (Pat Dowler)

Implementations Validators

No implementation validators for UWS 1.1, though CADC (and others?) have UWS 1.0 validators that still pass:

  • taplint TAP validator within stilts does non-exhaustive validation of the UWS v1.0 functionality of a TAP service: job submission, lifecycle tracking, deletion, job document parsing etc. See UWS Stage. If someone can point me at a running UWS 1.1-compliant TAP service (minimum: WAIT-blocking and job documents labelled version='1.1' ) I'll try to update the validation for it. -- MarkTaylor - 2015-07-03
Deleted:
<
<
 Please add your validator (even if 1.0) if applicable.

RFC Review Period: 2015-06-30 - 2015-08-18

<-- REMOVE comment-out for TCG Review Period

TCG Review Period: TCG_start_date - TCG_end_date

-->

Comments from the IVOA Community during RFC period: 2015-06-30 - 2015-08-18

Example Comment (2015 June 30th) by BrianMajor

I comment on these three points:

  • point 1
  • point 2
  • point 3

Comments from MarkTaylor

Changed:
<
<
(Still) a good clearly written document. One or two minor comments/suggestions:
>
>
(Still) a good clearly written document. One or two minor comments/suggestions:
 
Changed:
<
<
  • Notation: I don't understand the usage of curly and round brackets in referencing URL path elements. For instance in sec 2.1.11 I see: "/{jobs}/{job-id}/parameters/(parameter-name)", and in sec 2.2: "/(jobs)/(jobid)", and in sec 2.2.1.1: "/{jobs}/(job-id)". Are () and {} doing different, ahem, jobs here? If not, can you just pick one or the other?
>
>
  • Notation: I don't understand the usage of curly and round brackets in referencing URL path elements. For instance in sec 2.1.11 I see: "/{jobs}/{job-id}/parameters/(parameter-name)", and in sec 2.2: "/(jobs)/(jobid)", and in sec 2.2.1.1: "/{jobs}/(job-id)". Are () and {} doing different, ahem, jobs here? If not, can you just pick one or the other?
 
  • Sec 1.3: "an XML document (e.g. ADQL, CEA [harrison05])" - is it anachronistic to refer to ADQL in this context since post-ADQL-2.0 there is no ADQL/X representation?
  • Sec 2.1: A count indicator ("1") is missing from the Job-Owner link in the UML diagram
  • Sec 2.1.3: The phases "HELD", "SUSPENDED" and "ARCHIVED" do not appear in the diagram.
  • Sec 2.2: "future versions of this document will add other bindings such as SOAP." Really?
Changed:
<
<
  • Sec 2.2: "an non-existant job id" -> "a non-existent job-id"
  • Sec 2.2.1.1: "it should not return a response (i.e. block)" is a bit ambiguous. Prefer "it should not return a response (i.e. it should block)"?
>
>
  • Sec 2.2: "an non-existant job id" -> "a non-existent job-id"
  • Sec 2.2.1.1: "it should not return a response (i.e. block)" is a bit ambiguous. Prefer "it should not return a response (i.e. it should block)"?
 
  • Sec 2.2.1.1: "/{jobs}/(job-id)?WAIT&PHASE=QUEUED": I think it has to be "WAIT=<value>" not just "WAIT"?
Changed:
<
<
  • Sec 4.2: "ADQL [1] can serve as a JDL." - bibliography referencing is wrong.
>
>
  • Sec 4.2: "ADQL [1] can serve as a JDL." - bibliography referencing is wrong.
 
  • Sec 4.3: "Call it CEA v2 to distinguish it from CEA v1 as currently maintained by AstroGrid." - it's a bit anachronistic.
  • Sec 4.3: "The JDL in CEA v2 is similar to that in CEA v1 It is a formal ..." - missing full stop
  • Sec 4.3: "the emerging XForms technology" - is it still emerging?
  • Schema: version attribute to be made optional? (see schema evolution discussion)
Deleted:
<
<
 -- MarkTaylor - 2015-07-02
Added:
>
>

Comments from WalterLandry

Regarding the new job query capability in Sec 2.2.2.1, it feels like
we are creating yet another query syntax with new keywords. To be
concrete, I would change the examples to

  • /{jobs}?QUERY=PHASE=EXECUTING
  • /{jobs}?QUERY=STARTTIME>2014-09-10T10:01:02.000
  • /{jobs}?QUERY=TOP+100
"QUERY" and "TOP" come from TAP, "STARTTIME" comes from the UWS
SCHEMA. For now, the spec will only specify simple queries. So there
will be only one parameter in QUERY. But this allows future
expansion, so a more sophisticated service could allow full SQL
  • /{jobs}?QUERY=(PHASE=EXECUTING+OR+PHASE=COMPLETED+OR+PHASE=SUSPENDED)+AND+STARTTIME>2014-09-10+ORDER+BY+ENDTIME
 

<-- REMOVE comment-out for TCG Review Period

Comments from TCG member during the TCG Review Period: 2014-10-01 - 2014-10-29

WG chairs or vice chairs must read the Document, provide comments if any and formally indicate if they approve or do not approve of the Standard.

IG chairs or vice chairs are also encouraged to do the same, although their inputs are not compulsory.

TCG Chair & Vice Chair ( _Matthew Graham, Pat Dowler )

Applications Working Group ( _Pierre Fernique, Tom Donaldson )

Data Access Layer Working Group ( François Bonnarel, Marco Molinaro )

Data Model Working Group ( _Mark Cresitello-Dittmar, Laurent Michel )

Grid & Web Services Working Group ( Brian Major, Giuliano Taffoni )

Registry Working Group ( _Markus Demleitner, Theresa Dower )

Semantics Working Group ( _Mireille Louys, Alberto Accomazzi )

Education Interest Group ( _Massimo Ramella, Sudhanshu Barway )

Time Domain Interest Group ( _John Swinbank, Mike Fitzpatrick )

Data Curation & Preservation Interest Group ( Françoise Genova )

Operations Interest Group ( _Tom McGlynn, Mark Taylor )

Knowledge Discovery in Databases Interest Group ( George Djorgovski )

Theory Interest Group ( _Franck Le Petit, Carlos Rodrigo )

Standards and Processes Committee ( Françoise Genova)

-->


<--  
-->
 
This site is powered by the TWiki collaboration platform Powered by Perl This site is powered by the TWiki collaboration platformCopyright © 2008-2025 by the contributing authors. All material on this collaboration platform is the property of the contributing authors.
Ideas, requests, problems regarding TWiki? Send feedback