Work with jobs

A job is the highest level of work that the application or an individual user can submit to the RPF for processing. The jobs can be file processing operations, database operations, or other processing operations.

Jobs contain stages, which contain tasks. System administrators, portal administrators, and case administrators can view all jobs and associated stages and tasks in their system, portal, or case, respectively. Administrators can pause, restart, or cancel processing and queued jobs, and change the priority level for the RPF to process the job. Administrators can also add new jobs for processing.

View jobs

On the processing dashboard, the Recent Jobs section lists currently processing and completed jobs.

To view jobs:

On the Portal Home page, under Portal Management, click Processing.

The processing dashboard appears.

To view all jobs, click View all jobs. Or, in the navigation pane, click Jobs.

The following table describes the information on the Jobs page.

Note: For portal administrators, when organization security is enabled, the list of available items depends on membership in a provider or client organization. To understand how organizations are managed in Nuix Discover, see Organizations. For a summary of how organization security affects portal access for each user category, see Portal security table.

Column	Description
(Job status icon)	Hover over the icon to view information about the status.
Job ID	The unique identification number assigned to a job. Hover over the ID to view the case in which the job was created. Click the ID to view the job's stages.
Type	The job category, which is a high-level description of the submitted job.
Portal	The name of the SQL Server database associated with the portal. Note: This may be different than the portal name.
Organization	The provider or client organization associated with the job.
Case	The case with which the job is associated.
Priority	The job's rank. This can be Low, High, or Immediate. If multiple jobs are scheduled to run at the same time, the job with the higher priority runs first.
Start	The date and time that the job started.
Duration	The amount of time it took to complete the job.
Progress	The job's processing progress, shown as a percentage.

To view all jobs processed in the system, portal, or case, or that have been processed in the last 7, 30, or 60 days, select an option on the View jobs menu.

View job properties

To view the details of a job:

On the Portal Home page, under Portal Management, click Processing.

In the navigation pane, click Jobs.

Click a Job ID number.

In the navigation pane, click Properties.

View job stages and stage properties

A stage is a collection of tasks that is associated with a job.

To view job stages and stage properties:

On the Portal Home page, under Portal Management, click Processing.

In the navigation pane, click Jobs.

Click a Job ID number.

The following table describes the information on the Stages page.

Column	Description
(Stage status)	Hover over the icon to view information about the status.
Name	The name of the stage. Click to view the stage's tasks.
Tasks Completed	The number of tasks completed out of the total number of tasks in the stage's queue.
Duration	The amount of time it took to process the stage.
Start	The date and time that the stage started.
Progress	The stage's processing progress, shown as a percentage.

To view the stage's properties, click a stage name, and then click Properties in the navigation pane.

View stage input and output detail

You can view a stage's XML input, which is the XML set that provides instructions for a particular stage. You can also view the XML output produced for the previous stage. This information is useful when troubleshooting jobs, as some workers have a stage that depends on a previous stage's worker.

To view a stage's input and output detail:

To open the Stages page, do the following:

On the Portal Home page, under Portal Management, click Processing.

In the navigation pane, click Jobs.

Click a Job ID number.

On the Stages page, click a stage name.

In the navigation pane, click XML.

View stage tasks and task properties

A worker performs tasks when processing a job in the RPF. A task contains most of the information the worker needs to perform its function.

To view the tasks of a stage:

To open the Stages page, do the following:

On the Portal Home page, under Portal Management, click Processing.

In the navigation pane, click Jobs.

Click a Job ID number.

On the Stages page, click a stage name.

The following table describes the information that appears on the Tasks page.

Column	Description
Task ID	The unique number for the task.
Start	The date and time that the task started processing.
Duration	The amount of time it took to complete the task.
Supervisor	The name of the supervisor executing the task.
Status	The task's status.
Progress	The task's processing progress, shown as a percentage.

To view task properties, click a task ID.

View task input, output, and error detail

You can view a task's XML input, which is the XML set that provides instructions for performing a particular task. You can also view the XML output produced for tasks that succeeded with warnings. Additionally, you can view error data for tasks that encountered processing errors.

Note: Task output data is available only for stages that succeeded with warnings. Task error data is available only for tasks that failed or succeeded with warnings.

To view a task's input and output detail:

To open the Stages page, do the following:

On the Portal Home page, under Portal Management, click Processing.

In the navigation pane, click Jobs.

Click a Job ID number.

On the Stages page, click a stage name.

On the Tasks page, click a Task ID.

In the navigation pane, click XML.

Download job details

You can download full job details across all stages of the job.

To download job details:

To open the Stages page, do the following:

On the Portal Home page, under Portal Management, click Processing.

In the navigation pane, click Jobs.

Click a Job ID number.

On the Stages page, click Download job.

The downloaded XML file includes all details from the job, including XML from every stage and task.

Add jobs

You can add the following job types for processing.

Job type	Description
Gather case metrics	Scans the full file system to collect aggregate data about the case. The job reconciles files with the application, including any folders that do not correspond to levels. Note: This job could take several hours for large cases with complex file system hierarchies. For the Ingestions feature, the Gather case metrics job captures the total expanded items size for all Ingestions jobs that succeeded or that succeeded with warnings. For hosted data, the Gather case metrics job scans the File Transfer and Archive repositories that are configured for a case. If a case uses an Elasticsearch index, the Gather case metrics job captures the size of the Elasticsearch index. The Elasticsearch index is used to capture the coding audit history. When you run a Gather case metrics job, in addition to capturing the file size of the image, native, and content files associated with base documents, the application captures the total file size of the image, native, and content files associated with non-document entity items. This information appears in the Base documents (GB) column on the Portal Management > Reports > Hosted Details page.
Indexing and enrichment	Automatically runs the following tasks in the following order: Page count, which calculates page counts and updates the database accordingly for any content file find documents and any documents with a null or 0 (zero) page count Content file find Optical character recognition (OCR) processing for documents without content files, if the OCR documents without content files option on the Case Options page is enabled. For information about OCR processing, see Run OCR processing. Indexing Note: As of Nuix Discover version 10.6.005, for the Predictive Coding and Production features, Nuix Discover is configured (by default) to skip email headers for .msg files during indexing. To apply this change, you must reindex your case. Concept analysis Search term families for families configured to run automatically HTML extraction, excluding the following files: Files with sizes over the limit specified in the Agent maximum file size option on the Portal Options page. Files of standard image types, including the following file name extensions: .tiff, .tif, .jpg, .jpeg, .png, .gif, .bmp, .au, .snd, .wav, .mp3, .aif, .aiff, .aifc, .wma, .mpeg, .mpg, .mov, .mpe, .avi, .divx, .asx, .wmv, .movie, and .swf. Gather case user metrics Gather case aggregate metrics
Search term family	Processes all search term families in the case. Tip: To run a search term family job for one or more, but not all, search term families in a case, update families individually on the Search Term Families page in the case.

Note: Because concept analysis now runs as part of indexing and enrichment jobs, previously scheduled concept analysis jobs are obsolete and should be removed. For information about how to remove a job, see Edit jobs.

For information about how to schedule a recurring job, see Work with scheduled jobs.

To add a job:

On the Portal Home page, under Portal Management, click Processing.

In the navigation pane, click Jobs.

Click Add.

In the Add job dialog box, in the Job type list, select one of the following:

Gather case metrics

Indexing and enrichment, and then select from the following options:

Scan only level folders that have new documents or documents that have been submitted to refresh for indexing and enrichment. This option is selected by default.

Scan all level folders. Selecting this option will take longer than the previous option.

Optionally, in the Indexing and enrichment dialog box, select the following check box:

Update case metrics: When selected, this option runs the case user metrics and case aggregate metrics stages of the job.

Search term family

Click Next.

Under Start time, select the date and time to start the job, and then click Next.

On the Cases page, select the cases for which you want to add the job, and then click Finish.

The new jobs appear on the Jobs page.

Edit jobs

You can edit jobs that are currently processing, paused, or queued for processing. Editing entails pausing, restarting, or cancelling jobs. You can also reset a job's processing priority level. You cannot edit completed jobs, including failed and succeeded with warnings jobs.

To edit a job:

On the Portal Home page, under Portal Management, click Processing.

In the navigation pane, click Jobs.

Select the check box next to one or more processing, paused, or queued jobs.

Click Edit.

Do one of the following:

To pause the job, select Pause.

To restart a paused job, select Restart.

To cancel the job, select Cancel.

Caution: You cannot restart a cancelled job.

To change the priority in which the job is processed, under Priority, select the new level.

Click Save.

Download report

Portal administrators can filter jobs and download a CSV report of those jobs. Download the report by clicking Download report at the top of the Jobs page.