Salesforce Conga Composer Integration - Infogen Labs

Salesforce – Conga Composer IntegrationThe Context Conga Composer enables Salesforce customers to customize, streamlineand scale document generation and reporting for Salesforce. Composercan automatically populate richly formatted templates with data from anystandard or custom object in Salesforce and send it via a variety ofdelivery options. The administrator configures Composer Solutions for end-users to runComposer from a button or link on an object in Salesforce. Theadministrator decides what Salesforce object data to leverage, create thedocument templates, dictates formatting, and determines thecustomization options available to end-users. End-users can then click thebutton to run the solution. The administrator can allow end-users to make selections, such as whichtemplate to use for the final merged files, or pre-select templates andother options and run the solution entirely in the background, and alsoautomate solutions using Salesforce workflows or on a schedule usingConga Batch and Conga Trigger. Once documents are created, Composer can also allow you to emaildocuments, send documents for eSignature, or store the documents inservices like Box, Google Drive, or OneDrive for safekeeping. 2022 Infogen Labs Corporation All rights reserved

With the ability to predefine everything from templates and emailrecipients to activity logging and output file storage, Composer transformscomplex routines into single button clicks.What Does Conga Composer do? Conga Composer makes it easy to create and deliver sophisticateddocuments, presentations, and reports from Salesforce by automaticallypopulating richly formatted templates with data from any standard orcustom object. Create - Conga Composer offers document generation capabilities tocreate virtually any important document, report, or presentation usingSalesforce data. Placing a custom button or link on any object’s pagelayout gives you immediate access to all its fields. Salesforce reports orSOQL queries can retrieve any additional required data from as many as50 other objects or lists. Distribute - Conga Composer offers a variety of options for downloading,storing, and delivering your output files: oImmediately downloadedoSaved directly in Salesforce, Google Drive , or SpringCM oAutomatically emailedoSent for eSignatureAutomate - Composer doesn’t just produce and deliver documents – itautomates entire business processes. Use parameters to control thebehavior of your Composer button and streamline the user experience.You have a wide variety of options – preselect up to 10 templates togenerate one or more output files, use parameters to restrict options inthe user interface, or enable background mode to bypass it entirely. 2022 Infogen Labs Corporation All rights reserved

ApproachAnatomy of a Conga Composer ButtonThere are two types of Composer buttons: non-OAuth and OAuth (OpenAuthorization). Non-OAuth Buttons - All non-OAuth Conga Composer URLs start thesame way. The first three lines are identical in every Composer URL, andthe fourth line is customized to identify the Master Object from whichyou’ll be gathering data and running the solution. These first lines arereferred to as the Base URL, which looks like this:ohttps://composer.congamerge.com?Session ID {!API.Session ID}&ServerUrl {!API.Partner Server URL 210}&Id OAuth Buttons - OAuth (Open Authorization) is a different securityprotocol that is required for all Conga Composer buttons created in theSalesforce Lightning user interface. The Base URL of an OAuth buttonlooks like this:o/apex/APXTConga4 Conga Composer?serverUrl {!API.Partner Server URL 370}&id oIn both button types, the &Id parameter (or &id in the OAuthbutton) defines your master object – the Salesforce object fromwhich you will launch your Composer solution. The value of thisparameter will always be the ID of your master object. Forexample: 2022 Infogen Labs Corporation All rights reserved

Composer Parameters After the Base URL, you will see the Composer parameters that have beenadded to the Composer solution (assuming they have been added by theConga Admin). Parameters are settings that control the behavior of yoursolution. They always use the following convention:&ParameterName Value In the example below, you can see seven parameters have been added tothis Composer button URL:https://composer.congamerge.com?SolMgr 1&session ID {! API.Session ID}&serverUrl {! API.Partner Server URL 290}&Id {!Opportunity.Id}&Template ID a0436000001AbCp&CongaEmailTemplateId a0236000001gl7C&Template Group Invoice&DefaultPDF 1&OFN Conga Invoice - {!Opportunity.Name} - {!Today}&SC0 1&SC1 Attachments The parameters in this example control template selection, output filetype, output file name, and where to save a copy of the output document.For more information about parameters, see Customizing Composer withParameters and the Parameter Guide. 2022 Infogen Labs Corporation All rights reserved

How to Populate Parameter values? - There are three ways topopulate parameter values:oType the value into the parameter (using Solution Manager ormanually).oUsing a Salesforce merge field (such as {!Opportunity.Id}, whichwill dynamically update with a value when the solution is run.oUsing a Qvar, which allows you to retrieve data with a Conga Queryand then pass that data to another parameter to use as the value.Installing Composer from the Salesforce AppExchange Conga Composer Technical Requirements – Go through CongaComposer Technical Requirements for supported browser and internetdetails. To install Conga Composer – Follow below steps:oInstall Conga Composer into your Salesforce instance by visitingour listing on the AppExchange.oClick Get It Now and follow the on-screen prompts to installConga Composer.oLog in to the AppExchange.oSpecify where you want to install Conga Composer.oClick Install in production to install in your production instance.oClick Install in sandbox to install in a sandbox.oRead and accept the terms and conditions.oSelect the I have read and agree to the terms and conditions box.oClick Confirm and Install.oAs a best practice, and to avoid access issues for end-users Congarecommends selecting Install for All Users. Then click Install.oOnce the package is installed, to check the package in Salesforcefollow the below steps: Click on setup- In quick find search for‘Install package’ - Click on ‘Installpackage’. 2022 Infogen Labs Corporation All rights reserved

What's in the Composer Package? – To view component and object ofConga composer please go through Composer Package details.Assign User Licenses When installing Conga Composer from the AppExchange, the defaultlicense count upon installation is 10, one of which is assigned to theadministrator who installed Composer. To assign the remaining licenses for Conga ComposeroNavigate to the Installed Packages in Salesforce Setup.oClick Manage Licenses next to Conga Composer.oClick Add Users.oSelect the box to the left of names of the users who need access toConga Composer.oClick Add to add the selected users.oClick Add Users to save changes.Permissions Needed to Use ComposerUser permissions and access settings are specified in profiles and permission sets.Every user is assigned only one profile, but can also have multiple permissionsets. When determining access for your users, use profiles to assign the minimumpermissions and access settings for specific groups of users. Then use permissionsets to grant more permissions as needed. 2022 Infogen Labs Corporation All rights reserved

Configuring Profile Permissions –oWhen installing Conga Composer from the AppExchange, selectInstall for All Users. If you did not initially install Composer for allusers, you will need to modify the field level security for each fieldon the custom Conga Objects.oTo edit Profile permissions, navigate to Setup Manage Users Profiles.oFor every Profile that runs Composer: Minimum of Read Access to all custom Conga Objects(Conga Email Templates, Conga Global Merges, CongaQueries, Conga Solutions, Conga Solution Email Templates). Minimum of Read Access to ALL Objects and Fieldsincluded in the merge templates (keep in mind the mostrestrictive settings apply, so if a user has visibility to a fieldbut not the Object, they will not be able to merge data fromthat field). Minimum of Create permission to the DocumentsObject is needed if the user is going to utilize emailfunctionality in Composer. Check API Enabled under Administrative Permissions. Check Run Reports and Export Reports (if you are usingreports with your Composer solutions) and also ensure thereport folders that contain your Composer reports areshared with end-users. Configure Composer as a Connected App for any Profilesthat will use the OAuth button (this is required to use CongaComposer in the Salesforce Lightning interface). If you save output data to chatter, update System Settingsto check Moderate Chatter. Enable Custom Setting Definitions Access ComposeroConga Composer.APXTConga4.CongaComposer SettingsoConga Composer.APXTConga4.CongaSolutions Settings Enable Custom Metadata Type Access Composer 2022 Infogen Labs Corporation All rights reserved

oAPXTConga4.Composer SettingoAPXTConga4.Conga Solution ExportEnvironmentoAPXTConga4.Conga Solution ExportSettingo oAPXTConga4.Connected App SettingBatch (if Conga Batch is installed)oAPXT BPM.Conductor RegionoAPXT BPM.Conductor SettingTrigger (if Conga Trigger is installed)oCongaWorkflow.Workflow RegionoCongaWorkflow.Workflow SettingNavigate to Setup Security Controls Session Settings andensure that Lock sessions to the IP address from which theyoriginated is not enabled. Configuring Permissions Sets –oConga Composer is installed with the following Permission Sets thatyou can use for user access and permissions. Composer Administrator: Setup permissions for CongaComposer Administrator. Composer User: Setup permissions for Conga ComposerUser. Composer Salesforce Community User: Setuppermissions for Conga Composer Communities User.Create ‘Conga Solution’ record and create an action/button to generatethe document Click on the app launcher icon and select the ‘Conga Composer’application. Click on the ‘Conga Solutions’ tab - Enter ‘Conga Solution Name’ andselect ‘Master Object’ (Account) - Click on the ‘Create Record’ button. Open the conga solution record which you created in step 2. There will bethe option ‘Create button’ which will automatically create a button/action 2022 Infogen Labs Corporation All rights reserved

on the master object (Account) which you selected in step 2 to generatethe document. Newly created button/action will automatically add to the master object(Account) page layout. If not added, then follow the below steps to add abutton/action to the master object page layout. Click on Setup- Object Manager - Click on master object name (Account)- Page Layout - From ‘lighting and mobile action’ drag action/buttonwhich is generated and add button/action under ‘Mobile and lighting actionsection’.Create ‘Conga Template’ record to upload your template which you willuse to generate documents from records Click on the ‘Conga Template’ tab. - Click on the ‘New’ button. Enter the required field. Select ‘Template Type’ whether itsdocument/label /envelope. ‘Template Group’ here you can enter objectname (Account) (means for which object you are creating this template) Open the created record. If you already created the template with thecorrect Salesforce merge field, then you can upload your template fileunder the ‘Related tab’. Click on the ‘Related’ tab on the same record - Under the ‘Notes andAttachment’ related list clicks on the ‘Upload File’ button to upload yourtemplate file. 2022 Infogen Labs Corporation All rights reserved