- Welcome to the Knowledge Base
- Introduction to Workbooks
- Using the Knowledge Base
- Editions & Licensing
- Logging In
- Supported browsers
- Landing Pages
- HTML Editor
- Welcome Messages & Bulletins
- Exporting Data
- Multi Language
- Notifications & Reminders
- Workbooks Mobile Client
- Forecasts & Quotas
- Introduction to Importing
- Preparing your Import Data
- Workbooks Import Wizard
- Managing your Imports
- Introduction to Marketing
- Marketing Campaigns
- Mailing Lists
- Upload Library
Workbooks Web Insights
- Tracking Code
- Setting up the Plugin
- Viewing Web Insights Data on your Form Layouts
- Domain Names and Online Activities
- Gator Popup
- Reporting incorrect Leads created through Web Insights
- Reporting on Web Insights data
- Using UTM Values
- Why aren’t Online Activities being created in the database?
- Why is GatorLeads recording online activities in a foreign language?
- Using HubSpot with Workbooks
- Introduction to Event Management
- Enabling the Event Management Module
- Using Event Records
- The Event Management Portal
- Compliance Records
- Setting up the Integration
- Sending Mailshots using GatorMail
- GatorMail - Dynamic Content
- GatorMail Domain Setup
- GatorMail Field Mappings
- Managing your GatorMail Account
- Setting up GatorMail Workflows
Electronic Signing Tools
- DocuSign Functionality
- Setting up the DocuSign Integration
- DocuSign - Worked Examples
- DocuSign - Reporting
- Adobe Sign Integration
- Docusign Integration
- Creditsafe Integration
- Introduction to Zapier
- Available Triggers and Actions
- Linking your Workbooks Account to Zapier
Setting up Zaps
- Posted Invoices to Xero Invoices
- Xero payments to Workbooks Tasks
- New Case to Google Drive folder
- New Case to Basecamp Project
- New Workbooks Case to JIRA Ticket
- Jira Issue to new Case
- 123FormBuilder Form Entry to Case
- Eventbrite Attendee to Sales Lead and Task
- Facebook Ad Leads to Sales Leads
- Wufoo Form Entry to Sales Lead
- Posted Credit Note to Task
- QuickBooks Online
- Survey Monkey responses to Tasks
- Multistep Zaps
- Email Dropbox
Workbooks Exchange Server Sync
- WESS System Requirements
- Setting up the WESS
- Synchronising Emails
- Synchronising People & Contacts
- Synchronising Tasks & Meetings
- WESS Troubleshooting
- The WESS Add-in
Workbooks Outlook Connector
- Introduction to the Outlook Connector
- Before downloading the Outlook Connector
- Download/update the Outlook Connector
- Installing the Outlook Connector
- Using the Outlook Connector
- Outlook Connector Troubleshooting
- Microsoft Office
- Scribe/Workbooks Connector
People & Organisations
- Introduction to People & Organisations
- De-duplication and Merge
- Using Loqate
- Data Enrichment
- Introduction to Reporting
- Reporting Explained
- Displaying reports within Record Views
- Displaying Reports
- Adding a Report view to a Dashboard
- Exporting Reports
- Advanced Reporting
- Introduction to Transaction Documents
- Credit Notes
- Customer Orders
- Supplier Orders
- Contract Management
- Introduction to System Administration
Users & Security
- User Groups
- Account Settings
- Licences & Modules
Email & Integration
- Email Settings
- API Keys
- Web to Case and Web to Lead
- Preference Centre
- MailChimp, Constant Contact & dotMailer
- SharePoint Integration
- Bank Account Validation
- Creating & Modifying Picklists
- Creating Custom Fields
- Report-based Custom Fields
- Linked Fields
- Record Templates
- Form Layouts
- Customising relationships between parties
- Opportunity Stages
- Custom Records
- PDF Configuration
- Contact Support
Releases & Roadmap
- January 2020 Release
- September 2019 Release
- February 2019 - Event Management Release
- January 2019 Release
- October 2018 Release
- May 2018 Release
- February 2018 Release
- January 2018 Release
- November 2017 Release
- September 2017 Release
- June 2017 Release
- March 2017 Release
- December 2016 Release
- August 2016 Release
- January 2016 Release
- Workbooks Glossary
Creating a DocuSign Document with a Workbooks PDF
The DocuSign integration allows you to use either Workbooks PDFs or DocuSign Templates. This article covers how to setup a Workbooks PDF to use with the integration. This article assumes that you already have an existing PDF template to use with the integration. If you require a custom template to be developed, please contact firstname.lastname@example.org for further information. Before continuing with the Plugin, ensure that you have uploaded your PDF Template to Workbooks.
For Workbooks PDFs, you do not need to login to DocuSign to configure anything - all setup is completed within Workbooks. To access the integration configuration, click Start > Configuration > Email & Integration. Choose DocuSign.
Step 1 - Introduction
On the first page, select New Document then Continue. If this is the first document that you have configured, then you will taken straight to Step 2 below.
Plugin - Step 2 - Settings
Work through the Plugin settings, configuring them to your requirements as needed. See here for further information on each setting.
There are a few important settings that must be configured as detailed below for the integration to work with a Workbooks PDF Template:
- Select Workbooks PDF in the Integration Type picklist
- Select the relevant PDF Template Workbooks PDF Template picklist
- Select the Fields that will make up the PDF Name that is sent to the customer (defaults are applied if nothing is selected, see Settings URL above)
Click "Continue" when you are happy with the settings.
Step 3 - Configure AutoPlace Mappings
This step allows you to configure fields from your selected Workbooks record type to populate fields on the DocuSign document. The integration has the capability to default the field values on the DocuSign document to the value held within Workbooks. When the document is signed, the updated information can be reflected back in Workbooks.
For each mapping that is added here, the relevant Anchor String needs to be added to your Workbooks PDF code. The Anchor String must be a unique string in the PDF when it is generated, otherwise an interactive DocuSign Tag will be shown in all places where the Anchor String is repeated.
Workbooks recommends that Anchor Strings are added in the format "/TAG_NAME/" to minimise the risk of erroneous tags appearing in your document. We'd recommend that the Anchor String is also displayed in white font so that the user cannot see the text used by the integration, they will only see the DocuSign Tag which is placed automatically at the top left corner of the Anchor String when the document is generated.
To set up a new Mapping select the Add New button. In the dialogue box, populate the following information to create a new field mapping
- Docusign Tag Type: The DocuSign Field data type. The Tag Type can affect how data is displayed on the Document, more information can be found on DocuSign’s Support Site. Based on the Workbooks Custom Field type, we recommend reviewing this page which details the best type to use for the integration.
- DocuSign Anchor String: This defines where on the document the tag will appear if the tag is found by DocuSign in your template. See here for DocuSign's help page on Anchors.
- DocuSign Recipient Role: Although shown, this picklist can be left blank for DocuSign Templates.
- Workbooks Field: Select the field which will be used to initially pull through a value to the DocuSign Field. This field can then be updated if the field is made editable in the below setting. Otherwise, ensure you select Read Only below.
- Multi-select picklists are not supported in DocuSign and therefore, if configured in Workbooks, do not show in this list
- Picklist selections may break if they contain a semi-colon in the value, due to a limitation in DocuSign
- Additional Options: These options apply to the field when the recipient receives the document. Fields can be made: Editable, Read Only, Required, Hidden or Optional.
- Field Height: The height of the tag that appears on your document in pixels.
- Field Width: The width of the tag that appears on your document in pixels. If left blank, the default is set to 100.
Once you have added a mapping, it can be edited or deleted using the Actions button beside each row. 5 mappings are shown per page. A search feature is provided if you have several mappings - you can search by DocuSign tag name, DocuSign field type or Workbooks field name. Mappings are not stored until you click Continue.
Step 4 - Related Record Mappings
If you turned on the Update Related Records setting in Step 1, then a 2nd Mappings screen is shown. This screen allows you to configure mappings for fields that are on records related to the source record via a DLI field. For example, you may have a Contact DLI which relates a Person to your source document - this screen can be used to
The process for adding mappings is the same as Step 3. However, there are two slightly different options:
- Workbooks DLI Field: This is a list of all DLIs on the selected record type set in Step 1
- Workbooks Field: A DLI is driven from a report based on a record type. Once you select a DLI, this list will be populated with the fields from that record type.
- For example, if you have a Person DLI, the report will be based on People and thus the fields shown here will be for People records.
- This feature only allows you to drill through to one record. You cannot subsequently drill through to another record related to the first.
Again mappings can be edited or deleted using the Actions menu. They can also be searched. Changes will not be applied until you click Continue.
As per mappings for the Source record, Anchor Strings will need to be added to your PDF code to show these Tags when the document is generated.
Step 5 - Configuration Complete
The integration configuration for this document is now complete is ready to be generated and will now need to be added to the appropriate Form Layouts via a Button Process. This is fully documented here.