Lookup Controls

Owned by Phillip Hanegan
Last updated: Feb 17, 2022 by Dev Raj Gautam
3 min read

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 will enable users to search for another person.

Create a lookup

  1. From Workflow Studio, right-click on the package you just created and select New User Interface > Lookup.

     

     

  2. Completion of Step#1 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.

     

     

  3. Set the Title property to Hello World Person Lookup and the Description property to Search for a Person from the Properties grid.

     

  4. From the Properties grid, set the Type property to Single. Setting the Type to Single allows users to select only one object.

     

  5. 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.

    1. 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.

    2. Click the Data Method drop-down list and select the GetAllSearch(string columnsToSearch, string textToSearch) method. This method returns all people in the EmpowerID Identity Warehouse to the Lookup Control.

      The following image shows the Lookup Control Data Pane with the above selections made.

       

  6. Now that the component object for the Lookup Control has been set, click the Set Grid Type in the Properties pane to select the grid type for the designer.
    Select Person from the drop-down and click OK. Setting the grid type for Lookup Controls 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.

     

     

  7. Save your changes.

     

     

To publish a lookup

The forms developed above will have to be deployed to make them available to workflows. You can follow instructions for Build and deployment in the articles below,

Batch deploy to a local folder

Publish Workflow Studio Items to EmpowerID Environment

Â