Versions Compared

Key

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

...

On This Page

Table of Contents

Overview

The Permission Level Transfer Report can be exported through the DryvIQ Platform user interface or through the REST API. It provides the permissions assigned to each item at all levels of the hierarchy that were applied during transfer. The report includes only applied or equal permissions. The export does not include failed, skipped, or removed permissions.

In addition to providing information for the permissions applied for a job, the export can be used as a tool to expedite the creation of new permission mappings. The Permissions Import feature will accept the format of the Permission Level Transfer export, so you can use the export to create new permission maps as needed. Simply export the report, edit permissions as needed, and import the the CSV file as the permission mapping for the job you are creating.

The following features use permissions and will all generate the information for the report:

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

  • Simulation Mode/Analyzer

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

  • Jobs using Impersonation / Run as user

Exporting the Report in the User Interface

The Permission report available for export in the DryvIQ user interface is a full permission export. The report is saved as a CSV file in your default downloads location. (Some browsers will also display the file at the bottom of the browser window for quick access.) You can export the report from the Jobs and Reports areas.

Exporting the Report through Jobs

  1. Select Jobs.

  2. Select the job for which you want to view the report.

  3. Select Sharing Insights.

  4. Select Export full permissions report.

Exporting the Report through Reports

If a report includes multiple jobs, the export will include the permissions for all jobs in the report group.

  1. Select Reports.

  2. Select View full report on the report widget for which you want to view the report.

  3. Select Sharing Insights.

  4. Select Export full permissions report.

Exporting the Report Through the REST API

When exporting the report using a REST API call, you have the option of receiving a link through the call or viewing the CSV data within the response.

Get a Download Link

The following request produces a response that contains an href link. Copy and paste the link into your browser to download the CSV file.  

Code Block
GET {{url}}v1/transfers/permissions

View the CSV in the response

The following request produces a response that contains the report information in CSV format within the body of the message.

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

Override the Truncation Limit

Since the UI export only includes one million records, you can pull the report using the API to override the truncation limit. This is done by adding the page= and limit= parameters to the GET request. This allows you to pull the full report by page if needed.

Code Block
GET {{url}}v1/transfers/permissions.csv?page=#&limit=#
Note

Be sure to include both the page= and limit= parameter. If you only add the page= parameter, the report results will default to 100 and not one million.

Requesting Specific Permissions Through

...

REST API

Through the REST API, you have the option to request permissions by job, user/account map, item, audit trail, or a combination of each. Each can be passed in as a query string parameter. See the examples below for usage.

Option

Description

QUERY STRING PARAMETER

Example

Transfer Item ID’s

The transfer item identifier for the item located on the source platform

"item"

"item_id"

"transfer_item_id"

"items"

"item_ids"

"transfer_item_ids"

Code Block
GET {{url}}/v1/transfers/permissions?items

Include

The indicator to include all

“all”

Code Block
GET {{url}}/v1/transfers/permissions?include=all

Security Map ID’s
(ID assigned to a user through the User / Account map)

The identifier assigned to the user mapped in the job leveraging the user / account map

"security_map"

"security_maps"

"security_map_id"

"security_map_ids"

Code Block
GET {{url}}/v1/transfers/permissions?security_map_ids

Job ID’s

The identifier assigned to the job transferring the permissions and content

"job"

"jobs"

"job_id"

"job_ids"

Code Block
GET {{url}}/v1/transfers/permissions?jobs

audit_trail

The audit category for content

“null” (the permissions are new and haven’t been applied to the destination)

“created-by”

“modified-by”

Code Block
GET {{url}}/v1/transfers/permissions?audit_trail

Example Requests

The following examples show how to use the query parameters in combination with each other.

...