SOA Reference Architecture, Public Review Draft 1, lines 1875-1884

[Michael Poulin <m3poulin@yahoo.com>]

Document:  Public Review Draft 1,
SOA Reference Architecture
 
Content:
1875 Interaction is the use of a service to access
capability in order to achieve a particular desired real world
1876 effect, where real world effect is the actual result of
using a service. An interaction can be characterized
1877 by a sequence of actions. Consequently,
interacting with a service involves performing actions against
1878 the service, usually through a series of
information exchanges (e.g., messages), although other modes of
1879 interaction are possible such as modifying the
shared state of a resource. Note that a participant (or
1880 agent acting on behalf of the participant) can be
the sender of a message, the receiver of a message, or
1881 both.
1882 For purposes of this SOA Reference Architecture,
the authors have committed to the use of message
1883 exchange between service participants to denote
actions against the services that cause a real world
1884 effect, and to
denote events that report on real world effects that arise from those actions.
 
Issue Title: Mismatch of use of term “interaction” in several sentences. 
Comments: Based on the definition of “interaction” given in the lines 1875-1876, interacting with a service, i.e. using the service, involves performing actions by the service, not against the service. The interactions with a service are the actions against the service. 
The sentence in lines 1883-1884 may be read ambiguously: a) as the actions that cause a real world effect; b) as the services that cause the real world effect. I believe that messages can only denote actions performed by the services and the latter can cause a real world effect as well as the events produced by the services and reported as the real world effect (though denoted by the messages initially)
 
Submitter: Michael Poulin
 
Suggestion: 
 
1875 Interaction is the use of a service to access
capability in order to achieve a particular desired real world
1876 effect, where real world effect is the actual result of
using a service. An interaction can be characterized
1877 by a sequence of actions. Consequently,
interacting with a service, i.e. performing actions against
1878 the service usually through a series of
information exchanges (e.g., messages), involves actions performed by
1878 the service. Different modes of interaction are
possible such as modifying the shared state of a resource. Note 1879 that a
participant (or agent acting on behalf of the participant) can be the sender of
a message, the receiver of 
1880 of a message, or both.
1881 For purposes of this SOA Reference Architecture,
the authors have committed to the use of message
1882 exchange between service participants to denote
actions performed against and by the service, and to denote 1883 events that report on
real world effects that is caused by the service actions.


      ____________________________________________________________________________________
Be a better friend, newshound, and 
know-it-all with Yahoo! Mobile.  Try it now.  http://mobile.yahoo.com/;_ylt=Ahu06i62sR8HDtDypao8Wcj9tAcJ