On This Page

Overview

The Items report is available when viewing information for individual jobs through the Jobs menu option and when viewing reports through the Reports menu option. The Items report lists all items analyzed for the job(s) and the status of each item. The job overview statistics can be viewed by files or by folders, but the item statistics aggregates all items, including the files, folders, and the root folder.

If an item name is too long to display fully in the list, you can hover on the name. This will display a pop-up that displays the full name of the item.

Understanding the Status

The status identifies what happened with the item in the last job run. This helps you understand which items that were successfully transferred, which items were ignored, etc., so you can take the appropriate action.

The status values displayed in the user interface vary from the status values used in the REST API. The table below identifies the different status values and which correspond with each other. Note that the Items export uses the API status values.

UI Status	API/Export Status	Description
Flagged	Remediation	The item could not be transferred and was flagged for manual remediation.
Ignored	Skipped	The item was ignored due to a filter policy set for the job.
Pending	Pending	The item has not finished transferring to the destination. This can happen if a job is paused or canceled before an item is completely transferred.
Retrying	Retry	The item could not be transferred and is flagged for retry. The default retry attempts is 3.
Revised	Processed	The item name was revised as part of the transfer. This occurs when an item name conflicts with policies on the destination due to the inclusion of unsupported characters or length.
Succeeded	Success	The item was successfully transferred.
Unknown	Unknown	The item status is unknown.

Viewing Item Details

If you select a flagged or revised item in the list, you can view the “Flagged” reason or “Revised” reason by expanding the banner that displays on the right.

If you select a flagged or ignored item, you can use the Retry button that displays to set the item status to retry. DryvIQ will attempt to transfer the item during the next job run.

For flagged items, you can use the Ignore button that displays to set the item to be ignored on subsequent job runs.

Filtering the List

You can filter the Items list so it displays only items with a certain status, items that were revised for a specific reason, items of a certain file type, items that were flagged in a specific category, or items using a specific feature. You can also filter the list to show only files or only folders. Each filter option provides a secondary filter list that allows you to select a specific filter value. Select a filter below to view the available values.

Available Values:

Succeeded
Revised
Retrying
Flagged
Pending
Unknown
Ignored

Available Values:

Sanitized/Truncated
Compressed/Converted
Account/Group Unmapped

Available Values:

Folders
Files

Available Values:

Audio
Documents
Executables
Images
Movies
Other
Temporary
Windows

Available Values:

See Transfer Audit Categories below for a list of the values available for the Category filter.

Available Values:

Files with links

Available Values:

Nothing to remediate: No links were detected in the file.
Remediation needed: Links were detected in the file and require remediation to be executed to update the links.
Complete: Remediation was executed and finished processing. Regular URLs and unsupported URLs will also be considered “Complete” as there is no action to take against them.
Retry: Remediation was triggered but was not completed. Link remediation needs to be executed again to remediate the link.
Failed: At least one link in the file failed to be remediated. Failed files will not be reprocessed during subsequent link remediation executions unless the status is changed to “Retry.”

Customizing the Columns

The Items page contains four columns. By default, the columns display the identified item, resolved item, item status, and the item size (respectively). While the first two columns cannot be changed, the last two columns can be customized to display different information. Click the Arrow next to the column name and select the information you liked to display.

Column Name	Description
Status	Identifies what happened with the item in the last job run. This is the default heading for the third column.
Size	Displays the size of the item. This is the default heading for the fourth column.
Mime type	Displays the mime type for Google document types. Refer to the mime types for the Google document types below. Google Jamboard: application/vnd.google-apps.jam Google Sites: application/vnd.google-apps.site Google Maps: application/vnd.google-apps.map Google Forms: application/vnd.google-apps.form LucidChart: application/vnd.google-apps.drive-sdk.7081045131
File description	Displays a description of the item (Adobe Portable Document Format, Microsoft Office - OOXML - Word Document, etc.)
File type	Displays “Documents” and is blank for folders.
Transfer date	Displays the date the item was last transferred.
Type	Identifies the item as a file or folder.
Last failure	Displays the date the item last failed.
Number of links	Displays the number of links detected in the file. This requires link detection to have been enabled when creating the job.
link remediation status	Displays the current status of the identified links. This requires link detection to have been enabled when creating the job.

The columns can be sorted in ascending and descending order as needed, but the sort availability for the third and fourth columns is limited to certain column content.

Exporting the Report

Using the Export this report link to have the results exported to a csv file for review. The following information is included in the export.

Column Header	Description
Transferred on	Date the item was transferred
Status	Current status of the item. Note that the export uses the API Status values and not the status values from the user interface. See Understanding the Status above for more information.
Item Type	Identifies the item as a file or directory
Direction	The transfer direction for the item
Source ID	Item ID on the source platform
Source Name	Item name on the source platform. Names can vary between the source and destination due to name revisions that occur during transfer to accommodate naming restrictions of the destination platform.
Source Path	Item path on the source platform
Source Bytes	Byte size of the item on the source
Source Version	Number of versions on the source
Source Hash	Hash value on the source platform
Source Exists	Identifies if the item exists on the source platform
Destination ID	Item ID on the destination platform
Destination Name	Item name on the destination platform. Names can vary between the source and destination due to name revisions that occur during transfer to accommodate naming restrictions of the destination platform.
Destination Path	Item path on the destination platform
Destination Bytes	Byte size of the item on the destination
Destination Version	Number of versions on the destination
Destination Hash	Hash value on the destination platform
Destination Exists	Identifies if the item exists on the destination platform
Audit Category ID	The audit category ID for the item. See Transfer Audit Category below for more information.
Audit Category Name	The description for the audit category. See Transfer Audit Category below for more information.
Flagged	Indicates if the item was flagged during transfer
Retried	Identifies the number of time the item was retried.
Job ID	The ID assigned to the job
Job Name	The name of the job
Last Failure Level	Identifies the most recent failure level for the item
Last Failure Type	Identifies the type of failure
Last Failure Message	Description for the failure type
Last Failure Recorded On	Date the failure last occurred
Embedded Links	If link detection was enabled for the job, the number of embedded links identified for the item. Counts will not always match exactly depending on links are added to worksheet cell. If the links are added to multiple cells at the same time, DryvIQ read the link as one link shared across cells. In this instance, all shared links count as one link. If the links are added to multiple cells separately (one at a time), DryvIQ counts each cell as separate. In this instance, each link is counted individually.
Processing Status	Identifies how the file was revised. “None” indicates no revision was required.

Microsoft Excel has a maximum limit of 1,048,576 rows. When opening the export file, Excel will display a message to warn you if your file exceeds the maximum supported rows, and the excess content will not be displayed. Refer to Microsoft’s Excel specifications and limits for more information.

Transfer Audit Categories

Transfer Audit Category Description

Description

ID

Access Failures

"Files and folders that have failed due to access failures."

ae073f4b34a846ca9a71eabca31f475f

Access Rule Import Failures

"Failure importing access rule."

86209a22f805497283cf53d9fd5b57b1

Access Rule Warnings

"Unable to apply permissions due to an incompatible or unsupported access rule."

4d4e496ae6da4aeb91ce0f9a2cbe8bb4

Conflict Failures

"Files that have failed due to unresolved conflicts."

3024e963e1bf45578f6ef7c5722fea53

Conflict Warnings

"Files that have a conflict copy created."

fde8507bf96243cd8409404841276484

Connectivity Failure

"Files and folders that have failed due to connectivity issues with the platform provider."

9b3b464d77ab4fa5a03d097f6da9f745

Conventions Skipped

"Convention skipped due to an convention mapping failure."

6266b23b8c11429fb4492855cf8375a8

Duplicate Item Failures

"Files and folders that have failed because the platform does not allow duplicate names."

e92c5ec1a0f4415ba3efe79a8c78627b

Invalid Item Failures

"Files and folders that are invalid in the platform provider."

480f984a7dd94343b107553dd017ca83

IO Failures

"Files and folders that have failed for IO reasons."

65c5e85659284d279f6dea0c71707fc0

Item Locked Failures

"Item Locked Failures"

c0fd71c583614130a2246de0912831a8

Item Locked Warnings

"Files that have warnings when locked or unlocked."

c0fd71c583614130a2246de0912831a8

Item Not Found Failures

"Files and folders that have failed because they were not found in the platform provider."

009fa2b7578d488695a3f0db0dc53553

License Failures

"Files and folders that have failed due an unlicensed product feature."

17cd1af5358f4a5cb718c7083dbed7ca

Permission Failures

"Files and folders that have failed because the authorized account does not have permission to access the resource."

a4bdd7af71f6490c817155b4d1dabe51

Policy Failures

"Files and folders that have failed for violating a policy imposed by the platform provider."

9ab945f3d3524f4a9b128eb717cf20fd

Property Value Import Failures

"Failure importing property values."

2215d620a6ab447c989d835a4252937d

Property Value Import Warnings

"Property Value Import Warnings"

b1ca22f62c604cd7a57525e10feeb075

Property Value Warnings

"Unable to transfer property values due to an invalid property map."

e52a9e0303b049cdb51e7748abb66d28

Restricted Content Skipped

"Files that were skipped due to restricted content."

35b00b5a556f48828e94d66c6ee1f222

Security Identifier Warnings

"Unable to apply permissions due to an invalid user or group."

e700f185cd81471caa08be63141bcc55

Unknown Failures

"Files and folders that have failed for unknown reasons."

814d1fa15a974c83a8bcac10d266798b

Items Report Using the REST API

List all Items

Use the following call to list all items for all jobs.

GET {{url}}v1/transfers/items

List all Items for a job

GET {{url}}v1/transfers/{{job}}/items?fields=all

List all files and folders for a specific job

GET {{url}}v1/transfers/items?jobs={{job}}&fields=all

List Items by Parent Folder

For a given job, this call returns all items within a folder.

GET {{url}}v1/transfers/items?jobs={{job}}&parent={{parent}}&fields=all

List Items for a Job by Status

GET {{url}}v1/transfers/items?jobs={{job}}&fields=all&item_status=success

Statuses for REST API calls include:

none[0]: No remediation flag has been applied to the item.
success[1]: Item was moved successfully with no modifications by DryvIQ.
skipped: Item was skipped due to a policy configuration defined in your job such as Large Item Policy or Duplicate Name Policy.
processed[2]: Item was reviewed and changed by DryvIQ during transfer. See processed statuses section below for further details.
remediation: DryvIQ could not transfer the item and it was flagged for manual remediation. This is the status you would use to get all flagged items.
retry: DryvIQ could not transfer the item and flagged it for retry. Default retry attempts is set to 3.
pending: Item has not finished transferring to the destination. If a job is paused or canceled, an item could go to a pending status as well.

List Items by Processed Status

Processed status means the item was reviewed and changed by DryvIQ during transfer.

{{url}}v1/transfers/items?jobs={{job}}&fields=all&processing_status=converted

Processed statuses include:

none: No processing has occurred on the item.
filtered: Item was filtered by DryvIQ to meet Job Filter configurations defined in your job (Job Filters).
skipped: Item was skipped due to a policy configuration defined in your job such as Large Item Policy or Duplicate Name Policy.
truncated: Item was modified by DryvIQ to conform to the destination platform requirements such as Segment Transformation Policy.
converted: Item was compressed into a zip file by DryvIQ because the item is not supported on the destination (Restricted Content).
conflict_copy: A copy of the item was created due to the policy configuration defined in your job (Conflict Policy).
access_rules: Permissions were applied to an item (Permissions Import).
metadata: Metadata was applied to an item (Metadata Import).
unmapped: DryvIQ was not able to map permissions or owner of the item.

List Items for a Job by Transfer Audit Category

Failed: Indicates the job audit log has captured one or more error entries.
Warning: Indicates the job audit log has captured one or more warning entries.

List all audit categories

GET {{url}}v1/transfers/categories?priority=all

List all items for a specific job and category

GET {{url}}v1/transfers/{{job}}/items?fields=all&audit_categories={{category}}

Get items for a Job formatted as CSV

All of the previous parameters can be added to this URL.

List all items for a specific job in .csv format

GET {{url}}v1/transfers/{{job}}/items.csv

Example Response

transferred_on,status,item_type,direction,source_id,source_name,source_path,source_bytes,source_version,source_hash,source_exists,destination_id,destination_name,destination_path,destination_bytes,destination_version,destination_hash,destination_exists,category_id,retried
2018-03-21T18:16:59+00:00,success,"",->,"",do-not-delete-many-files,"/",0,"","",True,"",destination,"/",0,"",""
2018-03-21T18:16:59+00:00,success,"",->,"",1 - Copy - Copy - Copy (2) - Copy - Copy.txt,"/1 - Copy - Copy - Copy (2) - Copy - Copy.txt",16,"","",True,"",1 - Copy - Copy - Copy (2) - Copy - Copy.txt,"/1 - Copy - Copy - Copy (2) - Copy - Copy.txt",16,"",""
2018-03-21T18:16:59+00:00,success,"",->,"",1 - Copy - Copy - Copy - Copy (2) - Copy.txt,"/1 - Copy - Copy - Copy - Copy (2) - Copy.txt",16,"","",True,"",1 - Copy - Copy - Copy - Copy (2) - Copy.txt,"/1 - Copy - Copy - Copy - Copy (2) - Copy.txt",16,"",""
2018-03-21T18:16:59+00:00,success,"",->,"",1 - Copy - Copy - Copy - Copy - Copy - Copy.txt,"/1 - Copy - Copy - Copy - Copy - Copy - Copy.txt",16,"","",True,"",1 - Copy - Copy - Copy - Copy - Copy - Copy.txt,"/1 - Copy - Copy - Copy - Copy - Copy - Copy.txt",16,"",""
2018-03-21T18:16:59+00:00,success,"",->,"",1 - Copy - Copy - Copy - Copy (2).txt,"/1 - Copy - Copy - Copy - Copy (2).txt",16,"","",True,"",1 - Copy - Copy - Copy - Copy (2).txt,"/1 - Copy - Copy - Copy - Copy (2).txt",16,"",""
2018-03-21T18:16:59+00:00,success,"",->,"",1 - Copy - Copy - Copy - Copy.txt,"/1 - Copy - Copy - Copy - Copy.txt",16,"","",True,"",1 - Copy - Copy - Copy - Copy.txt,"/1 - Copy - Copy - Copy - Copy.txt",16,"",""
2018-03-21T18:16:59+00:00,success,"",->,"",1 - Copy - Copy - Copy - Copy - Copy.txt,"/1 - Copy - Copy - Copy - Copy - Copy.txt",16,"","",True,"",1 - Copy - Copy - Copy - Copy - Copy.txt,"/1 - Copy - Copy - Copy - Copy - Copy.txt",16,"",""
2018-03-21T18:16:59+00:00,success,"",->,"",filetoupload.txt,"/filetoupload.txt",16,"","",True,"",filetoupload.txt,"/filetoupload.txt",16,"",""