Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
style

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

  1. From Workflow Studio, right-click on the package you just created and

    select Add

    select New

    Item >

    User Interface >

    EmpowerID

    Lookup

    Control

    .

    Image RemovedImage Added

  2. In the Add New Lookup Control window that appears, type a name for the Lookup Control in the Name field, ensure the package is correct and then click OK.
    Image Removed
    This opens the new Lookup Control in the Workflow Studio Designer.

    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.

    Image Added



    Image Modified

  3. From the Properties grid, set

    the Title property to 

    the Title property to Hello World Person Lookup

     and the Description property to 

     and the Description property to Search for a Person.

    Image Modified




  4. From the Properties grid, set

    the Type property to 

    the Type property to Single. Setting the Type to Single allows users to select only one object.

    Image Modified


  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 

      the Component Object

       drop

       drop-down list and

      select 

      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 

      the Data Method

       drop

       drop-down list and select

      the 

      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.

      Image Modified


  6. Now that the component object for the Lookup Control has been set, click

    the 

    the Set Grid Type

     button in the Lookup Designer ribbon

     in the Properties pane to set the grid type for the designer.

    Image Removed
    In the Set Grid Type window that appears, select Person from

    Select Person from the drop-down and

    click 

    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.

    Image Removed
  7. In the Confirm dialog that appears, click Yes to continue.
  8. Image Added

  9. Save your changes.

    Image RemovedImage Added


To publish a lookup

  • Open the lookup you want to publish.
  • From the toolbar located above the Workflow Studio Designer, click the Compile and Publish button.
    Image Removed
    In the Lookup Publishing wizard that appears, click the Next button.
    Image Removed
    Select the server to which you want to publish the Lookup and click Next.
    Image Removed
  • Click Next again and wait for the wizard to compile the Lookup and publish it to the hosting server.
  • Select Yes when prompted to restart one or more services.
    Image Removed
    In the Active Services window, select the Web Role Service on the hosting server and click the Restart button.
    Image Removed
  • Select Yes when prompted to restart Workflow Studio.
  • Select Yes to save changes to any opened files.
  • Div
    stylemargin-top: 30px
    Div

    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,

    Batch deploy to a local folder

    Deploy to EmpowerID Environment

    In this article

    In This Article

    Div
    stylefloat: left; position: fixed; padding: 5px;
    idtoc
    classtopicTOC
    Div
    stylefont-size: 1rem; margin-bottom: -65px; margin-left: 40px;text-transform: uppercase;
    Table of Contents
    stylenone