iConsole Search Definition Reference Guide › Configuring the Search Parameter Layout › Dynamic Parameters › Lookup Parameter Syntax

Lookup Parameter Syntax

Both Popup and Picker use an iConsole search to retrieve the list of items, this is generally stored as a 'System' search. The lookup SP is invoked by a user-defined script function (MyUserLookupFunction in the example below). This function permits a reviewer to select the required value(s), from a popup or picker window.

The function name is specified by the lookup_function attribute in the <parameter> element. The function takes one argument (name in the example below). This argument identifies the 'lookup' parameter field, that is, the parameter field that will hold the value selected by the user in the popup or picker windows. The PopupWithHiddenField parameter passes an additional argument to the lookup_function to identify the field that will receive the hidden IDs. In this case the selected names are for display only; it is the IDs that will be passed as a parameter to the search.

<parameter
  …
  lookup_function="MyUserLookupFunction"
  …
  …
  />
  <script type="text/javascript">>
    function MyUserLookupFunction(name)
    {
      Popup('User Selector','User_Picker',1,0,name, true);
    }