Jobs Grid
- Andrea Harvey
On This Page
- 1 Overview
- 2 Searching for Jobs
- 3 Filtering the Jobs List
- 4 Customizing Column Options
- 5 Viewing More Options
- 6 Managing Multiple Jobs
- 7 Exporting the Jobs List
- 8 List Jobs Using the REST API
Overview
The jobs grid provides an overview of all jobs created and options to manage them. The Jobs tab displays all the transfer jobs (jobs that actively move content), and the Simulation tab displays the simulation jobs (jobs not actually moving content). This makes it easier to manage your transfer and simulation jobs. The grid options are the same for both grids.
If a job name is too long to display fully in the Jobs list, you can hover on the name. This will display a pop-up that displays the full name of the job.
Searching for Jobs
Use the search field to quickly find a job. Simply type the search criteria you want to use and press ENTER. The Jobs list will show only jobs that meet your search criteria. Select Clear filters to reset the jobs list.
Filtering the Jobs List
The Filter by option allows you to refine the Jobs list based on job type, status, category, source platform, or destination platform. The filters can be used in combination with the search as needed.
Customizing Column Options
Last run and Job status are the default columns displayed on the jobs grid. You can change what displays in these columns based on the information you prefer to view. Click the arrow next to the column name to display the list of available column content. The list also includes options to sort the columns in ascending or descending order based on the selected data for the column.
Additional column descriptions are provided below. The jobs export will include the information available for these headers.
Column name | Description |
|---|---|
ID | Unique ID assigned to the job at the time of creation |
Source | Source path for the job |
Destination | Destination path for the job |
Last run | Default column option. The last run date and time for the job |
Next run | The next run date and time for the job. "Not scheduled" appears for jobs not set to run on a schedule. |
Job status | Default column option. Status indicating what's happening with the job. See Job Status, Item Error & Warnings Categories for more information. |
Job duration | The duration of a running job. Jobs that are not actively running will display a dash ( - ) as the status. |
Category | Category assigned to the job |
Created | Date the job was created (month and day) |
Modified | Date the job was last modified (month and day) |
Succeeded data | Sum of latest version sizes of items with the “Succeeded” status. |
Succeeded data (all versions) | Sum of all version sizes of items with the “succeeded” status. |
Succeeded items | Number of files and folders with the “Succeeded” status. |
Revised data | Sum of latest version sizes of items with the “Revised” status. This corresponds to the “Revised in transfer” value on the jobs Overview. These items needed to be revised in order to be transferred. |
Revised data (all versions) | Sum of all version sizes of items with the “Revised” status. This corresponds to the “Revised in transfer” value on the jobs Overview. These items needed to be revised in order to be transferred. |
Revised items | Number of files and folders with the “Revised” status. This corresponds to the “Revised in transfer” value on the jobs Overview. |
Retrying data | Sum of latest version sizes of items with the “Retrying” status. These items failed to be transferred, so DryvIQ will attempt to transfer them on the next job run. |
Retrying data (all versions) | Sum of all version sizes of items with the “Retrying” status. These items failed to be transferred, so DryvIQ will attempt to transfer them on the next job run. |
Retrying items | Number of files and folders with the “Retrying” status. These items failed to be transferred, so DryvIQ will attempt to transfer them on the next job run. |
Flagged data | Sum of latest version sizes of items with the “Flagged” status. These items failed to transfer, and DryvIQ will not attempt to transfer them again unless they are manually set to be retried on the next job run. Generally, these items require manual intervention. |
Flagged data (all versions) | Sum of all version sizes of items with the “Flagged” status. These items failed to transfer, and DryvIQ will not attempt to transfer them again unless they are manually set to be retried on the next job run. Generally, these items require manual intervention. |
Flagged items | Number of files and folders with the “Flagged” status. These items failed to transfer, and DryvIQ will not attempt to transfer them again unless they are manually set to be retried on the next job run. Generally, these items require manual intervention. |
Ignored data | Sum of latest version sizes of items with the “Ignored” status. These are items that were not transferred due to filters applied to the job. |
Ignored data (all versions) | Sum of all version sizes of items with the “Ignored” status. These are items that were not transferred due to filters applied to the job. |
Ignored items | Number of files and folders with the “Ignored” status. These are items that were not transferred due to filters applied to the job. |
Transfer rate | Previous or current job's execution transfer rate in bytes per second. Only counts file data payload |
Viewing More Options
When you select a job or multiple jobs in the list, a More options button displays. This button opens a menu with options you can use to manage job schedules, rename jobs, reset jobs, duplicate jobs, and delete jobs. The More options button is not available when selecting system jobs since you can't alter these jobs.
Managing Multiple Jobs
Selecting more than one job enables options to manage the schedules and run the selected jobs. When adding multiple job status filters, the grid will display jobs that match any of the selected statuses.
Exporting the Jobs List
The Export this list option exports the current job list to a csv file and provides additional information about the jobs. The export includes the same information available in the user interface; however, the export labels vary. Note that the export will reflect any filters applied to the job list before exporting the information. Expand the section below to view a compete list of the fields available in the export.
List Jobs Using the REST API
You can retrieve the same information available in the Jobs grid using the REST API.
List All Jobs
GET {{url}}v1/jobs?fields=category&limit=1000List All Simulation Jobs
GET {{url}}v1/jobs?simulation_mode=trueList all Child Jobs for a Convention Job
GET {{url}}v1/jobs?parent_job={{job}}List All Jobs by Filter
List All Jobs By Category
GET {{url}}v1/jobs?job_category_id={{id}}List All Jobs By Job Type
GET {{url}}v1/jobs?kind=personal_drive
Options include:
transfer
personal_drive
folder_mapping
systemList All Jobs By Source Platform
GET {{url}}v1/jobs?sources={{platform name}}
Options include:
box, office365, onedrive-business, sharepoint, dfb, fs, nfs, onedrive, box-service, dropbox
google-suite, google-teams, google-drive, azure-blobList All Jobs By Destination Platform
GET {{url}}v1/jobs?destinations={{platform name}}
Options include:
box, office365, onedrive-business, sharepoint, dfb, fs, nfs, onedrive, box-service, dropbox
google-suite, google-teams, google-drive, azure-blobList All Jobs By Category
GET {{url}}v1/jobs?transfer_type=sync
Options include:
copy
sync
move
migrate
publish
taxonomyExport Jobs List
This will export a list of all jobs to a csv file. The endpoint will return a download link (in its "links" section).
GET {{url}}v1/jobs.csv