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:
A job is allocated by a planner to the user or to a group of users according to the organisation.
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.
The work package is prepared and is ready for download to the current machine.
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.
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.
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
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:
Using the icons, you can:
Activate jobs: to activate a job that has been allocated to you
Download jobs: to download a work package to the current machine
Upload jobs: to submit jobs after relevant edits have been made and completed to your work area
Relinquish jobs: to remove a downloaded or activated job from your worklist
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 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
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
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
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.
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.