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 Jan 12, 2023

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


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 IDM Admin UI but not the IDM End User UI, the IDM Self-Service UI or the platform Admin 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 6?

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

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 © 2023 ForgeRock, all rights reserved.