A Fieldset is a collection of Fields that may be associated with a specific Document Type, or with all Document Types in the system.
Types of Fields
There are three types of fields:
- Normal - stores text metadata, such as invoice code
- Lookup - contains a list of selectable options that display in a pick list
- Tree - allows you to select metadata values by browsing a tree structure
Types of Fieldsets
The following two fieldset types are KnowledgeTree defaults:
Note: You can add plugins to KnowledgeTree that add different types of fieldsets, if required.
- Normal - may contain a variety of field types, i.e. one or more, or a combination, of Lookup field's, Tree field's, and Normal field's.
- Conditional - contains two or more Lookup fields. This fieldset must be configured in the Fieldset editing pages after you add the fieldset, in order to set one field as the 'master' field, and to define how user-selected values in the master field determine the display of subsequent fields and values that are presented when the user adds document metadata. Since conditional fieldsets comprise a collection of interdependent fields and values, you need to plan the fieldset structure before creating the fieldset in the DMS. To use this feature, enable the 'Conditional Metadata' plugin in DMS Administration >> Miscellaneous
.
Generic Fieldsets
A fieldset that is defined as 'generic' is automatically associated with each document type you add to the repository. Define a fielset as 'generic' when adding or editing the fieldset.
Working with Fieldsets
How to View Existing Fieldsets
1. To open the Fieldset management page, click Document Fieldsets in Document Metadata and Workflow Configuration.
2. On the Document Fieldsets page, view existing fieldsets listed in the table.
How to Add a New Fieldset
1. On the Fieldset management page in DMS Administration, click Create New Fieldset.
2. Define a name for the fieldset in the Fieldset Name field; then, add a description in the Description field.
3. In the Fieldset Type section, define whether the fieldset is 'Normal' or Conditional'; then, define whether this is a 'generic' fieldset.
4. Click Create Fieldset.
How to Add a New Conditional Fieldset
Before you begin, plan the fieldset, and its lookup fields and lookup values.
- 1. Add a new fieldset, and define the fieldset as 'Conditional'.
- 2. On the Edit Fieldset page, click Add New Field to add two or more lookup fields to this fieldset, and add lookup values for each field.
- 3. Once you have added all the fields and their lookup fields, set one field as the 'master' field - click Manage Field Ordering on the Edit Fieldset page.
- 4. Define the control field / dependent field relationship between all fields in the fieldset, starting with the master field - click Manage Field Ordering on the Edit Fieldset page. Repeat this step until all fields have been ordered into the control / dependent structure.
- 5. Edit fieldset rules to define conditional behaviour. To do this, click Manage Conditional Behaviour on the Edit Fieldset page.
- 6. For each control field, select a lookup value; then, select two or more lookup values in the dependent field - the dependent field values will display when the user selects the control field lookup value in the conditional fieldset. Click save this dependency to save each behaviour; then, when you're ready to configure the next field, click edit field.
- 7. When fieldset rules (conditional behaviour) have been set up on all control/dependent fields, click View Overview on the Edit Fieldset page to walk through a test of the fieldset you created.