Conga Composer Installation and Administration
Transcription
Conga Composer Installation and Administration
Conga, Inc. [email protected] Conga Composer Installation and Administration Guide Release 7 - Winter '13 Welcome Conga Composer lets you generate documents and spreadsheets by gathering data from Salesforce.com 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. Conga Mail Merge, included with your subscription to Conga Composer, is a step-by-step wizard that guides you through the process of creating batches of documents. You can access Conga Mail Merge by clicking the Conga Mail Merge tab. Contacting Conga Conga is a leading provider of software solutions to enrich your Salesforce.com experience, specializing in document creation tools that integrate data from Salesforce. Founded in 2006, Conga has since built a substantial market presence with more than 2,000 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. Sydney Time Tech Support Email: [email protected] Telephone: +61 28 417 2399 © 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. Sales For information on other products from Conga, please contact our New Business team: Sales Information Email: [email protected] Telephone: +1 303-465-1616 Resources Examples: For detailed sample templates, please see the Conga Composer 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 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 Welcome ............................................................................................................1 Contacting Conga ...............................................................................................1 Technical Support .............................................................................................. 1 Sales ................................................................................................................. 2 Resources ..........................................................................................................2 Table of Contents ...............................................................................................3 General Disclaimer .............................................................................................4 Installation ........................................................................................................5 System Requirements ........................................................................................ 5 Installing Conga Composer ................................................................................ 6 Upgrading Conga Composer ............................................................................... 8 What’s in the managed package? ....................................................................... 8 Who should upgrade? ........................................................................................ 8 Complete Documentation ................................................................................... 9 Add-Ons to Conga Composer .............................................................................. 9 Administration .................................................................................................10 Setup Page ...................................................................................................... 10 Basic Tab ..................................................................................................... 11 Advanced Tab ............................................................................................... 13 Recent Activity Tab........................................................................................ 14 User Management Tab ................................................................................... 15 Integration Partners Tab ................................................................................ 16 Integration with SpringCM™ ............................................................................ 17 SpringCM Parameters .................................................................................... 18 Preparing to use Conga in a Sandbox ............................................................... 19 Printing Labels using a Label Printer ................................................................ 19 Conga Composer 7 – Winter '13 Release Page 3 Installation and Administration Guide 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 Installation Getting started with Conga Composer is easy! The basic steps to configure Conga Composer are outlined below. You’ll find more detail about each step in the reference guides available on the Documentation page of our website. System Requirements To install and successfully use Conga Composer, you must have one of the following versions of Salesforce.com: Performance (Unlimited) Edition Enterprise Edition Developer Edition Professional Edition Sandbox Edition Conga Composer also works with the following1: Salesforce Customer Portal Salesforce Partner Portal Force.com Platform We’ve used Conga Composer with the following operating systems and browsers (although our goal is to work with any browser on any operating system): Microsoft Windows 2000, XP, Vista and Windows 7 Browsers: Internet Explorer 7+, Firefox 3+, Opera 9+, Safari 4+, Chrome 5+ Mac OS X Browsers: Safari, Opera, Firefox We’ve also used Conga Composer with the following versions of Microsoft Office: Microsoft Office 2010 for Windows Microsoft Office 2007 for Windows Microsoft Office 2003 for Windows Microsoft Office 2011 for Mac Microsoft Office 2008 for Mac Microsoft Office 2004 for Mac Conga Composer can also place Salesforce data into forms created as PDF files, such as government forms, loan applications and other highly secure applications. Instead of building these templates with Microsoft Office, you’ll need the following: Adobe Acrobat 9 Standard+ Please note: Adobe LiveCycle PDFs are not supported 1 Certain features not available in Customer and Partner Portal. Please inquire for details. Conga Composer 7 – Winter '13 Release Page 5 Installation and Administration Guide Installing Conga Composer The following steps provide an overview of how to install Conga Composer (and Conga Mail Merge) and the general steps involved in deploying the application. 1. Install Conga Composer into your instance of Salesforce by visiting our page on the AppExchange. a. Click the “Get It Now” button and follow the on-screen prompts to install Conga Composer. (You must provide system administrator credentials to install an application from the AppExchange.) 2. Enable security settings to allow Conga Composer to interact with your data: a. For each User Profile that has access to Conga Composer, ensure the “API Enabled” setting is active b. If you want to use Reports as a data source, ensure that “Run Reports” and “Export Reports” is enabled for each User Profile that has access to Conga Composer Note: If you are using Salesforce Enterprise Edition you will be prompted with the option of choosing a security level, we recommend choosing Grant access to all users: Page 6 3. Enable the recommended settings on the Conga Setup page: a. On the Salesforce Setup page, choose View Installed Packages, then Configure for Conga Composer. b. Enable the desired Template Managers (v5 recommended) c. Enable the recommended Behavior Modification settings (see image, right). d. Save your changes 4. (Optional) To use Salesforce reports as a data source for Conga Composer: Create reports that meet your needs. See “Using Salesforce Reports with Conga Composer” in the Conga Composer Configuration Guide, and “Using Salesforce Reports with Conga Mail Merge” in the Conga Mail Merge Configuration Guide for details. 5. (Optional) To use Conga Queries as a data source, you’ll need to upgrade to Conga Composer Release 8, which includes the Conga Queries custom object as part of the Composer app. 6. Add Conga Composer buttons to any desired standard or custom objects. See below for a brief explanation. Video: How to create a basic Conga Composer button 7. Create merge templates in Word, Excel, PowerPoint or Acrobat. See reference guides for each template type on the Documentation page of our website for details. Video: How to add merge fields to a Word template Tip! Do not enable “Lock Sessions to the IP Address from which they Originated” (under Salesforce Setup | Administer | Security Controls | Session Settings) Conga Composer 7 – Winter '13 Release Page 7 Installation and Administration Guide Upgrading Conga Composer Conga Composer and Conga Mail Merge are composite applications, which means that some parts of the system are installed into your instance of Salesforce, however most of the system runs on our servers. As a result, the portion of the system that runs on our servers does not require upgrading on your part: updates to the system are automatically made available at various times throughout the year. The portions of the system that are installed into your instance of Salesforce can be upgraded by visiting the Conga Composer listing on the AppExchange, clicking the “Get it Now” button and following the prompts to update the installed components. Warning! DO NOT uninstall your current version of Conga Composer before upgrading! If you do so, you will lose all of the Conga Composer components that you’ve already built. What’s in the managed package? 1. The Conga Template Manager (v5) The Conga Template Manager is a custom object into which Conga Templates are stored. This custom object does not count against your Salesforce limit on custom objects. 2. The Conga Email Template Manager The Conga Email Template Manager is a custom object into which HTML-based Conga Email Templates are stored. The custom object does not count against your Salesforce limit on custom objects. 3. The “Conga Reports” folder 4. The “Conga Composer Reports” folder 5. A custom setting for “Production Org Id” which is useful for customers who create Salesforce Sandbox instances Who should upgrade? 1. If you already have the Conga Template Manager (v4) installed, you should upgrade only if you wish to recover a custom object (and tab) against your Salesforce limit. Please note that you will need to migrate your Templates from the old custom object to the new one, either by manually recreating the records, or possibility through a data migration tool like the Salesforce Data Loader. 2. If you want to use Conga Email Templates, you should upgrade. 3. If you want to use the new “Production Org Id” custom setting for better control over Sandbox instances, you should upgrade. 4. If you want to use Conga Queries as a data source, you should upgrade. Page 8 Complete Documentation On the Conga website, you’ll find a rich array of documentation for all of our various products. Please visit the Documentation page on the Conga Support page to view the available choices. Topics include: Conga Composer Installation and Administration Guide (this document) Configuration Guide Storing Merge Templates Troubleshooting Guide Template Guides: o Excel o Conga HTML Email o PDF o PowerPoint 2007 (.pptx) o PowerPoint 2003 (.ppt) o Word Release Notes Add-Ons to Conga Composer The Installation Links page on the Conga website provides links to install any of our add-on products as well as installation links for installing any of our products in a Salesforce Sandbox instance. Some of the add-ons to Composer are free and others are paid but are available for a free 30 day trial. Conga Add-Ons Conga Conductor (paid, free 30 day trial available) Conga Workflow (paid, free 30 day trial available) Conga QuickMerge (free) Conga Composer 7 – Winter '13 Release Page 9 Installation and Administration Guide Administration Setup Page You can change various options in Conga by visiting the Conga Setup page, which is accessible from Salesforce Setup, then View Installed Packages and Configure for Conga Composer. The following options can be configured from the Conga Setup page: Basic Settings Advanced Settings Recent Activity User Management Integration Partners Note: The Conga Setup link also appears on the “Conga Mail Merge” page (upper-right corner) and the “Conga Composer” dialog box (lower-right corner) for users who have the following permissions: View All Data Modify All Data View Setup Tip! An alternative technique to open the Conga Setup page (for previous versions): Open the "Conga Mail Merge" tab in Salesforce, the look for the Setup link in the upper-right corner in the orange bar Tip! You may also open the Conga Setup page by opening a Conga Composer dialog box and look for the "Setup" link in the lower-right corner. Page 10 Basic Tab Disable the Editor You may choose to disable the rich-text editor on the Letters page (Step 4) of Conga Mail Merge. This forces users to choose a template from the template manager. (Certain regulated organizations would not want users entering a free-form letter.) Allow Use of Local Templates You may permit your users to upload a template from their own hard drives. This feature is disabled by default for all users except for administrators. This feature is always enabled for administrators because of its utility in creating and testing Word templates. Local templates can also be enabled via a Conga Composer parameter (See the DS8=1 parameter in Conga Composer Configuration Guide). Conga Template Manager We strongly recommend that you store templates in the Conga Template Manager V5 (“CTM”) – see Conga Composer Storing Merge Templates, for details. This custom object is included with Conga Composer and Conga Mail Merge. Optionally, you may enable Communication Templates (or the previous version of the Conga Template Manager), which may be useful while you migrate templates from the older repositories to the new, V5 repository. After migrating your templates, you should disable repositories not in use. Conga Composer 7 – Winter '13 Release Page 11 Installation and Administration Guide Behavior Modification The Behavior Modification settings govern how Conga pulls data and how Word templates behave. If your organization is new to Conga, we strongly recommend that you enable all of the Behavior Modification settings. If your organization has used Conga before Conga Spring ’11 was released, you may enable these settings, however, they may affect your templates, so please be careful. Query Object Name Correction This setting corrects a problem in which Conga Queries resulted in object names with doubleunderscores. For example, a merge field name for the Amount field on an Opportunity sometimes appeared as: OPPORTUNITY__AMOUNT Instead of OPPORTUNITY_AMOUNT This was an issue because after modifying the Conga Query sometimes resulted in slightly different field names, thus preventing a merge field from working properly. Prevent Auto-Incrementing Column Name This setting corrects a merge field naming problem in Reports and Queries in which column names were incorrectly labeled with an “_1”. Word Templates: Require TableStart/TableEnd for Detail Regions This setting makes it necessary to use TableStart/TableEnd to access detail data (ReportData or QueryData), which is important because some customers have unintentionally discovered that Conga would generate a separate document for each row of detail data in the absence of a TableStart/TableEnd. Page 12 Advanced Tab Field to Show on Log Activities You may choose a custom Task field to display in the Log Activities portion of Conga. Usually, this is a picklist field that lets users flag the activities. Field Retrieval Restrictions You can restrict the fields available to Conga by enabling this setting. (Not recommended without guidance from Conga.) Conga Composer 7 – Winter '13 Release Page 13 Installation and Administration Guide Recent Activity Tab Activity Reporting You can download a file with the activities of the users from your organization. Select the start and end date and click Run Report. Page 14 User Management Tab Starting in Conga Summer '12, you may manage user licenses either with the older User Management tool, described next, or using the Salesforce Manage License tool (recommended). User Management Tool The User Management tab lets you perform the following user-license activities: Determine whether User Management is enabled for your account View the number of licenses your organization has purchased and how many of those licenses are assigned Page through a list of users Sort the list by name, role and profile Search the user list by name, role and profile Only works with Salesforce instances of 100 or fewer users (of any type). Larger organizations MUST use the Salesforce Manage License tool (see next section.) To enable a license for a user, enable the "Authorized" checkbox for that user. Manage Licenses in Salesforce (recommended) User Management may now be performed with the "Manage Licenses" tool in Salesforce setup (Setup | Installed Packages | Manage Licenses). This standardizes how users licenses are managed with other AppExchange products and gives greater flexibility for large organizations. You can learn more about this feature in our knowledge base; or, if you have questions, please contact Conga support or your Conga Business Analyst. Conga Composer 7 – Winter '13 Release Page 15 Installation and Administration Guide Integration Partners Tab The Integration Partners tab lets you configure the integration with SendGrid. 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. Page 16 Integration with SpringCM™ 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. Easily add, share, and manage content directly from any two standard or custom Salesforce objects. Find and edit content folders, search and edit your documents in Microsoft Office. Effortlessly share content with iPad, shared folders, email links, and external review via email. The Conga Composer integration with SpringCM is not designed to retrieve or merge data from SpringCM into templates and output files. It provides the ability to distribute final merged output files to SpringCM from within Salesforce. SpringCM is available separately on the Salesforce AppExchange®. You must subscribe to that service to take advantage of this integration. Note: The integration with SpringCM has not yet been implemented for Conga Workflow or Conga Conductor. Note: As part of the SpringCM configuration, we recommend you enable “allow duplicate file name” and “allow duplicate folder names” in the SpringCM Administration website. Conga Composer 7 – Winter '13 Release Page 17 Installation and Administration Guide SpringCM Parameters PARAMETER DESCRIPTION &SCMVisble=[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. Page 18 Preparing to use Conga in a Sandbox You can configure your instance of Salesforce so that if you later generate a Sandbox from the production instance, Conga will automatically transfer your license information to the Sandbox. Here’s how: 1. Ensure that you’ve installed the latest version of the Conga managed package from the AppExchange 2. In your Production instance, copy your Salesforce Organization Id to the clipboard. Setup | Company Profile | Company Information. 3. Click Setup | Develop | Custom Settings 4. Click Manage for Conga Composer 5. If necessary, click New to create a new record, otherwise Edit 6. For the Name field, enter Conga Settings 7. For the Production Org Id field, paste the Organization Id you copied in Step 2. 8. Save the record With this established, when a new Sandbox is generated, it will carry with it the Id of your Production instance. Finally, the first time you click a Conga button from within the Sandbox, Conga will “see” that the Sandbox is linked to another instance and automatically transfer account subscription dates and template manager settings. User permissions are not transferred; Conga user restrictions are not enforced in Sandbox instances. Printing Labels using a Label Printer You can print to many popular label printers including the Brother QL-500 and Dymo LabelWriter 400 single-label printers. Most major label printer manufacturers include printer drivers in their solutions and work well with Microsoft Word. Following their guidance, you can quickly create a Word template to accommodate your label printer. Using Conga Composer or Conga Mail Merge, you can merge to that template and print from within Word. Conga Composer 7 – Winter '13 Release Page 19