Conga Composer Storing Merge Templates

Transcription

Conga Composer Storing Merge Templates
Conga, Inc.
[email protected]
Conga Composer
Storing Merge Templates
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
download the Conga Composer Examples file.
Articles and Videos:
Conga provides an online knowledgebase and YouTube channel that are available 24X7 to
help you answer questions.
QuickStarts:
Want to get started right away? Our Quick Start Guides will help you quickly generate your
first Conga Composer solutions.
To learn more, go to our Conga QuickStart Library.
Page 2
Table of Contents
General Disclaimer .............................................................................................4
Storing Merge Templates ...................................................................................5
Conga Template Manager ............................................................................................ 5
 To create a Conga Template Record: .................................................................. 5
Salesforce Mail Merge Template Repository.................................................................... 6
Your local drive or network directory ............................................................................ 7
Conga Email Template Manager ................................................................................... 8
Conga Winter '13 Release
Page 3
Storing Merge Templates
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 Conga solutions are entirely represented by standard Salesforce user interface
compliance when properly configured. Therefore, customers seeking the 508 Compliance
VPAT documentation are referred to Salesforce.
Page 4
Storing Merge Templates
A file-based merge template, regardless of type (Word, Excel, PowerPoint or PDF), may be
stored in either of these locations:



The Conga Template Manager (recommended)
The Salesforce Mail Merge Template Repository
Your local hard drive or network drive
Conga Email Templates must be stored in the:
 The Conga Email Template Manager
Conga Template Manager
The Conga Template Manager (“CTM”) is a custom object, included with Conga Composer, in
which merge templates can be stored.
Note: You must enable the Conga Template Manager on the Conga Setup page.
Salesforce Setup | View Installed Packages | Configure for Conga Composer.
The CTM has many advantages:
 Attach any kind of
template (Word, Excel,
PowerPoint or PDF)
without having to alter
the file extension

Use Salesforce security
to limit visibility of
templates to certain
users

Specify up to three fields in Salesforce to update after a merge operation – helpful in
advancing a workflow status field

Change the attachment related to a Template Record, without changing its Salesforce
Id, which is beneficial if you’ve referenced the Id in a Conga Composer URL
Access the Template Repository by viewing the “Conga Templates (v5)” tab in Salesforce.

To create a Conga Template Record:
1. Ensure that you’ve enabled the Conga Template Manager on the Setup page (see
above)
2. Open the Conga Templates (v5) Tab. Click New to start a new Template record
3. Enter a name and description. Click Save.
4. Upload your template by clicking Attach File.
5. If you want to reference this template from a Conga Composer button, copy its
Record Id to the clipboard and paste it into a Conga Composer Button URL after
“&TemplateId=”.
Conga Winter '13 Release
Page 5
Storing Merge Templates
Salesforce Mail Merge Template Repository
The Salesforce Mail Merge Template repository can be found at:
Setup | Administration Setup | Communication Templates | Mail Merge Templates
To load a Word template into this repository, click New Template, enter a descriptive name
and attach the file.
To attach an Excel or PDF file, however, you must alter the file extension of your template
because the Salesforce repository only allows files that have a “.doc” extension to be
uploaded.
Note: The Communication Templates is enabled by default on the Conga Setup page.
We highly recommend that you enable the Conga Template Manager and de-activate
Communication Templates.
Tip! Make a backup copy of your template before proceeding.
You can work-around the restriction in this way:
1. Start Windows Explorer
(right-click My Computer,
then choose Explore).
2. In Windows Explorer, disable
Hide File Extensions by
choosing Tools | Folder
Options then View (tab),
uncheck Hide extensions
for known file types, then
OK
3. Rename the template and
enter .doc after its regular
extension, resulting in a file
that ends in either “.xls.doc” or “.pdf.doc”.
Tip! Do not use “.docx” as the faux file extension -- use “.doc”
4. Upload the renamed file to the Salesforce repository
Example:
A template named “Quote Template.xls” would become “Quote Template.xls.doc”.
A template named “Quote Template.xlsx” would become “Quote Template.xlsx.doc”.
Tip! To re-open the local file, you’ll need to either remove the “.doc”
extension or open the backup copy.
Page 6
Your local drive or network directory
You can select a file from your local drive or a network directory.
Tip! This option is very convenient particularly when designing Conga Composer templates
because you can perform a merge and observe the results. If changes are necessary, tweak
the template and save it, then switch back to Conga Composer and click Merge again. You
can bypass the tedious operation of uploading the template to the Salesforce repository.
Conga Winter '13 Release
Page 7
Storing Merge Templates
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 templates built in Microsoft Word. For more information about
designing Conga Email Templates, please see the document on creating Conga Email
Templates.
Page 8