Work item status and actions
- Updated: 2025/09/11
Work items can be created in bulk via CSV upload or REST API, progressing through states such as Draft, New, Ready to run, On hold, Active, Completed, Failed, and Unknown. Each state allows specific actions, depending on the work item's current status.
Work item status
You can create work items in bulk by uploading them through a CSV file or by using the REST API. When you upload a large number of work items using a CSV file, they are inserted in multiple batches and the state of newly inserted work items is marked as Draft until all of them are inserted from the file. Following is the description of various work item states:- Data error: When work items have invalid data (while inserting from a CSV file), they are marked as Data error.
- New: When all the work items are inserted successfully, the work item state is marked as New.
- Ready to run: When a work item is cached and ready to process, the work item state changes from New to Ready to run.
- On hold: When you do not want to process a work item, you can mark the work item as On hold.
- Active: When a work item is being processed by a device, the state is changed to Active.
- Completed: When a work item is processed successfully, the state is marked as Completed.
- Failed: When a work item fails during processing, the state is marked as Failed.
- Unknown: When a device fails to report back on the state of work item processing, it is marked as Unknown.
Status and applicable actions
In WLM, each work item progresses through specific states during its lifecycle. The actions you can perform on a work item depend on its current state. The following table provides a description of each Work Item state and the actions you can perform on work items in that state:
Work item state | Description | Actions |
---|---|---|
Data Error | Data type mismatch when adding Work Items to the queue | View, Edit, and Delete |
New | New Work Item is added | View, Edit, and Delete |
Ready to run | Work Item is successfully processed for execution | View, Edit, and Delete |
On hold | Work Item is deferred for use by the queue administrator | View, Edit, and Delete |
Active | Work Item is currently being processed | View and Edit |
Completed | Work Item successfully processed by a device | View and Delete |
Failed | Work Item processing has failed to execute on unattended devices | View, Edit, and Delete |
Unknown | Work Items that are not identified by any of the devices | View, Edit, and Delete |