Configure list service attributes

In the Management Portal at Entitlement Catalog, on the Attributes tab of the service page, configure list attributes to store a list of values. This allows actors in a service transaction to select a value from the list when requested.

Configuration

Field

Explanation and Tips

Manual input

Specify values manually.

  • In the Values area, specify the values in the list.
    • You can use placeholders to specify values and descriptions. This allows you to configure services that dynamically resolve the values and descriptions of list service attributes. For example, you can use a person attribute as a value in a list service attribute. During the service transaction, this person attribute then resolves dynamically depending on the person that requests or subscribes to the service. This allows you to use personalized options in the list.
    • If you use placeholders to specify values, they need to resolve in unique values. If multiple placeholders resolve in the same value, only one value will be added to the list.
    • Click the arrows to change the order in which the values are shown. For example, to create a list in which the most common option is shown first.
  • In the Display field, specify the format in which the service attribute is shown.
  • In the Initial value field, specify an optional default value of the service attribute.
    • The value is limited to 2000 characters.

Copy from global attribute

Base the values on a text or table global attribute.

  • If you copy from a text attribute, the format of its value should be Value|Value|... or Value;ValueDescription|Value;ValueDescription|....
    Additional columns (i.e. values separated by a semicolon (;) will be ignored.
  • If you copy from a table attribute, the table should consist of two columns (Col 1 = Value, Col 2 = ValueDescription).
  • The Preview contents area shows a read-only view of the values of the global attribute.
    A warning message is shown if the value format is not matched.
  • The initial values are the values of the global attribute.
  • If you copy the values of a text global attribute, duplicate values may occur. For example, if the global attribute has a value Value1;ValueDescription1|Value1;ValueDescription2, the Preview contents area will show duplicate values. Because you may have set these duplicate values intentionally, Identity Director does not validate the values that are copied from the global attribute.

Copy from people attribute

Base the columns and values on a text, table or list people attribute.

  • If you select a text people attribute, the format of its value should be Value;ValueDescription|Value;ValueDescription|...
  • If you select a table people attribute, the format of its value should be Value;ValueDescription|Value;ValueDescription|... (only supported for table people attributes that consist of 2 columns).
  • The Preview contents area shows a read-only view of the values of the global attribute. A warning message is shown if the value format is not matched.
  • The initial values are the values of the global attribute.

You can force mandatory input by enabling Attribute may not be empty after workflow input from actor.

You can use the service attribute in multiple pages of a Provide Information workflow action by enabling Attribute can be used in multiple pages on Provide Information.

Placeholders

When you insert list service attribute as a placeholder in actions, use the following options to retrieve its values:

Placeholder

Explanation

#Service[<AttributeName>.Description]

Resolve the description of the attribute.

#Service[<AttributeName>.Value]

Resolve the selected value of the attribute.

#Service[<AttributeName>.ValueDescription]

Resolve the description of the selected value.

See also