TFORMer SDK - JAVA  7.0
Public Member Functions
JobDataXml Class Reference

Provides access to JobDataXml (a XML file that serves as JobData for a Job). More...

List of all members.

Public Member Functions

 JobDataXml ()
 Constructor for JobDataXml.
 JobDataXml (String filename)
 Constructor for JobDataXml.
String getFilename ()
 Gets the name of the XML input file.
String getXsltFilename ()
 Gets the XSLT filename (optional).
String getXsltTfcFilename ()
 Gets the XSLT TFC filename (optional).
boolean isHandleEscapeSequences ()
 Gets/Sets a flag indicating whether escape sequences in DataField values like \n or \x40 should be translated by TFORMer SDK.
boolean isReuseValues ()
 Gets a flag indicating whether DataField-values should be reused in consecutive records.
void setFilename (String sFilename)
 Sets the name of the XML input file.
void setHandleEscapeSequences (boolean bHandleEscapeSequences)
 Sets a flag indicating whether escape sequences like \n or \x40 should be translated by TFORMer.
void setReuseValues (boolean bReuseValues)
 Sets a flag indicating whether DataField values should be reused in consecutive Records.
void setXsltFilename (String sXsltFilename)
 Sets the XSLT filename (optional).
void setXsltTfcFilename (String sXsltTfcFilename)
 Sets the XSLT TFC filename (optional).

Detailed Description

Provides access to JobDataXml (a XML file that serves as JobData for a Job).

Overview

The JobDataXml enables TFORMer SDK to use XML-files as JobData for printing a Job.The data in the specified XML file provides the values of the DataFields. The XML file must comply with the formats recognized by TFORMer (see below). An optional XSLT file may be used to transform the XML file handed to TFORMer into one of the supported XML file formats.The following XML formats can be used:

Generic XML Format (Variant 1)

  <Root>
    <Records>
      <Record>
        <V Name="DataFieldName1">Value</V>
        <V Name="DataFieldName2">Value</V>
        <V Name="DataFieldName3">Value</V>
      </Record>
      <Record>
        <V Name="DataFieldName1">Value</V>
        <V Name="DataFieldName2">Value</V>
        <V Name="DataFieldName3">Value</V>
      </Record>
      :
      Further Data Records
      :
    </Records>
  </Root>
Name Description
Root This is the root element. It encloses all other elements of the XML-file.
Records This element encloses all records.
Record This element represents one Record. Within a Record the single DataField-values are defined.
V Data-Element. This element defines the name and the value of the DataField.
DataFieldName Name of the DataField (must be unique within a Record).
Value The actual value of the DataField.


The elements can be named arbitrarily. This means the terms Root, Records and Record can be selected at will. Only the order of the element-nodes is decisive: TFORMer interprets the lowest level of the XML-file as name/value pairs for data-fields, superordinate nodes always correspond to records.

Generic XML Format (Variant 2)

Variant 2 is comparable to variant 1, but instead of using the syntax <V Name="DataFieldName">Value</V> you can specify DataField-values using the following syntax:

  <Root>
    <Records>
      <Record>
        <DataFieldName1>Value</DataFieldName1>
        <DataFieldName2>Value</DataFieldName2>
        <DataFieldName3>Value</DataFieldName3>
      </Record>
      <Record>
        <DataFieldName1>Value</DataFieldName1>
        <DataFieldName2>Value</DataFieldName2>
        <DataFieldName3>Value</DataFieldName3>
      </Record>
      :
      Further Data Records
      :
    </Records>
  </Root>

XML Files Exported by Microsoft® Access

  <?xml version="1.0" encoding="UTF-8"?>
  <dataroot xmlns:od="urn:schemas-microsoft-com:officedata">
    <tblTableName>
      <DataFieldName1>Value</DataFieldName1>
      <DataFieldName2>Value</DataFieldName2>
      <DataFieldName3>Value</DataFieldName3>
    </tblTableName>
    <tblTableName>
      <DataFieldName1>Value</DataFieldName1>
      <DataFieldName2>Value</DataFieldName2>
      <DataFieldName3>Value</DataFieldName3>
    </tblTableName>
    :
    Further Data Records
    :
  </dataroot>

Internal XML Format

TFORMer Designer uses this format to store DataField name/value pairs.

  <PSData>
    <Form>
      <Records>
        <Record Copies="1">
          <V Name="DataFieldName1">Value</V>
          <V Name="DataFieldName2">Value</V>
          <V Name="DataFieldName3">Value</V>
        </Record>
        <Record Copies="1">
          <V Name="DataFieldName1">Value</V>
          <V Name="DataFieldName2">Value</V>
          <V Name="DataFieldName3">Value</V>
        </Record>
      </Records>
    <ImportedVariables/>
    </Form>
  </PSData>
Name Description
PSData This is the root element. It encloses all other elements within the XML-file.
Form This element encloses all records for one FormLayout. It must be specified only once.
Records This element encloses all records to be printed. It must be specified only once.
Record This element encloses all data-fields for one Record. For each Record there is one (optional) attribute named Copies. If this attribute is missing it defaults to 1 – meaning that this Record is used once. If you want to use the same data for multiple records you can specify the number of copies using this attribute.
V Data-Element. This element consists of the DataField-name (attribute name) and the value.
DataFieldName Name of the DataField (must be unique within a Record).
Value The actual value of the DataField.
ImportedVariables Used internally by TFORMer.

Example

Assume a suitable XML-file is available. The corresponding call to create the JobData and to assign it to a Job is as follows:
  // Create a new JobData instance. 
  // Here we import a XML file (must comply with the supported XML schemes)
  JobDataXml jobData = new JobDataXml("path/data.xml");

  // Assign the JobData to the Job
  printJob.setJobData(jobData); 

More Information

For a general description see JobData.

See also:
JobData
Note:
Thread-safety: A single instance of this class must not be used by different threads.

Constructor & Destructor Documentation

Constructor for JobDataXml.

Initializes a new instance of the JobDataXml class.

See also:
JobDataXml
JobDataXml ( String  filename)

Constructor for JobDataXml.

Initializes a new instance of the JobDataXml class.

Parameters:
filenameThe name of the XML input file
See also:
JobDataXml, Passing Files

Member Function Documentation

String getFilename ( )

Gets the name of the XML input file.

Returns:
The name of the XML input file
String getXsltFilename ( )

Gets the XSLT filename (optional).

Returns:
The XSLT filename, null if not used
String getXsltTfcFilename ( )

Gets the XSLT TFC filename (optional).

Returns:
The XSLT TFC filename, null if not used
boolean isHandleEscapeSequences ( ) [inherited]

Gets/Sets a flag indicating whether escape sequences in DataField values like \n or \x40 should be translated by TFORMer SDK.

Returns:
true if escape sequences in DataField values are translated
See also:
JobData, Escape Sequences
boolean isReuseValues ( ) [inherited]

Gets a flag indicating whether DataField-values should be reused in consecutive records.

Returns:
false if DataField-values are cleared between records
See also:
JobData
void setFilename ( String  sFilename)

Sets the name of the XML input file.

Parameters:
sFilenameThe name of the XML input file
See also:
JobDataXml, Passing Files
void setHandleEscapeSequences ( boolean  bHandleEscapeSequences) [inherited]

Sets a flag indicating whether escape sequences like \n or \x40 should be translated by TFORMer.

Parameters:
bHandleEscapeSequencestrue if escape sequences in DataField-values should be translated
See also:
JobData, Escape Sequences
void setReuseValues ( boolean  bReuseValues) [inherited]

Sets a flag indicating whether DataField values should be reused in consecutive Records.

Parameters:
bReuseValuesfalse if DataField-values should be cleared between Records
See also:
JobData, DataField
void setXsltFilename ( String  sXsltFilename)

Sets the XSLT filename (optional).

Remarks:
If specified, this XSLT file is used to transform the XML file handed to TFORMer SDK into one of the supported XML file formats (see JobDataXml).
Parameters:
sXsltFilenameThe XSLT filename (optional)
See also:
Passing Files
void setXsltTfcFilename ( String  sXsltTfcFilename)

Sets the XSLT TFC filename (optional).

Remarks:
A TFC file (TFORMer Command File) may be used to modify an existing FormLayout based on current input data.
Attention:
Internal usage only, the current implementation should not be used!
See also:
Passing Files
Parameters:
sXsltTfcFilenameThe XSLT TFC filename, null if not used

© 2006-2012 - all rights reserved by TEC-IT Datenverarbeitung GmbH
Generated on Tue Oct 23 2012 16:33:20 for TFORMer SDK - JAVA with doxygen 1.8.0