Printer Services Mail Archive: PS> PSI WSDL files

PS> PSI WSDL files

From: Alain Regnier (alain@ussj.ricoh.com)
Date: Wed Feb 25 2004 - 17:05:06 EST

  • Next message: Zehler, Peter: "PS> Formal Vote on PSI specifications"

    All,
     
    Following our discussion at the PSI face to face, I've included a non
    exhaustive list of issues with the current WSDL files:
     
     
     
      * In the "JobControlInterface" WSDL file (Apr. 11,2003),
          there are no descriptions about the following methods
     
             SetJobElements
             SetDocumentElements
             FetchDocumentDataByPull
             PullDocumentDataFetched
             FetchDocumentDataByValue
     
     
      * In the "QueryEndPointsInterface" WSDL file (Apr. 11,2003),
          there is a restriction about interface names when querying
          about information of an interface.
          (That is shown as "InterfaceIdentifierNameWKV" in the file.)
     
          So we have to select an interface name among
    "JobContorlInterface",
          "ServiceCapabilitiesInterface", and
    "TargetDeviceSupportInterface".
     
          But in the specification (Jan. 13,2004) there is the description
    at Page 19
          ("5.3 QueryEndPointsInterface") as follows.
     
                "Vendor can define their own interface names and
    namespaces."
     
     
    * Basic Profile
    The PSI specification violates WS-I Basic Profile 1.0
    (http://www.ws-i.org/Profiles/Basic/2003-01/BasicProfile-1.0-WGAD.html).
    All http://www.pwg.org/schemas/ps/latest/*.wsdl do not follow the
    following BP 1.0 rule:
     
    R2716 A document-literal binding in a DESCRIPTION MUST NOT have the
    namespace attribute specified on contained soapbind:body,
    soapbind:header, soapbind:headerfault and soapbind:fault elements.
     
    The solution is simple: removing the namespace attribute specified on
    wsdlsoap:body elements.
     
     
     
    "QuerySupportedInterfaces"
          Returns: interfaceIdentifiers: InterfaceIdentifierContainer
             'interfaceIdentifier'
                   WSDL(2003/04/11)
                             "name"
                             "namespace"
                             "version"
                             "dataModel"
    >>>> "secure" xsd:boolean
                   Specification(2004/01/13) cf. P.84 [7.4
    InterfaceIdentifier]
                             "name"
                             "namespace"
                             "version"
                             "dataModel"
    >>>> "sec" [none, ssl3, tls]
    >>>> "auth" [none, login, basic, digest, certificate]
    -------------------------------
    "GetTargetDeviceElements"
          Parameters:
                   WSDL(2003/04/11)
                             targetDeviceIdentifier:URI
    >>>> requestedElements:Printer
                   Specification(2004/01/13) cf. P.23
                             targetDeviceIdentifier:URI
    >>>> requestedPrinterElements:RequestedElements
    -------------------------------
    "CreateJob"
          Parameters:
                   WSDL(2003/04/11)
                             targetDeviceIdentifier:URI
    >>>> deliverToTargetDevice:Boolean
    >>>> requestedTargetDeviceDataType:DocumentDescription
                             jobDescription:JobDescription
                             jobProcessing:JobProcessing
                             defaultDocumentProcessing:DocumentProcessing
                   Specification(2004/01/13) cf. P.31
                             targetDeviceIdentifier:URI
    >>>> autoSelectTargetDevice:Boolean
    >>>>
    requestedTargetDeviceDataType:DocumentFormatDetails
                             jobDescription:JobDescription
                             jobProcessing:JobProcessing
                             defaultDocumentProcessing:DocumentProcessing
          Returns:
                   WSDL(2003/04/11)
                             jobURI:URI
                             unsupportedElements:UnsupportedElements
                   Specification(2004/01/13) cf. P.31
                             jobURI:URI
                             unsupportedElements:UnsupportedElements
    >>>> targetDeviceIdentifierAutoSelect:Boolean
    -------------------------------
    "PushDocumentDataDelivered"
          Parameters:
                   WSDL(2003/04/11)
    >>>> documentURI:URI
                             dataSinkURI:URI
                   Specification(2004/01/13) cf. P.38
    >>>> jobURI:URI
    >>>> documentNumber:int
                             dataSinkURI:URI
    >>>> documentOctetsSent:long
    -------------------------------
    "GetJobs"
          Parameters:
                   WSDL(2003/04/11)
                             jobFilterElements:Job
    >>>> requestedElements:Job
    >>>> myJobs:Boolean
    >>>> whichJobs:WhichJobsWKV
                             limit:int
                   Specification(2004/01/13) cf. P.41
                             jobFilterElements:Job
    >>>> requestedJobElements:RequestedElements
                             limit:int
          Returns:
                   WSDL(2003/04/11)
    >>>> Job:Job
                   Specification(2004/01/13) cf. P.41
    >>>> jobs:JobContainer
    >>>> callbackInterval:uint32
    >>>> unsupportedElements:UnsupportedElements
    -------------------------------
    "GetDocuments"
          Parameters:
                   WSDL(2003/04/11)
                             jobURI:URI
                             documentFilterElements:Document
    >>>> requestedElements:Job
                   Specification(2004/01/13) cf. P.46
                             jobURI:URI
                             documentFilterElements:Document
    >>>> requestedDocumentElements:RequestedElements
          Returns:
                   WSDL(2003/04/11)
    >>>> Document:Document
                   Specification(2004/01/13) cf. P.46
    >>>> documents:DocumentContainer
    >>>> callbackInterval:uint32
    >>>> unsupportedElements:UnsupportedElements
     
     
     
    Thanks,
     
     
    Alain Regnier
    Ricoh
     
     
     
     



    This archive was generated by hypermail 2b29 : Wed Feb 25 2004 - 17:02:36 EST