Versions Compared

Old Version 1

changes.mady.by.user Andrea Harvey

Saved on

compared with

New Version Current

changes.mady.by.user Andrea Harvey

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

On This Page

Table of Contents

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.

...

Info

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)

Transfer rate

Previous or current job's execution transfer rate in bytes per second. Only counts file data payload

Status data

Sum of latest

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

selected

the “succeeded” status

during transfer job

.

The available options are:

Succeeded

data

items

Number of files and folders with the “Succeeded” status.

Revised data

  • Retrying data

  • Flagged data

  • Ignored data

    • Status

    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

    selected status during transfer job. The available options are:Succeeded Flagged data 

    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)

  • Revised data (all versions)

  • Retrying data (all versions)

    • Status

    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)

  • Ignored 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

    selected status during transfer job. The available options are: 

  • Succeeded items

  • Revised items

  • Retrying items

  • Flagged items

    • Ignored items

    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.

    Expand
    titleExport Fields

    Field 

    Description

    job_id

    The ID assigned to the job in the

    ...

    DryvIQ Platform

    job_name

    The

    ...

    name assigned to the job when it was created in the DryvIQ Platform

    source_path

    The source path used for the job. This was selected when the job was created.

    source_id

    The ID assigned to the source connection used for the job. The ID is assigned by the

    ...

    DryvIQ Platform when the connection is created.

    source_name

    The name assigned to the source when it was created in the

    ...

    DryvIQ Platform

    source_account

    The account on the source platform used for the job. This was selected when the job was created.

    destination_path

    The destination path used for the job. This was selected when the job was created.

    destination_id

    The ID assigned to the destination connection used for the job. The ID is assigned by the

    ...

    DryvIQ Platform when the connection is created.

    destination_name

    The name assigned to the

    ...

    destination when it was created in the

    ...

    DryvIQ Platform

    destination_account

    The account on the destination platform used for the job

    ...

    successful_item_count

    ...

    . This was selected when the job was created.

    flagged_item_count

    The number of items in the job that were flagged for review. 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.

    number_of_executions

    The number of times the job has run

    last_failure_message

    The last failure message for the job

    ...

    (if applicable)

    status

    The job status indicating what's happening with the job. See Job Status, Item Error & Warnings Categories for more information. 

    last_execution

    The last run date and time for the job

    next_execution

    The next run date and time for the job. "Not scheduled" appears for jobs not set to run on a schedule.

    current_execution_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_on

    Date the job was created (month and day)

    modified_on

    Date the job was last modified (month and day)

    successful_bytes

    Sum of latest version sizes of items with the “Succeeded” status.

    successful_bytes_all_versions

    Sum of all version sizes of items with the “Succeeded” status.

    successful_items

    Number of files and folders with the “Succeeded” status.

    revised_bytes

    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_bytes_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.

    retry_bytes

    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.

    retry_bytes_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.

    retry_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_bytes

    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_bytes_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.

    skipped_bytes

    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.

    skipped_bytes_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.

    skipped_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_bytes_per_second

    Previous or current job's execution transfer rate in bytes per second. Only counts file data payload

    ...

    List Jobs Using the REST API

    You can retrieve the same information available in the Jobs grid using the REST API.

    List All Jobs

    Code Block
    GET {{url}}v1/jobs?fields=category&limit=1000

    List All Simulation Jobs

    Code Block
    GET {{url}}v1/jobs?simulation_mode=true

    List all Child Jobs for a Convention Job

    Code Block
    GET {{url}}v1/jobs?parent_job={{job}}

    List All Jobs by Filter

    List All Jobs By Category

    Code Block
    GET {{url}}v1/jobs?job_category_id={{id}}

    List All Jobs By Job Type

    Code Block
    GET {{url}}v1/jobs?kind=personal_drive

Options include:
transfer  
personal_drive  
folder_mapping
system

    List All Jobs By Source Platform

    Code Block
    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-blob

    List All Jobs By Destination Platform

    Code Block
    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-blob

    List All Jobs By Category

    Code Block
    GET {{url}}v1/jobs?transfer_type=sync

Options include:
copy  
sync   
move  
migrate  
publish  
taxonomy

    Export 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).

    ...