Hi folks, Monday (28 June 2004)
For use with WIMS over non-HTTP bindings (e.g., email - SMTP/IMAP/POP),
here's a second WIMS Manager Interface operation named 'ExecuteAction'.
This new operation would allow all WIMS Actions to be effectively
promoted to become direct WIMS Operations.
Comments?
Cheers,
- Ira
PS - I re-ordered the detail sections the way I think we decided at our
last PWG face-to-face. I'm not sure about this. I also corrected the
typos and weak references, Bill, in some Parameters and Returns (cut-and
-pasting from SetSchedule in the 19 May version of WIMS spec).
Ira McDonald (Musician / Software Architect)
Blue Roof Music / High North Inc
PO Box 221 Grand Marais, MI 49839
phone: +1-906-494-2434
email: imcdonald at sharplabs.com
------------------------------------------------------------------------
ExecuteAction (sourceURI : URI, targetURI : URI, action : PlanAction)
statusString : StatusString,
unsupportedElements : UnsupportedElements
Method Support:
WIMS Agent - OPTIONAL to support
WIMS Manager - OPTIONAL to support
Description:
Sends a PlanAction containing a single WIMS action to a WIMS Agent.
The receiving WIMS Agent:
(a) MUST immediately validate this action request;
(b) MUST attempt to execute any well-formed action request;
(c) MUST send a response containing the status of the action; and
(d) MAY send a SendReport or SendAlert to confirm the action.
Parameters:
sourceURI : xsd:anyURI
- URI of the source WIMS Manager - this value MUST use the
'pwg-wims:' URL scheme (see section 'WIMS URL Scheme') and MUST
conform to [RFC2396].
targetURI : xsd:anyURI
- URI of the destination WIMS Agent - this value MUST use the
'pwg-wims:' URL scheme (see section 'WIMS URL Scheme') and MUST
conform to [RFC2396].
action : pwg-sm:PlanAction
- single action for immediate execution - this PlanAction instance
MUST conform to the XML Schema defined in the PWG Semantic Model
[PWG-SM] module 'Schedule.xsd'.
Returns:
statusString : pwg-sm:StatusString
An ASCII string containing a keyword, returned by the Manager
reflecting the status of the action execution at the time of
response. Conforms to definition in the Semantic Model [PWG-SM]
'PwgCommon.xsd'.
unsupportedElements : pwg-sm:UnsupportedElements
An UnsupportedElements list that contains the elements that, as
specified in the action, are not supported by the WIMS Agent.
Conforms to definition in the Semantic Model [PWG-SM]
'PwgCommon.xsd'. If an element itself is not supported, the
element is returned with an empty value. If the element is
supported but the specified value is not supported, the element is
returned with the originally specified unsupported value.
------------------------------------------------------------------------