Jobs and Automation

A Job represents the execution of a function (tool) on a file. Jobs are used for operations like extracting artifacts, running transformations, and processing data.

View Your Jobs

1. Click Jobs in the sidebar (or navigate to /jobs).
2. By default, you see the My Jobs tab listing jobs you have created.
3. The jobs table shows:
   • Tool / Function — the tool and function that was executed
   • Job ID — first 6 characters of the UUID with ellipsis (click to copy the full ID)
   • Started On — the date and time the job was started
   • Status — current job status badge
   • Actions — cancel button for pending jobs

View All Jobs (Admin)

1. Navigate to the Jobs page.
2. If you are an administrator, you will see two tabs: My Jobs and All Jobs.
3. Click the All Jobs tab to see jobs from all users in the organization.

Non-admin users only see the My Jobs view (no tab switcher is shown).

Create a Job (Run a Function)

From the Files Page

1. Navigate to Files and select a file.
2. In the bottom Activity panel, click Create job (or Run Function).
3. In the Create Job dialog:
   • Select a Tool/Function: Browse the available tools and functions in the command list.
   • Select a Tool Version (if multiple versions are available).
   • Configure Parameters (if the selected function requires input parameters).
   • Advanced Options: Expand to choose an Agent or Agent Pool (Automatic by default, or select a specific agent/pool).
4. Click Execute Function to start the job.

From a System Page

1. Open a system and select a file in the snapshot tree.
2. If the file has functions available, the Create Job dialog can be opened from the file details panel.
3. Follow the same steps as above to configure and execute the function.

Extract Artifacts from a File

"Extract" is a specific job type that processes a file to produce viewable artifacts.

From the Files Page

1. Select a file that has no preview (you will see a "No Preview Available" message).
2. Click the Extract button in the empty state.
3. The Create Job dialog opens pre-configured for extraction — configure and execute.

From a System Page

1. In the snapshot file tree, right-click (or use the context menu) on a file.
2. Select Extract.
3. The system runs the appropriate extract function automatically.

Required role (System): Editor or above on the system.

View Job Details

1. From the Jobs page: Click the Tool / Function link on any job row.
2. From the Files page: Click a job in the Activity panel, or click a job group name in the file tree or artifacts browser.
3. The Job Details dialog shows:
   • Status with icon
   • Job ID
   • Tool Name and Function Name
   • Agent Name, Agent Assignment, Agent ID, and Pool Assignment (when assigned to a pool)
   • Started On date and Started By user
   • Inputs section (only visible to the job creator): Lists the input files with name, type, and size.
   • Status History: A collapsible table of all status transitions with timestamps.

You can also view job details by navigating directly to /jobs/:jobId.

Cancel a Pending Job

1. Navigate to the Jobs page or the Activity panel on a file.
2. Find a job with Pending status.
3. Click the X (cancel) button in the Actions column.
4. The job status will change to Canceled.

Only jobs in Pending status can be cancelled.

Job Statuses

Status	Description
Pending	Job is queued, waiting for an agent to pick it up
Claimed	An agent has claimed the job
Running	The job is actively executing
Validating	Output is being validated
Uploading	Results are being uploaded
Completed	Job finished successfully
Failed	Job encountered an error
Canceled	Job was cancelled by a user

Active jobs (Pending, Claimed, Running, Validating, Uploading) show a spinner indicator. When a job completes successfully, you will receive a browser notification and an audio cue. Failed and canceled jobs show a toast notification only.