Item Inspection Policy (REST API)
- Andrea Harvey
On This Page
Overview
The Item Inspection Policy allows you to control the level of tracking and reporting for content that exists on both the source and destination platform, including content that has been configured to be excluded from transfer and content that existed on the destination prior to the initial transfer. This feature categorizes items for reports on the job Validation tab. The inspection policy can be set for a job through the REST API within the job transfer block with the "item_inspection_policy" parameter. Items that have been ignored/skipped by policy or not shown because they already existed on the destination can now be seen on reports with the defined categories. All job types and transfer directions support validation.
The available inspection policy options are:
none (default)
all
filtered
flagged
shared
If the connection does not have access to a given folder in a hierarchy, DryvIQ cannot track and report the items.
None (Default)
None is the default inspection policy configuration. This option does not need to be configured through the REST API; it is the system default. This inspection policy will not track all items but will offer additional tracking with performance in mind. It tracks all items on the source except filtered items (items ignored/skipped through the job filters). For the destination, all content in the root (files and folders) that existed prior to the initial transfer will be tracked as destination only items and reported as ignored/skipped. For sync jobs, the destination will behave like the source.
Validation None | JSON Configuration |
|---|
"transfer": {
"item_inspection_policy": "none",
"item_inspection_policy_next": "none"
} |
All
This inspection policy tracks all content on both the source and destination, including filtered items and items that exist on the destination prior to the initial transfer.
Validation Track Everything | JSON Configuration |
|---|
"transfer": {
"item_inspection_policy": "all",
"item_inspection_policy_next": "all"
} |
Filtered
This inspection policy tracks only items on the source that are excluded from transfer based on the job filters. Content on the destination is not tracked for jobs that migrate in one direction from source to destination. For sync jobs, the destination will behave like the source.
Validation Track Filtered | JSON Configuration |
|---|
"transfer": {
"item_inspection_policy": "filtered",
"item_inspection_policy_next": "filtered"
} |
Flagged
This inspection policy will track items that have been flagged during transfer. It will track only flagged content that is not in a retry status. Content on the destination is not tracked for jobs that migrate in one direction from source to destination. For sync jobs, the destination will behave like the source. This configuration is only available through the REST API.
Validation Track Flagged | JSON Configuration |
|---|
Shared
This inspection policy tracks only shared items on the source. Filtered content configured to be skipped/ignored through job policies will be tracked if it has been shared. Content on the destination is not tracked for jobs that migrate in one direction from source to destination. For sync jobs, the destination will behave like the source.
Validation Track Shared | JSON Configuration |
|---|
Â
Content Reconciliation
The content reconciliation provides a comparison of the reconciled items between the source and destination. It can help track the success of the migration. By default, it shows the counts for files and folders, but you can choose to view just folders, just folders, or data. It reports on the following information:
Identified: This is the totals count of items or data identified on the source and destination (including flagged/retried items).
Ignored destination only items: This is the count of the items ignored on the destination and the percentage of the overall content theses items make up.
Ignored [Filter]: If filters were added to the job to exclude content, any entry for each filter is included in this section. It will identify the count of the filtered items and the percentage of the overall content theses items make up.
Successfully matched or transferred (Including flagged and revised): This is the count of items or data that have been successfully matched or transferred between the course and destination.
Â
REST API | Transfer Stats, By Inspection
Â
Â