On This Page
Table of Contents | ||
---|---|---|
|
Overview
The Docusign connector allows you to migrate your Docusign documents from your Docusign account to your content storage platform. Because this connector is created with read-only access, the connection will be able to read content but cannot be used to create or take action against it. Therefore, the connector can be used as a source connection for Migrate jobs, Discover scans, and for Govern policies that do not use actions. The connector should not be used as the destination connection for Migrate jobs or for Govern policies that require actions to be taken against the content (delete, move, etc).
Note |
---|
The Docusign connector currently only works with Discover scans using the File Inventory template. It does not currently work with any other Discover scan templates. It also does not currently work as a connector for Govern policy scans. |
Creating a Connection
Expand the Manage section in the left navigation menu.
Click Connections.
Click Add connection.
Select Docusign as the platform on the Add connection modal.
Enter the connection information. Reference the table below for details about each field.
Click Sign in with Docusign.
You will be prompted to provide the email address and password for the account you are using to create the connection. (If multi-factor verification is set up for your Docusign account, you will be required to complete additional verification steps as well.)
You will see a green "Connected” message on the bottom of the modal when DryvIQ establishes connection. (If the connection fails, verify the information you entered.)
Click Done to finish creating the connection.
Add Connection Modal for Docusign
Field | Description | Required |
---|---|---|
Display as | Enter the display name for the connection. If you will be creating multiple connections, ensure the name readily identifies the connection. The name displays in the application, and you can use it to search for the connection and filter lists. | Optional |
Platform API Credentials | Required | |
Use the system default client credentials | Select this option to use the default DryvIQ client application. | |
Use custom client credentials | Select this option to use custom client credentials provided by your administrator. When selected, two additional fields will be available to enter the credentials. | |
Client ID | This field displays only when you select Use custom client credentials. This is the client ID required to connect to the Docusign account. This value will be provided by your administrator. | Optional |
Client Secret | This field displays only when you select Use custom client credentials. This is the client secret required to connect to the Docusign account.This value will be provided by your administrator. | Optional |
Features and Limitations
Platforms all have unique features and limitations. DryvIQ’s transfer engine manages these differences between platforms and allows you to configure actions based on Job Policies and Behaviors. Use the Platform Comparison tool to see how your integration platforms may interact regarding features and limitations.
Supported Features | Unsupported Features | Other Features/Limitations |
---|---|---|
File size maximum: 25 MB | ||
File and folder creation and modification | Invalid characters: / \\ | |
Permission preservation | Restricted types: Docusign supports only a specific file formats. See Supported File Formats below. | |
Segment path length: 255 | ||
Docusign File Size Limits
Docusign limits individual files uploads within an envelope to 25 MB. Envelopes are limited to 130 documents. Refer to the following Docusign Support pages for more information: File Size Limitations for an Envelope and Docusign Document and Envelope File Size Limitations. The Docusign connector currently only supports moving content out of a Docusign account; therefore, the Docusign file size limits are less of an issue for the Docusign platform, and you need to verify your destination platform size limit is above 25 MB (which most platforms support).
Docusign File Size Reporting
Docusign does not track file size and provide it as part of its API. Therefore, DryvIQ cannot report on the content size for Docusign. When viewing migration job reports or discovery scan results in DryvIQ, the content size will be reported as 0 B.
Permissions
Item Permissions
Docusign permissions are based on permission profiles. Each user is assigned a permission profile, and a user has the same access to all items to which the profile grants the user access. If you enable permission preservation for a migration, DryvIQ will assign item permissions as follows when transferring items to the destination platform.
Docusign Permission Profile | New Permission Access Right |
---|---|
Administrator | FullControl |
Viewer | Read |
Sender | ReadWrite |
Custom Profile with account management permissions | FullControl |
Custom Profile without account management permissions | Read |
Shared Access
Docusign supports shared access through authorizations that are applied per user, so all items will have the same shared accounts. However, there are different levels of access. If you enable permission preservation for a migration, DryvIQ will assign shared access permissions as follows when transferring items to the destination platform.
Docusign Permission Profile | New Permission Access Right |
---|---|
Manage | FullContol |
Send | Read |
Sign | Read |
Edit | ReadWrite |
Shared Templates
When a template owner shares a template with another account, the template will be listed on the account's Shared with me page. However, the template will not be transferred as part of the account’s content unless it is moved into the account’s Shared Folders using the Share to Folders option. The Docusign API will not read templates outside of the Shared Folders.
Supported File Formats
Docusign eSignature supports the following file formats. However, Docusign does not support password security, so you must remove the security settings before DryvIQ can upload the file. Refer to Docusign support for more information about supported file types for Docusign eSignature.
Document Category | Supported Formats |
---|---|
Document | .doc, .docm, .docx, .dot, .dotm, .dotx, .htm, .html, .msg, .pdf, .rtf, .txt, .wpd, .xhtml, .xps |
Image | .bmp, .gif, .heic, .jpg, .jpeg, .png, .tif, .tiff |
Presentation | .pot, .potx, .pps, .ppt, .pptm, .pptx |
Spreadsheet | .csv, .xls, .xlsm, .xlsx |