OASIS Universal Business Language (UBL) TC

Re: [ubl] Re: Schema/model bugs

  • 1.  Re: [ubl] Re: Schema/model bugs

    Posted 04-06-2004 01:55
     MHonArc v2.5.0b2 -->
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    

    ubl message

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


    Subject: Re: [ubl] Re: Schema/model bugs


    w.r.t to UnSpecialised versus Unspecialised.  this was my filenaming 
    error.  In all cases it should be Unspecialised.
    
    w.r.t to Data Types.  the CCTS uses the spelling as "Data Type" (except 
    in one place where it is "Data type").  The spelling (and term) 
    "datatype" seems to be used in an XML/XSD environment to denote a very 
    precise set of objects 
    (http://www.w3.org/TR/2001/REC-xmlschema-2-20010502/#dt-datatype).
    
    The current NDR (draft P) uses both spellings fairly evenly, but (as 
    Mark said) is clear on the names of the schema 
    modules...UnSpecialisedDatatypes and SpecialisedDatatypes.
    
    So I don't think we can do as Stephen proposes. We use "datatype" and 
    "data type" for the CCTS objects and the XSD ones synonimously.  That 
    is, there is no semantic difference between xsd:dateTime  and 
    cct:DateTimeType - they are both "datatypes".
    
    To keep this simple, I suggest we adopt "datatype" for all our uses, 
    except where we explicitly want to talk about the objects in the CCTS 
    Table 8-1 and 8-2, then we use the term "Data Type".
    
    
    
    jon.bosak@sun.com wrote:
    
    >[This is the same message I just sent but with a better subject
    >line.]
    >
    >[stephen_green@seventhproject.co.uk:]
    >
    >| Either way, we would need to update our documentation
    >| to ensure consistency. We seem to have used both forms
    >| but I think we've especially favoured 'Unspecialised
    >| Data Types' (hence abbreviation UDT); I think this
    >| was to clarify the distinction from xsd:datatypes
    >| since this had caused some confusion with the understanding
    >| early on of the CCTS. The edits required in changing back to
    >| 'Datatypes' might include diagrams and their explanatory text.
    >
    >Here's my take on where we stand with this.
    >
    >Variants
    >
    >   The variants we're looking for are:
    >
    >      SpecialisedDatatypes
    >      SpecialisedDataTypes
    >
    >      UnspecialisedDatatypes
    >      UnspecialisedDataTypes
    >
    >      UnSpecialisedDataTypes
    >      UnspecialisedDataTypes
    >
    >Diagrams
    >
    >   The only artwork that I've checked into the fcs image that
    >   contains any of these terms is
    >
    >      ./art/UBL-1.0-ModelDependency.gif
    >
    >   and it spells these out as "Specialised Data Types" and
    >   "Unspecialised Data Types" (with spaces).  I'm still waiting a
    >   revised version of the schema assembly diagram, so we just need
    >   to make sure that it uses the forms we decide on.
    >
    >Explanatory text
    >
    >   Editing the text to make sure it's consistent is my problem;
    >   don't worry about it.
    >
    >Spreadsheets
    >
    >   As far as I can tell, none of the variants appear in the
    >   content of any of the spreadsheets, only in a couple of the
    >   file names:
    >
    >      ./mod/common/UBL-SpecialisedDataTypes-draft-12.xls
    >      ./mod/common/UBL-UnSpecialisedDataTypes-draft-12.xls
    >
    >Schemas and instances
    >
    >   The variants using "Datatype" appear in schema file names and
    >   in the content of both schemas and instances.
    >
    >Details
    >
    >   A detailed comparison of the occurence of each variant appears
    >   below.  From this it can be seen that there are a lot more
    >   files that have "Datatypes" than have "DataTypes," but these
    >   are all xsd and xml files that are trivial to change in batch
    >   mode (I could do this in about fifteen minutes).
    >
    >Recommendation
    >
    >   My own inclination is to make it "DataTypes" (or "Data Types"
    >   in text) throughout simply because "data" and "type" are
    >   English words and "datatype" is not.  Let's pick this up in the
    >   joint SC meeting tomorrow (Tuesday 6 April 8 a.m. San Francisco
    >   daylight time).  I'll be glad to make this change to the schema
    >   and instance files if this is all that's needed.
    >
    >Jon
    >
    >##################################################################
    >
    >1A. SpecialisedDatatypes
    >
    >    Found in file name:
    >
    >       ./xsd/common/UBL-SpecialisedDatatypes-1.0-draft-12.1.xsd
    >
    >    Found in text:
    >
    >       ./xml/joinery/UBL-DespatchAdvice-1.0-Joinery-Example.xml
    >       ./xml/joinery/UBL-Invoice-1.0-Joinery-Example.xml
    >       ./xml/joinery/UBL-Order-1.0-Joinery-Example.xml
    >       ./xml/joinery/UBL-OrderResponse-1.0-Joinery-Example.xml
    >       ./xml/office/UBL-Invoice-1.0-Office-Example.xml
    >       ./xml/office/UBL-Order-1.0-Office-Example.xml
    >       ./xml/office/UBL-OrderCancellation-1.0-Office-Example.xml
    >       ./xml/office/UBL-OrderChange-1.0-Office-Example.xml
    >       ./xml/office/UBL-OrderResponseSimple-1.0-Office-Example.xml
    >       ./xml/office/UBL-ReceiptAdvice-1.0-Office-Example.xml
    >       ./xsd/common/UBL-CommonAggregateComponents-1.0-draft-12.1.xsd
    >       ./xsd/common/UBL-CommonBasicComponents-1.0-draft-12.1.xsd
    >       ./xsd/common/UBL-SpecialisedDatatypes-1.0-draft-12.1.xsd
    >       ./xsd/maindoc/UBL-DespatchAdvice-1.0-draft-12.1.xsd
    >       ./xsd/maindoc/UBL-Invoice-1.0-draft-12.1.xsd
    >       ./xsd/maindoc/UBL-Order-1.0-draft-12.1.xsd
    >       ./xsd/maindoc/UBL-OrderCancellation-1.0-draft-12.1.xsd
    >       ./xsd/maindoc/UBL-OrderChange-1.0-draft-12.1.xsd
    >       ./xsd/maindoc/UBL-OrderResponse-1.0-draft-12.1.xsd
    >       ./xsd/maindoc/UBL-OrderResponseSimple-1.0-draft-12.1.xsd
    >       ./xsd/maindoc/UBL-ReceiptAdvice-1.0-draft-12.1.xsd
    >
    >1B. SpecialisedDataTypes
    >
    >    Found in file names:
    >
    >       ./mod/common/UBL-SpecialisedDataTypes-draft-12.xls
    >       ./mod/common/UBL-UnSpecialisedDataTypes-draft-12.xls
    >
    >    Found in text:
    >
    >       none
    >
    >##################################################################
    >
    >2A. UnspecialisedDatatypes
    >
    >    Found in file names:
    >
    >       ./xsd/common/UBL-UnspecialisedDatatypes-1.0-draft-12.1.xsd
    >
    >    Found in text:
    >
    >       ./xml/joinery/UBL-DespatchAdvice-1.0-Joinery-Example.xml
    >       ./xml/joinery/UBL-Invoice-1.0-Joinery-Example.xml
    >       ./xml/joinery/UBL-Order-1.0-Joinery-Example.xml
    >       ./xml/joinery/UBL-OrderResponse-1.0-Joinery-Example.xml
    >       ./xml/office/UBL-DespatchAdvice-1.0-Office-Example.xml
    >       ./xml/office/UBL-Invoice-1.0-Office-Example.xml
    >       ./xml/office/UBL-Order-1.0-Office-Example.xml
    >       ./xml/office/UBL-OrderCancellation-1.0-Office-Example.xml
    >       ./xml/office/UBL-OrderChange-1.0-Office-Example.xml
    >       ./xml/office/UBL-OrderResponseSimple-1.0-Office-Example.xml
    >       ./xml/office/UBL-ReceiptAdvice-1.0-Office-Example.xml
    >       ./xsd/common/UBL-CommonAggregateComponents-1.0-draft-12.1.xsd
    >       ./xsd/common/UBL-CommonBasicComponents-1.0-draft-12.1.xsd
    >       ./xsd/common/UBL-SpecialisedDatatypes-1.0-draft-12.1.xsd
    >       ./xsd/common/UBL-UnspecialisedDatatypes-1.0-draft-12.1.xsd
    >       ./xsd/maindoc/UBL-DespatchAdvice-1.0-draft-12.1.xsd
    >       ./xsd/maindoc/UBL-Invoice-1.0-draft-12.1.xsd
    >       ./xsd/maindoc/UBL-Order-1.0-draft-12.1.xsd
    >       ./xsd/maindoc/UBL-OrderCancellation-1.0-draft-12.1.xsd
    >       ./xsd/maindoc/UBL-OrderChange-1.0-draft-12.1.xsd
    >       ./xsd/maindoc/UBL-OrderResponse-1.0-draft-12.1.xsd
    >       ./xsd/maindoc/UBL-OrderResponseSimple-1.0-draft-12.1.xsd
    >       ./xsd/maindoc/UBL-ReceiptAdvice-1.0-draft-12.1.xsd
    >
    >2B. UnspecialisedDataTypes
    >
    >    Found in file name:
    >
    >       none
    >
    >    Found in text:
    >
    >       none
    >
    >##################################################################
    >
    >3A. UnSpecialisedDataTypes
    >
    >    Found in file name:
    >
    >       ./mod/common/UBL-UnSpecialisedDataTypes-draft-12.xls
    >
    >    Found in text:
    >
    >       none
    >
    >3B. UnspecialisedDataTypes
    >
    >    Found in file name:
    >
    >       none
    >
    >    Found in text:
    >
    >       none
    >
    >##################################################################
    >
    >
    >
    >To unsubscribe from this mailing list (and be removed from the roster of the OASIS TC), go to http://www.oasis-open.org/apps/org/workgroup/ubl/members/leave_workgroup.php.
    >
    >  
    >
    
    -- 
    regards
    tim mcgrath
    phone: +618 93352228  
    postal: po box 1289   fremantle    western australia 6160
    
    
    
    
    


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