[Index]
To access the latest documentation, go to Documentation and Resources at: https://voss.portalshape.com
Administrators with access to the Dropdown Filters menu can manage the items available in dropdown lists on input forms. A filter would typically be used to define a shorter dropdown list.
Filters can be added, removed, modified and two existing filters can also be merged to define a new filter.
The Dropdown Filter list macro name that is generated starts with DDF__ and is of the format (dots and slashes replaced by underscores):
DDF__<target model type> _<target model name>_<target field>
This is also the name shown in the Dropdown Filters list view at the hierarchy at which is was created.
Add a Dropdown Filter
Navigate to the required hierarchy.
Select the Dropdown Filters menu and click Add.
Choose Create a Dropdown Filter From the Select a Dropdown Filter Action dropdown list.
Choose the Target Model and Target Field names to which the filter is to be applied.
This is the dropdown field on an input form on the Admin Portal. Click Help on the input form to see the names.
Identify the associated Model Type and Dropdown Field of the Dropdown Filter specifications.
This can differ from the form names. Click Help on the input form to verify.
Set up the Filter Fields. Compare a Filter Field to a Filter Field Value:
Note that:
Add Additional Parameters to the filter:
For details and examples, refer to the topics on macro syntax in the Advanced Configuration Guide.
Click Save. A dropdown filter is created.
This filter is a named list macro that will be added to the GUI Rule which is in place at the selected hierarchy for the Target Field on the Admin Portal input form of the selected Target Model Name.
When a created dropdown filter is opened, the macro is shown in the Macro field at the bottom of the form. Users who have menu access to the list of named macros can also see the dropdown filter macros by filtering the list by name starting with DDF__.
Example of a Dropdown Filter
Consider the filter:
The list macro that is created applies to the GUI rule for the input field callForwardAll.callingSearchSpaceName of the input form for relation/LineRelation at the selected hierarchy. The list macro would then be:
{# device/cucm/Css | name /Cu2/i | direction: up #}
If you have access to the Macro Evaluator, you can test this macro. Also refer to the topic on Macro Syntax in the Advanced Configuration Guide for more details.
In the Dropdown Filters list view at the hierarchy, the Filter Name shows as:
DDF__relation_LineRelationTarget_callForwardAll_callingSearchSpaceName
Merged Dropdown Filters
Two existing dropdown filters can be merged to create a new dropdown filter. The merged filter is a dropdown list that uniquely combines the lists from the two dropdown filters.
Merge Dropdown Filters
Navigate to the required hierarchy.
Select the Dropdown Filters menu.
Check that the two dropdown filters that you want to merge are showing in the list view at the hierarchy. Otherwise, add the dropdown filters.
Choose Merge Existing Dropdown Filters from the Select a Dropdown Filter Action dropdown list.
Choose the Target Model and Target Field names to which the filter is to be applied.
Choose the two dropdown filters from the Dropdown Filters to merge form.
Click Save. A merged dropdown filter is created.
Note
Only two filters can be merged.
If you wish to merge more than two dropdown filters, first create a merged filter of each filter pair and select it to be merged.
When a created merged dropdown filter is opened, the macro is shown in the Macro field at the bottom of the form. The macro uses the fn.list_extend_no_dup macro function to uniquely merge the two dropdown filter lists. The macro syntax is of the format
{{ fn.list_extend_no_dup macro.DDF__<filter name 1>, macro.DDF__<filter name 2> }}
Refer to the topic on Macro Syntax and List Functions in the Advanced Configuration Guide for more details.
This relation implements the workflows to manage Spark Users.
Title | Description | Details | |||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Dropdown Filter Form | Group Assigned by FDP |
|
|||||||||||||||||||||||||||||||||||||||||||||||
Filter Name | The name of the dropdown filter to be created (Prefix: DD__ + target model + target field). |
|
|||||||||||||||||||||||||||||||||||||||||||||||
Select a Dropdown Filter action: | The Dropdown Filter action to perform. |
|
|||||||||||||||||||||||||||||||||||||||||||||||
Target Model Name * | The target fields's model to apply dropdown choices field to. |
|
|||||||||||||||||||||||||||||||||||||||||||||||
Target Field * | The target field to apply dropdown choices to. |
|
|||||||||||||||||||||||||||||||||||||||||||||||
Dropdown Filters to merge | Merge multiple Dropdown filters |
|
|||||||||||||||||||||||||||||||||||||||||||||||
Dropdown Filter | Dropdown Filter to merge. |
|
|||||||||||||||||||||||||||||||||||||||||||||||
Dropdown Filter specifications | Create a Dropdown filter. |
|
|||||||||||||||||||||||||||||||||||||||||||||||
Model Type | Model Type to be selected for Dropdown choice selection. |
|
|||||||||||||||||||||||||||||||||||||||||||||||
Dropdown Field | The field to display in the dropdown. |
|
|||||||||||||||||||||||||||||||||||||||||||||||
Filter Fields |
|
||||||||||||||||||||||||||||||||||||||||||||||||
Filter Field | The field to filter dropdown choices on. |
|
|||||||||||||||||||||||||||||||||||||||||||||||
Filter Condition | The condition to match field values on. Default: Contains |
|
|||||||||||||||||||||||||||||||||||||||||||||||
Filter Field Value |
|
||||||||||||||||||||||||||||||||||||||||||||||||
Additional Parameters |
|
||||||||||||||||||||||||||||||||||||||||||||||||
Parameter Title | Parameter Title. |
|
|||||||||||||||||||||||||||||||||||||||||||||||
Parameter Value | Parameter Value. |
|
|||||||||||||||||||||||||||||||||||||||||||||||
Macro * | The Macro content written in the syntax of the Macro language. |
|
|||||||||||||||||||||||||||||||||||||||||||||||
Ddf Macro |
|
||||||||||||||||||||||||||||||||||||||||||||||||
Macro * | The Macro content written in the syntax of the Macro language. |
|