Tip of the day

Support tickets can be submitted directly from application

List of values

Estimated reading: 5 minutes 94 views

A form element designated for selecting values from a list.

There are two ways to store values within a list:

1.Manually typing the values within the list controller itself. (The label and the stored values will be the same).

2.Connecting the list controller to a dictionary (Unlike the first method, this method enables to create a distinction between that displayed text and its stored value).

A list of values may also be cascaded while selecting a value from one element will affect available values on another list of values.

For example, if the selected value from one list of states is “California”, then the other list of cities controller will filter list so that only cities within California are displayed such as: Los Angeles, San Francisco, Sacramento, etc.

Configuration

LabelDescription
Add a tagAdd manually list of values, click enter or comma to enter new value
Select dictionaryCouple builtin dictionary with the template. Can be useful when list of values is deployed in many templates and single source need to be managed. For more information see “Dictionaries“.
Multi selectEnable multi value selection to pick from the list of values
Filter listSelect the list of values to link the lists such as cities and streets, only if the values ​​in the dictionaries have the same groups.
AJAXSelect to enable an autocomplete in the search box of the list of values controller. If a data dictionary is selected, the functionality exists by default and cannot be cancelled.
*In large lists, it is recommended to select “AJAX” in order not to overload the form.
Search typeIf “AJAX” is switched on then we have two options for search values remotely.
The default option is “Fuzzy”. User may override default. See notes on search types below

Search types

Fuzzy Search

Definition: Fuzzy search is a technique used to find matches to a query that are not exact. It is particularly useful for handling misspellings, typos, or variations in word forms. The goal is to return results that are close to the search term based on certain algorithms or criteria.

Example:

Suppose you are searching for the term “apple” in a database. With a fuzzy search, if you accidentally type “aple” or “appl”, the search engine might still return results for “apple” because it recognizes that the intended word is similar to the input.

Strict Search

Definition: Strict search, also known as exact search, only returns results that exactly match the search query. There is no tolerance for variations or misspellings in this type of search.

Example:

Using the same example, if you search for “apple” with a strict search, you will only get results that contain the exact or partial term “apple”.

  • If you type “aple” you will not get any results.
  • If you type “appl” you will get results.

Use Cases:

  • Searching for specific technical terms or codes.
  • Databases where precision is crucial (e.g., legal documents, scientific research).
  • Situations where accuracy is more important than flexibility in matching terms.

Comparison

  • Fuzzy Search:
    • Flexible and tolerant to errors.
    • May return a broader set of results.
    • Useful for improving user experience in search interfaces.
  • Strict Search:
    • Requires exact input.
    • Ensures precision and accuracy in results.
    • Useful in contexts where exact matches are necessary.

Notes and gotchas

  1. When connected to dictionary, note that a dictionary include “text” and “value” columns. While the textual representation is selected it is actually holding the underlying value. As a result on a signed document produced from Cellosign the text value will appear and the underlying value is transferred as a result in the archive process.
  2. When applying multi-select on PDF templates, make sure to leave enough room for selection, also note that on a PDF result that values are concatenated on a single line with a comma separating each of the selected values. Make sure to have enough room as needed, otherwise your values will be truncated from the archived PDF.
  3. When list of values is coupled with a dictionary and you wish to assign a value upon a certain condition, make sure that the value that you are adding is in the “value” column in the dictionary and not from the “text” column (The “text” is a label that only affects the displayed text).

When checking conditions on the list type controller, the following options are displayed:

EqualIf the list controller is exactly equal to the entered value.
Not EqualIf the list controller is not equal to the entered value.
EmptyIf the list controller has no value.
Not EmptyIf there is any selected value in the list controller.

When using conditional values in the list of values that is connected to a dictionary, you need to use the “Values” column and not the “Text” column.

See below the example of the list controller using the dictionary “Levels” with values 1, 2 and 3.

Depending on the selected radio button, the value in the list controller will be set to “Level 1”, “Level 2” or “Level 3”.

Client side:

Leave a Comment

Share this Doc

List of values

Or copy link

CONTENTS