Lookup Value

This activity is used to populate values on objects based on attributes from other objects. This activity has many interesting features and possibilities, i.e. you could lookup an OU placement for a user based on the user's department and have the list of OU's be maintained in the FIM Portal as objects themselves. Or you could have a list of "pretty names" for your cost centers and populate the CostCenter attribute based on a CostCenterId flowed from i.e. the HR system.

Activity Parameters

Parameter Description
XPathFilter The Lookup filter for getting the value, i.e. /Person[starts-with(AccountName, 'D')]. If your query returns more than one result, you can choose what happens/what is returned (see option below)
Attribute Name The name of the attribute that you want to get the value from (for now only single-value attributes is supported (and tested); go ahead and try with multi values if you dare...
Destination This is where you want to put the found/extracted value. If the lookup returns NULL and the value of the destination has a value, that value is deleted/removed. You can also use //WorkflowData/<parameter name> as destination to add a value to the workflow dictionary
Actor (run as) You can choose which account does the lookup's and the updating. You must make sure that Management Policy Rule's are in-place for the account chosen. Normally, FIM Service Account has sufficient permissions
Action on multiple lookup results Specifies what happens if the search returns more than one result. You can choose to return value of the first or last object or throw an error and exit

Installing the Lookup Value Activity

You can install this workflow by running the included PowerShell script 'Install-Workflows.ps1' with the parameter -CreateLookupValueActivity on the FIM Service server.

.\Install-Workflows.ps1 -CreateLookupValueActivity

You need to make sure that the user execute the installation command above, has the appropriate permissions in the FIM Service to be able create an Activity Information Configuration object and be able to put a new DLL in the Global Assembly Cache (GAC).

Last edited Dec 16, 2015 at 12:14 PM by Granfeldt, version 11


No comments yet.