com.adobe.icc.ddg.api

Interface LetterRenderService

Deprecated.

@Deprecated
public interface LetterRenderService

Dynamic Document Generation a.k.a Letter Rendering Service that accepts a Letter definition and an initial data XML to render a Letter as a PDF, either interactive or non-interactive.

Field Summary

Fields

Modifier and Type	Field and Description
static String	LAYOUT_TEMPLATE_KEY Deprecated. Return value of processLetter API contains processed template against this key.
static String	XML_DATA_KEY Deprecated. Return value of processLetter API contains processed data xml against this key.

Method Summary

Modifier and Type	Method and Description
Map<String,Object>	processLetter(Letter letter, String initialDataXML, boolean useTestData) Deprecated.
Map<String,Object>	processLetter(Letter letter, String initialDataXML, LetterRenderOptionsSpec letterRenderOptionsSpec) Deprecated.
Map<String,Object>	processLetter(String letterId, String initialDataXML, boolean useTestData) Deprecated.
Map<String,Object>	processLetter(String letterId, String initialDataXML, LetterRenderOptionsSpec letterRenderOptionsSpec) Deprecated.
byte[]	renderLetter(Letter letter, String dataXML, boolean renderInteractive) Deprecated.
com.adobe.icc.render.obj.PDFResponseType	renderLetter(Letter letter, String initialDataXML, boolean mergeDataOnServer, boolean useTestData, boolean renderInteractive) Deprecated.
com.adobe.icc.render.obj.PDFResponseType	renderLetter(Letter letter, String initialDataXML, boolean mergeDataOnServer, boolean useTestData, boolean renderInteractive, boolean saveToFile) Deprecated.
com.adobe.icc.render.obj.PDFResponseType	renderLetter(Letter letter, String initialDataXML, LetterRenderOptionsSpec letterRenderOptionsSpec) Deprecated.
byte[]	renderLetter(String letterId, String dataXML, boolean renderInteractive) Deprecated.
com.adobe.icc.render.obj.PDFResponseType	renderLetter(String letterId, String initialDataXML, boolean mergeDataOnServer, boolean useTestData, boolean renderInteractive) Deprecated.
com.adobe.icc.render.obj.PDFResponseType	renderLetter(String letterId, String initialDataXML, boolean mergeDataOnServer, boolean useTestData, boolean renderInteractive, boolean saveToFile) Deprecated.
com.adobe.icc.render.obj.PDFResponseType	renderLetter(String letterId, String initialDataXML, LetterRenderOptionsSpec letterRenderOptionsSpec) Deprecated.
String	serializeDataElementsToXML(String ddiAsXml, Map<String,Object> phValues, Map<String,Object> fieldValues) Deprecated.

Field Detail

LAYOUT_TEMPLATE_KEY

static final String LAYOUT_TEMPLATE_KEY

Deprecated.

Return value of processLetter API contains processed template against this key.

See Also:

Constant Field Values

XML_DATA_KEY

static final String XML_DATA_KEY

Deprecated.

Return value of processLetter API contains processed data xml against this key.

See Also:

Constant Field Values

Method Detail

renderLetter

@Deprecated
com.adobe.icc.render.obj.PDFResponseType renderLetter(String letterId,
                                                                  String initialDataXML,
                                                                  LetterRenderOptionsSpec letterRenderOptionsSpec)
                                                           throws ICCException

Deprecated.

Render the CTD against the given data XML. If there is a need to simply render the Letter without merging data with it, *mergeData* should be set to false.

Parameters:

letterId - ID of the Letter/CT to be rendered.

initialDataXML - XML data to be merged with the Layout template.

letterRenderOptionsSpec - specifies options to render letter.

Returns:

PDFResponseType that contains the PDFFile object

Throws:

Exception

ICCException

renderLetter

@Deprecated
com.adobe.icc.render.obj.PDFResponseType renderLetter(Letter letter,
                                                                  String initialDataXML,
                                                                  LetterRenderOptionsSpec letterRenderOptionsSpec)
                                                           throws ICCException

Deprecated.

Render the CTD against the given data XML. If there is a need to simply render the Letter without merging data with it, *mergeData* should be set to false.

Parameters:

letter - Correspondence Template to be rendered -- must be the *full* letter object containing all necessary data and assignments.

initialDataXML - XML data to be merged with the Layout template.

letterRenderOptionsSpec - specifies options to render letter.

Returns:

PDFResponseType that contains the PDFFile object

Throws:

Exception

ICCException

renderLetter

@Deprecated
com.adobe.icc.render.obj.PDFResponseType renderLetter(Letter letter,
                                                                  String initialDataXML,
                                                                  boolean mergeDataOnServer,
                                                                  boolean useTestData,
                                                                  boolean renderInteractive)
                                                           throws ICCException

Deprecated.

Render the CTD against the given data XML. If there is a need to simply render the Letter without merging data with it, *mergeData* should be set to false.

Parameters:

letter - Correspondence Template to be rendered -- must be the *full* letter object containing all necessary data and assignments.

initialDataXML - XML data to be merged with the Layout template

mergeDataOnServer - False if we only need to render the Letter, without merging data with it. If False, the letter is also augmented with the FormBridge library for use in an interactive filling environment. True if data needs to be merged (in which case the FormBridge library is not included). If true, the PDF bytes are returned; if false, the bytes are not returned and the PDF is saved to a temporary location that so that it can be loaded from the client using a URL to the file name in the PDFResponseType.

useTestData - specify whether to use test data for rendering or not

renderInteractive - specify whether to render an interactive or flat PDF

Returns:

PDFResponseType that contains the PDFFile object

Throws:

Exception

ICCException

renderLetter

@Deprecated
com.adobe.icc.render.obj.PDFResponseType renderLetter(String letterId,
                                                                  String initialDataXML,
                                                                  boolean mergeDataOnServer,
                                                                  boolean useTestData,
                                                                  boolean renderInteractive)
                                                           throws ICCException

Deprecated.

Render the CTD against the given data XML. If there is a need to simply render the Letter without merging data with it, *mergeData* should be set to false.

Parameters:

letterId - ID of the Letter/CT to be rendered

initialDataXML - XML data to be merged with the Layout template

mergeDataOnServer - False if we only need to render the Letter, without merging data with it. If False, the letter is also augmented with the FormBridge library for use in an interactive filling environment. True if data needs to be merged (in which case the FormBridge library is not included). If true, the PDF bytes are returned; if false, the bytes are not returned and the PDF is saved to a temporary location that so that it can be loaded from the client using a URL to the file name in the PDFResponseType.

useTestData - specify whether to use test data for rendering or not

renderInteractive - specify whether to render an interactive or flat PDF

Returns:

PDFResponseType that contains the PDFFile object

Throws:

Exception

ICCException

renderLetter

@Deprecated
com.adobe.icc.render.obj.PDFResponseType renderLetter(Letter letter,
                                                                  String initialDataXML,
                                                                  boolean mergeDataOnServer,
                                                                  boolean useTestData,
                                                                  boolean renderInteractive,
                                                                  boolean saveToFile)
                                                           throws ICCException

Deprecated.

Render the CTD against the given data XML.

Parameters:

letter - Correspondence Template to be rendered -- must be the *full* letter object containing all necessary data and assignments.

initialDataXML - XML data to be merged with the Layout template

mergeDataOnServer - False if we only need to render the Letter, without merging data with it. If False, the letter is also augmented with the FormBridge library for use in an interactive filling environment. True if data needs to be merged (in which case the FormBridge library is not included).

useTestData - specify whether to use test data for rendering or not

renderInteractive - specify whether to render an interactive or flat PDF

saveToFile - true to have the PDF saved to a temporary file for retrieval via URL from the client; false to have the PDF bytes returned in the PDFResponseType response.

Returns:

PDFResponseType that contains the PDFFile object

Throws:

Exception

ICCException

renderLetter

@Deprecated
com.adobe.icc.render.obj.PDFResponseType renderLetter(String letterId,
                                                                  String initialDataXML,
                                                                  boolean mergeDataOnServer,
                                                                  boolean useTestData,
                                                                  boolean renderInteractive,
                                                                  boolean saveToFile)
                                                           throws ICCException

Deprecated.

Render the CTD against the given data XML.

Parameters:

letterId - ID of the Letter/CT to be rendered

initialDataXML - XML data to be merged with the Layout template

mergeDataOnServer - False if we only need to render the Letter, without merging data with it. If False, the letter is also augmented with the FormBridge library for use in an interactive filling environment. True if data needs to be merged (in which case the FormBridge library is not included).

useTestData - specify whether to use test data for rendering or not

renderInteractive - specify whether to render an interactive or flat PDF

saveToFile - true to have the PDF saved to a temporary file for retrieval via URL from the client; false to have the PDF bytes returned in the PDFResponseType response.

Returns:

PDFResponseType that contains the PDFFile object

Throws:

Exception

ICCException

renderLetter

@Deprecated
byte[] renderLetter(String letterId,
                                String dataXML,
                                boolean renderInteractive)
                         throws ICCException

Deprecated.

Render the given Letter, identified by the letter ID, against the given data XML. This would return a flat PDF file, with data populated per the data XML provided. Note 1: The data XML in such cases is a must. Note 2: This API is not intended to be called from an ActionScript client due to the byte[] return type. ActionScript clients should use the alternate APIs which can save the PDF to a temporary file so that the client can access it via a URL.

Parameters:

letterId - ID of the Letter/CT for which the PDF has to be generated

dataXML - XML data to be merged with the Layout template

renderInteractive - specify whether to render an interactive or flat PDF

Returns:

flattened PDF bytes

Throws:

Exception

ICCException

renderLetter

@Deprecated
byte[] renderLetter(Letter letter,
                                String dataXML,
                                boolean renderInteractive)
                         throws ICCException

Deprecated.

Render the given Letter object against the given data XML. This would return a flat PDF file, with data populated per the data XML provided. Note 1: The data XML in such cases is a must. Note 2: This API is not intended to be called from an ActionScript client due to the byte[] return type. ActionScript clients should use the alternate APIs which can save the PDF to a temporary file so that the client can access it via a URL.

Parameters:

letter - The Letter object for which the PDF has to be generated

dataXML - XML data to be merged with the Layout template

renderInteractive - specify whether to render an interactive or flat PDF

Returns:

flattened PDF bytes

Throws:

Exception

ICCException

serializeDataElementsToXML

@Deprecated
String serializeDataElementsToXML(String ddiAsXml,
                                              Map<String,Object> phValues,
                                              Map<String,Object> fieldValues)
                                       throws ICCException

Deprecated.

Serialize data elements into XML by appending Fields/Variables elements to the input xml.

Parameters:

ddiAsXml - Serialize XML input data for DDI to be used

phValues - is map having PH values with key as place holder variable name

fieldValues - is map having Field values with key as somExpr of the Field

Returns:

String representing XML having data element as provided into dataElementValues

Throws:

ICCException

processLetter

@Deprecated
Map<String,Object> processLetter(Letter letter,
                                             String initialDataXML,
                                             boolean useTestData)
                                      throws ICCException

Deprecated.

Process the given Letter object, preparing the augmented layout template and final XML data that can be merged together in the desired render format.

Parameters:

letter - The Letter object which is to be processed.

initialDataXML - Initial XML data that is used to initialize the associated Data Dictionary (if any), and also augmented and merged with the Letter's layout template.

useTestData - specify whether to use the Letter's test data as initial XML data or not.

Returns:

A result Map that contains the augmented layout template and the final XML data.

The Layout template can be fetched by the key 'layoutTemplate', with the value being a byte array (byte[]).
The XML data can be fetched by the key 'xmlData', with the value being a byte array (byte[]).

Throws:

ICCException

processLetter

@Deprecated
Map<String,Object> processLetter(String letterId,
                                             String initialDataXML,
                                             boolean useTestData)
                                      throws ICCException

Deprecated.

Process the Letter identified by the given Letter ID, preparing the augmented layout template and final XML data that can be merged together in the desired render format.

Parameters:

letterId - ID of the Letter which is to be processed.

initialDataXML - Initial XML data that is used to initialize the associated Data Dictionary (if any), and also augmented and merged with the Letter's layout template.

useTestData - specify whether to use the Letter's test data as initial XML data or not.

Returns:

A result Map that contains the augmented layout template and the final XML data.

The Layout template can be fetched by the key 'layoutTemplate', with the value being a byte array (byte[]).
The XML data can be fetched by the key 'xmlData', with the value being a byte array (byte[]).

Throws:

ICCException

processLetter

@Deprecated
Map<String,Object> processLetter(String letterId,
                                             String initialDataXML,
                                             LetterRenderOptionsSpec letterRenderOptionsSpec)
                                      throws ICCException

Deprecated.

Process the Letter identified by the given Letter ID, preparing the augmented layout template and final XML data that can be merged together in the desired render format.

Parameters:

letterId - ID of the Letter which is to be processed.

initialDataXML - Initial XML data that is used to initialize the associated Data Dictionary (if any), and also augmented and merged with the Letter's layout template.

letterRenderOptionsSpec - specifies options to process letter.

Returns:

A result Map that contains the augmented layout template and the final XML data.

The Layout template can be fetched by the key 'layoutTemplate', with the value being a byte array (byte[]).
The XML data can be fetched by the key 'xmlData', with the value being a byte array (byte[]).

Throws:

ICCException

processLetter

@Deprecated
Map<String,Object> processLetter(Letter letter,
                                             String initialDataXML,
                                             LetterRenderOptionsSpec letterRenderOptionsSpec)
                                      throws ICCException

Deprecated.

Process the Letter identified by the given Letter ID, preparing the augmented layout template and final XML data that can be merged together in the desired render format.

Parameters:

letter - The Letter object which is to be processed.

initialDataXML - Initial XML data that is used to initialize the associated Data Dictionary (if any), and also augmented and merged with the Letter's layout template.

letterRenderOptionsSpec - specifies options to process letter.

Returns:

A result Map that contains the augmented layout template and the final XML data.

The Layout template can be fetched by the key 'layoutTemplate', with the value being a byte array (byte[]).
The XML data can be fetched by the key 'xmlData', with the value being a byte array (byte[]).

Throws:

ICCException