ValueInterpretations

Select None to treat each entry as a simple value, with no display label or remarks.

Usage

• Use for basic lists where only the value itself is needed (e.g., codes, numbers, or simple text).
• No additional display or tooltip information is shown to users.

Select DisplayValue to use the value component as a display label for each entry.

Usage

• Use when you want to show a user-friendly label in dropdowns or search screens, while storing a different underlying value.
• Each entry should be in the form key=value, where the key is stored and the value is displayed.

Example

AL=Alabama
AK=Alaska
CA=California

• "AL" is stored, "Alabama" is displayed.

Select Remarks to provide a description or tooltip for each value, making additional context visible in the UI and search screens.

Use Case 1: User Guidance and Review Context

Use this option when you want each value in the list to include a human-readable description, explanation, or context for review operators. This is especially helpful for fields with codes, abbreviations, or reason values that may not be self-explanatory.

• UI Behavior:
  The value is shown in the dropdown or autocomplete list, and the remarks appear as a tooltip or in search screens. This helps users understand the meaning or purpose of each value without cluttering the main display.
• Example:
  

  Value	Remarks
  AL	Alabama

  | AK | Alaska |

Use Case 2: AI-Powered Extraction and Validation

When using AI-powered data extraction, select Remarks to provide the model with a list of valid values and their descriptions. This context helps the AI model disambiguate similar values and improves extraction accuracy, especially for fields with overlapping or ambiguous codes.

• Configuration:
  Remarks can be supplied in two ways:
  1. Single Column Format:
     Each entry is formatted as value=remarks. The portion before the = is the value, and the portion after is the description.

     AL=Alabama
     AK=Alaska
     

  2. Separate Remarks Column:
     When using lookup results, provide two columns: one for the value and one named Remarks (or aliased as Remarks) for the description.

     State	Remarks
     AL	Alabama

     | AK | Alaska |
• AI Behavior:
  The list of values and their remarks is provided to the LLM or extraction engine, enabling it to match, validate, and explain extracted values.

Additional Notes

• If neither supported format is used, remarks will not be displayed for lookup values.
• For more details, see the documentation for the 'Include Lookup Results' property.