...
On This Page
| Table of Contents |
|---|
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.
| Info |
|---|
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.
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.
...
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.
Transfer Audit Categories
...
Transfer Audit Category Description
...
Description
...
ID
...
Access Failures
...
"Files and folders that have failed due to access failures."
...
| Code Block |
|---|
ae073f4b34a846ca9a71eabca31f475f |
...
Access Rule Import Failures
...
"Failure importing access rule."
...
| Code Block |
|---|
86209a22f805497283cf53d9fd5b57b1 |
...
Access Rule Warnings
...
"Unable to apply permissions due to an incompatible or unsupported access rule."
...
| Code Block |
|---|
4d4e496ae6da4aeb91ce0f9a2cbe8bb4 |
...
Conflict Failures
...
"Files that have failed due to unresolved conflicts."
...
| Code Block |
|---|
3024e963e1bf45578f6ef7c5722fea53 |
...
Conflict Warnings
...
"Files that have a conflict copy created."
...
| Code Block |
|---|
fde8507bf96243cd8409404841276484 |
...
Connectivity Failure
...
"Files and folders that have failed due to connectivity issues with the platform provider."
...
| Code Block |
|---|
9b3b464d77ab4fa5a03d097f6da9f745 |
...
Conventions Skipped
...
"Convention skipped due to an convention mapping failure."
...
| Code Block |
|---|
6266b23b8c11429fb4492855cf8375a8 |
...
Duplicate Item Failures
...
"Files and folders that have failed because the platform does not allow duplicate names."
...
| Code Block |
|---|
e92c5ec1a0f4415ba3efe79a8c78627b |
...
Invalid Item Failures
...
"Files and folders that are invalid in the platform provider."
...
| Code Block |
|---|
480f984a7dd94343b107553dd017ca83 |
...
IO Failures
...
"Files and folders that have failed for IO reasons."
...
| Code Block |
|---|
65c5e85659284d279f6dea0c71707fc0 |
...
Item Locked Failures
...
"Item Locked Failures"
...
| Code Block |
|---|
c0fd71c583614130a2246de0912831a8 |
...
Item Locked Warnings
...
"Files that have warnings when locked or unlocked."
...
| Code Block |
|---|
c0fd71c583614130a2246de0912831a8 |
...
Item Not Found Failures
...
"Files and folders that have failed because they were not found in the platform provider."
...
| Code Block |
|---|
009fa2b7578d488695a3f0db0dc53553 |
...
License Failures
...
"Files and folders that have failed due an unlicensed product feature."
...
| Code Block |
|---|
17cd1af5358f4a5cb718c7083dbed7ca |
...
Permission Failures
...
"Files and folders that have failed because the authorized account does not have permission to access the resource."
...
| Code Block |
|---|
a4bdd7af71f6490c817155b4d1dabe51 |
...
Policy Failures
...
"Files and folders that have failed for violating a policy imposed by the platform provider."
...
| Code Block |
|---|
9ab945f3d3524f4a9b128eb717cf20fd |
...
Property Value Import Failures
...
"Failure importing property values."
...
| Code Block |
|---|
2215d620a6ab447c989d835a4252937d |
...
Property Value Import Warnings
...
"Property Value Import Warnings"
...
| Code Block |
|---|
b1ca22f62c604cd7a57525e10feeb075 |
...
Property Value Warnings
...
"Unable to transfer property values due to an invalid property map."
...
| Code Block |
|---|
e52a9e0303b049cdb51e7748abb66d28 |
...
Restricted Content Skipped
...
"Files that were skipped due to restricted content."
...
| Code Block |
|---|
35b00b5a556f48828e94d66c6ee1f222 |
...
Security Identifier Warnings
...
"Unable to apply permissions due to an invalid user or group."
...
| Code Block |
|---|
e700f185cd81471caa08be63141bcc55 |
...
Unknown Failures
...
"Files and folders that have failed for unknown reasons."
...
| Code Block |
|---|
814d1fa15a974c83a8bcac10d266798b |
Items Report Using the REST API
List all Items
Use the following call to list all items for all jobs.
| Code Block |
|---|
GET {{url}}v1/transfers/items |
List all Items for a job
| Code Block |
|---|
GET {{url}}v1/transfers/{{job}}/items?fields=all |
List all files and folders for a specific job
| Code Block |
|---|
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.
| Code Block |
|---|
GET {{url}}v1/transfers/items?jobs={{job}}&parent={{parent}}&fields=all |
List Items for a Job by Status
| Code Block |
|---|
GET {{url}}v1/transfers/items?jobs={{job}}&fields=all&item_status=success |
...
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.
...
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.
...
| Code Block |
|---|
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.
...