Working with User Assigned Properties

In the Report Template Editor, the Properties dialog box contains the ability to make a property user definable. This allows you to let measurement routine operators change object properties at runtime.

For example, suppose you want your report title to change dynamically according to whatever the current measurement routine operator wants. You can add an interactive approach such as this to your reports by using this functionality.

To Make a Property User Assigned

  1. Select an object in one of the editors. For the example above, you would select a Text object.

  2. Right-click on the object. This causes the property sheet for that object to appear on the right side of the editor. On the left side of the property sheet, you will see check boxes next to most properties. These check boxes determine what properties you can make user definable.

  3. Select the check box next to the property that you want to make definable. For the example above, you would select the Text property for a Text object. A User Assigned Property dialog box appears, asking you to determine the message that will prompt the user for the property value and when the user should be prompted.

  4. In the Prompt box, type the prompt the user will receive, and then select from one of the two option buttons when the user will receive the prompt. You can choose to prompt the user either during template selection or measurement routine execution.

  5. Click OK. The User Assigned Property dialog box closes.

  6. Save the report template and return to your measurement routine.

  7. To test this, use the Report window and click the Template Selection icon. Select the report template from the dialog box and then execute your measurement routine.

  8. At some time during the previous step, PC-DMIS will display the Define User Assigned Properties dialog box to prompt you for the properties' values according to the option button you selected in the User Assigned Property dialog box.

To View and Manipulate all Your User Assigned Properties

  1. Access a report or label template that has user definable properties.

  2. Select Edit | User Assignable Properties. The User Assigned Properties dialog box appears. This dialog box shows those properties that will be presented during template selection or measurement routine execution.

  3. Select an item from the Prompt Style drop-down list to filter what gets displayed in this dialog. The user assigned properties appear in the list box below. The list box tracks all the properties, what objects they belong to, and their prompts.

If you selected Prompt when user selects template from the User Assigned Property dialog box, PC-DMIS will only prompt you once for any user assigned values. Thereafter, for that measurement routine, PC-DMIS will automatically use the initial property value until you clear out all template associated data. See the "Clearing Template Associated Data" topic in this chapter.

If you selected Prompt when report is executed then PC-DMIS automatically displays the Define User Assigned Properties dialog box each time the measurement routine executes.