Specifications

has been held in some location for a long time, to avoid that
the job would be unduly processed before other jobs.
Managing external metadata datasets
The functions described here allow associating external metadata with a job's internal job ticket.
The Dataset classes in the metadata module implement each of the supported metadata data
models: XML data model, JDF data model, XMP data model, and Opaque data model.
The createDataset() and setDataset() functions must not be used after any of the Job.sendTo() or
Job.fail()functions was called for a job.
Creates and returns a new external metadata dataset object with
the specified data model ("XML", "JDF", "XMP" or "Opaque") and
createDataset ( model :
String ) : Dataset
with a backing file path and name appropriate for this job, without
creating the actual backing file. Returns null if an unknown data
model is requested, or if any of the Job.sendTo() or Job.fail()
functions was already called for the job.
The caller is responsible for creating a backing file that conforms
to the specified data model before attempting to read any data
from the dataset. The backing file path can be retrieved from the
returned Dataset object.
It is not possible to create a writable or an embedded dataset with
this function.
Associates a metadata dataset object with the specified tag, for
this job. It is allowed to associate a dataset with a job that has
been created for another job.
setDataset ( tag : String,
value : Dataset )
Returns the metadata dataset object associated with the specified
tag for this job, or null if there is none.
getDataset ( tag : String ) :
Dataset
Returns a list of all tags for which a metadata dataset object is
associated with the job.
getDatasetTags( ) : String[
]
Managing embedded metadata datasets
Returns an embedded metadata dataset object with the XMP data
model for the metadata embedded in the job. If there is no supported
embedded metadata, the function returns a valid but empty dataset.
getEmbeddedDataset (
writable : Boolean ) :
Dataset
The backing file path for the dataset may point to the job itself (if it is
an individual file) or to one of the files in the job folder (in some cases).
Metadata may be embedded in the file as an XMP packet and/or as
binary EXIF or IPTC tags. Metadata fields from multiple sources are
synchronized into a unified XMP data model. See supported file formats
for more information.
When the getEmbeddedDataset() function is invoked on a job for the first time in a certain entry
point, it returns:
• A writable dataset if the “writable” argument is set to true and Switch supports updating
metadata for the file format of the backing file (see supported file formats).
471
Enfocus Switch 10