TagInput

TagInput

General Description

The TagInput widget allows a user to select multiple choices from a lookup list. The input is done with a keyboard. When the user starts entering a text, the drop-down part appears and allows selection of a value.

The best use for a TagInput are long lists of values. If you have only a short list of possible values and you need to select multiple entries you should use a Checklist.

Form View:

4718595_514x164

Table View:

4718596_253x186

Example

Since ORIGAM data storage is based on standard relational databases, it typically does not allow storing multiple values in a single database field. Therefore we use the most transparent way on storing TagInput choices-a child table.

1. Create a Child Entity

As the first step, create a child N:N entity that will contain a reference field to an entity from which you would like to pick-up values.

For example: Countries.

4718597_205x92

2. Create an Array Field

Then you have to create an Array type field in the main entity.

  1. Right-click on the entity and select New > Virtual Field
  2. In the ArrayRelation select the child entity (e.g. CountriesEntity)
  3. In the ArrayValueField select the field you will fill-in by selecting values from the TagInput widget (e.g. refCountryId)
  4. Caption, DataType and DefaultLookup should be automatically filled based on the selected field.

3. Set Up the Screen Section

Now when the data model is ready (an array field in the main entity is prepared) we will finally put the TagInput widget to our main entity’s screen section.

  1. Open the desired screen section
  2. Click on the array field from the list of fields
  3. Select the TagInput widget from the list of widgets and drag-drop it to the surface.
  4. Check if the DataLookup property is entered.

See Also

AsCombo Widget

Master Detail