The Generate Interactive Document operation accepts a number
of mandatory and optional parameters. Only the package definition
is required. However, if data is not specified as input to the service,
it must be specified in the package definition.
For information about the General and Route Evaluation property
groups, see
Common operation properties
.
Input properties
Properties for specifying the package definition; the PDF
Portfolio, the data to merge with the document, and the output document.
Package definition (Mandatory)
A
document
value that specifies the
number, location, and layout of advertising content that direct
marketing will replace. The package definition is XML-based. It
includes references to other resources and attachments that will
be placed in the document. You create the package definition using
the Asset Placement Plug-in for Flash Builder 4 and then add the
asset data.
This value is mandatory.
Document template
A
document
value that represents the
template PDF Portfolio (.PDF) or Flex navigator (.NAV) that will
be used to provide the interactive portion of the output document.
The service distinguishes between the two variations and creates
the output accordingly. Alternatively, you can set this value to
NULL and specify it in the package definition.
Print template
A
document
value that points to a non-interactive
printable PDF form. If provided, the PDF document is rendered and
placed inside the document, and updated with current data. The value
could also be an xfa template stored within a .XDP file with no
external references. (A PDF would be passed for efficiency.)
Alternatively,
you can set this value to NULL and specify it in the package definition.
When defined in the package definition file, the attachment must
use the reserved ID "printDocument" so that it is recognized as
the printable statement, and merged with statement data.
This
value is not mandatory.
XML data
A
document
value that specifies the
XML data that must be merged into the document. The data is reflected
in the navigator user interface through the flex components, as
well as merged into the Print Template if it has been provided.
You
must either pass the data to the operation as a parameter, or define
it within the package definition file (package.xml). When defined
in the package definition file, the resource must use the reserved
ID "data" so that it is recognized as the interactive document's
global data source.
Caching properties
Properties for specifying caching.
Caching ID
A
string
value that the service uses
to create a unique cache to hold any resources. This value is a
unique identifier for a particular batch run. The intended usage
is for operation in batches where many invocations may occur for
the same generation of documents. These resources would be shared
for the duration. When empty no caching is performed. The Batch
Processor service automatically passes this value.
Clear cache
Forces the service to clear
any cache found with the provided caching ID. This property is useful
when an invocation is restarted and you don’t want to keep resources.
For
efficiency, the service does not clear its cache based on timestamp
comparisons between the assets' original location and those it holds
in its cache. Rather, by default it holds items while they are being
used and expires items as they become idle.
Output
Property for specifying the output result.
Interactive Document result
A
document
value that represents the
output.
Exceptions
This operation can throw an AssetPlacementException.
|
|
|