Plugin Mode

Dynamic Refinement Lookup

Summary

Click the button to narrow down the records shown in the lookup’s selection dialog, based on the current record’s values. You can narrow it down further using preset conditions.

Smartphone support

This plugin supports smartphones.

How to use

Choose the lookup field and the fields to display in the selection dialog. On a creation or edit page, click Retrieve to search for records whose key contains the text entered in the lookup. If the lookup is empty, all records are candidates. To narrow the candidates further, configure a field in the referenced app, comparison operator, and comparison value. Select a record to retrieve its lookup data, or click Clear to clear the lookup.

When it runs

Depending on the settings, this customization runs at the following times. Any configured conditions are also evaluated.

  • When you open a record creation or edit page
  • When you click a button added by this plugin

Click the button added by this customization to run the operation.

The page-display and field-change triggers exclude inline editing from the pencil icon on the list page.

Parameters

Enter or select a value for each setting unless it is marked optional.

Lookup Field

Please select a lookup field.

The following field types can be selected.

  • Lookup (text)
  • Lookup (number)

Fields used as filter criteria

Choose the field in the referenced app to compare when filtering candidates. Leave it unset to skip this additional filter. This setting is optional.

The following field types cannot be selected.

  • Attachment
  • Table
  • Related records
  • Field group
  • Label
  • Blank space
  • Border

Select from the app referenced by “Lookup Field”.

Conditions

Choose how to compare the selected field with the comparison value. This setting is optional.

Available options:

  • Equals
  • Not Equals
  • Greater than(>)
  • Greater than or Equals(>=)
  • Less than(<)
  • Less than or Equals(<=)
  • Contains
  • Not Contains

Comparison values for fields used as filter criteria

Specify the comparison value. To filter using a value from the current record, select that field. This setting is optional.

Fields to display in the selection dialog

Choose the fields shown when selecting a lookup candidate. You can select more than one field.

The following field types cannot be selected.

  • Table
  • Related records
  • Field group
  • Label
  • Blank space
  • Border

Select from the app referenced by “Lookup Field”.

Restrictions

If you configure “Fields used as filter criteria”, also configure “Conditions”.

The following actions and conditions are useful when building similar behavior in customization mode.

Actions

Conditions