PWG> TFM Svc as strict subset of PSI/1.0

PWG> TFM Svc as strict subset of PSI/1.0

McDonald, Ira imcdonald at
Mon May 31 16:48:15 EDT 2004

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.

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."


- 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 at

[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


More information about the Pwg mailing list