# GuiActionType (Complex Type)

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

Actions are special things that can be done with particular object or list of objects. Action may be a task, or (later) a script, java class or any similar mechanism.

Item Summary
Name | Type | Multiplicity | Description
--- | --- | --- | ---
name | property string | [1,1] | Action short name (identifier).
description | property string | [0,1] | Free-form description.
documentation | property string | [0,1] | Technical documentation for a particular object or construct.
display | container DisplayType | [0,1] | Specification of action display properties.
taskTemplateRef | reference ObjectReferenceType | [0,1] | Reference to task template.

- ### Items

  - #### name

    Flags: RAM,runtime

    Multiplicity: [1,1]

    Action short name (identifier). This element is not displayed to the user. It is used for identification of the action and referencing (e.g. previous column). The definitions that have the same name in different layers (global, role, user) will be merged together.

  - #### description

    Flags: RAM,runtime

    Multiplicity: [0,1]

    Free-form description. It is not displayed to the user. It is supposed to be used by system administrators to explain the purpose of the configuration.

  - #### 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.

  - #### display

    Flags: RAM,runtime

    Multiplicity: [0,1]

    Specification of action display properties. (Only label is implemented in midPoint 3.9)

  - #### taskTemplateRef

    Flags: RAM

    Multiplicity: [0,1]

    Reference to task template. The template will be used to start a new task for the selected object or objects.