Setting Up Data Entry Form Parameters

The parameter is used to dynamically control data displayed in the data entry form. For example, the list of organizations is selected as a parameter for registry data entry form, on changing selection in the parameter, the working area of data entry form will display registry data corresponding to the required organization.

When adding a parameter, the control is automatically created on the sheets that were selected on determining parameter properties.

To set up data entry/output form parameters, click the

Parameter Editor button on the toolbar. The Parameter Editor dialog box opens:

To create a parameter:

Click the Add button in the Parameter Editor dialog box.
Click the Add Control button on the Controls panel. The Parameter Editor dialog box opens with a new automatically created parameter.

Set parameter properties using the properties panel of the Parameter Editor dialog box:

Name. Determine parameter name.
Dictionary. Determine a dictionary, to which the parameter will be linked. To do this, select the dictionary in the drop-down list or start entering dictionary name in the search string.
Dictionary Parameters. Set dictionary parameters control. To do this, click the Dictionary Parameters button. The Dictionary Parameters '<Dictionary Name>' dialog box opens:

NOTE. The Dictionary Parameters button is available only for parametrized dictionaries.

Determine settings:

Parameters. It contains all dictionary parameters. The column is read-only.
Value Type. Select parameter value creation option:

None. Default value. No value is sent to a parameter.
Value. A fixed value is sent to a parameter.
Parameter Attribute. Data entry form parameter attribute value is sent to a parameter.

Value. Set parameter value. The box appearance depends on the selected value type:

For the Value type. Specify in the box the specific value corresponding to dictionary attribute type.
For the Parameter Attribute type. Select in the drop-down list the available form parameter attribute.

NOTE. The Value box is available only for the Value and Parameter Attribute value types.

Data Entry/Output Form Sheets. Select in the drop-down list the sheets, which will display the parameter on the Controls panel.
Selection Type. Select in the drop-down list the element selection type:

Single with Mandatory Selection. Default value.
Single with Optional Selection.
Multiple.

Default Value. Determine value that will be displayed before the element is selected. To do this, select the checkbox and select the element in the drop-down list or start entering element name in the search string.

To limit available parameter values of form, set up links with another form parameters using advanced filter.

To open the advanced filter dialog box, click the Advanced Attribute button:

Determine advanced filter:

Attribute. Select an attribute of the specified dictionary in the drop-down list. To filter dictionary elements by linked dictionry attributes, select in the list of available linked attributes the attribute of the dictionary selected on link creation with attribute of the specified dictionary. Linked attributes are displayed at the first nested level and represent the tree of available linked attributes.

NOTE. If dictionary attribute contains multiple values, then on checking filtering condition all attribute values will be compared. If at least one attribute value meets the condition, the dictionary element will automatically meet the condition.

Condition. Set filtering condition. Available options: equal, not equal, greater, less, greater or equal, less or equal, included, not included.
Type. Select filter type. Available options: value, attribute.
Ignore Empty. Attribute empty values will be ignored if the checkbox is selected. It is available only for the Attribute type.
Value. It depends on the selected attribute and type:

If the Value type is selected, the specific value corresponding to the data type of attribute is specified in the field.
If the Attribute type is selected, select the attribute in the box using the drop-down list that looks like a tree of available attributes.
If the attribute is linked and the Value type is selected, the box has a pop-up menu with the linked dictionary available values.
If attribute is linked and the Attribute type is selected, the box has a pop-up menu with a tree of available attributes of linked dictionary.

Do Not Filter from Empty Values. Attribute values are not filtered if value is empty if the checkbox is selected.

Finish the selection by clicking the Apply button.

To edit a parameter:

Click the Parameter Editor button on the toolbar.
Select the Edit item in the control's context menu on the Controls panel.

After executing one of the operations the Parameter Editor dialog box opens, in which make necessary changes.

To delete the parameter:

Click the Delete button in the Parameter Editor dialog box.
Select the Delete item in the control's context menu on the Controls panel.

If parameter controls another parameter, remove dependency with controlled parameter to delete the controlling parameter.

Opening Data Entry Form with Parameters

On opening data entry form with parameters, the Determine Parameter Values dialog box opens:

The appearance of the parameter edit boxes depends on parameter type. If a default value has been determined for the parameter, the value is displayed in the corresponding box.

Enter or select (depending on parameter type) values for other parameters and click the Apply button.