Re: [wsbpel] Issue - 149 - proposal to vote

[Alex Yiu <alex.yiu@oracle.com>]

Proposal to vote for Issue 149:

Proposed to add <documentation> to all BPEL extensible element.

Suggested description of <documentation> added to the specification text:
----------------------------
The content of <documentation> are for human-consumption. Example types for those content are: plain text, HTML and XHTML. On the other hand, tool-implementation specific information (e.g. the graphical layout details) should be added through elements and attributes of other namespaces, using the general BPEL extension mechanism. (i.e. bpws:tExtensibleElements).
----------------------------

Here is the suggested schema changes:
----------------------------

    <import namespace="http://www.w3.org/XML/1998/namespace" 
        schemaLocation="http://www.w3.org/2001/xml.xsd" />
     <element name="documentation" id="documentation">
        <complexType mixed="true">
            <sequence minOccurs="0" maxOccurs="unbounded">
                   <any processContents="lax"/>
            </sequence>
            <attribute name="source" type="anyURI"/>
            <attribute ref="xml:lang"/>
        </complexType>
    </element>
    <complexType name="tExtensibleElements">
        <annotation>
            <documentation>
        This type is extended by other component types
        to allow elements and attributes from
        other namespaces to be added.
       </documentation>
        </annotation>
        <sequence>
            <element ref="bpws:documentation" minOccurs="0" maxOccus="unbounded" />
            <any namespace="##other" processContents="lax" minOccurs="0" maxOccurs="unbounded"/>
        </sequence>
        <anyAttribute namespace="##other" processContents="lax"/>
    </complexType>

----------------------------