On This Page

Overview

Control 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 or . 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 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:

• Basic transfer, Folder mapping, User job mapping, Network home drive mapping

• Simulation Mode

• Transfer in one direction with copy and both directions with sync

• Jobs using Impersonation (Run as user)

Default Configuration: "item_inspection_policy": "none"

The default validation option is inspect none.

The available inspection policy options are:

• none (default)

• all

• filtered

• flagged

• shared

None (Default)

None is the default inspection policy configuration. This option does not need to be configured in the application user-interface or through the REST API; it is the system default. This configuration inspection policy will not track all items but will offer additional tracking with performance in mind. Inspect none will track It tracks all items on the source at all levels of the hierarchy but not including those configured to be except filtered items (items ignored/skipped through policythe 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.

This option has the following features:

...

This option does not need to be configured in the application user interface or through the REST API; it is the system default. Jobs created in previous releases will now assume this settings after upgrade. A soft reset will be required to align the validation chart calculations using the inspect none configuration.

...

Source: All content (files & folders) at all levels in the hierarchy will be tracked; items configured to be ignored/skipped through policy will not be tracked. If the connection does not have access to a given folder in the hierarchy, we cannot track and report these items.

...

Destination: All content in the root (files & folders) that existed prior to the initial transfer will be tracked as destination only items and reported as ignored/skipped.

...

Destination: All content (files & folders) in lower depths of the directory (sub-folders) that existed prior to the initial transfer will not be tracked.

...

If the connection does not have access to a given folder in the hierarchy, we cannot track and report these items.

...

For sync jobs, the destination will behave like the source.

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

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

"transfer": {
"item_inspection_policy": "

filtered",
"item_inspection_policy_next": "

filtered"
 }

Track Everything | "item_inspection_policy": "all"

The validation option to inspect all will track all content at all levels in the hierarchy on both the source and destination; including items configured to be ignored/skipped through policy and items that existed on the destination prior to the initial transfer.

This option has the following features:

• This option can be configured via the REST API or in the application user interface through the Advanced Scripting option when creating a job..

• Source: All content in the root, folder, and subfolder directories including those configured to be skipped/ignored through policy and items that existed on the destination prior to the initial transfer will be tracked.

• Destination: All content in the root, folder, and subfolder directories including those configured to be skipped/ignored through policy and items that existed on the destination prior to the initial transfer will be tracked.

• If the connection does not have access to a given folder in the hierarchy, we cannot track and report these items.

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.

"transfer": {
"item_inspection_policy": "flagged",
"item_inspection_policy_next": "flagged"
 }

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.

"transfer": {
"item_inspection_policy": "

shared",
"item_inspection_policy_next": "

shared"
 }

...

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

GET {{url}}v1/transfers/{{job_id}}/stats/by_inspection

...