Versions Compared

Key

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

Introduction: This integration guide describes how to connect the Salesforce.com CRM platform to the Docupace document management system for the companies that use both systems.

Expand
titleChange Log

Date

Changes

August 2023

Note about the Person Account object in FSC.

New features from the R1 2023 release.

January 2023

Contact object is not used anymore.

Formatting.

The Docupace Integration package creates two new objects in the Salesforce system - Docupace Work Item and Docupace Document. These objects will contain information from the corresponding objects in Docupace. Their content will synchronize automatically to the data in Docupace.

After installing the Docupace Integration package on the Salesforce site and configuring all necessary settings, you need to add Docupace menu items (buttons) and apps (related lists) to the layouts of Salesforce objects. This example shows how to add Docupace menu items (Docupace Dashboard, Docupace Client Folder, and Docupace Starting Point) and apps (Docupace Documents and Docupace Work Items) to the layout of the Account page in the Salesforce Lightning UI and customize them.

Note

Important! Depending on the Salesforce license that your company owns, the standard included objects, their record types and respective layouts may differ. E.g. Financial Services Cloud solution has four record types for an Account object (Business, Household, Individual, and Institution) and additionally a Person Account object. All five of these layouts will need to be configured in the same way as described in this section of the guide.

Step 1: Add Mobile & Lightning Actions to Account Page Layout

Rw ui steps macro

In Salesforce Lightning, open the Setup section.

Rw step

Open the Object Manager (in the top toolbar). A list of all objects is displayed. Scroll down or use Quick Find to find the Account object.

Rw step

Click on the Account object name to open.

Image RemovedImage Added
Rw step

Open Page Layouts section. A list of layouts for that object is shown.

Rw step

Click on the layout you need to modify. A page with all layout elements is shown.

Rw step

In the list of elements, open Mobile & Lightning Actions.

Rw step

In the page layout, scroll down to the Salesforce Mobile & Lightning Experience Actions section.

Rw step

Drag and drop Docupace menu items (Docupace Starting Point, Docupace Dashboard, and Docupace Client Folder) from the list of elements to this section. Place them at the very beginning of the section.

Audience: Business Analysts and Developers who need to connect Salesforce.com to Docupace.

Info

Functionality: Steps that must be performed within Salesforce.com to set up Docupace menus and related lists.

Filter by label (Content by label)
max5
sortmodified
titleRelated Pages
cqllabel = "salesforce"

Step 2: Add Apps to Related Lists Section of Account Page Layout

Rw ui steps macro
Rw step

In the list of elements, click Related Lists.

Rw step

Drag and drop Docupace apps (Docupace Work Items and Docupace Documents) from the list of elements to the page layout.

Rw step

When all two items have been moved to the page layout, click Quick Save in the Account Layout toolbar.

Note: If a confirmation pop-up appears, click Yes.

Step 3: Customize the Docupace Work Items App

Rw ui steps macro
Rw step

Click on the Properties icon for the Docupace Work Items app.

Rw step

Move the following fields to the Selected Fields side by clicking Add.

  • Request Type

  • Task Name

  • WorkItem Detail

  • Product Type

  • Request Status

  • Created By

  • Created Date

Note: See the full list of available columns in section Available App Columns for Docupace Work Items and Documents.

Tip

Tip: Select the column name and click Up or Down, to arrange the desired order.

Info

Rw step

Then expand the Buttons section of the dialog and deselect the New button, as it is not useful to Salesforce users (new Work Items for an account will be created with the Docupace Starting Point button). Then click OK to confirm the new properties. Click Quick Save in the Account Layout toolbar.

Step 4: Customize the Docupace Documents App

Rw ui steps macro
Rw step

Click on the Properties icon for the Docupace Documents app.

Image RemovedImage Added
Rw step

Move the following fields to the Selected Fields side by clicking Add.

  • Docupace Id

  • Document Name

  • Display Document

  • Display Barcode

  • Description

  • Registration Type

  • Product Type

  • Vendor/Custodian

  • Created By

  • Created Date

Note: See the full list of available columns in section Available App Columns for Docupace Work Items and Documents.

Tip

Tip: Select the column name and click Up or Down, to arrange the desired order.

Rw step

Then expand the Buttons section of the dialog and deselect the New button, as it is not useful to Salesforce users. Then click OK to confirm new properties. Click Quick Save in the Account Layout toolbar.

Step 5: Add a Visualforce Page Element for Account Page Layout

Rw ui steps macro
Rw step

In the list of elements, click Visualforce Pages.

Rw step

Drag and drop DocupaceFetchAccountDocuments app from the list of elements to the Account page layout.

Rw step

Click on the properties for this element. Change Height to 0 pixels. Click OK in the pop-up window.

Rw step

Then click Save in the Account Layout toolbar to keep the changes and exit the page layout. If a confirmation pop-up appears, click Yes.

Rw step

If your Salesforce license has several Account layouts (e.g. Business, Household, Individual, etc.), repeat all the steps in this section of the guide for each of the layouts.

Rw step

To check the result, open any account in Salesforce and refresh the page (F5). Docupace buttons appear in the toolbar. Lists of Docupace documents and work items appear in the Related tab.

Tip

Congratulations! The integration steps are complete. You may now use Salesforce and access Docupace entries for your Accounts.

Available App Columns for Docupace Work Items and Documents

Anchor
App-Columns
App-Columns

Expand
titleExpand to see available Docupace Work Item Columns
  1. Client Detail (link)

  2. Client ID

  3. Client Sub Folder

  4. Client Sub Folder Detail (link)

  5. Contact

  6. Created By

  7. Created By Alias

  8. Display Barcode (link)

  9. Documents List (link)

  10. Event Type

  11. Last Activity Date

  12. Last Modified By

  13. Last Modified By Alias

  14. Last Modified Date

  15. Last Note

  16. Opportunity ID

  17. Other Description

  18. Owner Alias

  19. Owner First Name

  20. Owner Last Name

  21. Product Description

  22. Product Type

  23. Record Id

  24. Rep First Name

  25. Rep Last Name

  26. Request Number

  27. Request Status

  28. Request Type

  29. Subfolder Status

  30. Task Name

  31. Work Item #

  32. Work Item Detail (link)

Expand
titleExpand to see available Document Columns
  1. Contact

  2. Create Date

  3. Created By

  4. Created By Alias

  5. Created Date

  6. Description

  7. Display Barcode (link)

  8. Display Document (link)

  9. Display Index (link)

  10. Document Id

  11. Document Name

  12. Document Type

  13. Docupace Id

  14. First Name

  15. Last Modified By

  16. Last Modified By Alias

  17. Last Modified Date

  18. Last Name

  19. Owner Alias

  20. Owner First Name

  21. Owner Last Name

  22. Pages

  23. Product Type

  24. Record ID

  25. Registration Type

  26. Subfolder Type

  27. Vendor/Custodian