Hi Mr. Berkema,
I am now making a final check on WSDLs for the final vote
and found some mistakes and questions in PSI spec (July 14, 2004).
So I report them.
Any comment is welcomed.
--------------------------------------------------------------------
P.25
5.4.2 GetTargetDeviceElements
Parameters: 'requestedPrinterElements:RequestedElements'
There is no type definition of 'RequestedElements' in 'Printer.xsd'
file, but in 'PwgCommon.xsd' file.
i.e. ...... Semantic Model [PWG5105.1] Printer.xsd
-> ...... Semantic Model [PWG5105.1] PwgCommon.xsd
--------------------------------------------------------------------
P.26
5.4.3 GetKnownTargetDevices
Parameters: 'printerFilterElements:Printer'
Does the sentence '(Give an example of a printerFilterElemets)'
mean '16.2 printerFilterElements : Printer' in '16 Appendix B -
Example XML Instance Objects (Informative)'
So need to delete that?
If needed, it may be good to make the sentence 'See example in Section
16' be more in detail.
--------------------------------------------------------------------
P.101
'16 Appendix B - Example XML Instance Objects (Informative)'
The version of the Semantic Model in namespace is old.
--------------------------------------------------------------------
P.101
'16.1 unsupportedElements : UnsupportedElements'
What is 'C:\SEMANT~1\PwgObjects.xsd' ? Local file ?
--------------------------------------------------------------------
P.101
'16.2 printerFilterElements : Printer'
This is the sample shown in PSI Spec. (omitted the unnecessary part)
<?xml version="1.0" encoding="UTF-8"?>
<n:Printer xmlns:n="http://www.pwg.org/schemas/sm/0.95/"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://www.pwg.org/schemas/sm/0.95/http://www.pwg.org/schemas/sm/0.95/PwgSemanticModel.xsd">
<n:PrinterDescription>
:
:
</n:PrinterDescription>
<n:PrinterStatus>
:
:
</n:PrinterStatus>
</n:Printer>
'Printer' is the TYPE, but not the ELEMENT of parameter
'printerFilterElements'.
So the sample above is strange. Element 'Printer' should not
be expressed , but in the sample it is expressed.
Because in 'Priner.xsd' file, the type 'Printer' is defined
as follows.
<xsd:complexType name="Printer">
<xsd:sequence>
<xsd:element ref="PrinterDescription" minOccurs="0" />
<xsd:element ref="PrinterStatus" minOccurs="0" />
<xsd:element ref="ProcessingDefaults" minOccurs="0" />
<xsd:element ref="ProcessingReady" minOccurs="0" />
<xsd:element ref="ProcessingSupported" minOccurs="0" />
<xsd:any namespace="##any" minOccurs="0" maxOccurs="unbounded" />
</xsd:sequence>
</xsd:complexType>
If the parameter 'printerFilterElements' is expected to use
like the sample above, the definitions of 'GetKnownTargetDevices'
need to be done as follows.
==WSDL-Example(A)==
<xsd:complexType name="Printer">
<xsd:sequence>
<xsd:element ref="pwgsm:Printer" minOccurs="0" maxOccurs="unbounded"/>
</xsd:sequence>
</xsd:complexType>
<xsd:element name="GetKnownTargetDevices">
<xsd:complexType>
<xsd:sequence>
<xsd:element name="targetDeviceIdentifierFilter" type="xsd:anyURI"/>
<xsd:element name="printerFilterElements" type="tns:Printer"/>
</xsd:sequence> ^^^
</xsd:complexType>
</xsd:element>
(In the file 'Print.xsd', there is the definition of ELEMENT 'Printer'
like this. <xsd:element name="Printer" type="Printer" /> )
But strictly in accordance with PSI spec, the definition of
'GetKnownTargetDevices' is as follows.
This sample is same as ServiceCapabilitiesInterface.wsdl (20030411).
==WSDL-Example(B)==
<xsd:element name="GetKnownTargetDevices">
<xsd:complexType>
<xsd:sequence>
<xsd:element name="targetDeviceIdentifierFilter" type="xsd:anyURI"/>
<xsd:element name="printerFilterElements" type="pwgsm:Printer"/>
</xsd:sequence> ^^^^^
</xsd:complexType>
</xsd:element>
So there should be no element name called 'Printer' in the sample.
How do you think ?
--------------------------------------------------------------------
P.101
'16.3 jobFilterElements : Job'
Same as '16.2 printerFilterElements : Printer' above.
--------------------------------------------------------------------
P.102
'16.4 documentFilterElements : Document'
Same as '16.2 printerFilterElements : Printer' above.
Cheers,
Masa.
-----------------------
Masanonri 'MASA' Itoh
RICOH Co., Ltd. Software R&D Center
Mr. Berkema, Alan C (R&D Roseville) wrote on Thu, 22 Jul 2004 14:09:37 -0700
------------------------------------------------------------------------
All,
Here are the files, thanks to Ira, Jerry, and Dave!
The last call review process begins on 07/23/2004 and will end on
08/16/2004.
We will accept e-mail comments during this time period on the psi
reflector.
ftp://ftp.pwg.org/pub/pwg/ps/wd/wd-psi10-20040721.pdf (and .doc)
ftp://ftp.pwg.org/pub/pwg/ps/wd/wd-psi10-20040721-rev.pdf (and .doc)
Also the events Schema
ftp://ftp.pwg.org/pub/pwg/ps/schemas/events-20040721.xsd
Last Call Comment resolution meeting tbd at F2F?
Thanks,
Alan Berkema