Re: [ebxml-bp] ebBP 10/27/2005: Specification Element Changes(Specand Schema)

["Stephen Green" <stephen_green@bristol-city.gov.uk>]

Hi Monica

This looks very good. Many thanks. I'd wish to make a small change
just for accuracy:- 

to change

 externalDocumentDefRef="urn:oasis:names:specification:ubl:schema:xsd:Invoice-1.0"

to 

 externalDocumentDefRef="urn:oasis:names:tc:ubl:xpath:Invoice-1.0:sbs-1.0"

and it would make sense to add

 targetNamespace="urn:oasis:names:specification:ubl:schema:xsd:Invoice-1.0"

(although that is implicit in the externalDocumentDefRef="urn:oasis:names:tc:ubl:xpath:Invoice-1.0:sbs-1.0")


Many thanks again

All the best

Stephen Green

>>> Monica J Martin <Monica.Martin@Sun.COM> 31/10/05 21:18:32 >>>

> mm1: In line with our agreement at our last meeting 18 October 2005, 
> here is the proposed updated text on the Specification element with 
> the addition of the DocumentDefRef attribute. I've included both the 
> proposed technical specification text and the schema snippet for the 
> Specification element. Please provide comments this week. The updates 
> are in line with our agreement, meeting minutes from the last two 
> meetings and via email. Thanks and comments sure welcome and 
> appreciated. Many thanks to Stephen Green, Dale Moberg, and John 
> Yunker for their inputs here (actually the entire team is to be thanked).

mm2: One correction from last week's meeting, the new attribute name is 
externalDocumentDefRef (rather than documentDefRef). I have updated this 
in the schema and associated specification language. Sorry for the error.

I have provided the updated schema snippet below. As well, Dale and I 
have also suggested that we update a reference in the associated 
examples to show how this attribute may be used (See: "<!--Shows use of 
externalDocumentDefRef optional attribute-->". That is also included 
below. I'd ask everyone particularly Dale and Stephen to verify the 
example. Thanks.

[start schema snippet]

    <xsd:element name="*Specification*">
    - <#> <xsd:annotation>
      <xsd:documentation>A specification element that can associate many
    references to a particular ebBP element. For example, multiple
    specifications associated with a logical Business Document. Note:
    This element was added in v2.0.</xsd:documentation>
      </xsd:annotation>
    - <#> <xsd:complexType>
    - <#> <xsd:attribute name="*type*"
    type="*DocumentSpecificationType*" use="*optional*" default="*schema*">
    - <#> <xsd:annotation>
      <xsd:documentation>This attribute defines the type of the
    Specification of the particular ebBP element. Note: This attribute
    was added in v2.0.</xsd:documentation>
      </xsd:annotation>
      </xsd:attribute>
    - <#> <xsd:attribute name="*location*" type="*xsd:anyURI*"
    use="*required*">
    - <#> <xsd:annotation>
      <xsd:documentation>The location of the Specification of the
    particular ebBP element. Note: This attribute was added in
    v2.0.</xsd:documentation>
      </xsd:annotation>
      </xsd:attribute>
    - <#> <xsd:attribute name="*targetNamespace*" type="*xsd:anyURI*"
    use="*optional*">
    - <#> <xsd:annotation>
      <xsd:documentation>The target namespace of the Specification of
    the particular ebBP element. Note: This attribute was added in
    v2.0.</xsd:documentation>
      </xsd:annotation>
      </xsd:attribute>
    - <#> <xsd:attribute name="*externalDocumentDefRef*"
    type="*xsd:normalizedString*" use="*optional*">
    - <#> <xsd:annotation>
      <xsd:documentation>A name, URN or other reference that cites an
    external specification or reference that defines the document. This
    attribute was added in v2.0.1.</xsd:documentation>
      </xsd:annotation>
      </xsd:attribute>
      <xsd:attributeGroup ref="*name*" />
      </xsd:complexType>
      </xsd:element>

[end schema snippet]

Example snippet from Section 3.4.6.2 Specification element

    <ProcessSpecification
    xmlns="http://docs.oasis-open.org/ebxmlbp/ebbp-2.0";
        xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance";
           xmlns:xi="http://www.w3.org/2001/XInclude";
            name="PurchasingCluster" nameID="PC23"
           uuid="urn:purchasingcluster" specificationVersion="2"
           instanceVersion="1">
        <!--xi:include href="signals-package-2.0.1.xml"  parse="xml"
        xpointer="xpointer(/ProcessSpecification/Package[1])"/-->
    <!--Shows use of externalDocumentDefRef optional attribute-->
        <BusinessDocument name="Invoice" nameID="bd-invoice">
            <Specification type="schema"
                
    location="ubl-1-0-SBS-cs/xpaths/xml/XPath/Invoice-XPath.xml"
                   name="Invoice" nameID="invoice32"
                  
    externalDocumentDefRef="urn:oasis:names:specification:ubl:schema:xsd:Invoice-1.0"/>

        </BusinessDocument>
        <BusinessDocument name="InvoiceResponse"
           nameID="bd-invoiceResponse">
            <Specification type="schema"
                
    location="http://purchasingcluster.com/InvoiceResponse.xsd";
                   name="InvoiceResponse" nameID="invoice33"/>
        </BusinessDocument>
        <DataExchange name="Data:Invoice" nameID="data-invoice">
            <RequestingRole name="DIinitiator" nameID="DIinitiator1"/>
            <RespondingRole name="DIresponder" nameID="DIresponder1"/>
            <RequestingBusinessActivity name="ReqBA:SendInvoice"
                 nameID="debareq-invoice"
                   timeToAcknowledgeReceipt="PT6H"
                 timeToAcknowledgeAcceptance="PT12H">
                <DocumentEnvelope name="DE:ProcessInvoice"
                 nameID="data-de-invoice"
    businessDocumentRef="bd-invoice"/>
            </RequestingBusinessActivity>
            <RespondingBusinessActivity name="ResBA:ReceiveInvoice"
                 nameID="debares-invoice">
                <DocumentEnvelope name="DE:ProcessInvoiceResponse"
                 nameID="data-de-invoiceResponse"
                 businessDocumentRef="bd-invoiceResponse"/>
            </RespondingBusinessActivity>
        </DataExchange>
        <BusinessTransaction name="BT:Invoice" nameID="bt-invoice">
            <RequestingRole name="INinitiator" nameID="INinitiator1"/>
            <RespondingRole name="INresponder" nameID="INresponder1"/>
            <RequestingBusinessActivity name="ReqBA:SendInvoice"
                 nameID="reqba-invoice"
                 timeToAcknowledgeReceipt="PT6H"
                 timeToAcknowledgeAcceptance="PT12H">
                <DocumentEnvelope name="DE:ProcessInvoice"
                 nameID="bt-de-invoice" businessDocumentRef="bd-invoice"/>
                <ReceiptAcknowledgement name="sira" nameID="sira1"
                 signalDefinitionRef="ra2"/>
                <ReceiptAcknowledgementException name="sirae"
                 nameID="sirae1" signalDefinitionRef="rae2"/>
            </RequestingBusinessActivity>
            <RespondingBusinessActivity name="ResBA:ReceiveInvoice"
                 nameID="resba-invoice">
                <DocumentEnvelope name="DE:ProcessInvoiceResponse"
                 nameID="bt-de-invoiceResponse"
                 businessDocumentRef="bd-invoiceResponse"/>
                <ReceiptAcknowledgement name="sira" nameID="sira2"
                 signalDefinitionRef="ra2"/>
                <ReceiptAcknowledgementException name="sirae"
                 nameID="sirae2" signalDefinitionRef="rae2"/>
            </RespondingBusinessActivity>
        </BusinessTransaction>
    </ProcessSpecification>