OneSpan Sign for Salesforce
This is the QuickStart Guide for OneSpan Sign for Salesforce. It is intended for Salesforce System Administrators who want a quick way to install and explore the product for the first time.
This guide describes:
- You are a Salesforce System Administrator, and have a Salesforce Sandbox account (on
- The eSignLive Administrator must have a Salesforce System Administrator profile, and both the username and the password must be the same.
- Chatter is enabled in Salesforce.
- You have an eSignLive Sandbox account. If you don't yet have an account, you can sign up for one.
- You have one of the following Salesforce Editions:
If you want, you can evaluate the application using a Salesforce Developer account or a Salesforce Professional account.
To install OneSpan Sign for Salesforce v4 for the first time:
- Open a web browser, and navigate to https://appexchange.salesforce.com.
- Using the search field at the top of the page, search for eSignLive.
- Click the OneSpan Sign for Salesforce app, and then click Get It Now.
- Click Log in to the App Exchange, and enter your Salesforce login credentials.
- Click Install in Sandbox. An Almost there! screen appears.
- Select the I have read and agree to the terms and conditions box.
- Click Confirm and Install.
- On the screen that appears, enter the username of your Salesforce Sandbox account. The Transaction Installation Details page appears.
- Click the Install for Admins option, and click Continue. An Approve Third-Party Access dialog box appears.
- Select the Yes, grant access to these third party web sites box, and click Continue.
- If you have a Production Salesforce installation:
- Review the displayed information, and click Next. A Choose security level page appears.
- Select Grant Access to Admins Only, and click Next. An Install Transaction page appears.
- Click Install.
- After the installation is complete, click Manage Licenses, and assign the Salesforce license to the user who wants to use OneSpan Sign for Salesforce.
- The eSignLive Installed Transaction Details page appears, enabling you to review the application details.
Because you are installing the application for the first time, you have only one Salesforce license. For additional licenses, contact your eSignLive CSR (Customer Satisfaction Representative).
This section describes the following aspects of configuring the solution:
- You are both a Salesforce System Administrator and an eSignLive Administrator.
- Your Salesforce Sandbox account is configured with a First Name, Last Name, and Email Address. These values are the same as those used for your eSignLive Sandbox account.
OneSpan Sign for Salesforce must be connected to your eSignLive Sandbox account.
To connect OneSpan Sign for Salesforce to your eSignLive Sandbox account:
- Log in to the relevant Salesforce.com organization as a System Administrator.
- Click the Salesforce.com App Menu in the top-right corner. From the drop-down menu, select eSignLive. The eSignLive Transactions Home page appears.
- Click the Admin tab. The eSignLive Admin page appears.
- In the eSignLive section of the Configuration tab, select your environment from the Environment drop-down menu. For more information on environments, see Environment URLs & IP Addresses.
- Choose eSignLive Credentials as the Connection Method. Then type your eSignLive username and eSignLive password in the text fields.
- Click Connect. A dialog box requests the permission to connect.
- Click Allow. A connection is established between OneSpan Sign for Salesforce and your Sandbox eSignLive account.
To enable an existing Salesforce user to access OneSpan Sign for Salesforce:
- Log in to the relevant Salesforce.com organization as a System Administrator.
- In the top menu, click Setup.
- In the Administer section, select Manage Users.
- Click Users.
- Click the name of the Salesforce user.
- Click Permission Set Assignments, and then click Edit Assignments. In the Permission Set Assignments page, set the permissions.
- Click Save.
To view descriptions of the Permission Sets, click Configuring Permission Sets. If you want to evaluate OneSpan Sign for Salesforce for the first time, select all the Permission Sets.
After you've installed and configured your solution, you can test it by sequentially performing the following procedures:
- Creating a Transaction
- Adding Documents
- Adding Signers
- Preparing Documents
- Sending the Transaction
- Signing the Transaction
To create a package:
- Log into Salesforce as a user who has permission to create a package.
- On the Salesforce menu, click Transactions. The Transactions Home page appears.
- In the Recent Transactions section, click New.
- Enter a Transaction Name.
- Click Next. The package is created, with the logged-in user as its default signer.
The system supports a maximum of 5 MB per document (smaller documents yield better performance — we recommend under 5 MB per document). However, there is no limit to: (1) the number of documents in a transaction; (2) the total collective size of documents in a transaction.
To add documents to your package:
- From the Documents section of the package, click Add Document. A new page appears.
- Click Upload local files.
- Click Choose Files.
- Select one or more files from your local directory, and click Open.
- Click Add selected documents. The documents you selected are added to the package.
To add two signers to your package:
- From the Signers section of the package, click Add Signer. A new row appears.
- From the drop-down menu in that row, select Contact.
- Click the magnifying glass next to the Lookup field, and select a Contact.
- Click Add Signer again. A new row appears.
- From the drop-down menu in that row, select External Email.
- Manually enter the First Name, Last Name, and Email of a suitable signer.
- Click Save Signers. The two signers you specified are added to your package.
To prepare your documents for signing:
- While viewing your package (to which one or more documents have been added), click Prepare.The Designer view appears.
- On the Electronic Disclosure and Signature Consent agreement, click the right-facing arrow to display the package's first document.
- From the drop-down Signers menu, select a signer.
- Click Add Signature to add a Signature Block for that signer.
- Drag the Signature Block to where you want it to appear in the document.
- If you want to change the Signature Block type, or if you want to add a field, click the gear icon. The Signature Block menu appears.
- Repeat Steps 4-7 for each Signature Block you want to add to the document.
- If there is another document, click the right arrow to display it, and repeat Steps 4-8.
- Repeat the previous step for each document in the package.
- Close the window by clicking the X in the upper right corner.
To send your package to be signed:
From the Transaction Edit page, click Send. The package is sent to be signed, and each signer receives an appropriate email.
To sign the documents in your package:
- If you are the Transaction Owner as well as a signer (with at least one assigned Signature Block), on the Transaction Detail page, click Sign. A preview window displays the first document.
- If you are a signer but not the Transaction Owner:
- In the email you received, click Go to Documents.
- Read the Consent Agreement, and click Accept. A preview window displays the first document.
- Sign all of your Signature Blocks in the document. Those blocks should be indicated by sticky notes.
- To confirm your signatures in the current document, click OK.
- Repeat Steps 3-4 for each document in the package.
- Once all your signatures have been applied, a refreshed version of the screen confirms that you have finished signing the package.
- To verify that all documents in a completed package have been signed, in the Documents section of the Transaction Detail page, click the icon under Signed Documents. This enables you to download your documents. Open each document, and verify that all its Signature Blocks have been signed.
If any unsigned Signature Blocks lie outside your screen, an Unsigned Signatures notification displays the number of signatures that are still required.
A progress bar at the top of the document indicates the number of signatures you have completed, as well as the total number of signatures assigned to you in this document (e.g., 3/10 completed).
Once a package has been signed by all signers, its status is changed to Completed. To view that status, it may be helpful to refresh your page.
To learn more about using OneSpan Sign for Salesforce v4, see the OneSpan Sign for Salesforce 4 User's Guide.