Versions Compared

Key

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

Excerpt
Include Page
TERMS:Fieldset Field
TERMS:Fieldset Field

Fieldset Overview

Icon

Image Modified

Pre-Requirement

Before creating a fieldset, first, create the underlying fieldset schema (a group of fields).

Limitation

Not available in batch edit mode of the Batch Editor!

Only Single Fieldset fields are available in the Excel Roundtrip App.

Parent-Child Setup

You can create a schema "Fieldset" following a parent-child setup. When you connect your Fieldset schema to the Fieldset field, the parent-child hierarchy is ignored.

If you connect the Fieldset field to a parent, you will only see fields on the parent. 

If you connect the Fieldset field to a child, you will only see fields on the child, no propagated fields from the parent.

Single Fieldset

One data entry using the underlying source schema, e.g., one copyright information for an image (there shouldn't be more than one).

Multi Fieldset

Multiple data entries, each using the underlying source schema.

Behavior

field-type_fieldset-single_behavior.mp4

Examples

  • Duration (fields: start, end)

  • Address (fields: street, zip, and city)

  • Weblink (fields: URL, link text)

  • Comments (fields: date, person, comment)

  • Usage details (fields: department, description, source)

Info

VIDEO: How to Use Fieldset for Working Notes 

Fieldset Value Handling

Picturepark Setup Example

Layer: Corporate Information (ID: CorporateInformation)

Field: Duration (FieldId: duration)

Fieldset Schema Fields: Start (ID: start), End (ID: end)

Fieldpath

corporateInformation.duration.start

Excel Roundtrip App

LAYER.FIELDSET-FIELD.SOURCE-FIELD

Default Value in Business Rule

A fieldset value:

Code Block
languagejson
"fieldsetId": { "fieldsetFieldId": "value" }

A multi-tagbox value in a single fieldset:

Image Modified
Code Block
languagejson
{"layerfield": {"fieldsetfieldId": [ { "_refId": "$industryRefId$" } ]}}

Advanced search for field

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

Use in the display pattern

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

General Access

To get the display pattern from the fieldset: 
corporateInformation.duration

To get the fieldset schema name: 
corporateInformation.duration.kind

To get a specific value in single fieldsets: 
corporateInformation.duration.start

Use in the business rule

The Business Rules do not check the value pairs in the correct order, and therefore fieldsets shouldn't be used. It may otherwise happen that the business rule connects the value from the first entry (array) with the key from the 2nd entry (array). 

Returned field value

Single:

  • Kind (ID of the underlying schema)

  • Field Id from the underlying schema

  • Value in field 


Multi: Array

  • Kind (ID of the underlying schema)

  • Field Id from the underlying schema

  • Value in field

Fieldset Field Settings

Name

Include Page
TERMS:Name
TERMS:Name

ID

Include Page
TERMS:Field ID
TERMS:Field ID

Single item fieldset

Allowing one or multiple data entries into the fieldset field. This setting cannot be changed afterward.

A case for a single fieldset:

  • provide one headquarter address

  • provide one birthday

  • provide one employee address

  • provide one image caption

A case for a multi fieldset: 

  • provide multiple exciting links to an article

  • provide multiple approval stages for content

  • provide multiple partners

  • provide multiple authors

Source

The underlying fieldset schema.

Required

Include Page
TERMS:Required
TERMS:Required

UI required

Include Page
TERMS:UI required
TERMS:UI required

Sortable

Sorting based on fieldset values not supported.

Include in filters

Filtering based on fieldset values not supported.

Include in search

All entries in a Fieldset are indexed. When the search finds a match, the parent Content Item is displayed.

Boost value

The search does not consider the boost settings of the underlying fieldset schema.

Fieldset Schema Permissions

...