PSD1133 – MultiListStaticStringControl

Fact

• PhenixID Identity Manager 5.3.3 or later

Situation

You are editing a e.g. user and like to save one or more values chosen from a list of values. You like the list to be of values from a list that you have created, for example Banana, Orange, Melon. You even might like to show one value but store another. For example, instead of Banana the list number of Banana is stored instead. See screenshot below.

If you like to create the list based on LDAP objects instead and store the values as string, please read PSD1132.

If you like to create the list based on LDAP object with backlink intact, please read PSD1073.

Solution

Use the custom control se.nordicedge.controls.lists.MultiListStaticStringControl

1. Open IM configurator and Tab Designer
2. Open or add a new form, for example a View Edit form/tab
3. Click button for “Create a Custom Control” and drag it to the workspace of the form.
4. Click “Options for Custom Control”
5. Paste se.nordicedge.controls.lists.MultiListStaticStringControl to Class Name: and then click “Query Custom Control Class”
6. Configure the Custom Control (see parameters below) and add an attribute to the control where the values should be stored.
7. Save and test the control.

Below are the configurable parameters for the control.
(Some are explained a little more in detail.)

Side by side mode (true/false). Default is true.
The control has one grid for the search result and one for the current result. Set this option to true to show the grids side by side. Set this option to false to show the search result grid above the current result grid.

Source list column header (Static values )

Source list header (Selectable)

State list column header. Default is current attribute name

Current state (Current state)

Static list lenght (Total)

Current state length (Total)

Add button (Add)

Remove button (Remove)

Jsp file to use. Default is /jsp/CustomControls/MultiListCC.jsp
The default jsp-file to use for this custom control is /jsp/CustomControls/MultiListCC.jsp but you may use another jsp-file of your choice. In this option the file path is the URL, starting at the IM web app directory.

Width (%) for search result at side by side mode. Default is 50.
By default, the grid for the search result and the grid for the current state have the same width at side by side mode. In this option you can change the width of the search result, in percent.

Hide current members from search result (true/false).
Default is false.
By default in the left pane, you will see all the objects that are matching the search, including those who are already members of the group. If you do not like to present the existing members in the search result, this is the parameter to use.

List of selectable values. Prepend with POLICY: to define values in policy. Val1[|store1]#val2[|store2]..
The list of values that the user can choose from could either be added here or added in a policy. The advantage of using a policy is if values are to be used in several forms, then you only need to manage them in one place.
* Add values in the control
Add each value with the separator #. For example Banana#Lemon#Orange
* Add values in using policy
If you like to use a policy, instead of the values in the example above you just type a policy name of your choose. For example MyListValues.
In the control, instead of the values in the example above you type POLICY:MyListValues
In DSEditor.properties you create a policy using your made up name, see example below with some example values.
MyListValues=Banana#Lemon#Orange
* Have different display names and store values
If you like to display Banana but you like to store in the directory Ban123 instead. Then you can use PIPE as a separator. Se example below.
Banana|Ban123#Lemon|Lem938#Orange|Ora832

Show only current state. Default false
If you like to only display the stored values and not add/remove, change this value to true