PWG Mail Archive: PWG> TFM Svc as strict subset of PSI/1.0

PWG> TFM Svc as strict subset of PSI/1.0

From: McDonald, Ira (imcdonald@sharplabs.com)
Date: Mon May 31 2004 - 16:48:15 EDT

  • Next message: Harry Lewis: "PWG> Re: TFM Svc as strict subset of PSI/1.0"

    Hi folks, Monday (31 May 2004)

    PSI/1.0 _already_ supports very precise document transforms, via the
    'requestedTargetDeviceDataType : DocumentFormatDetails' parameter
    of the CreateJob method. This is the _same_ functionality incorporated
    into the latest JDF/1.2 spec. A PSI client uses FetchDocumentDataByPull
    or FetchDocumentDataByValue later to retrieve the transformed output.

        ftp://ftp.pwg.org/pub/pwg/ps/wd/wd-psi10-20040113.pdf

    Thus, here's a proposal to define a PWG Transform Service (TFM) as a
    strict _subset_ of PSI/1.0 without Target Devices (and without _any_ new
    features or Job/Document elements). The proposal is summarized by the
    commented table of contents from the latest PSI/1.0 draft.

    Rationale for proposal, from section 5.5.2 CreateJob of PSI/1.0 spec:

    "targetDeviceIdentifier : URI

    A URI that defines the Target Device that is to be associated with a
    Job. See definition in section 7.2.

    <...>

    If the client specifies the Print Service's Service Root URL as the
    targetDeviceIdentifier, then the Print Service is considered the final
    destination, and the Print Service can perform all job processing. For
    example, document transformation."
             ^^^^^^^^^^^^^^^^^^^^^^^

    and later in section 5.5.2:

    "requestedTargetDeviceDataType : DocumentFormatDetails

    If this parameter is specified, then the Print Service shall transform
                                                           ^^^^^^^^^^^^^^^
    the source Document into the data type requested. If the specified
    Target Device does not support the requestedTargetDeviceDataType, the
    Print Service shall throw a ProcessingRequestUnsupported exception."

    Comments?

    Cheers,
    - Ira

    Ira McDonald (Musician / Software Architect)
    Blue Roof Music / High North Inc
    PO Box 221 Grand Marais, MI 49839
    phone: +1-906-494-2434
    email: imcdonald@sharplabs.com

    ------------------------------------------------------------------------
    [Transform Service (TFM) subset of PSI/1.0 - per TOC of PSI/1.0]

    5 Interface Definition

    5.1 PSI Service Root URL
    5.2 Negotiating a secure PSI connection

    5.3 QueryEndPointsInterface
    5.3.1 Interface Usage Examples
    5.3.2 QuerySupportedInterfaces
    5.3.3 QueryInterfaceDefinition

    5.4 ServiceCapabilitiesInterface
    5.4.1 Interface Usage Examples
    5.4.2 GetTargetDeviceElements -- needed to query TFM Service elements
    ** delete ** 5.4.3 GetKnownTargetDevices -- TFM Service is only endpoint
    5.4.4 ValidateReference

    5.5 JobControlInterface
    5.5.1 Interface Usage Examples
    5.5.2 CreateJob
    5.5.3 CloseJob
    5.5.4 AddDocumentByReference
    5.5.5 AddDocumentByPush
    5.5.6 PushDocumentDataDelivered
    5.5.7 AddDocumentByValue
    5.5.8 GetJobs
    5.5.9 GetJobElements
    ** delete ** 5.5.10 SetJobElements -- passive Jobs only
    5.5.11 CancelJob
    5.5.12 GetDocuments
    5.5.13 GetDocumentElements
    ** delete ** 5.5.14 SetDocumentElements -- passive Documents only
    5.5.15 CancelDocument
    5.5.16 FetchDocumentDataByPull -- needed for client to retrieve output
    5.5.17 PullDocumentDataFetched -- needed for client to retrieve output
    5.5.18 FetchDocumentDataByValue -- needed for client to retrieve output
    ** delete ** 5.5.19 FetchJobs -- no Target Device support

    ------------------------------------------------------------------------



    This archive was generated by hypermail 2b29 : Mon May 31 2004 - 16:48:25 EDT