Versions Compared

Version Old Version 3 New Version 4
Changes made by

Andrea Harvey

Andrea Harvey

Saved on

Key

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

...

Link Detection is available as one of the Behavior options when creating a job. This feature is disabled by default. Select the Allow link detection on supported files toggle to enable the feature.Image Removed

...

Viewing Link Information

When enabled, link detection will identify the links in files and make the information available for review on the individual Job reports and the roll-up reports. Information is available on the Content Insights, Items, and Log pages.

...

This information can be exported to a csv file for further review using the Export this report link. The export includes the following information.

Field

Description

source_id

The ID assigned to the file on the source platform

source_name

The filename on the source platform. The source and destination file names may not match if SkySync needed to sanitize the the filename due to character or length restrictions for the destination platform.

source_path

The path where the file is located on the source platform.

destination_id

The ID assigned to the file on the destination platform

destination_name

The filename on the destination platform. The source and destination file names may not match if SkySync needed to sanitize the the filename due to character or length restrictions for the destination platform.

destination_path

The path where the file is located on the destination platform.

link

The URL for the link detected.

count

The number of times the link was found in the file.

Link counts for spreadsheets will not always match depending on how the link was added to a cell. If the links are added to multiple cells at the same time, SkySync reads 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 cell at a time), SkySync counts each cell as separate. In this instance, each link is counted individually.

Items

In addition, the Items page has additional options to allow you to view link information. You can filter the Items page to show just items that have links by selecting Feature as the filter and then selecting Files with Links as the value for the filter. The page will display only files that have links.

...

When creating the job through the REST API, you can enable Link Detection in the transfer block by sending “link_detection” set to “true.”

POST {{url}}v1/jobs

Code Block
{
  "name":"Job Name",
  "kind": "transfer",
  "transfer": {
      "transfer_type": "copy",
      "link_detection": "true",
      "source": {
        "connection": { "id": "source_connection_id" },
        "target": {
          "path": "source_connection_path"
        }
      },
      "destination": {
        "connection": { "id": "destination_connection_id" },
        "target": {
          "path": "destination_connection_path"
        }
      }
  }
}

Export Link Detection Report for a Specific Job

The code below will export the link detection report for a specified job (if the job has any embedded links). The report will be exported to a CSV file.

Code Block
GET {{url}}v1/transfers/{job}/links.csv

You can specify multiple jobs by separating the job IDs with commas.

Code Block
GET {{url}}v1/transfers/jobs=jobID1, JobID2, JobID3/links.csv

Export Link Detection Report for All Jobs

The code below exports the link detection report for all jobs (if the jobs has any embedded links). The report will be exported to a CSV file.

Code Block
GET {{url}}v1/transfers/links.csv