Assigning property values

Property assignments assign specific values to properties under certain events and conditions. Property assignments are useful in numerous situations including:

• Setting default values for new documents
• Calculating a property value based upon the values of other properties
• Recalculating one value when the value of another property changes

To assign property values:

1. In Configurator, expand Property Sets in the configuration tree to display the existing property sets.
2. Expand the property set that contains the property for which you want to configure assignments. The names of the properties currently in the selected property set appear.

3. Select the desired property in the configuration tree. The property’s property pages appear in the right pane.

   Note    The Enable for scripting option must be selected and VBScript name must be complete for the Validation and Assignment pages to be active.

4. Click the Assignment tab. The property’s existing assignments appear.
5. Click the Edit button to edit the property.
6. If you want to modify an existing assignment, select it in the list of assignments. The assignment’s settings appear at the bottom of the page.
7. If you want to create a new assignment, click the Add button to add a new assignment to the list of property assignments.

8. Select an event from the When column using the descriptions in the following table.

   Tip    Property change events occur in the order listed in the previous table. If multiple assignments are configured for a property, depending on the options selected for Condition and Assignment, you may want to arrange them in step 12 to be applied in the same order.

Property assignment events

When	Description
Page enters edit mode	When a user clicks the Edit button to edit the page.
Property is changed	When a user manually changes the value of the property selected from Field. When this option is selected, a Field list is visible for property selection. Note    The property that is changed must be on the same page as this property. If you want to change this property based upon changes to a property on a different page, use Page is applied or Page is refreshed.
Page is applied	When a users clicks the Apply or OK button after editing a page.
Page is refreshed	When a user selects Refresh on the View menu or presses F5.

9. Select a criterion from Condition using the descriptions in the following table.

Property assignment conditions

Condition	Description
Unconditionally	Always when the event selected for When occurs.
If property is empty	Only if the selected property is empty when the event selected for When occurs. When this option is selected, a Field list is visible for property selection.
If property is not empty	Only if the property is not empty when the event selected for When occurs. When this option is selected, a Field list is visible for property selection.
If new document	Only if the document is being created or imported by a user. When this option is selected, a list of actions that create a new document is visible for action selection.
If expression is true	Click the Meridian Enterprise Script Editor button  to build a VBScript expression that will be evaluated to determine when a value will be assigned. For information on using VBScript for configuration expressions including their limitations, see the BlueCielo Meridian Enterprise VBScript API Reference.

10. Select a value from Assignment using the descriptions in the following table.

Property value options

Assignment	Description
Literal value	Set the property to an explicit value. When this option is selected, a Value input box is visible for value entry.
Value of another property	Set the value of this property to the value of another property. When this option is selected, a Field list is visible for property selection.
Expression	Click the Meridian Enterprise Script Editor button  to build a VBScript expression that will be evaluated to calculate the value to assign to the property.
Clear value	Empty the property of whatever value it contains.

11. Repeat steps 6 through 10 for each property that you want to configure.
12. To change the order in which assignments are applied to the property, click the Move Up  and Move Down  buttons to arrange the assignments.
13. Click OK to save your changes.