Versions Compared

Key

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

What's the difference between Field Instance, Field Definition and Field Query?

A Field Definition ist is the highest level of abstraction. It defines an abstract object, that can be instantiated abitrarily arbitrarily often, with different, independent values.
A Field Defintion is used to define a typed input field, give it a label and possibly group multiple input fields together.

The concrete actual creation of an instance, filled with values, placed in a concrete on an actual page is called Field Instance.

These Instances can be analyzed with Field Queries. They take a Field Defintion and collect all matching instancesInstances. Changes to a Field Instance are directly reflected in a matching Field Query.

How do I copy a Field Instance to another Confluence page?

Copying is not support by Data Field Instances. To instantiate a new Filed Instance, add a new Data Field Instance macro and fill it with the required values.

How do I integrate Managed Data Fields into Confluence page templates?

Managed Data Fields can be perfectly integrated with Confluence blueprints. Whether you want to insert a placeholder Field Instance to be filled with values when the user creates a page from the blueprint, or if you preset values while defining the template.
Both - Field Instances and Field Query - will work like a charm.

What happens when I delete a Field Definition?

Usually, all changes to Field Defintions are directly applied to all matching Field Instances. When possible, existing instances are merged with the changes applied to the definition.

When a Field Defintion is deleted completely deleted, all Field Instances matching this Definition are of course preserverdpreserved. The app will not delete any data without your approval.
A Field Instance without an underlaying Field Definition is marked with a little hint.
Additionally, they are still found by Field Queries runnig on the old Field Definition. However, these Queries cannot be edited anymore.