ClientPrintCommand

Top  Previous  Next

ClientPrintCommand is used to generate a report document by executing a set of of processes on the server, to convert the generated document to PostScript and send it to the browser and without displaying the document on the browser area printing it directly to a local printer.

Important Note: A PrintProcess element must exists in the process list and its "Print To" property must be set to "2. Client Printer". Additionally a "Reporter > ClientPrint > ClientPrintIFrame" element must be placed into the page where this element is used.

The process list of this element typically includes

1. Either a JasperProcess or a FopProcess element that generates a report in PDF format

2. A PrintProcess element that prints the generated PDF file to a local printer.
Obviously the process list may also include other processes.

PrintCommand_pe

Properties

 

Process List

It includes the processes that generates the report document(s) and it must include 1 PrintProcess element to print the documents to a local printer.

 

Validate Input

Select "true" if you want that the input fields are validated before submitting the request. The validation is performed only for the fields that are located in the ProcessBlock where the selected Process Definition elements exist.

 

Confirmation Request Message

For some cases it is necessary to ask the user for confirmation before submitting the process form; for instance, before deleting a record. If a value is given into this property, it will be displayed to the user in the confirmation request dialog and the process form will be submitted only if the user confirms.

Access Control (Accepts MScript)

The processes in the process list are executed only if the current user has sufficient property. If no definition is made in this property then the "Access Control" property of the page is used. For more information please see "Basic Elements > Element "Page" > Property "Access Control""  topic.

Process Manager Debug Level (Accepts MScript)

To trace the steps of the Process Manager on the system console give a value to this property between 1 (less details) and 3 (more details). The debugging settings of processes are defined in the Process List dialog.

 

CallBack Function

The Javascript function to be called after the processes were executed on the server, the response received and the defined refresh handlers executed.

 

Example:

function CallMeAfterPrint(parms, printResult) {  
  if (printResult != "success") {
    alert("Print failed!" 
      + "\n Command Name  : " + parms.commandName
      + "\n Form Name     : " + parms.formName
      + "\n Callback Func : " + parms.callbackFunc );
  }
}