Re: Draft of UML diagram based on schema 43a - issues with schema and diagram

[William Cox <wtcox@CoxSoftwareArchitects.com>]

Here are the issues I've found in schema 43a. Fundamental issues first, minor documentation/comment issues later. I'm re-attaching the referenced PNG.

(a) the default value for List.of is OBIX:obj. In Op.in the default value is OBIX:Nil. But these is not defined in the schema, nor is it a string. The type is contractList,, so this should be the string "Nil" (instead of OBIX:Nil); not sure what OBIX:obj should be. The type again is contractList, so it should be a string.  This is a significant issue.

I suggest "Nil" for the contractList with no contracts.

I don't know what I'd suggest for OBIX:obj.  Suggestions?


(b) why is there both a simpleType "contractList" and a global attribute "is" of type contractList?

(c) there are some type issues:  some are XML types, some are UML types. See List where I have max, min of type xs:long. In UML basic types, this would be integer (which has no value limitations); previous diagram was int.  Which should it be? I'm a bit uncomfortable with xsd types without namespacing, but the text before Figure 4-1 would seem to justify using xsd types without tags.

(d) minor comment issues

Line 225:
<xs:documentation>Names the Contract the Object implements.</xs:documentation>
comment should be "…ContractList…"

Line 238:

    </xs:attribute>
    <xs:attribute name="of" type="contractList">
        <xs:annotation>
            <xs:documentation>Specifies the type of child Objects contained by this Object.</xs:documentation>
        </xs:annotation>
    </xs:attribute>
    <xs:attribute name="out" type="contractList">
        <xs:annotation>
            <xs:documentation>Specifies the output argument type used by this Object.</xs:documentation>
        </xs:annotation>
    </xs:attribute>

Are these "child Objects" or contractLists?  The simpleType is "contractList" per line 40.

Thanks!

bill
--

William Cox 

Email: wtcox@CoxSoftwareArchitects.com 

Web: http://www.CoxSoftwareArchitects.com 

+1 862 485 3696 mobile

On 6/15/15 6:52 PM, William Cox wrote:

Attached.

Some minor issues - followup email later this evening. Mostly UML versus xsd types (and xs flag), plus OBIX:obj as default in List, OBIX:Nil in Op, Feed etc.

Thanks!

bill

--

William Cox 

Email: wtcox@CoxSoftwareArchitects.com 

Web: http://www.CoxSoftwareArchitects.com 

+1 862 485 3696 mobile

Attachment: Obix-v1.1 Obj and Subclasses.png
Description: PNG image