Configure checklist service attributes

In the Management Portal at Service Catalog, on the Attributes tab of the service page, configure checklist attributes to store a list for multiple value selections. Users can then select one or more values from the list when requested.

Examples

Configuration

Field

Explanation and Tips

Manual input

Specify values manually.

  • In the Label field, specify a user-friendly name for each value. This is shown to the user in a Provide Information action. For example, if you use the attribute in a service that installs the Microsoft Office suite, use the Label field to specify Microsoft Word, Microsoft Excel, Microsoft Outlook and Microsoft Visio.
    • You can use placeholders to specify labels and values. This allows you to configure services that dynamically resolve the labels and values of checklist service attributes. For example, you can now use a person attribute as a label in a checklist 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 checklist.
    • If you use placeholders to specify labels, they need to resolve in unique labels. If multiple placeholders resolve in the same label, only one label will be added to the list.
    • Click the arrows to change the order in which the labels are shown. For example, to create a list in which the most common option is shown first.
  • In the Value field, specify the (optional) value that corresponds to the Label field. For example, this makes it easier to configure conditions: instead of specifying Microsoft Word in the condition, just specify its value, A.
  • In the Initial State field, specify the initial state of the value when the attribute is used: selected is True, cleared is False. In the Web Portal, this is shown as a check box, after which users can then make their selection. For example, this allows users to specify that they want to install Microsoft Word, Microsoft Excel and Microsoft Outlook, but not Microsoft Visio.

Copy from global attribute

Base the values on a text or table global attribute.

  • If you select a text global attribute, the format of its value should be either Value;Description|Value;Description|... or Value;Description;State|Value;Description;State|...
  • If you select a table global attribute, the format of its value should be either Label;Value|Label;Value|... or Label;Value;State|Label;Value;State|...
  • If you include the third column, which specifies the state of the checklist, Identity Director takes the value from this and converts all the characters to lowercase. If the result of this matches the value “true”, then the state of the checklist is true; otherwise, the state is false.
  • 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.
  • When you copy the values of a text global attribute, duplicate values may occur. For example, if the global attribute has a value Value1;Description1|Value1;Description2, the Preview contents area will show duplicate values. Because you may have set these duplicate values intentionally, Ivanti Identity Director does not validate the values that are copied from the global attribute.

Copy from people attribute

Base the values on a text or table people attribute.

  • If you select a text people attribute, the format of its value should be Value;Description|Value;Description|...
  • If you select a table people attribute, the format of its value should be Label;Value;State|Label;Value;State|... (3 columns).
  • The Preview contents area shows a read-only view of the values of the people attribute. A warning message is shown if the value format is not matched.
  • The initial values are the values of the people attribute.

At least one option must be selected after workflow input from actor

Force a mandatory input for at least one option.

Mapping

You can map checklist service attributes to attributes of other types:

These actions fail if the format of the checklist service attribute is not matched. For example, suppose you have configured a checklist service attribute Microsoft Office with the following settings:

Label

Value

State

Microsoft Word

A

False

Microsoft Excel

B

True

Microsoft Outlook

C

False

Microsoft Visio

D

True

When you map the checklist attribute to other service attributes or Ivanti Automation parameters, the value of these items has to match the format label;value;state|.

Placeholders

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

Placeholder

Explanation

Example

#Service[{attributename}.all]

Resolve all values of the attribute, including all labels, values and initial states.

#Service[Microsoft Office.all] results in "Microsoft Word;A;False|Microsoft Excel;B;True|Microsoft Outlook;C;False|Microsoft Visio;D;True".

#Service[{attributename}.labels.all]

Resolve all labels of the attribute.

#Service[Microsoft Office.labels.all] results in "Microsoft Word;Microsoft Excel;Microsoft Outlook;Microsoft Visio".

#Service[{attributename}.labels.selected]

Resolve all selected labels of the attribute.

#Service[Microsoft Office.labels.selected] results in "Microsoft Excel;Microsoft Visio".

#Service[{attributename}.{labelname}.value]

Resolve the value of the specified label of the attribute.

#Service[Microsoft Office.Microsoft Excel.value] results in "B".

#Service[{attributename}.{labelname}.state]

Resolve the state of the specified label of the attribute. The state always resolves in lower-case letters.

#Service[Microsoft Office.Microsoft Excel.state] results in "true".

#Service[{attributename}.values.all]

Resolve all values of the attribute.

#Service[Microsoft Office.values.all] results in "A;B;C;D".

#Service[{attributename}.values.selected]

Resolve all selected values of the attribute.

#Service[Microsoft Office.values.selected] results in "B;D".

#Service[{attributename}.Description]

Resolve the description of the attribute.

"This is the attribute that stores the selection of the actor".

See also

Was this article useful?    

The topic was:

Inaccurate

Incomplete

Not what I expected

Other