Jump to: navigation, search

Changes


Commissioning Objects (UBIK Android)

283 bytes added, 15:39, 3 August 2015
A commissioning task is a special task, which is able to display the property which defines the status of the check directly on row level.
There are two types of commissioning tasks, on one hand state relevant task which are indicated by either the cross a circle with or without a check icon at the beginning of the row as well as the "Not Applicable" label and Checkbox icon which is a circle with a diagonal line in it at the end of the row. On the other hand, there are not state relevant tasks, which can be seen as some kind of information object which do not have a status. The information object is indicated by the white circle "i" as icon where state relevant tasks display the current status. Further it do not have the "Not Applicable" checkboxicon.
All commissioning tasks no matter of what type are intended to be nested into a parent object called commissioning workpackage, which provides the functionality to close all underlying tasks and synchronize them with the server, may triggering some further functionality there.
{{Attention|A commissioning task is finished only if a value is entered as property, or the "Not applicable" checkbox icon is ticked toggled accordingly. A value is entered if the property is not null, which means that even a boolean property false is valid!. The boolean status is reflected through the checkbox color, the checkbox is dark blue if it has not been set yet, white with a checksign if true and white and empty if it is false.}}
== Information commissioning task ==
Like mentioned before, this task is indicated by the white circle "i" in front of the rest of the row. It is originally intentioned to hold further information for the user, like a manual additional photos or just as a note for the engineer which is not relevant for the status of the whole commissioningprocess. Nevertheless, it is possible to give it a value like the other tasks which is of course synchronized with the server at least if the commissioning workpackage gets finished.
== State relevant commissioning task ==
All tasks like checking if a functional plan is available, certain protocolls are in place and updated or entering some specific values is handled with these tasks. It is also possible to check a task as "Not Applicable" if a task is not possible to be done at the moment but should be seen as finished.
The icon leading the row is indicating the completion status of the task. A task is finished once the value is not null OR the "Not Applicable" checkbox icon is tickedtoggled. This means even a boolean property FALSE means a task is finished. It is possible to both fill out a tasks property and toggle it as "Not Applicable".
== Commissioning Workpackage ==
[[File:UI_commissioning_big_picture.png|220px|thumb|border|alt= Architecture of status calculation|Architecture of status calculation]]
A workpackage contains tasks of the above mentioned two types. The UI is showing an extra line on bottom of the content browser once navigated into a workpackage which shows two icons an icon and a buttonwith an integrated icon. Both icons indicate a differnt kind of status, the left The standalone button visualizes the workpackage status which is a property assigned to the workpackage. The other icon is calculated as sum of all status of underlying state relevant commissioning tasks which means that as long as at least a single child object is not finished and therefore shows a red crossan empty circle, the whole workpackage is regarded as (technically) not finished. The icon within the button visualizes the workpackage status which is a property assigned to the workpackage. Resulting out of this, a workpackage has four possible states:
* Workpackage status OPEN | technical status OPEN
For now, it is possible to change underlying commissioning tasks even if the workpackage is finished.
{{Attention|If a commissioning workpackage does not contain any commissioning checks or if they are not yet fetched by the server, the technical status displayed at the bottom right left corner is FINISHED!}}
Following gallery should give an overview about all possibilities that can occur upon using this feature:
166
edits