Jobs

Overview

The Jobs tab allows you to track the status of all the jobs uploaded or workspaces modified in CAM. In the Job’s list, you can click a job’s Description to view specific details about that job’s parameters and processing. Some of the common jobs that can be tracked in this tab are:

Create a Workspace
Modify a Workspace:
- Update Matters
- Add Users & Groups to Workspaces
- Remove Users from Groups & Workspaces

And many others.

Important: Currently, the daily Throttle limit is set to a maximum of 50,000 jobs daily for optimum and error-free performance. The Data Uploader (DU) can hold bulk jobs in the queue for up to 7 days from the job creation date. After 7 days, if they are not processed, the jobs are removed automatically from the queue.

Please Consider: If you have a large number of jobs that you need to run, you could start all jobs at the same time and let the Data uploader work through the backlog. However, this results in poor performance and even failure if the number of jobs is too high. The first few jobs are put into the Running state and the remaining jobs are put into the Queued state. This could make a lot of jobs fail even when they aren’t running and that can negatively impact the other jobs that are running. Please work with your partner or professional services consultant to discuss best practices for managing and queueing jobs.

Dates in the Jobs tab are displayed in the logged-in user’s timezone. E.g. the document specialist in Chicago logs into CAM and looks at the Jobs tab: the created, submitted, and processed dates are then in the Chicago timezone. All dates in the backend are stored in UTC.

Note: In Data Uploader, or SSI or CAM in general, When a provisioning job for a team channel or site is received, CAM creates a separate job for each tab or app in addition to the Team creation or provisioning job. For provisioning users, or groups or workspaces, or folders, there is only one job when bulk updating or creating records from DU or SSI.

E.g. one record will show for Data Upload. Then a record shows the subsequent action of Create Workspace if the job was creating workspaces from DU.

1 Overview
2 Configuring Jobs
- 2.1 Upload CSVs
3 Job Tab Information
- 3.1 Generate CSV sample
- 3.2 Notification
- 3.3 Link to Workspace
- 3.4 Find/Replace/Retry
- 3.5 Reconciliation Report
- 3.6 Retry Job(s)
- 3.7 Archive Job(s)
  - 3.7.1 Auto archiving jobs
  - 3.7.2 Job Cleanup
- 3.8 Modify Workspace
- 3.9 Jobs for Deleting Records
- 3.10 Filter a Job
- 3.11 Export a Job
- 3.12 Action
- 3.13 Secondary Authentication for Bulk Jobs
- 3.14 To enable:
- 3.15 Documents tab:
4 Required Permissions
5 Background Jobs

Configuring Jobs

Upload CSVs

You can also upload a job from this tab. Click the Upload CSV button and browse and select the file to be uploaded.

It allows uploading 25 CSV files at a time and file sizes not more than 50KB. The execution status of each file upload is displayed.

Job Tab Information

Column Name	Description

Column Name	Description
Checkbox	Check the box to select a job, or multiple jobs, to run an action.
Job	This columns lists the status of the job in the upload process in the external system. Hover your cursor over the external systems logo to view the external system name. The upload process is categorized in the following stages: Data Upload - This status is indicated when a job is uploaded via the Data Uploader or the Workspace Wizard, Upload Users or the Jobs tab> Upload CSV button. Modify Workspace - This status is indicated when a job is successfully uploaded and the modify process is initiated (for matters with same client and matter ID, or users & groups details updated) Create Workspace - This status is indicated when the workspace creation process is initiated in NetDocuments and iManage. ( with a new client and matter ID) Create Group - This status is indicated when a new user group creation is initiated in CAM. Create User - This status is indicated when the process to add a new user in CAM is initiated.
Job Description	This column displays the name of the workspace, matter and/or client updated in the external system. Click on the link to modify the workspace parameters.
Link	Click the Link to open the external system login page.
Status	This column displays the status of the job. Click on the column name to view the count of the jobs against each status. The job status is categorized as: All - Displays the count of all jobs in all statuses. All statuses will be selected. Clicking all again will deselect all statuses. Completed - Displays the count of jobs successfully completed. If all statuses was selected before, only the completed status will be selected after changing to this. Completed with errors- This new status will show jobs that partially completed successfully, but some portion(s) failed with an error. In Progress - Displays the count of jobs in progress. (generally displayed when a job is uploaded) and jobs have unprocessed background jobs. In Progress with Errors- A in progress job that partially completed, but has one or more errors. Queued - Displays the count of jobs in queued up for the next process Pending - Displays the count of jobs in pending status Pending with Errors- A pending job to be executed, but has a pre-existing error. Error - Displays the count of failed jobs Waiting for Confirmation: If bulk jobs are submitted and need confirmation, this status displays. Click the Confirm Bulk Jobs button.
Created Date	Displays the job creation date
Completion Date	Displays the completion date for the job
Action	Click on the above icon to view the Instance Log for the job or retry a job.
Created By	Displays the user who created the job. This parameter currently only works for the following jobs: Create/Update Group for Office/iManage/CAM Delete Group iManage Manage Project Team Update Group Membership Modify Workspace for iManage/NetDocuments Modify Workspace Security NetDocuments Modify Group Security Office Create Folders for iManage/NetDocuments Generate Template for iManage/NetDocuments Create User from UI NetDocuments/iManage/Office (M365) Create Tab jobs (M365) OneNote jobs (M365) Planner jobs

Generate CSV sample

This option allows the creation of a CSV Sample.

Click on the Jobs Tab Action menu, and select Generate CSV Sample.
Specify the following details:
1. Which System do you want to use? Select from the drop-down. This is a mandatory field.
2. What action do you want to do? Select from the drop-down. Available actions are: Create Workspace, Add Folder, Delete Folder, Create Teams, Update Security. This is a mandatory field.
3. Select a template.
Click Generate CSV. The button will remain disabled until the system and action are selected.
Click Download.

Notification

This option allows notifications to be set for a job.

First create the email template, as discussed here: Email Templates | Scheduling Notifications
In the Roles tab in Account Management, enable the permission to Enable Job Notification.
Click on the Jobs Tab Action menu, and select Notification.
Enter the notification details.
1. Notification name
2. Type of jobs for Completed or Errored.
3. Email template selection
4. Frequency
5. CAM users to send to
Click save. The notification will run for those jobs.

Link to Workspace

This option allows you to link workspaces from iManage, NetDocuments to CAM.

In the Roles tab in Account Management, enable the permission Link To Workspace.
Click the above icon in the top right corner and select Link to Workspace.
Enter the workspace details
1. System
2. Repository
3. Workspace ID (SystemId from the system)

4. Click Search.

5. Based on query fields entered, it lists workspaces, not on CAM.

6. Navigate to all workspaces using the Previous Page and Next Page buttons.

7. Either select a specific workspace/s or select the Select All radio button and click Next.

8. Select either Link all workspaces by query or Link only selected workspaces.

10. Select the template from the dropdown of the templates list.

11. Select Skip Workspace Structure to avoid copying folder structure to CAM, default it's No.

12. Select Skip Workspace Security to skip linking the security in CAM, default it's No.

13. Select Link Metadata Values to link Metadata in CAM, default it's No.

14. Click Submit to link workspaces to CAM.

15. The Job will be created for each linked workspace and listed in the Jobs tab.

Find/Replace/Retry

This new option allows the user to find an existing job and either replace the job or retry the job.

In the Jobs tab, select the Action menu.
Select the Find Replace and Retry button.
Type in the attribute name to search, and the value of it.
Select Job Status and Job Types, this allows multi-select.
Click Find. This will find and display the number of instances where the value was found.
To replace the values, enter the New Value, and click Replace and Retry. This will replace the value in all instances that were found and retry those jobs.
A new job called Replace and Retry Jobs will appear in the Jobs tab.

Required Permissions

For more information on configuring permissions, click here

Permissions	Allows User To

Permissions	Allows User To
View Jobs (Service Center)	View the Job tab (Hides the Job tab)
View Job Details	View job details in Jobs tab (Disables the job link in Description column)
Edit Job Details	View the job details in Jobs tab (Hides the Edit button in the Parameters panel)
Retry Job	Retry a job (Disables the Retry option in the action menu)
Link To Workspace	Enables user to link workspaces from external systems