Set up DocuSign to connect to Sage People

Setting up DocuSign to connect to Sage People uses standard DocuSign functionality. Learn the essential steps to follow and for more information on DocuSign, see https://support.docusign.com/en/home.

Note

A step in this task requires you to upload a configuration file to DocuSign. Ask your Customer Success team for the DocuSignToSFConfig2.xml file before starting these steps.

Resolution

  1. Log in to the DocuSign account you want to use with Sage People.

  2. In the top navigation panel, select Admin.

  3. Click Integrations and select Connect.

  4. Select Add Account Configuration and select Salesforce.

  5. Select Production, the latest API version, and select OAuth.

  6. Click Save.

  7. Sign in to Sage People with your Production login credentials when the system prompts you to complete the connection. We recommend performing this with your Sage people Docusign user.

  8. Select Edit next to your newly setup connection and check Enable Log.

  9. Select the users you want to integrate:

    Screenshot: Selecting All Users to be included into the DocuSign connection to Sage People

  10. Under Trigger Events, select the checkboxes to enable messaging for the envelope and recipient events you want to see. Typically, select all for testing and initial operation:

    Screenshot: Selecting all options under Trigger Events for testing purposes

  11. Select Save.

  12. Select Actions then select Upload:

    Screenshot: Selecting Actions > Upload for the Salesforce connection

  13. Find and select the file:

    DocuSignToSFConfig2.xml

    This file contains the default object-level mapping between Sage People and DocuSign.

  14. DocuSign asks you to confirm; select OK.

    If you redisplay the Salesforce Connect configuration, DocuSign displays the configuration details including the default mapping:

    Screenshot: Connect Objects screen on DocuSign

  15. Select Go to DocuSign:

    Screenshot: Go to DocuSign link on DocuSign

  16. In the top navigation bar, select Templates, then select New and New Template:

    Screenshot: Selecting New to create a new DocuSign template

  17. Enter a Template name and upload your document.

    • A template can contain multiple documents

    • Choose an Online Document lets you select a document from Box, Google Drive, Salesforce, or other online source

  18. In the Add Recipients to the Envelope section, add Recipient Roles for each type of recipient. Indicate the routing order for the system to follow when distributing the document.

    For example, for a form HR needs to complete and sign before sending to an employee, add HR and Employee roles. Set HR with Order number 1, Employee with Order number 2:

    Screenshot: Add Recipients to the Envelope screen

    • Leave Email and Name blank. Sage People supplies these on distribution

    • You can repeat roles in the Order sequence for forms needing completion and validation in multiple stages

  19. In the Message section, customize the Subject line. Add a message you want to send with the document.

  20. Select Next.

    DocuSign prompts you to tag the document.

  21. DocuSign displays the form for tagging. Drag and drop the tags from the left panel onto the form data fields. Do this for each of the recipients you've defined.

    • Make sure you tag all fields requiring completion. The system can't extract or map data from untagged fields

    • Create Custom Tags to tag fields the Standard tags don't cover

    • Set Custom Tag properties to validate input using one of the supplied masks. For example for zip code, or by specifying a regular expression (regex), for example for Social Security Number

    • You can set the recipient in Tag properties from your list of Recipient roles. This dictates who can complete or edit each field, important for the Signature fields

      Note

      We also know DocuSign Tags as Tabs. Tags in the form within DocuSign become Tabs when they return to Sage People. The two terms are synonymous.

  22. When you've finished tagging the form, select Save and Close.

  23. Select Go to Admin:

    Screenshot: Selecting Go to Admin in DocuSign

  24. Select Integrations then select API and Keys:

    Screenshot: Selecting API and Keys

  25. Copy the API Account ID and save it to use when setting up Sage People HCM for DocuSign.