LookupList

This System tool returns all of the non-null values for a specific attribute in a specific key. These values are placed in a variable of type ListofString. Refer to the Attributes that can be looked up in keys topic for a list of attributes that can be looked up.

If you are just looking up a single attribute value, such as a user's email address, or a workgroup's extension, use the LookUp tool. LookUp and LookUpList have similar functionality, so refer to the LookUp tool online help for examples of looking up values in Directory Services Keys.

Inputs

Key Type

The name of the key in CIC Directory Services you want to search. When you type a key, its name must be enclosed in quotes. For example, if you were looking up an email address for a specific user, you would type "User" in this field. The keys that can be searched are:

• "DnisDid"

• "Line"

• "LineGroup"

• "Server Parameter"

• "StationGroup"

• "User"

• "Workgroup"

• "Workstation"

• "Wrap-up Code"

Note: Some User Rights attributes (e.g., View Workgroup Queue List, View Station Queue List, Modify Attendant Configurations, Modify Line Queue List, etc.) take longer to be updated and propagated through the system than all other attributes.  Some administrative changes to these user rights might not be immediately visible to the Lookup tools. If timing is important with the Lookup tool steps, use the IC Change Notification Monitor initiator to monitor for User Rights changes before using the Lookup tools.

Attribute Type

The specific attribute in the key type you want to search. Refer to the Attributes that can be looked up in keys topic for a list of attributes that can be looked up. If you type an attribute name as a literal value, it must be enclosed within quotes.

Sort Lists by Value?

False will sort the lists lexicographically by key value. True will sort lexicographically by attribute value.

Outputs

Key Type

A variable of type ListofString that contains a list of child key names retrieved from the search. Null values are not retrieved.

Attribute Value

A variable of type ListofString that contains a list of values retrieved from the specified attribute. Null values are not retrieved.

Exit Paths

Success

This step takes the Success exit path if the path to the key is valid and the attribute type and key type are valid.

Failure

This step takes the Failure exit path if the path to the key is invalid, or if the attribute or key type is invalid.