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 selectAdd New Item > User Interface > EmpowerID Lookup Control.
In theAdd New Lookup Controlwindow that appears, type a name for the Lookup Control in theNamefield, ensure the package is correct and then clickOK.
This opens the new Lookup Control in the Workflow Studio Designer.
From the Properties grid, set theTitleproperty toHello World Person Lookupand theDescriptionproperty toSearch for a Person.
From the Properties grid, set theTypeproperty toSingle. 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 theComponent Objectdrop-down list and selectPersonView. 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 theData Methoddrop-down list and select theGetAllSearch(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 theSet Grid Typebutton in the Lookup Designer ribbon to set the grid type for the designer.
In theSet Grid Typewindow that appears, selectPersonfrom the drop-down and clickOK. 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.
In theConfirmdialog that appears, clickYesto continue.
Save your changes.
To publish a lookup
Open the lookup you want to publish.
From the toolbar located above the Workflow Studio Designer, click theCompile and Publishbutton.
In the Lookup Publishing wizard that appears, click theNextbutton.
Select the server to which you want to publish the Lookup and clickNext.
ClickNextagain and wait for the wizard to compile the Lookup and publish it to the hosting server.
SelectYeswhen prompted to restart one or more services.
In the Active Services window, select theWeb Role Serviceon the hosting server and click theRestartbutton.
SelectYeswhen prompted to restart Workflow Studio.