About this article
This article will explain how to set up Salesforce as an App Connector. This means, opening Templafy directly from within Salesforce. The App Connector module must be activated before you can connect to Salesforce as an App Integration. Sections in this article:
- Setting up Salesforce as an App Connector in Templafy
- Installing the Templafy Salesforce app Package in Salesforce
- Configuring the installed Templafy app in Salesforce
- Deploying the configured application within the section in Salesforce where the Templafy app can/should be initiated in
- Troubleshooting
Prerequisites
|
|
In order to have the Templafy app running in Salesforce, there are four steps to follow.
-
Set up the app connector in Templafy.
-
Install the Templafy Salesforce app Package in Salesforce.
-
Configure the installed Templafy app in Salesforce.
-
Deploy the configured application within the section in Salesforce where the Templafy app can/should be initiated in.
Setting up Salesforce as an App Connector in Templafy
- In the Admin Center, access
Integrations
section - Go in
Available
tab - Find/Search for
Salesforce
- Click
+
- Enter the required information
Display Name
Salesforce Tenant Domain Name
|
Installing the Templafy Salesforce app Package in Salesforce
|
- Follow the link provided by Templafy:
- Install Templafy and specify to which group:
- Grant access:
- The installation will process.
- The installation is complete.
- Click
Done
. - The app should now appear under
App Manager
.
Configuring the installed Templafy app in Salesforce.
- Under
App Manager
locate the Templafy app and clickManage
.
- Click on
Edit policies
.
- From the
Permitted Users
combo box selectAdmin approved users are pre-authorized
and save changes.
- After changing the type of permitted users and saving the changes, under the settings of the app, a new section appears called
Profiles
. Click onManage Profiles
.
- From
Application Profile Assignment
select the profiles which will or should have access to the application and save the changes. Example selection could be:Standard User
-
System Administrator
Deploying the configured application within the section in Salesforce where the Templafy app can/should be initiated in
The Templafy app can be launched from within several sections in Salesforce. For instance, it can be initiated from an Opportunity object page, Lead/contact object page, and Account object page amongst others. In this example, we will configure the app to be launched from within an opportunity, but you can configure it on as many pages as you desire as long as the page supports file uploads.
- Once you are in the desired location in which the Templafy App connector should be present, click on
Edit Page
- In this section, you will be now able to place the Templafy button in the area of the page you would like it to appear for the end-user. On the left-hand side, under
Components
, and inCustom-Managed
, the Templafy app should be present.
- The Templafy app can now be dragged to an insertion point for the component, either in an empty region or before or after another component.
- Once dropped, Salesforce will indicate you the component is still not yet valid. This is because you still need to configure the app so that it knows to which Templafy tenant it should connect to, and which should be the default Templafy directory, the web app should open. This can be configured on the right-hand side of the page.
-
Templafy tenant name
should be filled with the tenant's name, NOT the full URL. -
Templafy default directory
should include the slash. -
Related data to include
is an optional setting that will allow you to make Salesforce lists linked to the current object available for adaptive sections with HostSystem.
-
- Save the changes.
|
- You can now go back to the page, and the Templafy
Create Document
button will be visible and ready to be launched. It will be now visible in all Opportunities.
After the configuration is done, the next step is to set up your templates to use the data from Salesforce, which is explained in the article How to find the data available from the Salesforce App Connector.
|
Troubleshooting
As of Summer 2023, Salesforce has introduced new security settings that do not allow the Salesforce App Connector to work correctly. For new Salesforce instances, this setting is automatically enabled.
When using the app connector, and this setting is enabled, the following error may be thrown.
Uncaught (in promise) DOMException: Failed to execute 'postMessage' on 'Window': #<Object> could not be cloned.
To ensure the Salesforce App Connector works as expected, you can disable this setting in the Salesforce app setup.
In the left menu, click on Session Settings
under Security.
Scroll to the section titled Lightning Web Security
, and ensure the option in this section is unchecked.
Comments
0 comments
Article is closed for comments.