Tasks
The Tasks area can be accessed by selecting the Tasks tile from the home screen. The Tasks area allows Operatives to edit and complete tasks assigned to them, as well as create new tasks.
Upon entering the Tasks area, the Operative’s Task List will be displayed. This list contains all active Tasks currently assigned to the Operative, excluding any Tasks that have been deleted or completed. The Task List displays the name of each Task, and a Task can be opened by selecting it from the list.

Once a Task has been selected from the list page, it displays the information for the Task, such as the Name, Description, Assigned Personnel, Site, Plot and the attached images, each section and where the information is derived from is described below.
- Name – Displays the name for the Task, which is populated from the Name field entered when the Task was created within the Operative Portal, Admin System, or Mobile Application.
- Description – Displays the Description for the Task, which is populated from the Description field entered when the Task was created within the Operative Portal, Admin System, or Mobile Application.
- Site – The Task List displays the Site assigned to the Task, which is derived from the Site dropdown configured within the Task. If no Site has been assigned to the Task, this will state Unknown Site.
- Plot – The Task List displays the Plot assigned to the Task, which is derived from the Plot dropdown configured within the Task. If no Plot has been assigned to the Task, this will state Unknown Plot.
- Assigned Personnel – Displays who the Task is Assigned To, which is derived from the User field configured within the Task. Once a Task has been created within the Operative Portal or Mobile Application, the assigned users cannot be edited from the Operative Portal. If changes to the assigned users are required, they must be completed within the Admin System.
- Images – The Images section displays any images attached to the Task, which may be added from the Operative Portal, Admin System, or Mobile Application. Users can select and hold an image to display a menu containing a View Image option. Selecting this option will expand the image into a larger view. An X icon is displayed in the top-right corner of the expanded image, allowing the user to minimise and close the image view when required.
- Some images may display an amber Download icon. This indicates that the image was uploaded from another device and has not yet been downloaded to the current device. Selecting this icon will begin downloading the image, after which the image thumbnail will be rendered within the application and the image becomes viewable.
- Images displaying a green tick icon indicate that the image has successfully synchronised with the Admin System and Operative Portal. Images without a green tick are currently only stored locally on that specific mobile device until synchronisation has been completed.

To upload an image to a Task, the user must first open the required Task and enter Edit mode by selecting the Edit option in the top-right corner of the screen. Once Edit mode has been enabled, the Select Image and Take Photo buttons will become available.
Selecting the Select Image option will display the user’s photo library, allowing images to be uploaded from the device camera roll.
Selecting the Take Photo option will open the device camera, allowing the user to capture a new image. After a photo has been taken, the user will be presented with the options to either Retake the photo or Use Photo.
Access to the Select Image option is dependent on the status of the Allow Task Library Uploads checkbox within the user’s record in the Admin System. If this setting is disabled, the Select Image option will not be available to the user.
To delete an image, the user can select and hold the image to display the available menu options. If the image has not yet been synchronised with the Admin System or Operative Portal, an option labelled Delete Local Image will be displayed. Selecting this option will permanently remove the image from the task and it cannot be recovered.
Images that have already been synchronised are identified by a green tick icon. For these images, the Delete Local Image option will not be available when the image is selected and held.
Tasks themselves cannot be deleted from the Mobile Application. If a Task needs to be deleted, this must be completed by an administrator within the Admin System.
If the Task has been created from a Contract Manager Form submission within the Operative Portal or Mobile Application, an additional button labelled View Fix Report will be available within the Task. Selecting this button will display a report containing the completed Contract Manager Form along with all submitted responses. The report is displayed within a scrollable view, allowing the user to navigate through all pages of the report.

To mark a Task as Completed, the user must first open the required Task and enter Edit mode by selecting Edit in the top-right corner of the screen. The user can then enable the Mark As Completed slider so that it displays in green. Once this has been completed, the user must select Save in the top-right corner to apply the changes.
After the Task has been saved, it will immediately be marked as Completed. Completed Tasks are not displayed within the Task List. Once a task has been marked as completed, it will no longer appear in the user’s active Task List.
Task Messenger
The Task Messenger on the Mobile Application provides functionality so the Operative can chat back and forth with other Operatives, Contract Manager and Admin users on the Admin System.
When the user receives a Task message, the Tasks tile on the home screen will display a red notification indicator in the top-right corner of the tile. The notification indicator will contain a white number showing the total number of unread Task messages that require the user’s attention.

When the user enters the Tasks area, the Task List will display a red notification indicator to the right of any Task that contains unread messages. The notification indicator will contain a white number showing how many unread messages are associated with that specific Task.

When a Task is selected from the Task List, a chat bubble icon will be displayed within the Task. Selecting the chat bubble icon will open the Task chat, displaying all messages associated with that Task.

When the chat bubble icon is selected, the Mobile Application will display the Task chat, showing all messages associated with that Task. Within the chat view, each message displays the date and time it was sent.
The Mobile Application displays a timestamp for when each message was sent. If the same user sends multiple messages within a five-minute window, those messages are grouped under a single timestamp.
To send a Task message, the user can enter text into the message field located at the bottom of the page and then select the Send icon. Pressing Return on the keyboard will create a new line within the message field, allowing the user to format their message as required.

The Task chat can receive messages from other Operatives or Contract Managers who are assigned to the Task through either the Operative Portal or Mobile Application. Messages sent by other users will display the sender’s name above the message content to identify who sent the message.
The Task chat can also receive messages from users within the Admin System, regardless of whether those users are assigned to the Task or not.
The application also provides functionality for viewing the exact time a message was sent. Users can select and drag a message to the right, which will display the precise timestamp for that message.

Each time the user receives a new Task message, the application will send a push notification to the user’s device. The title of the notification will display the Task Name, followed by the name of the user who sent the message and the message content itself.
Selecting the push notification will open the application and navigate the user to the home screen.

If the user is offline when accessing the Mobile Application, the Message field within the Task chat will be disabled, as messages cannot be sent while the device is offline.
In addition, the status indicator displayed in the top-right corner of the chat screen will appear red to indicate that the user is not currently connected to the chat service and will not receive new messages until connectivity has been restored.

Creating a New Task
The Tasks area allows Operatives to create new Tasks, assign them to admin users, enter Task details, and attach images where required.
To create a Task within the Mobile Application, the user must first enter the Tasks area and then select the + button located in the top-right corner of the screen. The application will then navigate the user to a new Task page where the Task details can be entered, as described below.

Each field within the new Task details page is described below.
- Name – The Name field is a free-text field that allows the Operative to enter the required Task name. The Name field is mandatory when creating a Task. A Task cannot be created unless a Task name has been entered into the field.
- Description – The Description field is a free-text field that allows the Operative to enter the required description for the Task.
- Site – The Site dropdown lists all non-deleted Sites assigned to the user currently signed in, allowing the user to select the relevant Site for the Task. Once a Site has been selected, the Plot dropdown will be populated with all non-deleted Plots associated with that Site. Selection of a Site is not mandatory when creating a Task.
- Plot – The Plot dropdown is only populated once a Site has been selected. This dropdown lists all non-deleted Plots associated with the selected Site, allowing the user to select the relevant Plot for the Task. The selection of a Plot is not mandatory to create a Task.
- Assign Users – The Assign Users section allows the user to select one or more admin users to assign to the Task. At least one user must be selected before the Task can be created.
- Images – The Images section provides two upload options: Select Images and Take Photo. Selecting the Select Images option will open the user’s photo library, allowing images to be uploaded from the device camera roll. Selecting the Take Photo option will open the device camera, allowing the user to capture a new image that will be uploaded to the Task. After a photo has been taken, the user will be presented with the options to either Retake the photo or Use Photo. Once the photo has been confirmed, it will automatically be added to the Task.

The Add Task button at the bottom of the page will be greyed out and disabled until the required information has been entered.

Once the user has entered the required Task details, such as a Task Name and Assignee, they can select the Add Task button located at the bottom of the page to create the Task.

After the Task has been created, the Operative who created the Task will no longer be able to view it within their Task List, as they are not assigned to the Task by default.