[Oslc-Automation] Action resources - implementation patterns

John Arwe johnarwe at us.ibm.com
Mon Jan 6 13:29:11 EST 2014


> > 2: In the final paragraph of [1], a statement is made: "However, as 
> "This" refers to the SHOULD in that same paragraph. The "already 

OK; I'll assume that some clarification either has been or will be made, 
given that I just proved by example that it can parse incorrectly ;-)

> > 3: In the RDF body pattern [4], we say "It is possible for bindings 
> They do not say that the bindings "MUST have a single http:body 
> property, which MUST have a single rdf:type value of...". 

> I have now attempted to make this explicit in the "It is possible 
> for bindings to match [both]" paragraph. 

I suggest "an http:body" --> "at least one http:body" in these cases (not 
having looked at the revisions - so... grain of salt).

> > 4: In the RDF body pattern [4] and resource shape pattern [2], we 
> "a binding" (each binding/a single binding) would be correct. I have
> updated the text to say "a binding". 

I suggest "a single binding", since I read 'a' sometimes as 1:1 and 
sometimes as 1:*, depending on context.
So this is really: if you mean 1:1, club me in the head with it.

> > 5: In the resource shape pattern [2], we say "finding or 
> A) I'd expect that all communications between the client and server 
>    so far have probably used a single serialization/format. This is 
> B) I would expect the consumers to set the Content-Type header. We 
>    should state this explicitly. 

So we might differ here.  My response to the other thread lays out my 
"opaque" assumption for the template case.  Hopefully by the time of this 
week's meeting we can be clear which of those are demanded by in-scope 
scenarios, if they drive different spec content.  "Opaque" I'd really like 
to make work, since it's more loosely coupled IMO, although I would not be 
entirely surprised if "other" cases exist where "completely opaque" won't 
work; in that case we'd have to figure out where to draw the line.

> > 6: In the RDF body pattern [4], I'm not sure what the extra(?) level
> > of indirection through oslc:ContentAsRDF buys us.  Is this simply to
> > follow the patten of [6]? 

My earlier reply reflects this; had not read this response when I Sent 
earlier.  I'll have to think on this.
I agree that if the provider's instructions say blob=x, 
content-type=text/plain AND we say that clients have to understand that 
"sub-type" of instructions, then it would be daft to say "...what he said, 
but -as RDF-".  I was assuming the instructions would amount to blob=x, 
content-type=y and then clients can just treat it like a blob.

> > 10: The construction of Appendix A [12] seemed at odds with itself. 
> In any case, these are not contradictory - the second section is 
> intended to require providers to offer at least onebinding per 
> action that meets these conditions, not imposing these conditions on
> all bindings (again, I've tried to make this clearer). Therefore 

I may have finally figured this out.  If it's clearer now, can't hoit.

> By "literal body" I mean something like text/plain (or binary data), 
e.g. : 

OK - good to know how that fits in; dovetails with my desire for opacity 
in those bodies.  I was thinking of the CM scenario where it's RDF that is 
expressible as, say, Turtle (which is under text/* so it's literal in that 
sense).  WRT non-RDF bodies, OK to allow it and understand how it fits in, 
not completely sure we need to specify it now (as long as we're sure it 
can be added compatibly).

> 11. In the "what are actions?" section [13] it now says "without 
> knowing anything about R other than its URI and (perhaps) how to 
> construct HTTP requests given instructions". However, "how to 
> construct HTTP requests given instructions" is not really "about R".
> Unless you mean "consumers must be able to retrieve R's triples". 

Ha!  I hear the parens in a different place.  Knowing what (I think) it 
says, I hear it as:
"without 
> knowing anything about R other than its URI and 
> (perhaps) how to construct [generic] HTTP requests given [generic] 
instructions"
not as 
> knowing anything about R other than its URI and (perhaps) how to 
construct [generic] HTTP requests [against/to R]
> given [generic] instructions"


> 12. Not related to your changes, but we have a "MUST" in the 
> "providers" section [14] under the "Overview (informative)" section 
> [15]. There is an equivalent MUST under the "instruction for 
> executing currently available actions" section [16], so I've just 
> removed the bold markup from the one in the informative section. 

Also remove the caps, if you haven't.  Practice I've picked up working on 
LDP.


> 13. Under "instructions for executing currently available actions" 
> [16] these words: "A consumer executes an action by following a 
> single interaction pattern that it supports, and applying 
> information supplied in the action binding to the pattern. A consumer 
MAY
> use any interaction pattern whose identification rule is matched by 
> the action binding. " seem to suggest that a consumer MAY use an 
> interaction pattern that it supports even if its rule did not match.
> Otherwise what is that MAY saying other than that they also might 
> not? While it does not make sense for consumers to do so, should we 
> include a MUST somewhere? e.g. "A consumer MUST use one of the 
> interaction pattern(s) whose identification rules are matched by the
> action binding it has chosen."? 

This was attempting to cover the case where a single binding matches n>1 
interaction patterns, and saying "we don't care which you choose, of those 
you support that match the binding".
Were you perhaps reading "A consumer MAY use any interaction pattern whose 
identification rule is matched" to say "use an" instead of "use any"?
In which case "use any ...pattern(s)" or "use any (of possibly multiple 
matching) ..." might help?


Best Regards, John

Voice US 845-435-9470  BluePages
Tivoli OSLC Lead - Show me the Scenario

-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://open-services.net/pipermail/oslc-automation_open-services.net/attachments/20140106/a77e80a6/attachment-0003.html>


More information about the Oslc-Automation mailing list