Setting Completion Rules for Individual Screens
Completion rules determine when the host has completed updating the screen. When you customize a form at design time, default completion rules are automatically generated.
However, there may be situations when a default rule needs to be changed (for example, the default completion rule causes the application to appear slow, or the form appears incomplete). You would use the Recognition Rule Editor - Completion Rule page to optimize the performance of your application.
||The settings you make from the Screen Recognition Rule Editor - Completion Rule page affect only the currently selected host screen. To set the default completion rules for an entire application, you would specify them from the Host Settings dialog box. (For additional information about customizing completion rules on a global basis, see Setting Default Completion Rules for an Application.)
|To set the completion rule for an individual screen
- Open Presentation Designer.
- Open the project based on an active host session that you want modify.
- From the Editor pane, select the Customize tab.
- In the Project pane, on the Forms page, right-click the name of the host screen for which you want to modify the completion rule, then select Screen Recognition Rule.
The Screen Recognition Rule editor appears.
- Select the Completion Rule tab.
- From Select Rule Type, select the completion rule type that you want to apply to this form.
||Use the completion rule defined in the host settings to determine screen completion for this host screen.
||Determine a fully downloaded screen by monitoring the absence of transmissions from the host for a specific time interval (that you indicate) in milliseconds.
For a specific host screen that always takes longer to download than other screens in your application, the Default time-out setting might be too short. This rule type allows you to set a longer wait-time that applies only to the currently selected screen.
||Use the screen recognition rule to determine the completion of the screen. If the expected screen recognition rule never evaluates as true, the associated Max Quiet Time (that you specify) sets a maximum length of time the application will wait before timing out.
- You must first have captured a screen before you can create the recognition rule. Once you have done so, you can configure and use the recognition completion rule.
- A performance penalty may result unless the recognition completion rule is properly configured.
- If you selected the Host Quiet rule type, in the Quiet Time box, adjust the length of time to wait, in milliseconds, before determining the completion of a screen. (The default is 1500 milliseconds.)
If you selected the Recognition rule type, in the Max Quiet Time box, type the length of time to wait, in milliseconds, for successful evaluation of the screen recognition rule. (The default is 5000 milliseconds.)
- Choose the OK button to save your changes.
The Screen Recognition Rule editor closes.