# GuiObjectListViewType (Complex Type)

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

Supertype: GuiObjectListPanelConfigurationType
Specifies the page used to list specific object type or object collection.

Item Summary
Name | Type | Multiplicity | Description
--- | --- | --- | ---
$itemDefinition.Name.LocalPart | property string | [0,1] | GUI feature identifier.
$itemDefinition.Name.LocalPart | property string | [0,1] | Free-form description (comment) intended for system administrator.
$itemDefinition.Name.LocalPart | container DisplayType | [0,1] | Display properties of the UI feature.
$itemDefinition.Name.LocalPart | property UserInterfaceElementVisibilityType | [0,1] | Defines, whether this feature will be visible or it will be hidden.
$itemDefinition.Name.LocalPart | property int | [0,1] | The content of this property specifies an order in which the user interface feature should be displayed relative to other similar features that are displayed together.
$itemDefinition.Name.LocalPart | container SearchBoxConfigurationType | [0,1] | Configuration of the search box (the set of input fields that control definition of search query).
$itemDefinition.Name.LocalPart | property DistinctSearchOptionType | [0,1] |
$itemDefinition.Name.LocalPart | container GuiObjectColumnType | [0,-1] | Configuration of the object list column.
$itemDefinition.Name.LocalPart | property boolean | [0,1] |
$itemDefinition.Name.LocalPart | property string | [0,1] | Symbolic name for this view.
$itemDefinition.Name.LocalPart | property QName | [0,1] | Type of displayed objects.
$itemDefinition.Name.LocalPart | container CollectionRefSpecificationType | [0,1] | Specification of an explicit or implicit object collection that will be used to select objects in this view.
$itemDefinition.Name.LocalPart | reference ObjectReferenceType | [0,1] | DEPRECATED.
$itemDefinition.Name.LocalPart | container GuiActionType | [0,-1] | List of actions for this view.
$itemDefinition.Name.LocalPart | container GuiObjectListViewAdditionalPanelsType | [0,1] | Configuration of additional panels that can be present in some view types.

- ### Items

  - #### $itemDefinition.Name.LocalPart

    Flags: RAM,runtime

    Multiplicity: [0,1]

    GUI feature identifier. E.g. idetifier for view or widget. The feature specifications that come from different roles will be merged if they have the same identifier. The identifier is also used for diagnostics, e.g. used in the logfiles.

    Although identifier type is defined as string, it is strongly recommended to use URI for all customizations. The URI should be based on identifier that you own (e.g. DNS domain). Using non-URI forms may still work, but there is risk of conflicting with default midPoint configuration.

    If no identifer is specified for a view then midPoint will internally generate a value for the identifier. This internal identifier value is based on the GUI feature definition, e.g. object type and/or collection OID or other aspects of the view. The algorithm for identifier generation may change and the results are not guaranteed to be completely unique. Therefore it is strongly recommended to explictly set identifier for all the UI features in any non-trivial midPoint configuration.

    Identifier may not be needed at all in some cases (e.g. additionalPanels in views).

  - #### $itemDefinition.Name.LocalPart

    Flags: RAM,runtime

    Multiplicity: [0,1]

    Free-form description (comment) intended for system administrator. Description will NOT be displayed as any part of the UI feature. The purpose is to explain the purpose or configuraiton details.

  - #### $itemDefinition.Name.LocalPart

    Flags: RAM,runtime

    Multiplicity: [0,1]

    Display properties of the UI feature. It is used to display the link in the menu and so on. Only some parts of display specification may be used. E.g. for views only label is used now. E.g. the CSS properties are ignored.

  - #### $itemDefinition.Name.LocalPart

    Flags: RAM,runtime,AVals:4

    Multiplicity: [0,1]

    Defines, whether this feature will be visible or it will be hidden.

    The default (since 4.0) is 'automatic', which means that all defined features will be visible if possible, unless explicitly hidden. However, this can be changed, e.g. by setting default visibility in the dashboard definition. Also, some hardcoded dashboards have different defaults. E.g. the legacy 3.x end-user home page has default visibility of "vacant".

  - #### $itemDefinition.Name.LocalPart

    Flags: RAM,runtime

    Multiplicity: [0,1]

    The content of this property specifies an order in which the user interface feature should be displayed relative to other similar features that are displayed together. E.g. this may be used to order views in the menu, widgets on the dashboard and so on. These items that do not have any displayOrder definition will be displayed last. Items with the same displayOrder are displayed in alphabetic order.

  - #### $itemDefinition.Name.LocalPart

    Flags: RAM,runtime

    Multiplicity: [0,1]

    Configuration of the search box (the set of input fields that control definition of search query).

  - #### $itemDefinition.Name.LocalPart

    Flags: RAM,runtime,AVals:2

    Multiplicity: [0,1]

  - #### $itemDefinition.Name.LocalPart

    Flags: RAM,runtime

    Multiplicity: [0,-1]

    Configuration of the object list column. This is supposed to be universal mergeable configuration. It may be specified in global configuration, roles but also in user's preferences. Therefore it may refer to the columns specified by the "higher" configuration and override some parts of that (e.g. hide/show columns, change ordering, etc.). When merging the configurations there is no way how to remove columns. New columns may be added, setting of the existing columns may be changed, but the columns may not be removed. If the columns should not be displayed then it may be hidden.

  - #### $itemDefinition.Name.LocalPart

    Flags: RAM,runtime

    Multiplicity: [0,1]

  - #### $itemDefinition.Name.LocalPart

    Flags: RAM,runtime

    Multiplicity: [0,1]

    Symbolic name for this view. It is used as a view identifier. Views with the same name will be merged together. The name is used to detect whether a particular view is overriden, e.g. if view defined in system configuraiton is overridden in the role. It may also be used by other system components (e.g. dashboard widgets, reports) to refer to this view. It will also be used for diagnostics, logging and so on.

    DEPRECATED. Use identifier instead.

  - #### $itemDefinition.Name.LocalPart

    Flags: RAM,runtime

    Multiplicity: [0,1]

    Type of displayed objects. It may not be present in case that the type is defined in a referenced object colleciton.

  - #### $itemDefinition.Name.LocalPart

    Flags: RAM,runtime

    Multiplicity: [0,1]

    Specification of an explicit or implicit object collection that will be used to select objects in this view. If no collection is specified then it is assumed that all objects of a particular type has to be displayed (type element above is mandatory in that case).

  - #### $itemDefinition.Name.LocalPart

    Flags: RAM

    Multiplicity: [0,1]

    DEPRECATED. Use "collection" element instead.

  - #### $itemDefinition.Name.LocalPart

    Flags: RAM,runtime

    Multiplicity: [0,-1]

    List of actions for this view. Actions are special things that can be done with particular object or list of objects.

  - #### $itemDefinition.Name.LocalPart

    Flags: RAM,runtime

    Multiplicity: [0,1]

    Configuration of additional panels that can be present in some view types. E.g. configuration of "managers" and "members" panels in orgstruct views.