# 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] |
binding | property VariableBindingDefinitionType | [0,1] |
display | container FormItemDisplayType | [0,1] |
widget | property string | [0,1] | Name of the UI widget that should be used to display this item.
validation | property FormItemValidationType | [0,1] |
formItems | property FormItemsType | [0,1] |

- ### Items

  - #### name

    Flags: RAM,runtime

    Multiplicity: [0,1]

  - #### description

    Flags: RAM,runtime

    Multiplicity: [0,1]

  - #### binding

    Flags: RAM,runtime

    Multiplicity: [0,1]

  - #### display

    Flags: RAM,runtime

    Multiplicity: [0,1]

  - #### widget

    Flags: RAM,runtime

    Multiplicity: [0,1]

    Name of the UI widget that should be used to display this item. Normally, the widget will be chosen automatically based on the type of the backing item (see "ref" element). The "widget" element can be used to override this default behavior. It is used for default included types like text, label, combo, password, checkbox, etc. or class name for custom implementation. NOTE: widget was never really working it will probably not work. It is deprecated now. Later on it will be replaced by an equivalent setting in FormItemDisplayType.

  - #### validation

    Flags: RAM,runtime

    Multiplicity: [0,1]

  - #### formItems

    Flags: RAM,runtime

    Multiplicity: [0,1]