Configuring jobs in the Worklist

The Worklist allows you to download jobs from your organisation’s 1Spatial Management Suite server to a user’s machine to perform offline, in-field editing. When the job is complete and the machine is re-connected to the Internet, the user can upload edits back to the server to merge changes into the central database.

The worklist icon is displayed when there is a config file present that enables 1Edit to connect to the 1Spatial Management Suite. This file must be placed in a config folder within the application's local storage location, for example: C:\Users\<username>\AppData\Local\Packages\1Edit_qw7y987j427n8\LocalState\Config

and must have the following contents:

<services>

<worklistroot>http://preamble.server.com/wf</worklistroot>

</services>

To use the Worklist to create projects, you must have a template in place. See Using templates for more details.

The 1Spatial Management Suite provides the following lifecycle for a job:

    1. A job is allocated by a planner to the user or to a group of users according to the organisation.

    2. A single user picks up the job to work on it. A job can only be activated and worked on by a single user. When a job has been activated, the server will automatically prepare a work package ready for the user. This task may take a variable amount of time depending on the size of the job.

    3. The work package is prepared and is ready for download to the current machine.

    4. The user downloads the work package associated with the job to their local machine. The work package includes all the spatial data that can be edited in performing the job, along with some surrounding data for context. It also can include raster data and other resources to assist in performing the work.

    5. The user finishes the work and uploads the changes to the server. The changes are normally then validated. At this point, jobs are either:

·      Invalid: the job fails validation and a child job is created to correct the validation error, or

·      Committed: the edits in the job are valid and are applied to the central database. Jobs will be no longer visible in the user's worklist.

Using the Worklist

The Worklist allows you to view jobs that have been allocated to you and/or your work group using the 1Spatial Management Suite.

Jobs are grouped into the following columns:

·      Allocated

·      Activated

·      Prepared

·      Downloaded

·      Uploaded

·      Invalid

·      Conflicted

Click Icon-worklist.jpg on the Projects page to open the Worklist page, then enter your login details. A list of jobs is displayed, in columns according to status.

The job list is automatically refreshed when new jobs are allocated to you and/or your work group.

Click the job to view further information.

The buttons that are displayed depend on the available options for the job in the work flow, and this depends on the current status of the job. For example, a job that is allocated to you can then be activated using the Activate Job icon:

Icon-activate_job.jpg

Using the icons, you can:

Jobs can be deleted and revoked using the 1Plan web interface only.

Jobs can have the following statuses:

·      Activated: After a job has been allocated to a user or group, the job can then be activated. When a job is activated, the server prepares a work package, the job's status is changed to Prepared, and moves into the In Progress column. Click on an allocated job then click Icon-activate_job.jpg A workspace is created for the job, and the job is displayed in the Prepared column. The job can then be downloaded or relinquished. If a failure occurs during activation, the job reverts to an Allocated status.

·      Downloaded: Prepared jobs can be downloaded to the current machine. The downloaded job can then be opened as a project in 1Edit. The first time a project is created from a downloaded package, a new project is created based on the data in the package, setting up default styles and schema for your organisation. After this point, the project can be opened from the Projects page in 1Edit, taking you back to your current edits.

Click the job then click Icon-download.jpg A message is displayed to verify whether or not the download was successful. Click Yes if the job downloaded successfully. The job is displayed in the Downloaded column.

·      Uploaded: When the edits are complete and your machine is re-connected to the internet, work can be uploaded to the 1Spatial Management Suite server for validation and re-integration with the central database.

Select a downloaded job and click Icon-upload.jpg In the Job Upload Details panel, enter the time taken to perform the job (in minutes) and a description of the change. Both fields are compulsory. Click Ok. 1Edit prepares a file containing the changes made since the job was downloaded and sends this file to the 1Spatial Management Suite server. If the job passes validation and is successfully committed to the database, the job's status changes to Completed and is no longer present in the 1Worklist interface.

·      Relinquished: Downloaded or activated jobs can be relinquished by users if they cannot perform a job that they have activated or has been allocated to them. Users can return the job to the list of allocated jobs at any point until they upload changes.

To relinquish a job, click Icon-relinquish.jpg and enter a reason for relinquishing the job and any comments, if applicable.

Click OK to return the job to the allocated list for another user to pick up. The user assigned to the job is removed, the job package is deleted from the schema, the workspace is deleted, and the job is no longer displayed in the user's worklist. The job's work group is retained however, and the job will still appear in the worklist for all members of that group. After a job is revoked, its status changes to Proposed.

·      Completed: If a job passes validation and is successfully committed to the database, the job's status changes to Completed and will no longer appear in the worklist interface.

Jobs can be deleted and revoked using the 1Plan web interface only.

Resolving job conflicts and errors

If a job fails validation, a child job is created (containing the edits of the current job) containing information about the errors and is returned to the planner for allocation. From this point, it is handled in the same way as a normal job and can be picked up by any user, depending on the setup of the organisation.

Jobs that fail validation contain additional information to create bookmarks in 1Edit, which allows you to view validation errors that need to be corrected.

When these errors have been corrected, the validation failure job is uploaded to the 1Spatial Management Suite server and the changes are applied to the parent job (that is, the job that originally failed validation.) The job is then re-validated; if it passes validation, both the parent and child job moves to a Completed status. If the job fails validation, another child job is created to allow for corrections.