Back Forward Harness forms
How to support work object printing

About Harness rules

 zzz Show all 

Follow these steps to support complete or custom printing of work objects in your application, including information about attachments and history.

In the Process Work workspace, the Print toolbar button (Print) starts Internet Explorer printing, which prints the current work object form as displayed. This printout may not include desired fields and may use colors, fonts, and labels that are not desired in hard copy prints.

Follow these steps to allow application users to print work objects.

 zzz Add the iconPrint icon to the harness

You can offer work object printing through a labeled button at the bottom of the work object form or through an icon on the header. Development steps are similar. (These instructions assume the harness rule is in the newer SmartFrames format.)

When creating a custom harness rule for printing, select the standard PrintView harness in the Template field of the New dialog box, so that the generated HTML includes JavaScript references to harness_print.js in your copy.

1. To add an icon, click the down arrow (Menu) in the Basic control group (Basics) and select the Icon control (Button). Drag the icon control to the top-right array of icons and drop it into position. To add a button, To add an icon, select the Button control (Button). Drag the button control to the bottom area of the wireframe harness or to a cell and drop it into position. Complete the panel that appears.

2. Select CUSTOM as the Type.

3. Select an icon or enter text for a button label. The recommended icon is named iconPrint(Print).

4. Select PrintWork for the Do Action field as the activity to execute when the icon or button is clicked.

5. To use the standard harness named Work-.PrintView, or a harness in your application named PrintView that overrides this standard harness, leave the first parameter blank. If you have created custom harness rules, enter the Purpose key part of a harness rule that supports printing as the first parameter.

6. Select the Prompt parameter box if you want users to select which top-level sections to print. (When selected, by default the dialog box is defined by the standard harness named Work-.PrintOptions.)

7. Choose in a pop-up window as the presentation.

8. Complete the ToolTip text and other fields in the panel as desired. See Icons — Placing an icon in a layout cell.

9. Save the harness rule.

 zzz Advanced cases

If you selected the Prompt parameter, the standard activity Work-.Print presents the harness named PrintOptions (or another if specified) to the user. The standard Work-.PrintOptions harness lets users select which of four top-level sections are to be printed; this information is then conveyed to the Work-.PrintView harness.

You can override the activity and these two harness rules in your application, to control which top-level choices are presented, the layout and format of the print version of the work object, and other processing.

zzz About Harness rules