Hello All,

 

My name is Karolina Sarnowska.  I am a part of Andrew Grimshaw’s group at the University of Virginia.  I have been working with Mark Morgan on getting Genesis II ready for the Interoperability Fiesta.  I wanted to email everyone what I just posted on the Wiki regarding some issues with the documentation.

 

-Karolina

 

ByteIO Interoperability Testing Scenarios Document Issues and Corrections

This section lists issues in the ByteIO Interoperability Testing Scenarios document and presents corrections. The issues are listed in the order that they appear in the document and reference the specific section they refer to.

Missing Tags in SOAP Body of Request Message

(4.2) wsrf-rp:GetMultipleResourceProperties operation

The non-normative example of the elements the ByteIO client adds to the SOAP body of the request message is missing the <wsrf-rp:ResourceProperty> tag. The SOAP body should instead contain the following: 

<wsrf-rp:GetMultipleResourceProperties>
    <wsrf-rp:ResourceProperty> rbyteio:Readable </wsrf-rp:ResourceProperty>
    <wsrf-rp:ResourceProperty> rbyteio:Writeable </wsrf-rp:ResourceProperty>
    <wsrf-rp:ResourceProperty> rbyteio:TransferMechanism </wsrf-rp:ResourceProperty>
</wsrf-rp:GetMultipleResourceProperties>

Incorrect Resource Property Name and Possibly Incorrect Query

(4.3) wsrf-rp:QueryResourceProperties operation

An incorrect name for the Resource Property is used in the non-normative example of the elements the ByteIO client adds to the SOAP body of the request message. The Resource Property queried is called “ModificationTime” not “ModificationDate”. The SOAP body should instead contain the following: 

<wsrf-rp:QueryResourceProperties>
    <wsrf-rp:QueryExpression Dialect=”http://www.w3.org/TR/1999/REC-xpath-19991116”>
        /*/rbyteio:ModificationTime
    </wsrf-rp:QueryExpression>
</wsrf-rp:QueryResourceProperties>

It is also unclear whether this example contains the correct query. If the query does not need to include the namespace, then the query could be instead “/*/ModificationTime”.

Missing Tag in SOAP Body of Response Message

(4.3) wsrf-rp:QueryResourceProperties operation

The non-normative example of the elements the ByteIO client adds to the SOAP body of the response message is missing the <rbyteio:ModificationTime> tag. The SOAP body should instead contain the following: 

<wsrf-rp:QueryResourcePropertiesResponse>
    <rbyteio:~ModificationTime>
      2006-09-11T16:15:33+05:00 
    </rbyteio:ModificationTime>
</wsrf-rp:QueryResourcePropertiesResponse>

Missing Tags in SOAP Body of Request Message

(5.2) wsrf-rp:GetMultipleResourceProperties operation

The non-normative example of the elements the ByteIO client adds to the SOAP body of the request message is missing the <wsrf-rp:ResourceProperty> tag. The SOAP body should instead contain the following: 

<wsrf-rp:GetMultipleResourceProperties>
    <wsrf-rp:ResourceProperty> sbyteio:Seekable </wsrf-rp:ResourceProperty>
    <wsrf-rp:ResourceProperty> sbyteio:TransferMechanism </wsrf-rp:ResourceProperty>
    <wsrf-rp:ResourceProperty> sbyteio:EndOfStream </wsrf-rp:ResourceProperty>
</wsrf-rp:GetMultipleResourceProperties>

Possibly Incorrect Query

(5.3) wsrf-rp:QueryResourceProperties operation

This section incorrectly refers to a modification date query. It should instead state: In this case, the client wishes to query the resource’s writeable property.

Mainly, it is unclear whether the non-normative example of the elements the ByteIO client adds to the SOAP body of the response message contains the correct query. If the query should include the namespace, then it should be “/*/sbyteio:Writeable” and the SOAP body should then contain the following: 

<wsrf-rp:QueryResourceProperties>
    <wsrf-rp:QueryExpression Dialect=”http://www.w3.org/TR/1999/REC-xpath-19991116”>
        /*/sbyteio:Writeable
    </wsrf-rp:QueryExpression>
</wsrf-rp:QueryResourceProperties>

If the namespace is not required, then querying for “/*/Writeable” if fine.

Missing Tag in SOAP body of Response Message

(5.3) wsrf-rp:QueryResourceProperties operation

The non-normative example of the elements the ByteIO client adds to the SOAP body of the response message is missing the <sbyteio:Writeable> tag. The SOAP body should instead contain the following: 

<wsrf-rp:QueryResourcePropertiesResponse>
    <sbyteio:Writeable>
      true 
    </sbyteio:Writeable>
</wsrf-rp:QueryResourcePropertiesResponse>

Discussion

This section lists questions that need to be answered to resolve ambiguity in the Interoperability Fiesta documentation.

Queries and Namespaces

If the client wishes to query a resources property, should the query contain the namespace? Which of the following queries are valid? The sections in parentheses refer to where the queries appear in the “ByteIO Interoperability Testing Scenarios” document.