# FormFieldGroupType (Complex Type)

### Namespace: http://midpoint.evolveum.com/xml/ns/public/common/common-3

Supertype: AbstractFormItemType

A group of fields. The group is rendered in a such a way that it will be obvious that the fields belong together and form a a logical group (e.g. by using box with a border). This can be used to display value of complex containers. But it may also be used to visually group together a set of related properties that are not in the same container.

The group is NOT meant to automatically generate fields for every container item. Individual fields must be defined as sub-items of this group.

If ref element is used it MUST point to PrismContainer. In that case subitems of this group must point to the container value items.

The group may not have any ref element. In that case the subfields may refer to any property.

Item Summary
Name | Type | Multiplicity | Description
--- | --- | --- | ---
name | property string | [0,1] |
description | property string | [0,1] | Free-form textual description of the object.
documentation | property string | [0,1] | Technical documentation for a particular object or construct.
binding | property VariableBindingDefinitionType | [0,1] |
display | container FormItemDisplayType | [0,1] |
validation | property FormItemValidationType | [0,1] |
formItems | property FormItemsType | [0,1] | List of group subitems.

- ### Items

  - #### name

    Flags: RAM,runtime

    Multiplicity: [0,1]

  - #### description

    Flags: RAM,runtime

    Multiplicity: [0,1]

    Free-form textual description of the object. It is supposed to describe the object or a construct that it is attached to.

    This information may be presented to midPoint users, even to ordinary end users. For example role description may be presented to users when they are selecting roles to request. Therefore the description should be written in a language that the users can understand.

    Description is assumed to be a plan, non-formatted text. Amount of white space is considered insignificant. E.g. leading and trailing white space may be skipped, multiple spaces can be collapsed to one and so on.

  - #### documentation

    Flags: RAM,runtime

    Multiplicity: [0,1]

    Technical documentation for a particular object or construct.

    The purpose of this element is to document system configuration and behavior. The documentation will not be presented to end users. In fact, it will probably not be presented at all in midPoint user interface. This documentation element is supposed to be a part of the technical documentation of midPoint deployment. The tools than generate deployment configuration will look for these elements and combine them to compiled documentation document.

    AsciiDoc formatting is assumed for this element. Any leading or trailing whitespace is skipped. Indentation equivalent to he indentation of the first non-blank line of text is also skipped.

  - #### binding

    Flags: RAM,runtime

    Multiplicity: [0,1]

  - #### display

    Flags: RAM,runtime

    Multiplicity: [0,1]

  - #### validation

    Flags: RAM,runtime

    Multiplicity: [0,1]

  - #### formItems

    Flags: RAM,runtime

    Multiplicity: [0,1]

    List of group subitems.