Tagbox
Tagbox Overview
Icon | |
Behavior | VIDEO: How MultiValue Tagbox Behaves When you click into the field, you get suggestions. When you type, you get suggestions that match your input. The List Display Pattern of the connected list is used for suggestions. Please ensure that the display pattern is adapted for correct suggestions. |
Main benefit | Tags are specific, support searching with a lot of additional attributes, and are easy to maintain. You can add attributes to the tags anytime, which extends the metadata for all tagged Content Items. You can translate only your tags and find your Content Items in all translated languages. Tagboxes also support the user when adding metadata by showing suggestions, and the user cannot add wrong spelled product names or person names, so the metadata values are already "validated." By not allowing the creation of new List Items, users must work with approved terms only, and your metadata is safe. Note: Permission to create new List Items: "Manage items" in the Schema Permission Set applied to the List. Support for circular references allows for creating extended schemas. |
Connected List | You can create a tagbox without having the List created. When choosing your connected List you can create one. |
Custom vs. System Lists | System Lists are already available in the system used in various places. You cannot change them or the values.
Custom lists are lists you create for your purposes, like keywords or products or events. |
List Items | The List contains List Items, which have various attributes. The List Item can have a name only or a name, description, and further useful information. When you connect the List to a Tagbox, the List Items become tags added to the Content Item, also known as "tagging." |
View mode | In view mode, the display of tags comes from the Name Display Pattern of the List, connected to the Tagbox field. |
Edit mode | In edit mode:
|
Filters | You can add a tagbox as a filter, using it as facet in the sidebar or for suggestions. In the filter editor you select the tagbox._refid value as filter field, then you add a text field e.g. tagbox.name as search field. This way the tags are shown with a name. When a user selects a tag the ID is used to find the assigned Content Items, which is more accurate. |
Suggestions in the Tagbox | When you click into the Tagbox Field, you get suggestions from the connected List. You can continue typing to drill down the suggestions further to find your desired tag. The suggestions consider the filter defined in the Tagbox Settings. The Display Pattern List of the connected list is used for suggestions. Please ensure that the display pattern is adapted for correct suggestions. With appropriate permissions, you can add new List Items while editing your Content Item.
|
Contextual information (card) | The assigned tags in view mode appear as clickable links. When you click the tag, you see a card with further attributes of the List Item. The card display consists of:
|
Examples |
|
Tagbox Value Handling
Picturepark Setup Example | Layer: Corporate Information (ID: CorporateInformation) |
Fieldpath | corporateInformation.persons |
Usage in Excel | LAYER.TAGBOX-FIELD.CONNECTED-LIST-FIELD |
Tagbox in Fieldset in Business Rules | Entering a list item into a tagbox inside a fieldset requires to first initialize the fieldset, then add the value:
|
Advanced search for field | _exists_:corporateInformation.persons
|
Advanced search for the field value |
|
Use in Display Pattern |
|
Unique Identifier | _refId
|
Returned field value | Single:
|
Tagbox Field Settings
Name | For single Tagboxes, use the singular for name, e.g., department. |
ID | |
Single item tagbox | Allow one or multiple tags. Once set and saved, this cannot be changed afterward. Use single item tagbox where you want to make sure only one tag is sufficient like either-or questions, e.g., state (active, passive). |
Connected List | This List contains the List Items used as tags within the Tagbox field. You can create a tagbox without having the List created. When choosing your connected List you can create one. |
Item filter | Limit the List Items available for selection by using a filter, e.g., show only actual products or employees from the board of management. |
Minimum | Only whole numbers (integers) are supported. Adding a minimum value sets the field required. |
Maximum | Setting the maximum value to 1 turns a multi-item tagbox to a single item tagbox; however, we recommend choosing a single item tagbox instead. |
Required | Required ensures that editors add at least one tag. |
Sortable | |
Preview pattern | The option to define which Display Pattern shows in the view mode of the Tagbox. The Preview pattern allows showing the List Display Pattern with additional values instead of the Name Pattern, which shall be short and precise. |
Default Values | Assign the default values for when users create new tags while editing Content Items. When you add default values, you can also create the filter for the Tagbox from them. When Picturepark finds Default Values, you find a link above the "Filter" field that allows generating the Filter from Default values. |
Include in Filters | Sorting of tagboxes and fieldsets uses the "Name" display pattern of the items. There is a language fallback. |
Search | Definition of the fields which Picturepark search considers. |
Boost | Picturepark ignores the boost settings of the underlying schema. |