Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Excerpt
Include Page
TERMS:Tagbox Field
TERMS:Tagbox Field

...

Picturepark Setup Example

Layer: Corporate Information (ID: CorporateInformation)

Field: Persons (ID: persons)

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:

  1. Assign Layer with Default Value for the Fieldset

    Code Block
    {
    	"kind": "AssignLayerAction",
    	"layerId": "Product",
    	"defaultValues": {
    		"fieldsetFieldId": {}
    	},
    	"traceRefId": null
    }
  2. Assign Tagbox Items

    Code Block
    languagejson
    {
    	"kind": "AssignTagboxItemsAction",
    	"path": "layerId.fieldsetFieldId",
    	"fieldId": "tagboxId",
    	"refIds": "$variable$",
    	"replace": false,
    	"traceRefId": null
    }

Advanced search for field

_exists_:corporateInformation.persons

  • This query finds all Content Items with the tagbox available and not empty. 

Advanced search for the field value

Filter by label (Content by label)
showLabelsfalse
cqllabel = "advanced-search" and label = "tagbox" and space = "SOL"

Use in Display Pattern

Filter by label (Content by label)
showLabelsfalse
cqllabel = "display-pattern" and label = "tagbox" and space = "SOL"

Unique Identifier

_refId

Filter by label (Content by label)
showLabelsfalse
cqllabel = "advanced-search" and label = "id-search" and space = "SOL"

Returned field value

Single:

  • Field Id from the underlying schema

  • Value in field


Multi: Array

  • Field Id from the underlying schema

  • Value in field

...

Name

For single Tagboxes, use the singular for name, e.g., department.
Multi Tagboxes use plural names e.g., persons.

ID

Include Page
TERMS:Field ID
TERMS:Field 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. 

VIDEO: How To Create List From Tagbox Settings

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

Include Page
TERMS:Sortable
TERMS: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. 

VIDEO: How To Create 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.

...