[Oslc-Automation] Actions 2.0 updates

[John Arwe]

1:  drafted (see other email); I had not fully read this but re-used 
:verdict anyway, so great minds think alike I guess.  I did keep with 
"empty = cancelled" since we have the type as core:Dialog and that's 
currently the common interface for those, so you might want to propose 
changes but they'll be far less drastic versus what was there yesterday.

2: It sounds like the ODT content is still valid.  Will you be updating it 
then for currency?



Best Regards, John

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




From:   Martin P Pain <martinpain at uk.ibm.com>
To:     John Arwe/Poughkeepsie/IBM at IBMUS, 
Cc:     oslc-automation at open-services.net
Date:   03/19/2014 06:43 AM
Subject:        Re: [Oslc-Automation] Actions 2.0 updates



> 1: I defined the immediate execution dialog output.  Re-reading it, 
> it doesn't give a client any way to know whether or not the action 
> succeeded, which "seems like a problem" so I'll probably take 
> another pass at it unless others think that's a fine state of 
> affairs ("fire and forget"). 

I don't like the "MUST" requiring an empty response, as I think it would 
be valid to use a Creation dialog as an Action Dialog, if the action is to 
create something (e.g. "create linked defect") - the intention as I 
understand it is that "an empty response does not imply that the action 
failed". 

If we didn't fix this "problem" now, then it would be 
backwards-incompatible to make an empty response mean "cancelled". So we 
can either define what the non-empty "success" response should be, or 
accept that if we want to add the distinction later the "cancelled" 
information will have to be explicit. 

IMO, an explicit way of saying "the dialog was cancelled" be better 
anyway, as otherwise the consumer is implying something from lack of data 
(even though it isn't RDF, so that's less of a problem, but still feels 
like bad practice). Although that's already the case in existing creation 
& selection dialogs. (With selection dialogs, fair enough - if it's not 
telling you what it's selected it's not fit for purpose. However, with 
creation dialogs just because it doesn't tell you what it's created 
doesn't neceserily have to mean that it hasn't created it.) An explicit "
http:statusCodeNumber" value in the response, or something equivalent to 
"oslc_auto:state" or "oslc_auto:verdict" might be better, to allow an 
explicit way to say "this was cancelled" or "an error occurred" (again, I 
know the response isn't RDF, but we have these terms to reuse if we want 
them). 

> Martin: what do you want to do with the contents of the ODT at the 
> end of App B?  Has that been effectively superseded by your Auto 2.1
> wiki content, or does that need revising as well (if so, are you 
> able to make the revisions)? 

In my mind this is a version of [1], but applied to a specific example. 
[2] also does the same, as you suggest, but addresses a different example. 
The ODT covers how a consumer processes an action with multiple bindings 
of different types. [2] addresses deferred execution dialogs and future 
actions. 

I think a worked example covering the scenarios in the ODT would still be 
valuable, although it will need a fair amount of work to update it to the 
latest spec content. I suggest it could go in an "Actions examples" page, 
which could also link to the teardown scenarios page. Alternatively, we 
could definethe scenario that those examples fulfill, and create a 
separate page for that. Any feeling on which of these would be best? 

(I see the contents of this ODT, despite using AutoRequests, to be 
examples that belong in Core not Automation.) 

[1] 
http://open-services.net/wiki/core/Exposing-arbitrary-actions-on-RDF-resources/#Domain-specific-consumers 

[2] 
http://open-services.net/wiki/automation/Temporary-deployment-scenarios/ 

Martin Pain
Software Developer - Green Hat
Rational Test Virtualization Server, Rational Test Control Panel
Open Services for Lifecycle Collaboration - Automation WG joint chair 

E-mail: martinpain at uk.ibm.com
Find me on:  and within IBM on:   




IBM United Kingdom Limited
Registered in England and Wales with number 741598
Registered office: PO Box 41, North Harbour, Portsmouth, Hants. PO6 3AU 

"Oslc-Automation" <oslc-automation-bounces at open-services.net> wrote on 
19/03/2014 01:40:46:



Unless stated otherwise above:
IBM United Kingdom Limited - Registered in England and Wales with number 
741598. 
Registered office: PO Box 41, North Harbour, Portsmouth, Hampshire PO6 3AU
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://open-services.net/pipermail/oslc-automation_open-services.net/attachments/20140319/343e82cb/attachment-0003.html>
-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Type: image/jpeg
Size: 518 bytes
Desc: not available
URL: <http://open-services.net/pipermail/oslc-automation_open-services.net/attachments/20140319/343e82cb/attachment.jpe>
-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Type: image/jpeg
Size: 1208 bytes
Desc: not available
URL: <http://open-services.net/pipermail/oslc-automation_open-services.net/attachments/20140319/343e82cb/attachment-0001.jpe>
-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Type: image/gif
Size: 360 bytes
Desc: not available
URL: <http://open-services.net/pipermail/oslc-automation_open-services.net/attachments/20140319/343e82cb/attachment.gif>