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.

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

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

The dialog box consists of the data entry form parameter list and property setup panel.

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 typing 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, select the element in the drop-down list, and start typing element name in the search string. If a parameter is selected as an alternative hierarchy source, the checkbox is disabled.
Selection Schemas. Select selection schema to automate element selection by specified parameters in the drop-down list. To do this, select the schema in the drop-down list. If the dictionary has no selection schemas or alternative hierarchy is set, selection schema cannot be selected.
Group of Elements. Determine a group of elements to limit the list of available elements. If the dictionary does not have groups of elements or alternative hierarchy is set, group of elements cannot be selected.
Alternative Hierarchy. Select alternative hierarchy to display elements of alternative dictionary, instead of the elements of the dictionary that is used to build a parameter or set up dynamic selection of alternative hierarchy depending on the attribute of other parameter. Depending on the alternative hierarchy type, set:

NOTE. Alternative hierarchy can be set if selection schema is not set for a dictionary.

If the None type is selected. The main hierarchy is displayed. The specified type is used by default.
If the Fixed type is selected, the alternative hierarchy source is a dictionary. Select a dictionary in the drop-down list or click the search button and start typing the dictionary name. Only one dictionary can be selected.

If the Dynamic type is selected, the alternative hierarchy source is parameter. Select a parameter attribute of data entry form in the drop-down list or click the search button and start typing the parameter name. When this option is selected, the Selection Schema and Group of Elements options are unavailable.

If the attribute that was set as an alternative hierarchy key for parameter was deleted, the parameter value in data entry form control will be empty. Set another parameter attribute as alternative hierarchy key.

NOTE. If dictionary or parameter attribute is not selected as an alternative hierarchy data source, clicking the Apply button applies the main hierarchy.

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:

The advanced filter setting is available when there is no group of elements setting.

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.

If parameter attribute is set as alternative hierarchy for another parameter, then to delete the parameter used for alternative hierarchy, one should change the source type or alternative hierarchy source or should not use alternative hierarchy.

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.