Conga Composer® Configuration Guide Welcome

Transcription

Conga Composer® Configuration Guide Welcome
Conga
[email protected]
Conga Composer® Configuration Guide
Release 7 - Winter ‘13
Welcome
Conga Composer lets you generate documents and spreadsheets by gathering data from
Salesforce and merging to a template. The resulting file(s) can be printed or emailed and you
can log the actions you’ve taken in Salesforce.
Conga Composer solutions let you create individual documents by clicking a button from a
record in Salesforce.
Contacting Conga
Conga is a leading provider of software solutions to enrich your Salesforce experience,
specializing in document creation tools that integrate data from Salesforce. Founded in 2006,
Conga has since built a substantial market presence with thousands of customers worldwide.
Technical Support
At Conga, we are committed to providing you with timely answers to your technical support
questions. We provide support to system administrators for our products via email or
telephone. Generally, we’re available weekdays, during the following hours:
North America
Support Hours: 8 a.m. – 8 p.m. Eastern Time
Tech Support Email: [email protected]
Telephone: +1 303-465-1616 or (866) 502-3334
Europe, Middle East, Africa (EMEA)
Support Hours: 9 a.m. – 5 p.m. British Time
Tech Support Email: [email protected]
Telephone: +44 20 3608 0165
Asia / Pacific (APAC)
Support Hours: 9 a.m. – 5 p.m. Eastern Time
Tech Support Email: [email protected]
Telephone: +61 28 417 2399
Sales
For information on other products from Conga, please contact our New Business team:
Sales Information Email: [email protected]
Telephone: +1 303-465-1616
© 2014 Conga. All Rights Reserved. Conga, Conga Suite and Conga Composer are all
trademarks or registered trademarks of Conga, as are other names and marks. All other
trademarks or registered trademarks are the properties of their respective owners.
Resources
Examples:
For detailed examples, including sample templates, report designs and sample output, please
visit the knowledgebase article on our Conga Starter Template Library.
Articles and Videos:
Conga provides an online knowledge base and YouTube channel that are available 24X7 to
help you answer questions.
QuickStarts:
Want to get started right away? Our QuickStart library will help you quickly generate your
first Conga Composer solutions. The topics in the QuickStart library include:
•
•
•
Creating a Simple Document
Creating Your First Custom Solution
Creating a Complete Solution
Conga Composer Winter ‘13 Release
Page 2
Table of Contents
1. What is Conga Composer? ......................................................................................... 5
2. Create a Conga Composer button ............................................................................. 6
 Create the button ..................................................................................................... 6
 Adjust the Window Open Properties ........................................................................... 7
 Add the button to a Page Layout................................................................................ 8
3. Gather Salesforce Data .............................................................................................. 9
 What fields are available for merging? ..................................................................... 10
 What if I need data from an object related to the Master Object? .............................. 12
 Using Salesforce Reports with Conga Composer ....................................................... 13
 Using Conga Queries with Conga Composer ............................................................. 26
 Create and Store a Merge Template ......................................................................... 27
4. Refine Conga Composer Solutions with Parameters .............................................. 28
 Basic Configuration Parameters ............................................................................... 29
Data-Gathering Parameters .................................................................................. 29
Template Selection Parameters ............................................................................. 32
Email Parameters ................................................................................................. 36
Activity Logging Parameters ................................................................................. 40
 Conga Window Appearance ..................................................................................... 44
Background Mode Parameters............................................................................... 46
 Output File Parameters ........................................................................................... 51
General Output File Parameters ............................................................................ 51
PDF (Output File) Parameters ............................................................................... 54
Excel Parameters ................................................................................................. 56
PowerPoint Parameters......................................................................................... 56
Word Parameters ................................................................................................. 57
Email Template Parameters .................................................................................. 58
 Integration Parameters ........................................................................................... 59
DocuSign Integration Parameters ......................................................................... 59
EchoSign Integration Parameters .......................................................................... 64
Salesforce Chatter Integration Parameters ............................................................ 69
Salesforce Content Integration Parameters............................................................ 70
SendGrid Integration Parameters .......................................................................... 73
Sertifi Integration Parameters............................................................................... 74
SpringCM Integration Parameters ......................................................................... 75
 Advanced Parameters ............................................................................................. 76
Advanced Data Gathering Parameters ................................................................... 76
Advanced Template Selection Parameters ............................................................. 80
Advanced Data-Formatting Parameters ................................................................. 81
Advanced Control Parameters ............................................................................... 83
Formula-Driven Parameters .................................................................................. 84
 Conga Composer URL Examples .............................................................................. 85
5. Conga Email Template Manager .............................................................................. 86
6. Know Your Limits ..................................................................................................... 87
7. Other Parameters .................................................................................................... 88
 Supported Culture Codes ........................................................................................ 88
8. Index of Conga Composer Parameters ................................................................... 90
Conga Composer Winter ‘13 Release
Page 3
General Disclaimer
Conga Composer solutions depend on and leverage technology from a multitude of software
and hardware vendors including but not limited to salesforce.com, Microsoft, Google, and the
providers of various Internet browsers (“Third Party Technology”). Output from Conga
Composer solutions can be impacted by these and numerous other factors beyond the control
of Conga, including:
• Template design errors in Microsoft Word, Excel, PowerPoint templates, PDF Forms or
Conga HTML email templates
•
The nature and scope of data and/or images being retrieved for merging into templates
•
Individual user’s browser, network, ISP and/or hardware settings (see Conga Composer
Installation and Administration Guide for additional details)
•
The use of any encryption gateways or appliances that require any re-direct of Conga
Composer traffic
•
The availability and performance of the salesforce.com service and other software-as-aservice solutions such as eSignature, eCommerce and other AppExchange products, and
periodic updates, enhancements or other changes to such services made by their
respective vendors
•
Salesforce.com security settings including User Profiles and Permissions, folder and
object access and field-level security
•
Internet performance, regional and even global outages
For these reasons, Conga cannot guarantee that your particular implementation of
Third Party Technology and Conga technologies – even if configured based on
Conga documentation and/or guidance offered by Conga Support personnel – will
perform consistent with your expectations or requirements, or provide the output
you require. Accordingly, Conga disclaims any and all liability resulting from, or
related to, performance issues associated with Conga products to the extent arising
from your implementation, configuration, or the behavior of Third Party
Technology.
508 Compliance
Conga Composer is an installable package from the Salesforce AppExchange, which
integrates with an individual customer's existing implementation of Salesforce. When
properly configured, Conga Composer will run within an existing Salesforce instance without
the need to view, manipulate or configure the application outside of the Salesforce user
interface.
The use of Conga solutions is entirely represented by standard Salesforce user interface
components when properly configured. Therefore, customers seeking the 508 Compliance
VPAT documentation are referred to Salesforce.
Conga Composer Winter ‘13 Release
Page 4
Conga Composer
1. What is Conga Composer?
Conga Composer allows you to create an individual document from a button or link placed on
a standard or custom object page layout. With Conga Composer, you can retrieve data from
multiple Salesforce objects using specially configured Salesforce reports (or other search
requests), and then merge the data into a Word, Excel, PowerPoint, PDF template or HTML
email.
This chapter provides guidance on building Conga Composer solutions that leverage
Salesforce Reports as a data source. The following illustration depicts a common business
scenario in which Conga Composer retrieves data from multiple reports to produce a
sophisticated document.
Conga Composer Winter ‘13 Release
Page 5
2. Create a Conga Composer button

Create the button
You’ll need to create a button (or link) from which you will invoke Conga Composer.
1. Choose Setup | App Setup | Customize | [Object] | Buttons and Links
2. Click New in the
Custom Buttons and
Links section
3. For the Label, enter something that will describe the kind of document you will create
with Conga Composer, or simply enter Conga Composer.
4. For the Display type, choose Detail Page Button
5. In the URL text box, type or paste the Conga Composer Base URL:
https://www.appextremes.com/apps/Conga/Composer.aspx
?SessionId={!API.Session_ID}
&ServerUrl={!API.Partner_Server_URL_210}
&Id=
6. Append your object’s Id to the end of the URL (after Id=) using the Insert Merge Field
list. For example, a Contact would require {!Contact.Id}, an Account would require
{!Account.Id} and a custom object would require {!Record.Id} .
Tip! Always use the Insert Merge Field list to locate the
desired Id field. This id is the Master Object Id.
Tip! Your button URL must not contain spaces, particularly at the ends of lines
7. Click Save.
Tip! Conga Composer will retrieve all fields from the Master Object,
automatically making them available for merging.
Conga Composer Winter ‘13 Release
Page 6

Adjust the Window Open Properties
1. Choose Setup | App Setup | Customize | [Object] | Buttons and Links
2. Click the name of the
button you created (not
the Edit link)
3. Click Window Open
Properties
4. Set the Height to 500
5. Clear the checkbox on #6
Show Scrollbars
6. Click Save
Conga Composer Winter ‘13 Release
Page 7

Add the button to a Page Layout
1. Choose Setup | App
Setup | Customize |
[Object] | Page Layouts and
edit the desired Page Layout.
From the Page Layout
Properties screen, click
Buttons or Custom Links.
2. Drag your new button to the
appropriate region on the page
layout.
3. Click Save.
Tip! The button you have created is ready for use. Open a record of this type in Salesforce
and click your new button to see Conga Composer in action!
Note: The “Preview As” button will not work.
Watch a Video
This video demonstrates how to create a basic Conga Composer button
Conga Composer Winter ‘13 Release
Page 8
3. Gather Salesforce Data
The process of gathering the correct data from Salesforce is iterative. Generally, you start by
examining the fields that Conga Composer has automatically retrieved. If those fields are
sufficient for your solution, you’re ready to build your template.
If not, you’ll need to add as many Reports or Queries necessary to retrieve whatever data is
required for your solution.
(2)
(1)
Add or modify
Examine the
Salesforce
Template Builder
Reports
window
(3)
Modify
Conga Composer
Button
URL
How do you know which fields are available to you? To answer that question, let’s discover
the power of the Template Builder.
Conga Composer Winter ‘13 Release
Page 9

What fields are available for merging?
An essential tool in the development of Conga Composer solutions is the Template Builder.
The Template Builder is located at the lower-left corner of the Conga Composer page.
Tip! You’ll use the Template Builder frequently in the upcoming sections.
The Template Builder exposes the data retrieved by Conga Composer from the Master
Object, and from any Salesforce Reports or Conga Queries referenced in the Conga
Composer URL. (The use of Salesforce Reports and Conga Queries is described later in this
chapter.)
Select the desired dataset to view the available merge field names. The field names listed
in the left column indicate the field names you must use in your templates. Filter the list of
fields by entering search criteria in the Live Search box. You may search the field names or
the sample data (drawn from the first row of data available).
Click the field name to copy it to the clipboard, then switch to your template (in Word, Excel,
PowerPoint or a PDF Form) and paste the field name into the appropriate location (see the
template-specific guides for information on how to create a merge field).
See the next page for several tips on how to best use the Template Builder.
Conga Composer Winter ‘13 Release
Page 10
Tip! If an Opportunity is your Master Object, Conga Composer will automatically make the
Opportunity Line Items available for merging in the OppLineItems dataset.
Tip! If a Quote is your Master Object, Conga Composer will automatically make the Quote
Line Items available for merging in the QuoteLineItems dataset.
Tip! The View Data link allows you to download the
available data as an Excel workbook.
Tip! The User and Org datasets appear only if “Track Activities”
is enabled for the Master Object
Conga Composer Winter ‘13 Release
Page 11

What if I need data from an object related to the Master Object?
To gather information from Salesforce that isn’t contained in the Master Object, you may
use:


One or more Salesforce Reports
One or more Conga Queries
The benefit of using Salesforce Reports to gather additional data for Conga Composer is that
creating reports and linking them to Conga Composer is quick and easy, but they’re
somewhat limited in the information you can access.
Conga Queries, on the other hand, are more powerful in that they can access most objects in
Salesforce, but they’re more complicated to set up. Let’s examine each method.
Conga Composer Winter ‘13 Release
Page 12

Using Salesforce Reports with Conga Composer
You can use a Salesforce report to retrieve data related to your Master Object. Conga
Composer will automatically filter the report by passing the Master Object Id into the
report’s Advanced Filters. (You may override the default behavior and instead use other
information to filter the report.)
Conga Composer filters the report by passing the Master Object Id
into the first cell of the value column in the report when the merge
begins
Example:
Let’s say your Conga Composer button is located on an Account and you’d like to use a
report to retrieve all Contacts related to that Account so you can print a phone directory.
1. Create a Conga
Composer
button and
place it on your
Account page
layout
2. Create a
report based on
“Contacts &
Accounts”
3. Drag and drop the fields you’re interested in from Fields to Preview
4. In the Filters section, set the following:
a. Show: View drop-down list to All Accounts
b. Date Field: Clear any values in Start Date and End Date
c. Add Field Filter: Field drop-down list to Account Id
5. Save the report into any publicly accessible folder, we recommend Conga Composer
Reports. (See “Best Practice: Report Naming Conventions” for advice about report names
and folders.)
Conga Composer Winter ‘13 Release
Page 13
This report is now ready to receive the Master Object Id (which is the Account Id) from
Conga Composer. Next, we’ll explore how to include the report in the Conga Composer
button.
Tip! Test your report by pasting sample data into the Advanced Filters
and choose Run Report. Don’t save the report with the sample data.
(In our example, you would paste an Account Id.)
Tip! Focus the scope of each Conga Composer report to pull only the objects and fields
necessary.
Tip! Conga Composer will retrieve a report that contains a maximum of 1,500 rows and
contains less than 5 Mb of total data.
Additionally, each Conga Composer solution has a combined row limit of 25,000.
Tip! If you include an Id column in your report, position it as the last (right-most) column.
Referencing the Report in the Conga Composer button
To include the new report in the Conga Composer button, do the following:
1. Open the Reports Tab
2. Run the report by clicking the report name
3. Select the report’s Id in
the browser’s URL and copy
it to the clipboard (the 15character value after the last “/” (slash))
4. Edit the Conga Composer button: Setup | App Setup | Customize | [Object] |
Buttons and Links | Edit
5. Move to the end of the URL and enter the following parameters:
&ReportId=
6. Paste the Report Id from
the clipboard
7. Save the button
Tip! After including a report in the Conga Composer button, click the Conga Composer button
and then open the Template Builder to test whether Conga Composer has retrieved the
correct data.
Tip! You may use up to 50 reports in a Conga Composer button.
Create another report (as directed above) and include its Id
after the previous Report Id, separated by a comma.
Watch a Video This video demonstrates how to include a Salesforce report
in a Conga Composer button
Conga Composer Winter ‘13 Release
Page 14
Frequently Asked Questions about using Salesforce Reports in Conga Composer

FAQ: How can I filter the report on something other than the Master Object Id?
Although Conga Composer will use the Master Object Id as the default filter value in the
report’s Advanced Filters, you may override this behavior and use any field from the master
object.
Tip! You can also use a field from a parent of the master object,
like an Account field related to a Contact.
To use a different field, you’ll need to do the following:
 Configure your report to receive the desired value
 Update your Conga Composer button to send the desired value
Configure your report to receive some other field value:
1. Edit the report
2. In the Filters section, Add a Field Filter and select the field you’d like to use in the field
drop-down list
3. Leave the Value field empty
(This cell is known as pv0)
4. Save the report
Example:
Let’s extend our example from earlier. Instead of creating a directory of Contacts at a given
Account, let’s say we want all Contacts who are in the same state as the Account (but not
necessarily affiliated with the Account). In the image above, the Account Id field has been
replaced with Contact’s Mailing State/Province so that we can search for Contacts who are in
the same State/Province as the Account.
Update your Conga Composer button to send the desired value:
1. Edit the Conga Composer button: Setup | App Setup | Customize | [Object] |
Buttons and Links | Edit
2. Move to the end of the URL and add the following to the ReportId parameter:
?pv0=
3. Select the field that
contains the desired
search criteria from the
Insert Merge Field drop-down list.
Example:
Change the Report Id parameter so that it uses the Account’s Billing State as the search
criteria. The parameter would appear as:
&ReportId=00O50000001LNBd?pv0={!Account.BillingState}
Tip! When including a ?pv0= parameter, the “pv” must be lowercase.
Tip! Don’t use fields that might contain commas or ampersands to filter reports.
Best practice: Use Id fields to ensure correct results.
Conga Composer Winter ‘13 Release
Page 15
Tip! When passing numeric date values to a report, you must pass them
in the US date format, “mm/dd/yyyy”. You can ensure the correct format
by using a Salesforce formula field to “parse” a Date field.
Conga Composer Winter ‘13 Release
Page 16

FAQ: How can I filter the report with criteria from two or more fields?
For even more demanding situations, you can pass a second, a third and even as many as
five parameters to the same report. The values for those parameters are numbered
sequentially: pv0, pv1, pv2, etc. Each pv parameter must be separated with a tilde symbol
(~).
Example:
Extending the example from above, let’s say we want a list of all Contacts in the same
State/Province as the Account and who are also doctors.
The selection criteria of the report would need to be:
The Report Id parameter Conga Composer button URL would need to be:
Conga Composer Winter ‘13 Release
Page 17

FAQ: How can I filter the report with two or more values from one field?
You may use multiple values in a single pv value by separating each value with a pipe symbol
( | ).
Example:
Again, extending the previous example, let’s say we want a list of all Contacts in the same
State/Province, who are either doctors or professors. In this case, the report is already ready
to receive the filter criteria. We only need to change the Report Id parameter of the Conga
Composer button:
Conga Composer Winter ‘13 Release
Page 18

FAQ: My report already has filter criteria under Advanced Filters. Can Conga
Composer filter the report using subsequent rows in Advanced Filters?
Yes. If you want Conga Composer to filter your report with a value in, say, the pv1 position,
you may define the ReportId parameter in your button to use any combination of pv
positions.
Example:
Let’s say your report has filter criteria in the first row of the Advanced Filters (i.e., the pv0
position) and you want Conga Composer to supply filter criteria for the second row (pv1).
You could specify that as:
&ReportId=00O5000000001LNBd?pv1={!Account.BillingState}

FAQ: What if I don’t want to dynamically filter the report? I just want the report
contents as-is.
You can retrieve the contents of a report without applying any dynamic filtering by passing
an empty value for “pv0”:
&ReportId=00O5000000001LNBd?pv0=

FAQ: How can I gather data from multiple reports?
Conga Composer Winter ‘13 Release
Page 19
You may include up to 50 ReportId parameters in a Conga Composer URL, thus making 50
reports accessible in a single merge operation. To do so, enter a comma, then the next Id as
shown below.
Example:
Here, we have Conga Composer configured to pull data from four reports:
https://www.appextremes.com/apps/Conga/Composer.aspx
?SessionID={!API.Session_ID}
&ServerURL={!API.Partner_Server_URL_210}
&Id={!Contact.Id}
&ReportID=00O50000001NGuW,
00O50000001O2gr,
00O50000001NGv5?pv1={!Contact.MailingState},
00O50000001NGvL
Each of these reports would be visible through the Template Builder window as a separate
dataset. Conga Composer automatically assigns the worksheet names based on the sequence
of report IDs included in a Conga Composer URL.
You may also use Report Aliases to name the worksheets. See “Using Report Aliases” for
details.
Conga Composer Winter ‘13 Release
Page 20

FAQ: How can I control the sort-order of the data retrieved from a report?
You can control the sort-order of the information Conga Composer retrieves from a report:
1. From the Reports Tab, run the
Report by clicking its name
2. Click the column-header label
of the desired column to sort by
3. Save the report
Example:
Say your report shows a list of Contacts related to an Account and you’d like the list of
contacts sorted by Last Name. To set the sort-order, you would run the report, click on the
Last Name column (even though the report may have zero rows of information currently on
it), then save the report.
When Conga Composer interacts with the report, the data it gathers is sorted according to
your sort-order choice.
Tip! You can sort on multiple columns by changing the report to a Summary Report and
summarizing on another field. Conga Composer doesn’t use the summary information, but
will adhere to the sort-order of the report.
Conga Composer Winter ‘13 Release
Page 21

FAQ: I’m creating Quotes (or Invoices) from an Opportunity and its related
Opportunity Line Items. Do I need a report to retrieve the Opportunity Line Items?
No, in this particular case, you don’t. Conga Composer automatically makes Opportunity Line
Items available to you without any reports because the master object is an Opportunity.
Opportunity Line Items appear as a separate dataset (“OppLineItems”) in the Template
Builder window:
Tip! Conga Composer will automatically retrieve the line items from a Salesforce Quote
record, too.
Conga Composer Winter ‘13 Release
Page 22

FAQ: How can I use my own label for a data sheet?
You may supply an alias for a Report (or Query) to override the default name.
Please follow these guidelines:
•
•
•
•
•
•
•
The alias must precede the Salesforce Report (or Query) Id
It must be enclosed in square brackets (“[” and “]”)
It may contain only alphanumeric characters; punctuation marks and other special
characters are not permitted
It must contain at least 2 characters and but not more than 20 characters
It must be unique within the entire Conga Composer URL
Spaces are not permitted within an alias, or between the brackets and the Report Id
Reserved sheet names (“Master”, “Org”, “User”, “ReportData”, etc.) may not be used as
an alias
Example:
In this example, an alias has been added to each Report Id.
The resulting datasets in the Template Builder window appear as:
The field names in your template must then refer to the alias name. For example, in
Microsoft Word would you create a field for { TableStart:Contacts } and
{ TableEnd:Contacts }.
Conga Composer Winter ‘13 Release
Page 23
Best Practice: Report Naming Conventions
When naming reports created for use with Conga Composer, we suggest you adopt a naming
convention that reflects:
•
The Conga Composer solution the reports are intended to support (Account Plan,
Custom Invoice, etc.)
•
The sequence in which the reports are listed in the Conga Composer URL
(ReportData, ReportData1, ReportData2, etc.) or the Report Alias (see “FAQ: How can
I use my own label for a data sheet?” above for further details)
•
A description of the data being retrieved
•
The Salesforce “Report Type”
In the example below, four Salesforce reports called from a Conga Composer solution titled
“Executive Brief” on a Contact page layout might be named as follows:
By following this guidance, you will find it much easier to locate the Salesforce report
responsible for the tables revealed on the Template Builder window.
Tip! If you follow this guidance and for some reason change the order of the report IDs in
the URL, or insert or delete one, remember to update the impacted Salesforce Report Names
to ensure they reflect their position(s) in the URL. You can avoid having to make this update
by using Report Aliases instead.
Conga Composer Winter ‘13 Release
Page 24
Using Report Fields in Templates
Fields retrieved from Conga Composer reports require special attention in templates. This is
true of Word, Excel and PDF templates, though the conventions differ from one to the other.
For complete details about designing templates, please see the various guides on the
Documentation page of our support website:






Microsoft Word Merge Templates
Microsoft Excel Merge Templates
Microsoft PowerPoint Merge Templates
PDF Templates
Conga HTML Email Templates
Storing Merge Templates
Conga Composer Winter ‘13 Release
Page 25

Using Conga Queries with Conga Composer
In addition to using Salesforce reports to gather information from Salesforce, you may also
use Conga Queries, records stored in the Conga Query Manager.
The link to this private listing is located on our website. Locate Conga Query Manager,
click Get It Now for your appropriate Salesforce edition and then follow the instructions to
install the additional component.
This custom object stores Salesforce Object Query Language (SOQL) statements that will
retrieve data related to the Master Object.
Complete details on the installation and use of the Conga Query Manager are provided on the
Support page from our website.
Using Queries instead of Reports
Conga Queries have certain strengths over the use of Salesforce Reports for gathering data:
•
•
•
•
•
Queries are slightly faster and more reliable than Salesforce Reports
Queries can access objects that cannot be displayed in Salesforce Reports (Notes,
Approval History)
Queries reduce clutter on the Reports Tab
Queries have tighter security and visibility controls than Salesforce Reports
Queries are more reliable when multiple queries (say, over 10) are including in Conga
Composer solution
Using Salesforce reports remains a viable option for basic requirements.
Warning! Conga Composer will retrieve a report (or query) that
contains a maximum of 1,500 rows and
contains less than 5 Mb of total data.
Additionally, each Conga Composer solution has a combined row limit of 25,000.
For complete details on how to use Conga Queries, please visit our Documentation page, and
look for the Conga Query Manager link.
Conga Composer Winter ‘13 Release
Page 26

Create and Store a Merge Template
Now that your Conga Composer button is configured to retrieve the desired data from
Salesforce, your next task is to create a merge template using Word, Excel, PowerPoint,
HTML email, or PDF form. Each type of template has its own benefits and naming
conventions regarding merge fields, so please refer to the appropriate guide for your
template type:





Microsoft Word Merge Templates
Microsoft Excel Merge Templates
Microsoft PowerPoint Merge Templates
PDF Templates
HTML Email Templates
Finally, after designing a template you may store your template in any of three locations:



The Conga Template Manager
The Salesforce template repository
Your local hard drive or network drive
Each of these is discussed in Storing Merge Templates.
Conga Composer Winter ‘13 Release
Page 27
4. Refine Conga Composer Solutions with Parameters
Conga Composer solutions can be highly customized to enhance the user experience. If
desired, you may include any of the following parameters in your Conga Composer URL.
Append each parameter to the URL value in your Conga Composer button.
A few caveats:
1. Each parameter/value pair must be entered with the following convention:
&Parameter=Value
2. Each parameter must begin with an ampersand (&)
3. Spaces are not permitted anywhere in Conga Composer URLs, including
parameter/value pairs. If your Value requires spaces, replace them with plus signs
(+). Quotes (“”) are not permitted anywhere in URLs either.
4. Parameter names are not case-sensitive, but the values you set them to may be, so
it’s a best practice to observe case closely
5. Parameters may be appended to the Conga Composer URL in any order
6. Several complete examples are available in the last section of this chapter
7. The Conga Composer URL should not exceed 1750 characters
We invite you to explore the following categories:
1.
2.
3.
4.
Basic Configuration
Dialog Box Appearance
Output File Parameters
Integration Parameters
Conga Composer Winter ‘13 Release
Page 28

Basic Configuration Parameters
The Basic Configuration Group lists the most popular parameters for Conga Composer.
These parameters define:
•
•
•
•
How data is gathered
Which templates are presented to users
How to address outbound email messages
How activity logging should take place
Data-Gathering Parameters
The following parameters affect how Conga Composer gathers data from Salesforce.
PARAMETER
DESCRIPTION
Id=[id]
Sets the master object. All fields are retrieved from this object.
** Note: A Conga Composer URL must contain one (and only one)
instance of this parameter **
Requires:
A Salesforce Id of any record (Contact, Lead, Account, Custom Object,
etc.) or a field that contains an Id
Conga Composer Winter ‘13 Release
Page 29
PARAMETER
DESCRIPTION
ReportId=[id]
Retrieves the contents of the specified report(s) (identified by its 15character Salesforce id) and makes the report contents available
through a ReportData dataset as seen on the Template Builder window.
You may include up to 50 ReportId values in a Conga Composer URL,
thus making 50 reports accessible in a single merge operation. Conga
Composer will retrieve a report that contains a maximum of 1,500
rows.
Requires:
A 15-character Salesforce Id of a Report. May optionally include filter
criteria.
Example 1:
…&ReportId=00143532453dg3A
Example 2: (two reports)
…&ReportId=00O43532453dg3A,00O43532453dgF2
Report Aliases:
An optional report alias may precede the report id:
•
Enclose the alias in square brackets
•
Minimum 2 characters, maximum 20
•
Alphanumeric characters only
•
Reserved sheet names may not be used (“Master”, “Org”, etc.)
•
The alias must be unique within the button URL
Example 1:
…&ReportId=[MyContacts]00143532453dg3A
Example 2: (two reports)
…&ReportId=[MyAccounts]00O43532453dg3A,
[MyCases]00O43532453dgF2
For more options and a complete discussion of using Reports
with Conga Composer, please see Using Salesforce Reports with
Conga Composer , page 13
Conga Composer Winter ‘13 Release
Page 30
PARAMETER
DESCRIPTION
QueryId=[id]
Retrieves the SOQL query stored in the specified Salesforce record(s),
executes the SOQL query and makes the SOQL query results available
through a QueryData dataset as seen on the Template Builder window.
You may include up to 50 QueryId values in a Conga Composer URL,
thus making 50 queries accessible in a single merge operation. Conga
Composer will retrieve a query that contains a maximum of 1,500 rows.
Requires:
A 15-character Salesforce Id of a Query record. May optionally include
filter criteria.
Example 1:
…&QueryId=a00143532453dg3
Example 2: (two queries)
…&QueryId=a00143532453dg32,00143532453dgF2
Query Aliases:
An optional query alias may precede the query id:
•
Enclose the alias in square brackets
•
Minimum 2 characters, maximum 20
•
Alphanumeric characters only
•
Reserved sheet names may not be used (“Master”, “Org”, etc.)
•
The alias must be unique within the button URL
Example 1:
…&QueryId=[MyContacts]a00143532453dg3
Example 2: (two queries)
…&QueryId=[MyAccounts]a00143532453dg32,
[MyCases]a0043532453dgF2
For more options and a complete discussion of using Queries
with Conga Composer, please see Using Conga Queries with Conga
Composer , page 26
You can find other, more advanced parameters for Data Gathering in the Advanced
Parameters section.
Conga Composer Winter ‘13 Release
Page 31
Template Selection Parameters
The following parameters pertain to merge templates.
PARAMETER
DESCRIPTION
TemplateId=[id]
Pre-selects the template(s) specified in the File Template list box
You may include up to 10 TemplateIds. Additional limitations apply.
With multiple templates specified and the output format set to “Adobe
PDF”, the system will convert each output files to PDF, join the
collection and return a single PDF.
With multiple templates specified and the output format set to “Same
as Template”, the system will return a zipped file containing each
output file.
To return a zipped collection of PDFs, include the parameter
&ZipPDFs=1 (see below).
Requires:
A 15-character Salesforce Id of a Template record
Example 1:
…&TemplateId=00143532453dg3B
Example 2 (multiple templates):
…&TemplateId=00143532453dg3B,001435121234499
Example 3 (referencing a field that contains the template id):
…&TemplateId={!Contact.TemplateId}
TemplateGroup=[value]
Filters the list of file templates that appear on the Conga Composer
dialog box to those that match this criteria. May include one or more
values, separated by commas.
Requires:
•
Templates must be stored in Conga Template Manager
•
Template Group value set on each Template Manager record
Each record in the Conga Template Manager can be set with one or
more Template Group values, separated by commas. This parameter
filters the available templates using this field.
Conga Composer Winter ‘13 Release
Page 32
PARAMETER
DESCRIPTION
SelectTemplates=[0 or 1]
Displays the “Multiple Template Selection” dialog box which allows
users to select and arrange up to 10 templates from any of the
following template sources:
•
•
•
Conga Template Manager
Salesforce Content
Salesforce Documents Tab
The Salesforce Content Title and Description fields are searchable
through the dialog box. At this time, the attachments are not indexed.
Salesforce Content may be suppressed by including the
“&HideContent=1” parameter. Salesforce Content can be set as the
default option by including the “&DefaultPane=1” parameter.
Tips:
•
This parameter works especially well with the TemplateGroup
parameter, which can be used to ensure that each template has
appropriate merge fields.
•
This parameter also works especially well as an inline window,
rather than as a traditional pop-up window.
•
If Background Mode (DS7) is also included, a template must be
selected
•
This parameter won’t work with a QVar that results in a list of
template ids.
You can find other, more advanced parameters for Template Selection in the Advanced
Parameters section.
Conga Composer Winter ‘13 Release
Page 33

FAQ: Pre-Selecting a Merge Template for Conga Composer Solution
For most Conga Composer solutions, it’s often desirable to pre-select the template that
you’ve intended to use with this particular merge operation. You may do so by including the
“TemplateId” parameter in the URL that calls Conga Composer.
Example:
https://www.appextremes.com/apps/Conga/Composer.aspx
?SessionID={!API.Session_ID}
&ServerURL={!API.Partner_Server_URL_210}
&Id={!Contact.Id}
&TemplateId=01H500000005tMS
The Id of the desired template is found by navigating to the template, stored in either the
Salesforce template repository or the Conga Template Manager.
Click the name of the template
and select the id from the
template’s URL.
Tip! The id required is from the Template Manager record,
not the attachment stored with the record
Conga Composer Winter ‘13 Release
Page 34
This page intentionally left blank
Conga Composer Winter ‘13 Release
Page 35
Email Parameters
The standard Conga Composer dialog includes the option to generate the desired merge
output and attach it directly to an outbound Salesforce email message. This feature can
greatly reduce the time required to otherwise generate a merge file, save it to disk, launch
an email message and attach the file – a great productivity tool.
Tip! The Email Parameters work with Conga's integration with SendGrid.
Conga Composer Winter ‘13 Release
Page 36
PARAMETER
DESCRIPTION
EmailToId=[id]
Sets the value of the To field.
Requires:
A Salesforce Id of a Contact or Lead, or a field that contains the Id of a
Contact or Lead.
Note: If using a Lead Id with Conga Email Templates, must use
SendGrid integration, Leads and Conga Email Templates do not work
with Salesforce email.
If the Conga Composer Master Object is an Opportunity, the To field is
automatically set to the Primary Contact, without the use of this
parameter. To override this behavior from an Opportunity, set the
parameter to “+”, e.g., “…&EmailToId=+”
If the Conga Composer Master Object is a Quote, the To field is
automatically set to the Contact on the Quote, without the use of this
parameter.
Example 1:
…&EmailToId={!Contact.Id}
Example 2:
…&EmailToId=00143532453dg3C
NOTE: This parameter will not work when the master object is a Lead
and you are using Conga email templates, there is a Salesforce
limitation concerning Leads. It will however work when using standard
Salesforce email templates.
EmailRelatedToId=[id]
Sets the value of the Related To field.
Requires:
The Salesforce ID of an Account, Opportunity or other Salesforce
object, or a field that contains this kind of ID.
The Related To field causes the sent email to appear in the Activity
History related list of the object identified. In the absence of this
parameter, Conga defaults the Related To field to the Master Object.
The supported objects for the Related To field are: Account, Asset,
Campaign, Case, Contract, Opportunity, Order, Product, Solution,
custom objects with “track activities” enabled.
Example 1:
…&EmailRelatedToId={!Opportunity.Id}
Example 2:
…&EmailRelatedToId=00143532453dg3D
EmailAdditionalTo=[text]
Sets the value of the Additional To field.
Requires:
An email address or a field that contains one or more email addresses.
Example 1:
…&[email protected]
Example 2:
…&[email protected], [email protected]
Example 3:
…&EmailAdditionalTo={!Contact.OtherEmailAddress}
Conga Composer Winter ‘13 Release
Page 37
PARAMETER
DESCRIPTION
EmailCC=[text]
Sets the value of the CC field.
Requires:
An email address or a field that contains one or more email addresses.
Example 1:
…&EmailCC [email protected]
Example 2:
…&EmailCC={!Contact.OtherEmailAddress}
EmailBCC=[text]
Sets the value of the BCC field.
Requires:
An email address or a field that contains one or more email addresses.
Example 1:
…&EmailBCC [email protected]
Example 2:
…&EmailBCC={!Contact.OtherEmailAddress}
EmailTemplateId=[id]
Loads the subject and body fields from a Salesforce email template.
** Note: Attachments stored directly in the email template are not
applied unless EmailTemplateAttachments is set to 1 **
Requires:
•
A 15-character Salesforce Id of an email template stored in Setup |
Communication Templates | Email Templates
•
EmailRelatedToId parameter or EmailToId parameter must be set
Example:
…&EmailTemplateId=00143532453dg7A
EmailSubject=[text]
Sets the value of the Subject field.
If you set this parameter and use EmailTemplateId, this value will
override the value of the Email Template’s Subject.
Requires:
Any text. Use + to indicate spaces.
Example 1:
…&EmailSubject=Thank+You
Example 2:
…&EmailSubject=Account+Brief+for+{!Account.Name}
EmailTemplateAttachments=
[0 or 1]
Indicates to preserve attachments stored with the Email Template.
•
•
If set to 0, attachments stored on the Email Template are ignored
If set to 1, attachments stored on the Email Template are
preserved
Requires:
EmailTemplateId parameter must be set
Conga Composer Winter ‘13 Release
Page 38
PARAMETER
DESCRIPTION
EmailFromId=[id]
Indicates an Organization-Wide Address as the From identity of the
email.
Requires
•
A 15-character Salesforce Id of an Organization-Wide Address as
defined in Setup | Email Administration | Organization-Wide
Addresses
Tip
•
After setting up the Org-Wide Address, edit the record to locate the
Salesforce Id. It will begin with “0D2…”
•
Each Org-Wide Address may be restricted by Profile
EmailReplyToId=[id]
Changes the apparent sender of an email by setting the message's
ReplyTo and DisplayName properties to those of the specified User.
Requires
•
A 15-character Salesforce User Id
Important
•
This parameter only affects email that is delivered in an unattended
manner, e.g., Background Mode (DS7=12), Conga Conductor and
Conga Workflow.
EmailUseSignature=[0 or 1]
Indicates whether to include or exclude the sending user's signature
from appearing in the email body.
•
•
If set to 0, the signature block is excluded
If set to 1, the signature block is included (default)
Important
•
This parameter only affects email that is delivered in an unattended
manner, e.g., Background Mode (DS7=12), Conga Conductor and
Conga Workflow.

FAQ: Detailed example of using the Email parameters
Here’s an example that would be applicable to a Conga Composer button contained on a
Case. It specifies who to address the Email to, establishes the Related object, specifies the
Additional To and CC fields, and then specifies an Email Template.
https://www.appextremes.com/apps/Conga/Composer.aspx
?SessionID={!API.Session_ID}
&ServerURL={!API.Partner_Server_URL_210}
&Id={!Contact.Id}
&TemplateId=01H500000005t
&EmailToId={!Contact.Id}
&EmailRelatedToId={!Case.Id}
&EmailAdditionalTo={!Case.OwnerEmail}
&[email protected]
&EmailTemplateId=00X60000000vrZ4
Conga Composer Winter ‘13 Release
Page 39
Activity Logging Parameters
The following parameters affect the Log Activity Options of the Conga Composer dialog box.
Tip! For clarity, the following “LG” parameters are shown in uppercase,
however they are not case-sensitive in practice.
PARAMETER
DESCRIPTION
LG0=[0 or 1]
Save Text
Determines whether to store the text of the document (post-merge) to the
body of the Task
•
•
If set to 0, “Save Text:” is “-None-”
If set to 1, “Save Text:” is “Document Text (Word only)” (default)
** Note: This feature only works with Microsoft Word templates **
LG1=[text]
Activity Subject
Sets the Subject to the text specified. Also used as in the subject of a FollowUp Task, if one is created. If not specified and the Activity Subject is blank,
the output filename is used for the Activity Subject.
Important: Do not use the “less than” (<) or “greater than” symbol (>) with
this parameter
Example 1:
…&LG1=Quote+Generated
Example 2:
…&LG1={!Opportunity.EmailSubject}
Conga Composer Winter ‘13 Release
Page 40
PARAMETER
DESCRIPTION
LG2=[integer]
Follow-Up Date
Sets the follow-up date by using the integer to add days to today’s date
Example:
...&LG2=14
would set a follow-up date 14 days from today
LG3=[0, 1 or 2]
Attach File
Sets the file attachment options
•
•
•
LG4=[0, 1 or 2]
If set to 0, "Attach
If set to 1, "Attach
the type of master
If set to 2, "Attach
File:" is "-None-" (default)
File:" is "Attach to [record]" where [record] would be
object record, e.g., “Opportunity”
File:" is "Attach only, No Task Record"
Automatic Logging
Sets whether to automatically log an activity after merging
•
•
•
LG5=[id]
If set to 0, “Automatic Logging” is disabled (default)
If set to 1, “Automatic Logging” is enabled
If set to 2, Master Field to Set fields are updated but no Task record is
created
Sets the “Assigned To” field in the Activity
Requires:
A Salesforce Id of a User or a field that contains this kind of Id. In the
absence of this parameter, the “Assigned To” field is set to the current user.
Example 1:
…&LG5={!Opportunity.Assistant__c}
Example 2:
…&LG5=00553532453dg3D
LG6=[id]
Sets the Assigned To field in the Follow-Up Activity
Requires:
A Salesforce Id of a User or a field that contains this kind of Id. In the
absence of this parameter, the “Assigned To” field of a follow-up activity is set
to the current user.
Example 1:
…&LG6={!Opportunity.Assistant__c}
Example 2:
…&LG6=00553532453dg3D
Conga Composer Winter ‘13 Release
Page 41
PARAMETER
DESCRIPTION
LG7=[text]
Sets the Activity Subject in the Follow-Up Activity
Sets the Subject to the text specified. If not specified the Follow-Up Activity
Subject is set to “Follow-Up: “ and the Activity Subject value.
Important: Do not use the “less than” (<) or “greater than” symbol (>) with
this parameter
Example 1:
…&LG7=Please+follow-up
Example 2:
…&LG7={!Opportunity.EmailSubject}
LGAttachOption=
[0, 1, 2 or 3]
Sets the Salesforce object to which attachments generated during Activity
Logging are stored
•
•
•
•
If
If
If
If
set
set
set
set
to
to
to
to
0,
1,
2,
3,
attachments
attachments
attachments
attachments
are
are
are
are
saved
saved
saved
saved
to
to
to
to
“Notes & Attachments”(default)
“Salesforce Content”
“Salesforce Chatter”
“SpringCM”
Requires:
•
&LG3=1 or 2
•
&LG4=1 or 2
Works with:
•
AttachmentParentId (see below)
AttachmentParentId=[id]
Specifies the record in Salesforce to which the output file is attached, when
requested. In the absence of this parameter, the default attachment parent
record is the Master Object.
Requires:
A Salesforce Id of a object to which attachments are allowed.
When used with “LGAttachOption=2” (Chatter), this parameter may be set to
a Chatter User Id or Chatter Group Id.
LGParentId=[id]
Overrides the default record against which a completed task is created. In the
absence of this parameter, the task is created against the Master Object.
Requires:
•
A Salesforce Id of an object which allows Activity Tracking
Example:
…&Id={!Opportunity.Id}
&LGParentId={!Account.Id}
LGWhoId=[id]
Specifies the WhoId (the related Contact/Lead) when creating a Task record.
Requires:
•
A Salesforce Id of an object which allows Activity Tracking
Conga Composer Winter ‘13 Release
Page 42
PARAMETER
DESCRIPTION
MFTS0=[ApiFieldName]
Master Field to Set
Also available:
MFTS1, MFTS2
MFTSValue0=[text]
Also available:
MFTSValue1,
MFTSValue2
MFTSId0=
Also available:
MFTSId1, MFTSId2
Requires:
•
The API Field Name of the field that should be set as part of the activity
logging activity
•
A value in the corresponding MFTSValue parameter (see below)
•
As part of the Activity Logging family of parameters, this feature is usually
triggered through Automatic Logging (&LG4=1 or 2)
Master Field to Set Value
Requires:
•
A value in the corresponding MFTS parameter
•
Don’t use with “&”, “%”, “<” or “>” or other special characters
Set a field on a non-Master record
For a long time Composer has allowed you to set a field on the Master Object.
This behavior (known as “Master Field to Set”) has been enhanced so that you
may set a field on another record instead of the Master Object.
This parameter must be used in conjunction with &MFTS0 and &MFTSValue0.
Example:
…&id={!Opportunity.Id}
&MFTSId0={!Account.Id}
&MFTS0=Opportunity_Status__c
&MFTSValue0=Proposal+Created
In this example, the Master Object is an Opportunity, however the Master
Field to Set parameters are configured to set the “Opportunity_Status__c”
field on the related Account. The field would be set to “Proposal Created.”
As is customary with Master Field to Set, fields are set as part of the Activity
Logging options. Frequently, administrators choose to include the &LG4=1 or
2 parameter so that Activity Logging takes place automatically, and field
updates are therefore automatically included.
This parameter may be populated via a QVar query.
Conga Composer Winter ‘13 Release
Page 43

Conga Window Appearance
The Conga Window Appearance Group lists the parameters that primarily affect the
appearance of the Conga window. These parameters define:
•
•
Interface Restriction Parameters
Background Mode Parameters
Interface Restriction Parameters
For a variety of reasons, it may sometimes be desirable to pre-set certain settings on the
Conga Composer dialog and restrict the user’s ability to alter them.
Note: This is a navigation/convenience feature, not a security feature. Though the
parameters are deliberately cryptic to obscure their purpose, a determined user could
potentially alter them in a URL and override the intended behavior.
PARAMETER
DESCRIPTION
FP0=[0, 1 or 2]
Locks the output file format
•
•
•
DS0=[0 or 1]
If set to 0, “Output Format” is “Same as template” and the output format
radio buttons are not locked (default)
If set to 1, “Output Format” is “Adobe Acrobat” and the output format
radio buttons are locked
If set to 2, “Output Format” is “Same as template” and the output format
radio buttons are locked
Disable Controls
•
•
Conga Composer Winter ‘13 Release
If set to 0, all controls in the Conga Composer dialog box (including
buttons) are enabled (default)
If set to 1, all controls in the Conga Composer dialog box (except the
buttons) are disabled
Page 44
PARAMETER
DESCRIPTION
DS1=[0 or 1]
Disable Merge Button
•
•
DS2=[0 or 1]
Disable Email Button
•
•
DS3=[0 or 1]
If set to 0, the Email Button is enabled (default)
If set to 1, the Email Button is disabled
Disable Log Activity Button
•
•
DS4=[0 or 1]
If set to 0, the Merge Button is enabled (default)
If set to 1, the Merge Button is disabled
If set to 0, the Log Activity Button is enabled (default)
If set to 1, the Log Activity Button is disabled
Lock Template Choices
•
•
If set to 0, the list of template choices is not locked (default)
If set to 1, the selected template choice is locked
Requires:
TemplateId parameter must be configured
In the absence of this parameter, the template indicated by the TemplateId
parameter is pre-selected in the list, but the user may select a different
template. This parameter prevents the user from selecting a different
template.
DS5=[0 or 1]
Disable View Data link
•
•
DS6=[0 or 1]
Disable View Template link
•
•
DS7=[code]
If set to 0, the View Data link is enabled (default)
If set to 1, the View Data link is disabled
If set to 0, the View Template link is enabled (default)
If set to 1, the View Template link is disabled
Background Mode: Initiate Conga Composer without user intervention
Complete details about Background Mode are contained in the next section,
Background Mode Parameters
DS8=[0 or 1]
When enabled, makes the “Choose a template from your local computer” radio
button visible, regardless of the corresponding setting on the Setup page
•
•
DS9=[0 or 1]
If set to 0, the Local Templates radio button behaves according to the
setting on the Setup page (default)
If set to 1, the Local Templates radio button is displayed
Disable Template Builder link
•
•
If set to 0, the Template Builder link is enabled (default)
If set to 1, the Template Builder link is disabled
You can find other, more advanced parameters for Conga Window Restrictions in the
Advanced Parameters section.
Conga Composer Winter ‘13 Release
Page 45
Background Mode Parameters
Background Mode parameters let you bypass the classic Conga Composer dialog box. In the
following table, the various background mode (DS7) parameter values are summarized by
the type of behavior desired.
Once you’ve located the desired behavior, please glance at the details for that mode to
determine whether other prerequisites must be met.
GENERAL BEHAVIOR
DS7 VALUE
Attach the output file to
Salesforce
1 – Master Object5 – Master Object, No Refresh
6 – Salesforce Content
Email the output file
2 – Email
12 – Automatic Email
Download the output
file
3 – Prompt for Download
13 – Automatic Download
Integrate with EchoSign
4 – EchoSign Agreement
14 – Auto-Deliver then Master Object
24 – Auto-Deliver then Confirmation
Integrate with DocuSign
7 – DocuSign Envelope
17 – Auto-Deliver
Integrate with SpringCM
8 – SpringCM folder
PARAMETER
DESCRIPTION
BML=[text]
Background Mode Label
Displays a message on the Background Mode dialog box. Displays up to 50
characters.
Requires:
Background Mode (DS7) must be configured
Example 1:
…&BML =Thank+You
Example 2:
…&BML=Account+Brief+for+{!Account.Name}
Conga Composer Winter ‘13 Release
Page 46
PARAMETER
DESCRIPTION
DS7=[0, 1, 2, 3, 4, 5, 6,
7, 8, 12, 13, 14, 17 or
24]
Background Mode: Initiate Conga Composer without user intervention
Requires:
TemplateId parameter must be set
It is recommended that the Window Open Properties for the link or button be
set to: Width: 300
Height: 150
** Note: When using Email mode (ds7=2), Direct mode (ds7=3) or EchoSign
mode (ds7=4), if you want to log activities or follow-up tasks, you must also
enable Automatic Logging (lg4=1) since those settings fall under “Log Activity
Options”. **
DS7=0
Background Mode is not enabled (default)
DS7=1
Background Mode is enabled and the merged document is attached to the
master object
*** Warning *** &DS7=1 causes the output document to be attached to
the Master Object AND created a completed Task. To suppress the Task
record, include the &LG3=2 parameter.
DS7=2
Background Mode is enabled and the merged document is attached to a
Salesforce email
DS7=3
Background Mode is enabled and the merged document is delivered to
browser to save or open
DS7=4
Background Mode is enabled and the merged document is attached to a new
EchoSign Agreement. (See EchoSign integration parameters)
DS7=5
Background Mode is enabled and the merged document is attached to the
master object (like ds7=1), except that the user can navigate away from the
master object while the merge process occurs
DS7=6
Background Mode is enabled and the merged document is attached to
Salesforce Content
DS7=7
Background Mode is enabled and the merged document is attached to a
DocuSign Envelope
DS7=8
Background Mode is enabled and the merged document is saved in a
SpringCM folder
DS7=12
Background Mode is enabled and the merged document is automatically
delivered via email. (Requires EmailToId and EmailTemplateId)
*** Warning *** No preview available before delivery. Please test
your configuration thoroughly before using this value.
Conga Composer Winter ‘13 Release
Page 47
PARAMETER
DESCRIPTION
DS7=13
Background Mode is enabled and the merged document is automatically
delivered to browser to save or open.
*** Warning *** The behavior of this parameter varies by browser.
Please test your solution thoroughly before releasing to your endusers.
For Internet Explorer, we recommend the following browser
configuration:
(1) Add “https://*.appextremes.com” to “Trusted Sites”
(2) Allow files to open from Trusted Sites (Custom Settings | Downloads |
Enable)
(3) Enable Protected Mode checkbox (or position the window to run Inline)
DS7=14
Background Mode is enabled and the merged document is automatically
delivered via EchoSign.
*** Warning *** No preview available before delivery. Please test
your configuration thoroughly before using this value.
DS7=17
Background Mode is enabled and the merged document is attached to a
DocuSign Envelope and automatically delivered.
*** Warning *** No preview available before delivery. Please test
your configuration thoroughly before using this value.
DS7=24
Background Mode is enabled and the merged document is automatically
delivered via EchoSign. The browser is redirected to the EchoSign
Confirmation Page.
Requires:
•
EchoSign version 9.5+
*** Warning *** No preview available before delivery. Please test
your configuration thoroughly before using this value.
DS7Preview=[0 or 1]
Background Mode Preview
Allows the end-user to preview the merged PDF before delivering the file
according to the specific DS7 mode
Warning: Currently does not work with Conga Email Template Id
Requires:
•
FP0=1 or DefaultPDF=1
•
DS7 set to anything except 3 or 13
Conga Composer Winter ‘13 Release
Page 48
Conga Composer error messages are still displayed on the dialog box, even when Background
Mode is enabled.
If you're using a pop-up window for a background mode dialog box, we recommend enabling the
"Resizable" property so the window can be stretched in case an error message is displayed.
Conga Composer Winter ‘13 Release
Page 49
This page intentionally left blank
Conga Composer Winter ‘13 Release
Page 50

Output File Parameters
The Output File Parameters Group lists the parameters that primarily affect the behavior of
the merge templates used in a merge operation. These parameters define:
•
•
•
•
•
•
General Output File Parameters
PDF Output File Parameters
Excel Parameters
PowerPoint Parameters
Word Parameters
Email Template Parameters
General Output File Parameters
The following parameters affect the output file generated by Conga Composer.
PARAMETER
DESCRIPTION
DefaultPDF=[0 or 1]
Sets the default output type to Adobe Acrobat
•
•
If set to 0, "Output Format" is "Same as template" (default)
If set to 1, "Output Format" is "Adobe Acrobat"
The user may override this choice unless the “Lock Output to PDF” parameter
(fp0=1) is enabled.
FP0=[0, 1 or 2]
Locks the output file format
•
•
•
If set to 0, "Output Format" is "Same as template" and not locked
(default)
If set to 1, "Output Format" is "Adobe Acrobat"
If set to 2, “Output Format” is “Same as template” and the output format
radio buttons are locked
Then, the Output Format radio buttons are locked.
Conga Composer Winter ‘13 Release
Page 51
PARAMETER
DESCRIPTION
OFN=[text]
Sets the Output File Name, overriding the default output file name.
Requires:
A text value to use for the output file name
You may use static text or merge field names for the values to place in the
filename. Use a plus sign (+) to represent literal spaces. Do not include
symbols unsupported in filenames, “\”, “/”, “>”, “<”, etc.
Example:
...&OFN={!Account.Name}+-+Quote
If the Account name is “ABC Corp.”, the resulting file name would be:
ABC Corp. – Quote.doc
Additionally, you may use a special field within the OFN parameter:
{Template.Label}
This can be used in a generic Conga Composer dialog box to refer to the
template label (as defined in the Salesforce repository). If using a local
template, the filename appears in place of the label.
** Note: Internet Explorer 7 will replace spaces in a filename with the
characters “%20” if the output file is opened before saving to disk.
For example, the file above would appear as
ABC%20Corp. %20-%20Quote.doc
if the file is opened before saving to disk.**
MTOFN=[text]
Multi-template Output File Name sets the output file name when using
multiple templates, affecting the file name of .zip files or consolidated PDFs.
Example:
…&MTOFN={!Account.Name}+-+Invoice
AttachmentParentId=[id]
Specifies the record in Salesforce to which the output file is attached, when
requested. In the absence of this parameter, the default attachment parent
record is the Master Object.
Also works with Conga Conductor (QMode=2) to control the behavior of the
merge operation’s primary output.
Requires:
A Salesforce Id of a object to which attachments are allowed.
Conga Composer Winter ‘13 Release
Page 52
PARAMETER
DESCRIPTION
AWD=[0, 1 or 2]
Assemble Word Documents
Assembles the output Word documents before the file is either converted to
PDF or delivered to the specified output location. The benefit is unified page
numbering and a "seamless" output document.
Requires:
All templates must be Microsoft Word.
•
•
•
If set to 0, Word output files are not assembled, resulting in a ZIP file
output (default)
If set to 1, Word output files are assembled with a "New Page Section
Break" between documents
If set to 2, Word output files are assembled with a "Continuous Section
Break" between documents
Note: Embedded fonts only supported in first template, so the use of
embedded fonts is not recommended
Conga Composer Winter ‘13 Release
Page 53
PDF (Output File) Parameters
If the output file from the merge operation is a PDF, the following parameters affect the file
generated by Conga Composer.
PARAMETER
DESCRIPTION
FlattenPDFForms=
[0 or 1]
"Flattens" PDF Form fields from the output PDF.
This parameter addresses a limitation in the iPhone/iPad PDF Reader which
does not display values in PDF form fields. By "flattening", the values of the
fields are blended into the PDF background and are thus visible on iPads.
•
•
If set to 0, the PDF form fields are not "flattened" (default)
If set to 1, the PDF form fields are flattened
Requires:
•
A PDF Form Template. (Not for use with Word, Excel or PowerPoint
templates)
Note:
Because this parameter flattens field contents, it is not comaptible with fields
that contain code such as javascript
PS0=[0 or 1]
Enables PDF Encryption
•
•
If set to 0, the PDF is not encrypted (default)
If set to 1, the PDF is encrypted
Requires:
Output to a PDF
Encrypts the output PDF and disables print, copy and form-fill. These settings
apply to any PDF output, whether from a PDF form or after converting a Word
or Excel template.
PS1=[0 or 1]
Allow PDF printing
•
•
If set to 0, PDF printing is not permitted (default)
If set to 1, PDF printing is permitted
Requires:
Output to a PDF and Enable PDF Encryption (ps0=1) enabled
Enables printing options in the output PDF
PS2=[0 or 1]
Allow PDF copying
•
•
If set to 0, PDF copying is not permitted (default)
If set to 1, PDF copying is permitted
Requires:
Output to a PDF and Enable PDF Encryption (ps0=1) enabled
Enables copying text to the clipboard from the output PDF
PS3=[0 or 1]
Allow PDF form fill-in
•
•
If set to 0, PDF form fill-in is not permitted (default)
If set to 1, PDF form fill-in is permitted
Requires:
Output to a PDF and Enable PDF Encryption (ps0=1) enabled
Conga Composer Winter ‘13 Release
Page 54
PARAMETER
DESCRIPTION
Enables form fields to be editable in the output PDF (for those fields not
specified as “read-only”)
PSPW=[text]
Sets the password to open the output PDF.
Note: This parameter requires that &PS0=1 (PDF Security) be enabled.
Example:
…&PSPW=OpenSesame
PDFIQ=[5 to 100]
PDF Image Quality
Do Not Use
Adjusts the quality of images in output PDF files. The quality scale ranges
from 5 (low quality, small file size) to 100 (high quality, large file size).
(Default value is 100.)
PDFQR=[0 or 1]
Enables Quick-Render mode on PDF output
Do Not Use
•
•
Conga Composer Winter ‘13 Release
If set to 0, high-quality, low speed PDF rendering is enabled (default)
If set to 1, low-quality, high speed PDF rendering is enabled
Page 55
Excel Parameters
The following parameters affect the behavior of Excel templates.
PARAMETER
DESCRIPTION
ExcelAutoFitRows=
[0 or 1]
Automatically sizes the height of all rows in an Excel output document
ExcelAutoFitColumns=
[0 or 1]
Automatically sizes the width of all columns in an Excel output document
SCHP=[0, 1 or 2]
Strips punctuation from merge field names
•
•
•
•
If set to 0, the height of the rows is not adjusted (default)
If set to 1, the height of the rows is automatically adjusted
If set to 0, the width of the columns is not adjusted (default)
If set to 1, the width of the columns is automatically adjusted
This setting removes punctuation from merge field names, making it possible
to refer to those fields in Excel templates.
•
•
•
If set to 0, merge fields may contain parentheses
If set to 1, parentheses are removed from merge field names
If set to 2, all punctuation (including colons) are removed from merge
field name
PowerPoint Parameters
The following parameters affect the behavior of PowerPoint templates.
PARAMETER
DESCRIPTION
APF=[0 or 1]
Assemble PPTX Files
Assembles the output PPTX presentation files before the file is either
converted to PDF or delivered to the specified output location. The benefit is
unified slide numbering and a "seamless" output document.
Requires:
All templates must be PowerPoint PPTX.
•
•
PPTPreserveRows=
[0 or 1]
If set to 0, PPTX output files are not assembled, resulting in a ZIP file
output (default)
If set to 1, PPTX output files are assembled
Preserves the table size (rows) when merge fields are placed within a table.
•
•
Conga Composer Winter ‘13 Release
If set to 0, empty rows are removed (default)
If set to 1, the table size is preserved whereby empty rows may appear
Page 56
Word Parameters
The following parameters affect the behavior of Word templates.
PARAMETER
DESCRIPTION
AWD=[0, 1 or 2]
Assemble Word Documents
Assembles the output Word documents before the file is either converted to
PDF or delivered to the specified output location. The benefit is unified page
numbering and a "seamless" output document.
Requires:
All templates must be Microsoft Word.
•
•
•
If set to 0, Word output files are not assembled, resulting in a ZIP file
output (default)
If set to 1, Word output files are assembled with a "New Page Section
Break" between documents
If set to 2, Word output files are assembled with a "Continuous Section
Break" between documents
Note: Embedded fonts only supported in first template, so the use of
embedded fonts is not recommended
WPD=[0 or 1]
Enables “Word Protect Documents” behavior.
The output Word document is locked to prevent editing, except for merge
fields that contain the “TEXTBOX:” prefix. See the Microsoft Word Templates
Guide for further details.
Conga Composer Winter ‘13 Release
Page 57
Email Template Parameters
The following parameters affect the behavior of Conga Email templates.
PARAMETER
DESCRIPTION
CongaEmailTemplateId=
[id] (or &CETID)
Conga Email Template Id
This parameter pre-selects the Conga Email Template specified in the Email
Templates list on the Composer dialog box. Optionally, you may abbreviate
this parameter to “&CETId=” You may specify only one Conga Email
Template Id. This parameter may be populated via a QVAR query.
Example 1:
…&CongaEmailTemplateId=a0WG0000006PNrS
Example 2 (abbreviated):
…&CETId= a0WG0000006PNrS
Warning: Currently does not work with DS7Preview
CongaEmailTemplate
Group=[text] (or &CETG)
Conga Email Template Group
This parameter filters the list of Conga Email Templates that appear in the
Email Templates list on the Composer dialog box to those that match the
specified criteria. The value may include one or more values, separated by
commas. This parameter may be populated via a QVAR query.
Example 1:
…&CongaEmailTemplateGroup=Quotes
Example 2 (abbreviated, multiple values specified):
…&CETG=USA,Contact
Conga Composer Winter ‘13 Release
Page 58

Integration Parameters
The Integration Parameters Group lists the parameters that primarily affect how Conga
integrates with a wide variety of electronic signature and document storage tools. These
parameters define integrations with:
•
•
•
•
•
•
•
DocuSign
EchoSign
Salesforce Chatter
Salesforce Content
SendGrid
Sertifi
SpringCM
DocuSign Integration Parameters
DocuSign delivers Conga Composer documents via email, much like Salesforce itself, but
adds the ability to acquire, track and file signatures.
DocuSign lets you send documents electronically to collect electronic signatures and data
from your Salesforce account. Your recipients sign, enter data, initial, and date your
documents online and can update Salesforce automatically with signed documents and
collected data. For more information visit the DocuSign AppExchange listing.
DocuSign is available separately on the AppExchange. You must subscribe to that service to
use these integration parameters.
PARAMETER
DESCRIPTION
DocuSignVisible=[0 or 1]
Makes the DocuSign button visible on the Conga Composer dialog box.
DocuSign is available separately on the AppExchange. You must subscribe to
that service to use this integration parameter.
•
•
DocuSignR1Id=[id]
Also available:
The parameter with
R2, R3, R4, R5 or R6
If set to 0, the DocuSign button is not visible (default)
If set to 1, the DocuSign button is visible
Sets the recipient of the document to be delivered
Requires:
A Salesforce Contact, Lead or User Id
Example:
…&DocuSignR1Id=003ABCD12345
In the case of an Opportunity (as the master object) with Contact Roles, the
contacts whose Contact Role values match the DocuSign Roles will
automatically be included as document recipients
DocuSignR1Role=[text]
Also available:
The parameter with
R2, R3, R4, R5 or R6
Sets the recipient’s role
Requires:
A valid DocuSign Role Name, as defined in Envelope Settings
Example:
…&DocuSignR1Role=Signer+1
Conga Composer Winter ‘13 Release
Page 59
PARAMETER
DESCRIPTION
DocuSignR1Type=[text]
Sets the recipient’s type
Also available:
The parameter with
R2, R3, R4, R5 or R6
DocuSignR1AccessCode=
[text]
Also available:
The parameter with
R2, R3, R4, R5 or R6
DocuSignR1RoutingOrder
=[1,2 or 3]
Example:
…&DocuSignR1Type=Signer
Sets the recipient’s access code
Example:
…&DocuSignR1AccessCode=ABC123
Sets the recipient’s routing order
Also available:
The parameter with
R2, R3, R4, R5 or R6
DocuSignRelatedAccount
Id=[id]
Sets the related Account field on the DocuSign Envelope. This parameter is
used in establishing the relationship to the related Account on the DocuSign
Status record.
Requires:
A Salesforce AccountId ID
NOTE: This parameter only works when sending a DocuSign Envelope
directly via the API using DS7=17 and QMode=7
Example:
…&DocuSignRelatedAccountId=001ABCDEFGH
DocuSignCustomField=
[ApiFieldName]
Also available:
DocuSignCustomField1
DocuSignCustomField2
DocuSignCustomField3
DocuSignCustomField4
DocuSignCustomField5
DocuSignCustomField
Value=[value]
Also available:
DocuSignCustom
FieldValue1
DocuSignCustom
FieldValue2
DocuSignCustom
FieldValue3
DocuSignCustom
FieldValue4
DocuSignCustom
FieldValue5
Sets the name of a custom field to set on the DocuSign Envelope Record
created through the merge process. Use the Salesforce API name of the field
on the DocuSign Envelope Custom Object.
Requires:
DocuSignCustomFieldValue
Example:
…&DocuSignCustomField=Account__c
…&DocuSignCustomFieldValue=001ABCEDFGHIJL
Sets the value of the corresponding custom field
Requires:
DocuSignCustomField
Conga Composer Winter ‘13 Release
Page 60
PARAMETER
DESCRIPTION
DocuSignEmailBody=[te
xt]
Populates the body of the DocuSign email
DocuSignEndpoint=[Prod
, Demo, Test, Preview]
Used to configure a Conga Composer button to connect to a specific DocuSign
endpoint.
Because this value is transmitted through the Conga Composer window URL,
we recommend that this value be brief (say, not more than 40 characters).
Note: We expect this parameter will be used by DocuSign account engineers
rather than customers.
DocuSignSendReminders
=[0 or 1]
Sends reminder emails to recipients who have not yet completed their task
DocuSignRemindIn
=[0 to 999]
Indicates how many days should pass before the first reminder is sent
DocuSignRemindAgainIn
=[0 to 999]
Indicates how often (in days) the reminder should repeat until the transaction
is complete
DocuSignExpireIn
=[0 to 999]
Indicates the number of days until the transaction is expired
DocuSignExpireVoidEnv
=[0 or 1]
Indicates whether to enable the envelope to automatically expire
DocuSignWarnIn
=[0 to 999]
Indicates how many days prior to expiration you want an email message to
alert recipients that a deadline approaches for completion
•
•
•
•
Conga Composer Winter ‘13 Release
If set to 0, email reminders are not sent (default)
If set to 1, email reminders are sent
If set to 0, the envelope will not automatically expire
If set to 1, the envelope will automatically expire (default)
Page 61
PARAMETER
DESCRIPTION
DocuSignTag=[0 or 1]
Enables the DocuSign Tag Mode
After the merge operation is complete, the browser is redirected to the
DocuSign Tag screen
Requires:
•
TemplateId must be set
DocuSignEmailSubject=[
text]
Assign a custom email subject
DocuSignIgnoreOCR=[0
or 1]
Ignore Opportunity Contact Roles
By default, the email subject sent through DocuSign is pulled from the
DocuSign Admin Settings. With this parameter, you can override the Admin
Settings and establish a custom value for the email subject
When Composer creates a DocuSign Envelope from an Opportunity, it
automatically scans the list of Opportunity Contact Roles and attempts to
match DocuSign Role Names with the Contact Roles. If they match, the
Contact is automatically included as a signer.
Now, you can choose to skip that behavior, forcing Composer to ignore the
Opportunity Contact Roles. In using this parameter, it will be your
responsibility to populate the explicit DocuSign Recipient parameters if you
want to pre-address the Envelope
DocuSignR1EmailSubject
Also available: The
parameter with R2, R3,
R4, R5 or R6
DocuSignR1EmailBlurb
Also available: The
parameter with R2, R3,
R4, R5 or R6
DocuSignR1EmailLangua
ge
Also available: The
parameter with R2, R3,
R4, R5 or R6
Because this value is transmitted through the Conga Composer window URL,
we recommend that this value be brief (say, not more than 40 characters).
Note: This parameter only works when sending a DocuSign Envelope directly
via the API using DS7=17 or QMode=7
Because this value is transmitted through the Conga Composer window URL,
we recommend that this value be brief (say, not more than 40 characters).
Note: This parameter only works when sending a DocuSign Envelope directly
via the API using DS7=17 or QMode=7
Requires: A 2 or 5-character DocuSign language code:
Arabic (ar), Bulgarian (bg), Czech (cs), Chinese Simplified (zh-CN), Chinese
Traditional (zh-TW), Croatian (hr), Danish (da), Dutch (nl), English US (en),
English UK (en-GB), Estonian(et), Farsi (fa), Finnish (fi), French (fr), French
Canada (fr-CA), German (de), Greek (el), Hebrew (he), Hindi (hi), Hungarian
(hu), Bahasa Indonesia (id), Italian (it), Japanese (ja), Korean (ko), Latvian
(lv), Lithuanian (lt), Bahasa Melayu (ms), Norwegian (no), Polish (pl),
Portuguese (pt), Portuguese Brazil (pt-BR), Romanian (ro), Russian (ru),
Serbian (sr), Slovak (sk), Slovenian (sl), Spanish (es), Spanish Latin America
(es-MX), Swedish (sv), Thai (th), Turkish (tr), Ukrainian (uk) and Vietnamese
(vi).
Note: This parameter only works when sending a DocuSign Envelope directly
via the API using DS7=17 or QMode=7
Conga Composer Winter ‘13 Release
Page 62

Automatic Role Assignment via Opportunity Contact Roles
When using Conga Composer to generate a document from an Opportunity with Contact
Roles, Conga Composer will scan the Contacts' role names, and use those values for the
DocuSign Recipient role names if the roles exist on the DocuSign Administration Settings.
Conga Composer Winter ‘13 Release
Page 63
EchoSign Integration Parameters
EchoSign delivers Conga Composer documents via email, much like Salesforce itself, but
adds the ability to acquire, track and file signatures.
EchoSign allows you to use PDF forms to collect data from your signers, position signature
fields in your documents, collect two-party information from both sender and signer and
more. You can add EchoSign-specific form fields to Conga Composer PDF merge templates to
enable those features. For more information visit the EchoSign AppExchange listing.
EchoSign is available separately on the AppExchange. You must subscribe to that service to
use these integration parameters.
I M P O R T A N T
Setup:
After installing EchoSign from the AppExchange, you must modify the EchoSign
application by disabling the default value of the Signature Order field:
1. Edit the Signature
Order field by
choosing Setup |
AppSetup |
Create | Objects |
Agreement |
Signature Order
field
2. In the Picklist Values section, Edit the choice “Recipient signs, then I sign”
3. Uncheck (disable) “Make this value the default for the master picklist”
4. Save your changes
Each of the following parameters affects the field specified on an EchoSign Agreement
record. This integration requires EchoSign for Salesforce, version 6.0.
PARAMETER
DESCRIPTION
ESVisible=[0 or 1]
Makes the EchoSign button visible on the Conga Composer dialog box
Note: This parameter is required for all other
EchoSign parameters
•
•
Conga Composer Winter ‘13 Release
If set to 0, the EchoSign button is not visible (default)
If set to 1, the EchoSign button is visible
Page 64
PARAMETER
DESCRIPTION
ESAdditionalTo=[text]
**Parameter no longer recommended. Use the &ESCopyTo parameter
instead.**
(deprecated)
Sets the value of the Additional Recipients field
Requires:
An email address or a field that contains one or more email addresses.
Example 1:
…&[email protected]
Example 2:
…&[email protected], [email protected]
Example 3:
…&ESAdditionalTo={!Contact.OtherEmailAddress}
ESAgreementName=
[text]
Sets the Agreement Name
If not set, the agreement name is set to the output file name
Example 1:
...&ESAgreementName={!Opportunity.AgreementName__c}
Example 2:
…&ESAgreementName=Contract+for+{!Account.Name}
ESContactId=[id]
Sets the value of the Contact field
Requires:
A Salesforce Id of a Contact, or a field that contains the Id of a Contact.
If the Conga Composer Master Object is an Opportunity, the Contact field is
automatically set to the Primary Contact, without the use of this parameter.
If the Conga Composer Master Object is a Quote, the Contact field is
automatically set to the Quote's Contact, without the use of this parameter.
** Note: Depending on your EchoSign Agreement Object’s Page
Layout, this parameter may be required **
Example 1:
…& ESContactId ={!Contact.Id}
Example 2:
…& ESContactId =00143532453dg3C
ESContactId1=[id]
Also available:
ESContactId2,
ESContactId3
ESContractId=[id]
Sets an “Additional Contact” field(s)
Requires
A Salesforce Id of a Contact, or a field that contains the Id of a Contact.
Sets the value of the Contract field
Requires:
A Salesforce Id of a Contract, or a field that contains the Id of a Contract.
Example 1:
…& ESContactId ={!Contact.Id}
Example 2:
…& ESContactId =00143532453dg3C
Conga Composer Winter ‘13 Release
Page 65
PARAMETER
DESCRIPTION
ESCopyTo=[text]
Sets the value of the Email a Copy To field
Requires:
An email address or a field that contains one or more email addresses.
Example 1:
…&[email protected]
Example 2:
…&[email protected], [email protected]
Example 3:
…&ESCopyTo={!Contact.OtherEmailAddress}
ESCustomField=
[ApiFieldName]
Also available:
ESCustomField1
ESCustomField2
ESCustomField3
ESCustomField4
ESCustomField5
ESCustomFieldValue=
[value]
Also available:
ESCustomFieldValue1
ESCustomFieldValue2
ESCustomFieldValue3
ESCustomFieldValue4
ESCustomFieldValue5
ESExpireInXDays=
[value]
ESLanguage=[text]
Sets the name of a custom field to set on the EchoSign Agreement Record
created through the merge process. Use the Salesforce API name of the field
on the EchoSign Agreement Object.
Requires:
ESCustomFieldValue
Example:
…&ESCustomField=Account__c
…&ESCustomFieldValue=001ABCEDFGHIJL
Sets the value of the corresponding custom field
Requires:
ESCustomField
Sets the “Expire in X Days”
Requires:
•
EchoSign 9.5+
Sets the “Language” field
Requires:
•
EchoSign 9.5+
ESLeadId=[id]
Sets the value of the Lead field
Requires:
A Salesforce Id of a Lead, or a field that contains the Id of a Lead.
Example 1:
…& ESLeadId ={!Lead.Id}
Example 2:
…& ESLeadId =00Q43532453dg3C
ESLeadId1=[id]
Also available:
ESLeadId2,
ESLeadId3
Sets an “Additional Lead” field(s)
Requires
A Salesforce Id of a Lead, or a field that contains the Id of a Lead.
Conga Composer Winter ‘13 Release
Page 66
PARAMETER
DESCRIPTION
ESMessage=[text]
Sets the value of the Message field
Example 1:
…&ESMessage=Please+sign+the+attached+document
Example 2:
…&ESMessage={!Opportunity.AgreementMessage__c}
Can be populated via a QVar query.
ESOpportunityId=[id]
Sets the value of the Opportunity field
Requires:
A Salesforce Id of an Opportunity, or a field that contains the Id of an
Opportunity.
Example 1:
…& ESOpportunityId ={!Opportunity.Id}
Example 2:
…& ESOpportunityId =00643532453dg3C
ESPreview=[0 or 1]
Sets the “Preview Field”
Requires:
•
EchoSign 9.5+
ESRequirePWSign=
[0 or 1]
ESRequirePWView=
[0 or 1]
ESRequireSelfSign=
[0 or 1]
Sets the Password Required to Sign field
•
•
Sets the Password Required to View field
•
•
ESSignatureOrder=
[1 or 2]
If set to 0, Password Required to View is disabled (default)
If set to 1, Password Required to View is enabled
Sets the I Also Need To Sign field
Requires:
ESSignatureOrder=[1 or 2]
•
•
ESSignatureType=
[0, 1 or 2]
If set to 0, Password Required to Sign is disabled (default)
If set to 1, Password Required to Sign is enabled
If set to 0, “I Also Need To Sign” is disabled (default)
If set to 1, “I Also Need To Sign” is enabled
Sets the Signature Type
•
•
•
If set to 0, Signature Type is not set
If set to 1, Signature Type is set to “Written Signature”
If set to 2, Signature Type is set to “e-Signature”
Sets the Signature Order field. IMPORTANT: Please see the Setup instructions
at the beginning of this section.
Requires:
ESRequireSelfSign=1
•
•
Conga Composer Winter ‘13 Release
If set to 1, Signature Order is set to “Recipient signs, then I sign”
If set to 2, Signature Order is set to “I sign, then the Recipient signs”
Page 67
PARAMETER
DESCRIPTION
ESRemindRecipient=
[0, 1, 2 or 3]
Sets the Remind Recipient to Sign field
ESRecipient1=[id or
email address]
Also available:
The parameter with 2, 3,
4, 5, or 6
•
•
•
•
If
If
If
If
set
set
set
set
to
to
to
to
0,
1,
2,
3,
Remind
Remind
Remind
Remind
Recipient
Recipient
Recipient
Recipient
is
is
is
is
not set
set to “Never”
set to “Every Day, Until Signed”
set to “Every Week, Until Signed”
More flexible Recipients
Allows you to specify the recipients of an EchoSign Agreement using the
EchoSign Recipients Related List object. The benefit of using this object
rather than the discrete Lookup fields is that you may specify the id of a
Contact, User, Lead, Person Account or simply an email address as a
Recipient.
This parameter requires EchoSign version 11.0+
ESSVBA=[0 or 1]
Send Via Background Action – enhanced automatic delivery
When automatically sending an EchoSign Agreement through the API, you
may elect to trigger EchoSign's built-in delivery mechanism. This parameter
requires that API access is enabled for EchoSign and the EchoSign API Key is
entered in EchoSign configuration settings. This parameter works with the
&DS7=14 and &DS7Preview=1 parameters but won’t work with the &DS7=24
parameter.
Enhancement to Remind
Recipient
It's no longer necessary to use a custom field to enable the EchoSign
Automatic Reminders checkbox – Composer will populate the field
automatically whenever the &ESRemindRecipient parameter is utilized.
DS7=4
Background Mode for EchoSign
See Conga Composer Background Mode, page 45.
DS7=14
Background Mode for EchoSign (automatically-delivered, return to Master
Object)
See Conga Composer Background Mode, page 45.
DS7=24
Background Mode for EchoSign (automatically-delivered, return to
Confirmation)
See Conga Composer Background Mode, page 45.

Control the order in which EchoSign delivers files
You can control the order in which EchoSign delivers files for electronic signature by creating
a custom Text field (255 characters) on the EchoSign Agreement object with the Salesforce
API name "Attachment_Order__c".
Conga Composer will automatically populate this field with a list of the ids of the attachments
generated. EchoSign will deliver the attachments in the order specified.
Conga Composer Winter ‘13 Release
Page 68
Salesforce Chatter Integration Parameters
Conga Composer can store output documents in Salesforce Chatter, rather than as
attachments under the Notes & Attachments related list.
Conga Composer saves files to Chatter as part of the Activity Logging functions. We
recommend the following settings for integrating with Chatter:
• &LG4=1 (Enables Automatic Logging)
• &LGAttachOption=2 (Enables File Attachments to log to Chatter)
If you wish to override the default behavior where files are saved on the Chatter Feed for the
master object, you may use the &AttachmentParentId parameter to identify the record on
which the file should be posted. You may set AttachmentParentId to a User Id, Group Id or
record Id.
PARAMETER
DESCRIPTION
LG4=[0, 1 or 2]
Automatic Logging
Sets whether to automatically log an activity after merging
•
•
•
LGAttachOption=
[0, 1 or 2]
If set to 0, “Automatic Logging” is disabled (default)
If set to 1, “Automatic Logging” is enabled
If set to 2, Master Field to Set fields are automatically updated and no
Task record is created
Sets the Salesforce object to which attachments generated during Activity
Logging are stored
•
•
•
If set to 0, attachments are saved to “Notes & Attachments”(default)
If set to 1, attachments are saved to “Salesforce Content”
If set to 2, attachments are saved to “Salesforce Chatter”
Requires:
•
LG3=1 or 2
Works with:
•
AttachmentParentId (see below)
Conga Composer Winter ‘13 Release
Page 69
PARAMETER
DESCRIPTION
AttachmentParentId=[id]
Specifies the record in Salesforce to which the output file is attached, when
requested. In the absence of this parameter, the default attachment parent
record is the Master Object.
Requires:
A Salesforce Id of a object to which attachments are allowed.
When used with “LGAttachOption=2” (Chatter), this parameter may be set to
a Chatter User Id or Chatter Group Id.
Salesforce Content Integration Parameters
I M P O R T A N T
Conga Composer can store output documents in Salesforce Content, rather than as
attachments under the Notes & Attachments related list.
Setup:
We recommend that you create a Lookup Relationship field on Salesforce Content for
your Master Object type so that you can relate new Content records to the object
from which Conga Composer is initiated.
1. Customize Salesforce Content by choosing Setup | Customize | Salesforce
CRM Content
2. Create a new Lookup Relationship field for the type of field from which Conga
Composer will be called
3. Save your changes
4. Refer to this field using the ContentCustomFieldName and
ContentCustomFieldValue parameters (see below). You must also specify a
ContentWorkspaceId.
PARAMETER
DESCRIPTION
ContentVisible=[0 or 1]
Makes the Salesforce Content button visible on the Conga Composer dialog
box.
•
•
ContentWorkspaceId=
[id]
If set to 0, the Salesforce Content button is not visible (default)
If set to 1, the Salesforce Content button is visible
Sets the Salesforce Id of the Content Workspace under which attachments will
be stored.
Requires:
A Salesforce Id of a Content Workspace. The Id must begin with the prefix
"058".
Example:
…&ContentWorkspaceId=058a123456789ab
Conga Composer Winter ‘13 Release
Page 70
PARAMETER
DESCRIPTION
ContentCustom
FieldName=[value]
Sets the name of a custom field to set on the Salesforce Content Record
created through the merge process. Use the Salesforce API name of the field
on the Salesforce Content Object.
This parameter is
displayed above on
two lines, but should
be on one line in
actual use.
ContentCustom
FieldValue=[value]
This parameter is
displayed above on
two lines, but should
be on one line in
actual use.
DefaultPane=[0 or 1]
Requires:
•
ContentWorkspaceId
•
ContentCustomFieldValue
Example:
…&ContentCustomFieldName=Account__c
…&ContentCustomFieldValue=001ABCEDFGHIJL
Sets the value of the corresponding custom field
Requires:
ContentCustomFieldName
Sets Salesforce Content as the default option in the Select Templates view of
the Composer dialog box
•
•
If set to 0, “Conga Templates” is the default option (default)
If set to 1, “Salesforce Content & Documents” is the default option
Requires:
&SelectTemplates=1
DS7=6
Background Mode to Salesforce Content
•
If set to 6, Background Mode is enabled and the merged document is
attached to Salesforce Content
See Conga Composer Background Mode, page 45.
HideContent=[0 or 1]
Suppresses Salesforce Content from being displayed in the Select Templates
view of the Composer dialog box
•
•
If set to 0, “Salesforce Content & Documents” is visible (default)
If set to 1, “Salesforce Content & Documents” is not displayed
Requires:
&SelectTemplates=1
LGAttachOption=
[0, 1 or 2]
Sets the Salesforce object to which attachments generated during Activity
Logging are stored
•
•
•
If set to 0, attachments are saved to “Notes & Attachments”(default)
If set to 1, attachments are saved to “Salesforce Content”
If set to 2, attachments are saved to “Salesforce Chatter”
Works with:
•
AttachmentParentId (see below)
Conga Composer Winter ‘13 Release
Page 71
PARAMETER
DESCRIPTION
LGContentEnabled=
[0 or 1]
Indicates whether Activity Logging should attach files to Salesforce Content
Do not use. Replaced
with LGAttachOption.
•
•
If set to 0, files attached as a result of Activity Logging are stored in
Notes & Attachments (default)
If set to 1, files attached as a result of Activity Logging are stored in
Salesforce Content
Note: ContentWorkspaceId, ContentCustomFieldName and
ContentCustomFieldValue are also used in conjunction with this setting.
Conga Composer Winter ‘13 Release
Page 72
SendGrid Integration Parameters
SendGrid is an email delivery service with features that assure customers an extremely high
deliverability rate at a low cost. Delivering emails via SendGrid means customers can
circumvent Salesforce email limits and can still use Salesforce email templates.
SendGrid is available separately from their website. You must subscribe to that service to use
this integration.
I M P O R T A N T
Setup:
1. Subscribe to a plan on the SendGrid website. Configure your SendGrid
account according to their instructions.
2. Open the Conga Setup page (located on the lower-right corner of the Conga
Composer dialog box). On the "Integration Partners" tab, paste your SendGrid
username and password. The credentials are encrypted and stored securely.
3. Save your changes.
4. Once Conga is configured with your SendGrid credentials, all email generated
through Conga will be delivered via SendGrid.
Conga Composer will automatically create a completed Task record for each email sent
through SendGrid.
From the Conga Composer dialog box, when the Email button is clicked, Conga Composer
generates the output document (as usual) and then presents a editable email, pre-addressed
to the email address configured in the Conga Composer button.
Conga Composer's Email Parameters work with SendGrid.
Tip! While Salesforce email templates generally work with SendGrid,
we don't recommend the use of Salesforce Letterhead email templates.
Instead, you may configure a SendGrid Template (from their website) to
achieve the same result as a Salesforce Letterhead template. In other words, use either a
SendGrid Template (recommended) or a Salesforce email template, not both.
Conga Composer Winter ‘13 Release
Page 73
Sertifi Integration Parameters
Sertifi delivers Conga Composer documents via email, much like Salesforce itself, but adds
the ability to acquire, track and file signatures. You can learn more about Sertifi for
Salesforce here: https://www.sertifi.com/Sertifi_Salesforce.html
Sertifi is available separately on the AppExchange. You must subscribe to that service to use
this integration parameter.
PARAMETER
DESCRIPTION
SertifiVisible=[0 or 1]
Makes the Sertifi button visible on the Conga Composer dialog box.
•
If set to 0, the Sertifi button is not visible (default)
•
If set to 1, the Sertifi button is visible
SertifiEmailTo=[text]
Sets the value of the recipient of the document to be delivered via Sertifi
Requires:
An email address or a field that contains one or more email addresses.
SertifiSigner2Email=[Em
ail address]
Specify more recipients
SertifiCCSignerEmail=[E
mail Address]
Use this parameter to specify the CC Signer email address
Use this parameter to specify the Signer2 email address
Automatic inclusion of the Composer attachment in the outbound Sertifi email
The latest version of Sertifi will automatically pre-select the file created by
Composer for a Sertifi email message
Conga Composer Winter ‘13 Release
Page 74
SpringCM Integration Parameters
SpringCM provides secure file sharing, document management, and collaboration services,
making it easy to add, find, share, and manage content directly from standard or custom
objects in salesforce.com. You can learn more about SpringCM on their website.
SpringCM is available separately from the Salesforce AppExchange. You must subscribe to
that service to use this integration.
PARAMETER
DESCRIPTION
SCMVisible=[0 or 1]
Makes the SpringCM button visible on the Conga Composer dialog box
•
•
If set to 0, the SpringCM button is not visible (default)
If set to 1, the SpringCM button is visible
DS7=8
Background mode is enabled and the merged document is saved in a
SpringCM folder, as defined by the SpringCM configuration rules
LGAttachOption=3
Attaches a copy of the merged document to a SpringCM folder, as defined by
the SpringCM configuration rules
Requires:
LG4=1
Frequently used in conjunction with the &LG3=2 parameter. Also works with
the &LGAttachmentParentId parameter.
Conga Composer Winter ‘13 Release
Page 75

Advanced Parameters
The Advanced Parameters Group lists parameters that are used less frequently in Conga
solutions, however, they provide invaluable functionality. These parameters affect:
•
•
•
•
•
Advanced Data Gathering
Advanced Template Selection
Advanced Data Formatting
Advanced Dialog Box Restrictions
Formula-Driven Parameters
Advanced Data Gathering Parameters
PARAMETER
DESCRIPTION
DV0=[value]
The DataValue parameters insert a value into the Master data set
without requiring a custom field in Salesforce.
Also available:
DV1, DV2
Example:
…&DV0=Draft+Document
In this example, a column for DV0 would appear on the Master dataset
as seen on the Template Builder window. This value could be displayed
in a watermark or page header on a Word template.
Conga Composer Winter ‘13 Release
Page 76
PARAMETER
DESCRIPTION
QVar0Id=[id]
and {QVar0}
QVar, which stands for Querystring Variable, lets you execute a Conga
Query and use the result of the query as a value for another Conga
Composer parameter.
Also available:
QVar1Id, QVar2Id
Requires:
A 15-character Salesforce Id of a Query record. May optionally include
filter criteria.
Usage Guidelines:
•
Set QVar0Id to the Salesforce Id of a Conga Query record.
Optionally, you may pass filter criteria to the Query. See #2
below for an example.
•
The Conga Query must return only one column of data and
must not retrieve more than 50 rows of data.
•
Multiple rows of data are returned as a comma-separated list.
•
In another Conga Composer parameter, indicate where you
want to insert the QVar0 result with "{QVar0}" (no quotes).
•
The resulting values for all QVar variables appear on the
Template Builder window.
•
The resulting value may be inserted into most Conga
Composer parameters, but not all. Most importantly, it can be
included in ReportId, QueryId, TemplateId, TemplateGroup
and the Email parameters.
•
The duplicate values are automatically stripped from the
resulting data.
•
Not recommended for retrieving date values.
•
Not for use with the SelectTemplates parameter
•
May be used with MFTSValue parameter
Example:
Say you wanted to look up the Id for an Account's Primary Contact and
use the Id in the EmailToId parameter. You could accomplish this by
following these steps:
Conga Composer Winter ‘13 Release
1.
Create a Conga Query to retrieve the desired data and copy its
Salesforce Id to the clipboard.
2.
Reference the Conga Query by including &QVar0Id=QueryId:
&QVar0Id=a01234567890?pv0={!Account.Id}
3.
Pass the QVar result into the EmailToId parameter:
&EmailToId={QVar0}
Page 77
PARAMETER
DESCRIPTION
QVar0Format=[code]
Formats the result of a QVar query.
Also available:
QVar1Format, QVar2Format
The [code] value follows the convention below.
Code: [#][#][#][#][#]
A B C D E
A = Delimiter between data elements [0=none, 1=comma,
2=pipe, 3=semi-colon, 4=colon, 5=hyphen] (“2-Pipe” is
useful for delimiting values that are passed to a Report)
B = Symbol to enclose each data element [0=none,
1=apostrophes, 2=quotes]
C = Symbol after delimiter [0=none, 1=space]
D = Truncate each data element to 15-characters [0=off, 1=on]
(Useful when passing values to a Salesforce Report)
E = Reserved for future use
Example:
Your Conga Query pulls 18-character IDs that you want to pass to a
Report as the pv0 value. The Format Code you would use is “20010”,
which would indicate:
2 = Separate with Pipes
0 = No symbol to enclose each data element
0 = No space between elements
1 = Truncate to 15 characters
0 = Unused
The parameter would be included in the button as:
…&QVar0Format=20010
ReportVar=[value]
Placeholder to represent a value passed to multiple reports, thereby
resulting in a shorter overall URL length
Requires:
At least two ReportId values
Example:
&ReportVar=California|New+York|New+Jersey
&ReportId=00O987654321?pv0={ReportVar},
00O876543210?pv0={ReportVar},
00O654321033?pv0={ReportVar}
In this example, the value of ReportVar
(“California|New+York|New+Jersey”) would be passed to each report’s
selection criteria. Note the placement of “{ReportVar}” to indicate
where to insert the value.
Conga Composer Winter ‘13 Release
Page 78
PARAMETER
DESCRIPTION
XMD=[0 or 1]
Excludes the master object data from being included in the merge
process
•
•
If set to 0, the master data is included in the merge process
(default)
If set to 1, the master data is excluded from the merge process
Requires:
Applicable only when using exactly one Report as the only data source.
The benefit of using this parameter is that in a Word Template, you do
not need to use region tags (<<TableStart:ReportData>>), simply
place the ReportData fields wherever you like on the template, as
though they were Master fields. (See Designing Microsoft Word Merge
Templates, Chapter 4).
Conga Composer Winter ‘13 Release
Page 79
Advanced Template Selection Parameters
The following parameters pertain to merge templates.
PARAMETER
DESCRIPTION
DefaultLocal=[0 or 1]
Sets the default source for a template to the user’s local computer
•
•
If set to 0, default template source is set to “Choose a template
from Salesforce.com”
If set to 1, default template source is “Choose a template from your
local computer”
Requires:
Setup options configured to allow Local Templates. (See Appendix)
DS4=[0 or 1]
Lock Template Choices
•
•
If set to 0, the list of template choices is not locked (default)
If set to 1, the selected template choice is locked
Requires:
TemplateId parameter must be set
In the absence of this parameter, the template indicated by the
TemplateId parameter is pre-selected in the list, but the user may
select a different template. This parameter prevents the user from
selecting a different template.
TNC=[value]
Filters the list of templates at appear on the Conga Composer page to
those that match this criteria. (The parameter means "Template Name
Contains".)
Tips:
•
This parameter works with templates stored either in the Conga
Template Manager or Communication Templates
•
This parameter works in conjunction with TemplateGroup
ZipPDFs=[0 or 1]
In a multiple-template merge, indicates that output PDF files should be
zipped rather than assembled into a single (large) PDF.
Requires:
•
Multiple Template Ids specified
•
Output format set to “Adobe PDF” (DefaultPDF=1)
Conga Composer Winter ‘13 Release
Page 80
Advanced Data-Formatting Parameters
Primarily used for international scenarios, these parameters affect the appearance of number
and date values in Microsoft Word templates. Please note: these options override
default data formatting options and are generally not necessary for most users.
PARAMETER
DESCRIPTION
CurrencyCulture=[code]
Overrides the default cultural settings for currency formatting. Useful in
Word templates that format currency fields with the “\# Currency”
picture switch (see Designing Microsoft Word Merge Templates, chapter
4).
Requires:
A 5-character code (2 lowercase letters, a hyphen, followed by 2
uppercase letters). The code denotes a “language/country” pair. The
first two letters indicate the language, the last two indicate the country.
Example codes:
de-DE
en-GB
en-US
es-ES
German/Germany - Euros
English/Great Britain – British Pounds
English/United States – Dollars
Spanish/Spain – Euros
See the complete list of language/country codes.
Example 1:
…&CurrencyCulture=de-DE
This code would specify that the culture is for German/Germany. For
Word merge fields that use the “\# Currency” picture switch, the
currency values would automatically be formatted as Euros.
Example 2: (using a field to control Culture)
..&CurrencyCulture={!Contact.Culture}
Culture=[code]
Overrides the default cultural settings for currency and date formatting.
Useful in Word templates that format currency fields with “\# Currency”
picture switch (see Designing Word Templates). Exactly the same as
CurrencyCulture, but affects date as well as currency formatting.
See the complete list of language/country codes.
TPV=[0 or 1]
Translate Picklist Values
For organizations where picklist values have been translated via the
Translation Workbench, this setting enables Conga Composer to
retrieve the translated values. This parameter does not work with
SOQL queries; use To Label() on the picklist field instead.
•
•
Conga Composer Winter ‘13 Release
If set to 0, picklist values are not translated (default)
If set to 1, picklist values are translated to the language specified
in the User’s Personal Information settings
Page 81

FAQ: Formatting currency values on a record-by-record basis
Let’s say we’re creating a quote from an Opportunity and we’d like format currency values
based on a field in the Opportunity. Here’s how:
1. Create a picklist field on the Opportunity to contain
the culture choices. Let’s call the field “Culture.” In this
example, let’s use the following choices:
2. Insert the CurrencyCulture parameter into the
Conga Composer URL:
…&CurrencyCulture={!Opportunity.Culture}
3. Format the currency fields in your Word template
using the “\# Currency” picture switch:
{ MERGEFIELD Opportunity_LineItem_SalesPrice \#
Currency }
These settings would result in output such as:


Tip! Disable Wrap Text in cells that use Currency formatting to keep the value and
the symbol on the same line.
Table | Table Properties | Cell | Options, then uncheck Wrap Text.
Conga Composer Winter ‘13 Release
Page 82
Advanced Control Parameters
PARAMETER
DESCRIPTION
DC=[0 or 1]
Disable Conga Execution
This parameter is usually set a part of a Salesforce formula to evaluate the
contents of a field and, in turn, prevent the execution of Conga if the field
doesn't meet some criteria.
Example:
…DC={!IF(Opportunity.StageName = "Closed Won", "0", "1") }
DCL=[text]
Disable Conga Execution Label
Displays a message on the Conga Composer dialog box when "Disable Conga
Exeuction" is enabled. Displays up to 50 characters.
Requires:
DC=1 (Disable Conga Execution)
Example 1:
…&DCL =Required+fields+have+not+been+set
EC=[0 or 1]
Enable Conga Execution
This parameter is usually set a part of a Salesforce formula to evaluate the
contents of a field and, in turn, enable the execution of Conga if the field
meets some criteria.
Example:
…EC={!IF(Opportunity.StageName = "Closed Won", "1", "0") }
ECL=[text]
Enable Conga Execution Label
Displays a message on the Conga Composer dialog box when "Enable Conga
Execution" is disabled. Displays up to 50 characters.
Requires:
EC=0 (Enable Conga Execution)
Example 1:
…&ECL =Required+fields+have+not+been+set
OCNR=[0 or 1]
On-Close, No Refresh
Disables the default behavior when the Close button is clicked. By default, the
Salesforce record is refreshed when Close is clicked.
•
•
Conga Composer Winter ‘13 Release
If set to 0, the Salesforce record is refreshed (default)
If set to 1, the Salesforce record is not refreshed
Page 83
Formula-Driven Parameters
Rather than defining a parameter with a particular value, you can use Salesforce formulas to
provide a limited amount of dynamic flexibility to your Conga Composer URLs.
Example:
Say you’d like users of a particular profile to always generate PDFs from Conga Composer,
whereas users of other profiles may choose whether to use the native file format or PDFs.
You could accomplish this by using a formula to control the behavior of the “fp0” parameter.
In this example, after the base URL (gray), we’ve enabled the Default PDF parameter and
made the Force PDF parameter (fp0) dynamic, based on the user’s Profile. For System
Administrators, “fp0” is disabled. For others, “fp0” is enabled.
https://www.appextremes.com/apps/Conga/Composer.aspx
?sessionId={!API.Session_ID}
&serverUrl={!API.Partner_Server_URL_210}
&id={!Contact.Id}
&DefaultPDF=1
&FP0={!IF( $Profile.Name = "System Administrator", "0", "1")}
Tip! In practice, we would recommend using an Id, such as $Profile.Id,
rather than a text string, such as the Profile Name.
Tip! You can learn more about the Salesforce formula language by searching
for “Operators and Functions” in the Salesforce.com online help.
Conga Composer Winter ‘13 Release
Page 84

Conga Composer URL Examples
Sometimes it’s helpful to see a complete Conga Composer URL to fully comprehend how to
assemble various parameters. Here are three examples.

Example 1
In addition to the base URL (the gray text), this example enables PDF encryption (ps0=1)
and PDF printing (ps1=1). Next, it disables the Log Activity button (ds3=1), sets the
template (TemplateId) and locks the template choice (ds4=1).
https://www.appextremes.com/apps/Conga/Composer.aspx
?SessionId={!API.Session_ID}
&ServerUrl={!API.Partner_Server_URL_210}
&Id={!Contact.Id }
&PS0=1
&PS1=1
&DS3=1
&TemplateId=0014432553FB
&DS4=1

Example 2
The next example demonstrates the use of multiple reports. After the base URL, we’ve
included four reports (ReportId), specified a template (TemplateId) and the Email To field
(EmailToId)
https://www.appextremes.com/apps/Conga/Composer.aspx
?SessionId={!API.Session_ID}
&ServerUrl={!API.Partner_Server_URL_210}
&Id={!Contact.Id}
&ReportID=00O50000001NGuW,
00O50000001O2gr,
00O50000001NGv5,
00O50000001NGvL
&TemplateId=01H500000005z4L
&EmailtoID={!Contact.Id}

Example 3
The final example demonstrates the use of Background Mode. After the base URL, we’ve
included a report (which is filtered by the Account ID), specified a template (TemplateId),
enabled the Background Mode that attaches the document (ds7=1) and forced the output to
Adobe Acrobat (fp0=1).
https://www.appextremes.com/apps/Conga/Composer.aspx
?SessionId={!API.Session_ID}
&ServerUrl={!API.Partner_Server_URL_210}
&Id={!Opportunity.Id}
&ReportId=00O50000001OAA2?pv0={!Opportunity.AccountId}
&TemplateId=01H500000005xop
&DS7=1
&FP0=1
Conga Composer Winter ‘13 Release
Page 85
5. Conga Email Template Manager
The Conga Email Template Manager custom object is a significant addition to Conga
Composer. With this new custom object, you can create Conga Email Templates that
work a lot like Conga Composer templates built in Microsoft Word. For more information
about designing Conga Email Templates, please see Conga Email Templates.
Conga Composer Winter ‘13 Release
Page 86
6. Know Your Limits
Conga Composer Limits – per Solution
Queries
Reports
Lines of Data in a Report
Columns per Tab in View Data workbook
Dataset
Qvar
Number of Templates per operation
Template Size
Maximum
50
50
1,500 Rows or 5 MB per merge
256
25,000 total rows
50 rows of data
10
5 MB
Conga Mail Merge Limits
Output File Size
Reports
Template Size
Conga Query Limits
Aggregate SOQL (SUM, COUNT, etc.)
Maximum
40 Mb
5k
5 Mb
Maximum
200 category values
Conga Conductor Limits
Conga Conductor, per batch process
Maximum
50 records for consolidated output.
500 records for distributed output.
Maximum
500 transactions per day
Conga Workflow Limits
Conga Workflow
Conga Courier Limits
Conga Courier Schedules
Contacts as recipients for a Courier
Schedule
Output file size
Maximum
200
25
Browser URL Limits
Internet Explorer
Maximum
2000 bytes (closer to 1,700 bytes in
practice)
64,000 bytes
Chrome, Firefox, Safari
Conga Composer Winter ‘13 Release
5 MB
Page 87
7. Other Parameters

1.
2.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
15.
16.
17.
18.
19.
20.
21.
22.
25.
26.
27.
28.
29.
32.
33.
34.
35.
36.
37.
38.
39.
40.
41.
42.
43.
44.
45.
46.
47.
48.
49.
50.
51.
52.
Supported Culture Codes
English Name
Afrikaans (South Africa)
Albanian (Albania)
Amharic (Ethiopia)
Arabic (Algeria)
Arabic (Bahrain)
Arabic (Egypt)
Arabic (Iraq)
Arabic (Jordan)
Arabic (Kuwait)
Arabic (Lebanon)
Arabic (Libya)
Arabic (Morocco)
Arabic (Oman)
Arabic (Qatar)
Arabic (Saudi Arabia)
Arabic (Syria)
Arabic (Tunisia)
Arabic (U.A.E.)
Arabic (Yemen)
Armenian (Armenia)
Assamese (India)
Bashkir (Russia)
Basque (Basque)
Belarusian (Belarus)
Bengali (Bangladesh)
Bengali (India)
Breton (France)
Bulgarian (Bulgaria)
Catalan (Catalan)
Chinese (Hong Kong
S.A.R.)
Chinese (Macao S.A.R.)
Chinese (People's Republic
of China)
Chinese (Singapore)
Chinese (Taiwan)
Corsican (France)
Croatian (Croatia)
Croatian (Latin) (Bosnia
and Herzegovina)
Czech (Czech Republic)
Danish (Denmark)
Dari (Afghanistan)
Divehi (Maldives)
Dutch (Belgium)
Dutch (Netherlands)
English (Australia)
English (Belize)
English (Canada)
English (Caribbean)
Abbreviation
af-ZA
sq-AL
am-ET
ar-DZ
ar-BH
ar-EG
ar-IQ
ar-JO
ar-KW
ar-LB
ar-LY
ar-MA
ar-OM
ar-QA
ar-SA
ar-SY
ar-TN
ar-AE
ar-YE
hy-AM
as-IN
ba-RU
eu-ES
be-BY
bn-BD
bn-IN
br-FR
bg-BG
ca-ES
zh-HK
zh-MO
zh-CN
zh-SG
zh-TW
co-FR
hr-HR
hr-BA
cs-CZ
da-DK
prs-AF
dv-MV
nl-BE
nl-NL
en-AU
en-BZ
en-CA
en-029
Conga Composer Winter ‘13 Release
53.
54.
55.
56.
57.
58.
59.
60.
61.
62.
63.
64.
65.
66.
68.
69.
70.
71.
72.
73.
74.
75.
76.
77.
78.
79.
80.
81.
82.
83.
84.
85.
87.
88.
89.
90.
91.
92.
95.
96.
97.
98.
99.
100.
101.
102.
103.
English Name
English (India)
English (Ireland)
English (Jamaica)
English (Malaysia)
English (New Zealand)
English (Republic of the
Philippines)
English (Singapore)
English (South Africa)
English (Trinidad and
Tobago)
English (United Kingdom)
English (United States)
English (Zimbabwe)
Estonian (Estonia)
Faroese (Faroe Islands)
Finnish (Finland)
French (Belgium)
French (Canada)
French (France)
French (Luxembourg)
French (Principality of
Monaco)
French (Switzerland)
Frisian (Netherlands)
Galician (Galician)
Georgian (Georgia)
German (Austria)
German (Germany)
German (Liechtenstein)
German (Luxembourg)
German (Switzerland)
Greek (Greece)
Greenlandic (Greenland)
Gujarati (India)
Hebrew (Israel)
Hindi (India)
Hungarian (Hungary)
Icelandic (Iceland)
Igbo (Nigeria)
Indonesian (Indonesia)
Irish (Ireland)
isiXhosa (South Africa)
isiZulu (South Africa)
Italian (Italy)
Italian (Switzerland)
Japanese (Japan)
Kannada (India)
Kazakh (Kazakhstan)
Khmer (Cambodia)
Abbreviation
en-IN
en-IE
en-JM
en-MY
en-NZ
en-PH
en-SG
en-ZA
en-TT
en-GB
en-US
en-ZW
et-EE
fo-FO
fi-FI
fr-BE
fr-CA
fr-FR
fr-LU
fr-MC
fr-CH
fy-NL
gl-ES
ka-GE
de-AT
de-DE
de-LI
de-LU
de-CH
el-GR
kl-GL
gu-IN
he-IL
hi-IN
hu-HU
is-IS
ig-NG
id-ID
ga-IE
xh-ZA
zu-ZA
it-IT
it-CH
ja-JP
kn-IN
kk-KZ
km-KH
Page 88
105.
106.
108.
109.
110.
111.
112.
114.
115.
116.
117.
118.
119.
120.
121.
122.
126.
127.
128.
129.
130.
131.
132.
133.
134.
135.
136.
140.
141.
142.
146.
147.
148.
152.
158.
159.
160.
161.
162.
163.
English Name
Kinyarwanda (Rwanda)
Kiswahili (Kenya)
Korean (Korea)
Kyrgyz (Kyrgyzstan)
Lao (Lao P.D.R.)
Latvian (Latvia)
Lithuanian (Lithuania)
Luxembourgish
(Luxembourg)
Macedonian (Former
Yugoslav Republic of
Macedonia)
Malay (Brunei
Darussalam)
Malay (Malaysia)
Malayalam (India)
Maltese (Malta)
Maori (New Zealand)
Mapudungun (Chile)
Marathi (India)
Nepali (Nepal)
Norwegian, Bokmål
(Norway)
Norwegian, Nynorsk
(Norway)
Occitan (France)
Oriya (India)
Pashto (Afghanistan)
Persian (Iran)
Polish (Poland)
Portuguese (Brazil)
Portuguese (Portugal)
Punjabi (India)
Romanian (Romania)
Romansh (Switzerland)
Russian (Russia)
Sami (Northern) (Finland)
Sami (Northern) (Norway)
Sami (Northern) (Sweden)
Sanskrit (India)
Setswana (South Africa)
Sinhala (Sri Lanka)
Slovak (Slovakia)
Slovenian (Slovenia)
Spanish (Argentina)
Spanish (Bolivia)
Abbreviation
rw-RW
sw-KE
ko-KR
ky-KG
lo-LA
lv-LV
lt-LT
lb-LU
mk-MK
ms-BN
ms-MY
ml-IN
mt-MT
mi-NZ
arn-CL
mr-IN
ne-NP
nb-NO
nn-NO
oc-FR
or-IN
ps-AF
fa-IR
pl-PL
pt-BR
pt-PT
pa-IN
ro-RO
rm-CH
ru-RU
se-FI
se-NO
se-SE
sa-IN
tn-ZA
si-LK
sk-SK
sl-SI
es-AR
es-BO
Conga Composer Winter ‘13 Release
164.
165.
166.
167.
168.
169.
170.
171.
172.
173.
174.
175.
176.
177.
178.
179.
180.
181.
182.
183.
187.
188.
189.
190.
191.
192.
193.
194.
195.
197.
200.
201.
202.
204.
205.
English Name
Spanish (Chile)
Spanish (Colombia)
Spanish (Costa Rica)
Spanish (Dominican
Republic)
Spanish (Ecuador)
Spanish (El Salvador)
Spanish (Guatemala)
Spanish (Honduras)
Spanish (Mexico)
Spanish (Nicaragua)
Spanish (Panama)
Spanish (Paraguay)
Spanish (Peru)
Spanish (Puerto Rico)
Spanish (Spain)
Spanish (United States)
Spanish (Uruguay)
Spanish (Venezuela)
Swedish (Finland)
Swedish (Sweden)
Tamil (India)
Tatar (Russia)
Telugu (India)
Thai (Thailand)
Tibetan (People's Republic
of China)
Turkish (Turkey)
Turkmen (Turkmenistan)
Uighur (People's Republic
of China)
Ukrainian (Ukraine)
Urdu (Islamic Republic of
Pakistan)
Vietnamese
(Vietnam)
Welsh (United
Kingdom)
Wolof (Senegal)
Yi (People's Republic
of China)
Yoruba (Nigeria)
Abbreviation
es-CL
es-CO
es-CR
es-DO
es-EC
es-SV
es-GT
es-HN
es-MX
es-NI
es-PA
es-PY
es-PE
es-PR
es-ES
es-US
es-UY
es-VE
sv-FI
sv-SE
ta-IN
tt-RU
te-IN
th-TH
bo-CN
tr-TR
tk-TM
ug-CN
uk-UA
ur-PK
vi-VN
cy-GB
wo-SN
ii-CN
yo-NG
Page 89
8. Index of Conga Composer Parameters
APF .......................................................... 56
AttachmentParentId ........................ 42, 52, 70
AWD .................................................. 53, 57
BML ......................................................... 46
CongaEmailTemplateGroup ......................... 58
CongaEmailTemplateId ............................... 58
ContentCustomFieldName ........................... 71
ContentCustomFieldValue ........................... 71
ContentVisible ........................................... 70
ContentWorkspaceId .................................. 70
Culture ..................................................... 81
CurrencyCulture ........................................ 81
DC ........................................................... 83
DCL ......................................................... 83
DefaultLocal .............................................. 80
DefaultPane .............................................. 71
DefaultPDF ............................................... 51
DocuSignCustomField ................................. 60
DocuSignCustomFieldValue ......................... 60
DocuSignEmailBody ................................... 61
DocuSignEmailSubject................................ 62
DocuSignEndpoint ..................................... 61
DocuSignExpireIn ...................................... 61
DocuSignIgnoreOCR................................... 62
DocuSignR1AccessCode .............................. 60
DocuSignR1Id ........................................... 59
DocuSignR1Role ........................................ 59
DocuSignR1RoutingOrder ........................... 60
DocuSignR1Type ....................................... 60
DocuSignRelatedAccountId ......................... 60
DocuSignRemindAgainIn ............................ 61
DocuSignRemindIn .................................... 61
DocuSignSendReminders ............................ 61
DocuSignTag ............................................. 62
DocuSignVisible ......................................... 59
DocuSignWarnIn ....................................... 61
DS0 ......................................................... 44
DS1 ......................................................... 45
DS2 ......................................................... 45
DS3 ......................................................... 45
DS4 ................................................... 45, 80
DS5 ......................................................... 45
DS6 ......................................................... 45
DS7 ................................... 45, 47, 68, 71, 75
DS7Preview .............................................. 48
DS8 ......................................................... 45
DS9 ......................................................... 45
DV0 ......................................................... 76
EC ........................................................... 83
ECL .......................................................... 83
EmailAdditionalTo ...................................... 37
EmailBCC.................................................. 38
EmailCC ................................................... 38
EmailFromId ............................................. 39
EmailRelatedToId ...................................... 37
EmailReplyToId ......................................... 39
EmailSubject ............................................. 38
EmailTemplateAttachments ......................... 38
EmailTemplateId ....................................... 38
EmailToId ................................................. 37
EmailUseSignature ..................................... 39
ESAdditionalTo .......................................... 65
ESAgreementName .................................... 65
Conga Composer Winter ‘13 Release
ESContactId ............................................. 65
ESContactId1 ........................................... 65
ESContractId ............................................ 65
ESCopyTo ................................................ 66
ESCustomField .......................................... 66
ESCustomFieldValue .................................. 66
ESExpireInXDays ...................................... 66
ESLanguage ............................................. 66
ESLeadId ................................................. 66
ESLeadId1................................................ 66
ESMessage ............................................... 67
ESOpportunityId ....................................... 67
ESPreview ................................................ 67
ESRecipient .............................................. 68
ESRemindRecipient ................................... 68
ESRequirePWSign...................................... 67
ESRequirePWView ..................................... 67
ESRequireSelfSign ..................................... 67
ESSignatureOrder ..................................... 67
ESSignatureType....................................... 67
ESSVBA ................................................... 68
ESVisible .................................................. 64
ExcelAutoFitColumns ................................. 56
ExcelAutoFitRows ...................................... 56
FlattenPDFForms ....................................... 54
FP0 .................................................... 44, 51
HideContent ............................................. 71
Id ........................................................... 29
LG0 ......................................................... 40
LG1 ......................................................... 40
LG2 ......................................................... 41
LG3 ......................................................... 41
LG4 .................................................... 41, 69
LG5 ......................................................... 41
LG6 ......................................................... 41
LG7 ......................................................... 42
LGAttachOption......................... 42, 69, 71, 75
LGParentId ............................................... 42
LGWhoId .................................................. 42
MFTS0 ..................................................... 43
MFTSId .................................................... 43
MFTSValue0 ............................................. 43
MTOFN..................................................... 52
OCNR ...................................................... 83
OFN......................................................... 52
PPTPreserveRows ...................................... 56
PS0 ......................................................... 54
PS1 ......................................................... 54
PS2 ......................................................... 54
PS3 ......................................................... 54
PSPW ...................................................... 55
QueryId ................................................... 31
QVar0Format ............................................ 78
QVar0Id ................................................... 77
ReportId .................................................. 30
ReportVar ................................................ 78
SCHP ....................................................... 56
SCMVisible ............................................... 75
SelectTemplates........................................ 33
SertifiCCSignerEmail.................................. 74
SertifiEmailTo ........................................... 74
SertifiSigner2Email .................................... 74
SertifiVisible ............................................. 74
Page 90
TemplateGroup ......................................... 32
TemplateId ............................................... 32
TNC ......................................................... 80
TPV .......................................................... 81
Conga Composer Winter ‘13 Release
WPD ........................................................ 57
XMD ........................................................ 79
ZipPDFs ................................................... 80
Page 91