OASIS Mailing List ArchivesView the OASIS mailing list archive below
or browse/search using MarkMail.

 


Help: OASIS Mailing Lists Help | MarkMail Help

sca-assembly message

[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]


Subject: ISSUE 35: Confusing words in Section 5.3 relating to Conversational Intent



http://www.osoa.org/jira/browse/ASSEMBLY-35

On Dec 17, 2007, at 2:54 AM, Mike Edwards wrote:

>
> RAISER:  Mike Edwards
>
> TARGET:  SCA Assembly specification
>
> DESCRIPTION:
>
> In the assembly specification, WD-01, the paragraph between lines  
> 860 and 864 dealing with conversational interfaces
> is confusing and should be rewritten to clarify its meaning and  
> properly describe normative requirements.
>
> The current text is as follows:
>
> "This specification requires interfaces to be marked as  
> conversational by means of a policy intent with the name
> "conversational".   The form of the marking of this intent depends  
> on the interface type.  Note that it is also possible
> for a service or a reference to set the conversational intent when  
> using an interface which is not marked with the
> conversational intent.  This can be useful when reusing an existing  
> interface definition that does not contain SCA
> information."
>
> It is left unclear
> - what is required on the interface itself (is marking mandatory?)
> - where the marking is described and what form it may take
> - the relationship between specifying the conversational intent on  
> the service/reference and specifying it on the
> interface itself.
>
>
> PROPOSAL:
>
> Replace the paragraph between lines 860 and 864 with the following:
>
> "There is a policy intent with the name conversational which is  
> used to mark an interface as being conversational
> in nature.  Where a service or a reference has a conversational  
> interface, the conversational intent MUST be
> attached either to the interface itself, or to the service or  
> reference using the interface.  How to attach the
> conversational intent to an interface depends on the type of the  
> interface.  For a WSDL interface, this is described
> in section 5.4 "SCA-Specific Aspects for WSDL Interfaces".  For a  
> Java interface, it is described in the Java
> Common Annotations and APIs specification. Note that setting the  
> conversational intent on the service or reference
> element is useful when reusing an existing interface definition  
> that contains no SCA information, since it requires no
> modification of the interface artifact."
>
>
>
> Yours,  Mike.
>
> Strategist - Emerging Technologies, SCA & SDO.
> Co Chair OASIS SCA Assembly TC.
> IBM Hursley Park, Mail Point 146, Winchester, SO21 2JN, Great Britain.
> Phone & FAX: +44-1962-818014    Mobile: +44-7802-467431
> Email:  mike_edwards@uk.ibm.com
>
>
>
>
> 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
>
>
>
>
>
>



[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]