Lookup Controls are User Interface elements that can be placed in a workflow to allow users to search for EmpowerID objects. This topic demonstrates how to use the Lookup Designer to create a Lookup Control that allows users to search for another person.
Create a lookup
From Workflow Studio, right-click on the package you just created and select New User Interface > Lookup.
This opens the new Lookup Control in the Workflow Studio Designer. You can save the lookup control with a meaningful name, click on the Save button, and select the path to save the lookup. Make sure you choose the correct folder for the package and save it inside the User Interface> Lookup Controls.
From the Properties grid, set the Title property to Hello World Person Lookup and the Description property to Search for a Person.
From the Properties grid, set the Type property to Single. Setting the Type to Single allows users to select only one object.
In the Lookup Control Data Pane located at the bottom of the designer, do the following to allow the Lookup Control to return a list of people.
Click the Component Object drop-down list and select PersonView. The Component Object drop-down list contains a list of class definitions that relate to the objects EmpowerID protects, and the PersonView object provides a consolidated view of all the data fields associated with EmpowerID people.
Click the Data Method drop-down list and select the GetAllSearch(string columnsToSearch, string textToSearch) method. This method returns all people contained in the EmpowerID Identity Warehouse to the Lookup Control.
The following image shows what the Lookup Control Data Pane looks like with the above selections made.
Now that the component object for the Lookup Control has been set, click the Set Grid Type in the Properties pane to set the grid type for the designer.
Select Person from the drop-down and click OK. Setting the grid type for Lookup Controls in this way automatically adds the columns associated with the component object you are binding to the Lookup Control. This allows you to provide a consistent look to your Lookups and makes it easier for localization as the default grid type columns are already localized.
Save your changes.
To publish a lookup
The forms developed above will have to be deployed to make them available to workflows. Build and deployment topics are detailed in the articles below,
In This Article