How To
ForgeRock Identity Platform
Does not apply to Identity Cloud

How do I add drop-down list controls to the Admin UI in IDM (All versions)?

Last updated May 19, 2021

The purpose of this article is to provide information on adding drop-down list controls to the Admin UI in IDM. This information does not apply to the End User UI or the Self-Service UI. This allows you to customize the default forms for managed objects.


Adding drop-down list controls

The default forms for managed objects are driven by schema. You can add drop-down list controls to the managed objects schema by adding an enumerated type configuration to the managed.json file (located in the /path/to/idm/conf directory).

You should add the following properties to the field that requires a drop-down list:

  • enum - this should be the option codes (no spaces).
  • options: enum_titles - this should be the option names as you want them displayed in the drop-down list.

Example

This example snippet from the managed.json file shows an updated Country field, which has four selectable options:

"country" : {    "description" : "",     "title" : "Country",     "viewable" : true,     "userEditable" : true,     "policies" : [        {           "policyId" : "minimum-length",           "params" : {               "minLength" : 1            }        }     ],     "returnByDefault" : false,     "pattern" : "",     "type" : "string",     "enum" : [         "uk",         "germany",         "us",         "chile"     ],     "options" : {         "enum_titles" : [             "United Kingdom",             "Germany",             "US",             "Chile"         ]     } }
Note

Drop-down list controls work in the Admin UI but not the End User UI or the Self-Service UI. This is a known issue: OPENIDM-11996 (UI Self-service pages don't render enumerated fields).

See Also

How do I add a new custom UI page in IDM 5.x and 6?

How do I change the display properties for a User Profile field in the Self-Service UI in IDM 5.x and 6?

Setup Guide › Admin UI

Related Training

N/A

Related Issue Tracker IDs

OPENIDM-11996 (UI Self-service pages don't render enumerated fields)

OPENIDM-8549 (Expand usability of Admin UI to manage reference data)


Copyright and Trademarks Copyright © 2021 ForgeRock, all rights reserved.