Using Forms Merge Scripts - Lexmark C792 Manual

Developing workflow solutions
<!-- Buttons in page 2 (page 2 starts after specifying all
5 buttons on the first page) -->
<!-- Place a profile button in position 5, using empty
buttons for the first 4 -->
<button/>
<button/>
<button/>
<button/>
<button>
<action>Single Profile</action>
<profileName>TestMFP</profileName>
<displayText>Test MFP</displayText>
<displayIcon>images\\testmfp_up.gif</displayIcon>
</button>
</buttons>
</welcomescreen>
An example file for the home screen on each device class can be found in the \src\solution\welcomescreen folder of
the TestMFP example template.

Using forms merge scripts

You can use forms merge scripts to perform advanced management of forms merge operations or modify forms merge
data and output documents. Using a forms merge script, you can:
•
Send merged documents to multiple destinations, including e‑mail messages, printers, network shares, FTP
locations, or destinations provided by custom components included with the solution.
• Retrieve and modify input data.
•
Create and insert new data pages.
•
Retrieve the number and description of the port used to submit the job.
•
Retrieve the name of the formset associated with the job.
•
Retrieve global solution settings.
•
Start another merge within the current merge.
The following scripting elements are unique to forms merge scripts:
•
mergeContext top‑level object—This provides fields and methods for forms merge jobs.
• DataPage object—This is a page of input data.
The script file TestMergeScript.js in the TestMergeScript example template is an example of a forms merge script.
Scripting for different stages of a forms merge
Forms merge scripts use callbacks to define functions that are activated at various stages of a forms merge job. The
main() function in the script contains any actions executed when the job is first submitted, as well as assignments of
callback functions. You only need to define and assign callback functions for the stages where scripted actions are
necessary.
29