[Index]

Model: relation/DropDownFilter

Dropdown Filters

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

  1. Navigate to the required hierarchy.

  2. Select the Dropdown Filters menu and click Add.

  3. Choose Create a Dropdown Filter From the Select a Dropdown Filter Action dropdown list.

  4. 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 GUI. Click Help on the input form to see the names.

  5. 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.

  6. Set up the Filter Fields. Compare a Filter Field to a Filter Field Value:

    Note that:

  7. Add Additional Parameters to the filter:

    For details and examples, refer to the topics on macro syntax in the Advanced Configuration Guide.

  8. 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 GUI 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

  1. Navigate to the required hierarchy.

  2. 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.

  3. Choose Merge Existing Dropdown Filters from the Select a Dropdown Filter Action dropdown list.

  4. Choose the Target Model and Target Field names to which the filter is to be applied.

  5. Choose the two dropdown filters from the Dropdown Filters to merge form.

  6. 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.

Model Details

Title Description Details
Dropdown Filter Form Group Assigned by FDP
  • Field Name: Dropdown Filter Form
  • Type: Object
Filter Name The name of the dropdown filter to be created (Prefix: DD__ + target model + target field).
  • Field Name: Dropdown Filter Form.filter_name
  • Type: String
  • Format: string
Select a Dropdown Filter action: The Dropdown Filter action to perform.
  • Field Name: Dropdown Filter Form.ddf_action
  • Type: String
  • Choices: ["Create a Dropdown Filter", "Merge existing Dropdown Filters"]
Target Model Name * The target fields's model to apply dropdown choices field to.
  • Field Name: Dropdown Filter Form.target_model_type
  • Type: String
  • Format: uri
Target Field * The target field to apply dropdown choices to.
  • Field Name: Dropdown Filter Form.target_field
  • Type: String
  • Format: string
Dropdown Filters to merge Merge multiple Dropdown filters
  • Field Name: ddf_merge.[n]
  • Type: Array
  • Cardinality: [2..2]
Dropdown Filter Dropdown Filter to merge.
  • Field Name: Dropdown Filter Form.ddf_merge.[n].ddf
  • Type: String
Dropdown Filter specifications Create a Dropdown filter.
  • Field Name: ddf_create.[n]
  • Type: Array
  • Cardinality: [1..1]
Model Type Model Type to be selected for Dropdown choice selection.
  • Field Name: Dropdown Filter Form.ddf_create.[n].model_type
  • Type: String
  • Format: uri
Dropdown Field The field to display in the dropdown.
  • Field Name: Dropdown Filter Form.ddf_create.[n].dropdown_field
  • Type: String
Filter Fields
  • Field Name: filter_fields.[n]
  • Type: Array
Filter Field The field to filter dropdown choices on.
  • Field Name: Dropdown Filter Form.ddf_create.[n].filter_fields.[n].filter_field
  • Type: String
Filter Condition The condition to match field values on. Default: Contains
  • Field Name: Dropdown Filter Form.ddf_create.[n].filter_fields.[n].filter_field_condition
  • Type: String
  • Default: Contains
  • Choices: ["Contains", "Does Not Contain", "Equals", "Does Not Equal"]
Filter Field Value
  • Field Name: Dropdown Filter Form.ddf_create.[n].filter_fields.[n].filter_field_value
  • Type: String
Additional Parameters
  • Field Name: parameters.[n]
  • Type: Array
Parameter Title Parameter Title.
  • Field Name: Dropdown Filter Form.ddf_create.[n].parameters.[n].parameter_title
  • Type: String
  • Choices: ["Direction", "Device", "NDL", "Limit", "Skip", "Title"]
Parameter Value Parameter Value.
  • Field Name: Dropdown Filter Form.ddf_create.[n].parameters.[n].parameter_value
  • Type: String
Macro * The Macro content written in the syntax of the Macro language.
  • Field Name: Dropdown Filter Form.macro
  • Type: String
Ddf Macro
  • Field Name: ddf_macro
  • Type: Object
Macro * The Macro content written in the syntax of the Macro language.
  • Field Name: Dropdown Filter Form.ddf_macro.macro
  • Type: String
API reference for relation/DropDownFilter