Create Pick List Fields - Review Manager

Instructions for creating a list for user selection in an updatable custom field


There are situations where you may need to create a custom field that includes a specific set of choices. This type of field is referred to as a Pick List Field. Users will then manually select from the list of choices that is either hard-coded or auto-populated by importing field values from a list created in the Reveal Review Manager.

How to create a Pick List Field

  1. Open Review Manager.
  2. Expand Project Setup.
  3. Select Lists.
    150 - 08 - Create List
  4. Click Add List.
    1. Enter a reasonably descriptive Name.
    2. Add an optional Description of the list.
    3. Specify Sort Order (Ascending or Descending).
    4. Click Save.
  5. Add Values to the list.
    1. For a Managed list, all values will be manually entered here by the administrator.
    2. An Automatic list will look to existing field or text file values and dynamically populate the list from those values. In the case of a text file each value should be separated by a hard return.
    3. Values may be added here:
       150 - 09 - Create List Values
      1. Individually using Add Value, or
      2. As Bulk Values, either
        1. from a Text File or
        2. from a Database Field.
      3. Bulk Values may Append to List or Overwrite List.
      4. You may Export the list values.

Add Pick List Field to Field Profile

List Fields are configured and added under Fields in Project Admin.

  1. Go to Add Fields.
  2. See Creating a Field to review this part of the process.
  3. Go to Field Profiles.
  4. Add the new field to a selected profile. See Creating a Field Profile to review adding a field to the profile.
  5. Go to Manage Fields.
  6. Select the Field Profile (or the first, if added to several profiles) into which you have placed the new list field.
    150 - 10 - Configure List Field
  7. Select the field to be associated with the List created in Reveal Review Manager. This must be done in each profile containing the field with which you want to associate the List.
    1. Change Effective Data Type to List.
    2. Set the number of Display Lines. The example here shows 2, but since lists cannot be Multi-Value fields 1line will suffice.
    3. Select the List Type from either Managed or Automatic.
      1. If specifying a list created and curated in Reveal Review Manager, select Managed.
      2. An Automatic list will look to existing column values and dynamically populate the list from those values.
    4. Specify whether or not the List should be Appendable, that is, should reviewers be able to add values to the list.
    5. Choose the Linked List from those created in Reveal Review Manager.
    6. Make sure that Updatable is set to Yes.
    7. Click Update to save.

How to use Pick List Field

  1. When seeking to use a Pick List field in review, make sure to select a Field Profile containing the List field as configured. 
  2. Open a document for review in the Document Viewer.
  3. Fields may be viewed and coded either under the Fields panel on the left-hand side of the Document Viewer or in Metadata View
  4. The field should appear as a picklist allowing the user to select a from a static list of choices.

In order to select a Pick List Field choice from the list, the field must not be Locked 

150 - 11 - Coding field list

Last Updated 4/28/2023