Use Salesforce

Introduction

It’s quite easy to start using the Plumsail Documents app for Salesforce:

  1. Set up a document generation process.

  2. Set up a Plumsail app in Salesforce.

  3. Add a Plumsail widget to the required object.

That’s it! We’ll review each of the steps in more detail further in the article.

Set up a document generation process

For demonstration purposes, we are using Opportunities in Salesforce. We also created a quote template that matches this Salesforce object. It is already populated with tokens, or special placeholders, from the opportunities.

You can start creating a process by the link above or find the template manually. For that, start from template:

Salesforce create process from template

Then search for the Salesforce one:

Salesforce create process from template

Name the process and proceed to the settings:

Salesforce create process from template

In the template settings we choose PDF as the output for the result file.

Salesforce process PDF output

Let’s explore how to use the app for Salesforce.

How to add a button and choose a process to run

Open an app launcher in Salesforce and search for Plumsail Documents. Open it.

Search for Plumsail Documents

For connecting to your account, you need to use an API key. Copy it in your Plumsail account:

Copy an API key

Then paste the key in the Salesforce app.

Note

Pay attention to a region: it should match the one selected during registration of your Plumsail account.

Connect to a Plumsail account

On the next step, select a Salesforce object for which you need to start the process and create a new button. Later you can switch between objects and all related buttons will be safe.

Add a new button

Select a process to start, enter a button title, and define whether to attach the result file to the current record. After that add the new button.

Configure a new button

You can delete the button and change its properties if click it. The added button will be displayed in a Plumsail Documents component on a record page.

Added button

How to copy tokens and add them into the template

Let’s go back to our document generation process to add tokens from Salesforce to the document template.

We created a process using the Salesforce quote template based on the Salesforce Opportunities. Feel free to add or remove tokens from the template to align with your object fields. Start with editing the process.

Edit the process

And then edit the template online.

Edit the template

Open settings of Plumsail Documents in Salesforce, select the required object, and click Template tokens.

Open the list of template tokens

You will see all tokens available for the current object. Find the token you want to display in the generated document and click it to copy.

Copy a token

Paste the copied token into the template of the process.

Insert the token