[[File:UI_new_commissioning_task.png|190px|thumb|border|alt= UI Representation of Commissioning Task Objects|UI Representation of Commissioning Task Objects]]
{{Attention|Since Version 3.0.0 {{Version/AndroidSince|3.0.0}} Commissioning Objects are handled as [[MRO_Objects_(Client)]]}}
A [[SYSCLS_COMMISSIONINGCHECK|commissioning task]] is a special task object, which displays properties defining the status of the check on the row level directly.
There are two types of commissioning tasks,
* '''state relevant''' tasks which are indicated by a circle with or without a (solid/hollow) check symbol at the left side of the row as well as the "Not Applicable" icon. The later icon is a circle with a diagonal line in it at the end of the row.
* '''non state relevant''' tasks, which can be seen as some kind of informational object which do not have a status. This line is indicated by a white "i" as icon and does not have the "Not Applicable" icon.
A work package contains tasks of the above mentioned types. Once navigated to a work package an icon and a button are shown at the bottom of the screen. This button visualizes the overall status evaluated of all status of the underlying state relevant commissioning tasks. This means that, as long as at least a single child task is not finished the whole workpackage is regarded as (technically) not finished. The icon within the button visualizes the work package's status which is again a property assigned to the work package. This leads to four possible states of a work package:
* # Workpackage status OPEN | technical status OPEN* # Workpackage status FINISHED | technical status OPEN* # Workpackage status OPEN | technical status FINISHED* # Workpackage status FINISHED | technical status FINISHED
Clicking the button attemps at the bottom attempts to switch the workpackage status and if . If the workpackage is changed from '''open ''' to '''finished''', it triggers a sync of the whole workpackagework package. As some kind of convinience, popup editors for For all state relevant and not filled out (technically open) child tasks which have not be set an editor will pop up and give allowing the user the possibility to fill out enter the missing value but can be canceled of course. Cancelling the dialog leaves the task's value empty.
For now, it is possible to change underlying commissioning tasks even if the workpackage is finished.
{{Attention|If a Up to now, it is possible to change commissioning workpackage does not contain any commissioning checks or tasks even if they are not yet fetched by the server, the technical status displayed at the bottom left corner work package is FINISHED!finished already.}}
Following gallery should give an overview about all possibilities that can occur upon using this feature:{{Hint|If a commissioning work package does not contain any commissioning checks or if they are not yet fetched from the server, the technical status displayed at the bottom left corner is '''Finished'''!}}
The following images should give an overview about possible states occuring upon using this feature: <gallery widths="170200" heights="310">File:UI_new_commissioning_task.png|New commissioning workpackage(status 1)File:UI_commissioning_task_not_done_properly.png|Open commissioning workpackage with open child tasks(status 1)File:UI_commissioning_task_done_properlyUI_commissioning_during_finishing_with_applicable.png|Open commissioning workpackage with technically finished tasksFile:UI_commissioning_during_finishing.png|Convinience Convenience method for not technically finished tasks upon closing workpackage. Tasks can be marked as not applicable during finishing workpackages; The delete button is removed. {{Version/AndroidSince|2.5.2}}File:UI_commissioning_task_finished_not_properly.png|Finished commissioning workpackage with open child tasks(status 2)File:UI_commissioning_task_done_properly.png|Open commissioning workpackage with technically finished tasks (status 3)File:UI_commissioning_task_finished_properly.png|Finished commissioning workpackage with technically finished tasks(status 4)
</gallery>
== Technical Background ==
The status of work packages is essentially an Integer property. Currently its value definitions are as follows.
* Anything not greater than (≤) 0 indicates the package is open;
* Anything not less than (≥) 1 indicates the package is finished.
== See also ==