Versions Compared

Key

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

In this page you find information about ….

Table of Contents

Managed Data Fields give you the ability to easily define and manage structured data fields globally in Confluence, instantiate field definitions on Confluence pages and perform queries on existing field instances.


Add a Field Definition

Status
titleTODO


Manage Access Control

Per default, every Confluence user may add, edit and delete Field Definitions, as described in Add a Field Definition. However, the access to Field Definition page can be controlled via Confluence user groups. If you the user group managed-data-fields-editors exists and contains at least one member, access is only granted to users in this group.

These users will then see a new button Field Definitions in the Confluence top bar, which allows quick access from everywhere in Confluence to the Managed Data Fields Definition page.

Field Types

You can defined Data Fields of different types.

As native types we refer to fields that define a text input, a date picker, a dropdown field, an option field with single or multi select.
Additionally, option fields are defined with fixed option values, i.e. you predefine all values, that can be assigned to an instance of this field.

As complex fields we refer to Data Fields, that are composed of several native typed fields. A complex field can for example be composed of two string inputs, a date field and an option field. The individiual components are called attributes and have their own labels and types.


Instantiate a Field

Once you defined your abstract Data Field, you can instantiate it as a macro in every Confluence page. Simply select the Managed Data Field Macrofrom the insert menu. Alternatively, use the shortcut { and start to type Managed Data Fields.

In the showing dialog, choose Field Instance, the Definition you want to instantiate and fill in your instance values. Click on Create to add the macro to your page.

Editing Existing Fields

If you already have a page with Data Field instances, you can edit them by going into the Confluence page editor, clicking on the corresponding macro placeholder, and entering your changes to the showing input panel.


Create a Field Query

StatustitleTODO
Image Added

Evaluation of Field Instances is done with Field Queries. A Field Query searches all current instances of a chosen Field Definition, when given matching a specified value filter and space filter. The results are listed in a nice table overview and can be downloaded as .csv-file.

Image AddedImage Added


Integration with Confluence’s Page Revisions

Status
titleTODO