DS7

A parameter that enables merge operations to occur in the background.

Category: Automation-Background Mode Parameter

Compatible with: Composer 8 and Composer 7

Parameter Name: DS7

Parameter Value: [value]

Parameter Requirements: None

Parameter Description: DS7 enables Background Mode, which initiates Conga Composer without user intervention. This parameter enables merge operations to occur in the background.

Value Definition
0 Background Mode disabled. (Default)
1 Background Mode is enabled and the merged document is attached to the master object.
2 Background Mode is enabled and the merged document is attached to a Salesforce email.

If you use this parameter and want to log activities or follow-up tasks, you must also enable Automatic Logging (AC0=1).

3 Background Mode is enabled and the merged document is delivered to browser to save or open.

If you use this parameter and want to log activities or follow-up tasks, you must also enable Automatic Logging (AC0=1).

4 Background Mode is enabled and the merged document is attached to a new Adobe eSign Agreement. (See Adobe eSign integration parameters)

If you use this parameter and want to log activities or follow-up tasks, you must also enable Automatic Logging (AC0=1).

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.
6 Background Mode is enabled and the merged document is attached to Salesforce Content.
7 Background Mode is enabled and the merged document is attached to a DocuSign Envelope.

If you use the DS7=7 parameter in a DocuSign-integrated Composer button, the routing order defined by DocuSignR1ID parameter appears out of order on the DocuSign envelope and custom anchor tags are not assigned to the correct recipients. This is a result of a DocuSign API limitation. To resolve the incorrect ordering on the DocuSign envelope, drag the first row slightly upward using the dotted area. This issue does not occur when DS7=17 is used to bypass the DocuSign user interface.

8 Background Mode is enabled and the merged document is saved in a SpringCM folder.
9 Background Mode is enabled and the merged document (Microsoft Office Word, Excel, or PowerPoint) is saved to Google Drive.
11 Background Mode is enabled and the merged document is attached to Salesforce Files for the Master Object.
12

Background Mode is enabled and the merged document is automatically delivered through email.

Using DS7=12 with a Conga Email Template requires the CongaEmailTemplateID (CETID) parameter and at least one of the following the email recipient parameters: EmailToID, EmaillAdditionalTo, EmailCC. Using DS7=12 with a Salesforce Email Template requires the EmailTemplateIdparameter and the EmailToId parameter.

No preview is available for this parameter. Please test your configuration thoroughly before using.

13 The parameter runs a merge in background mode, delivers the merged output to the user's browser, then returns the user to the Salesforce master record that initiated the merge.
Warning: This behavior is subject to browser restrictions and may not work consistently. After updating to Chrome Version 74.0.3729.108, users using a non-Oauth button URL are no longer prompted to download the merged document. The recommended workaround is to convert your button URL to an Oauth button to continue using &DS7=13. Alternatively, you can switch to using &DS7=3.
14 Background Mode is enabled and the merged document is automatically delivered through Adobe eSign.

No preview is available for this parameter. Please test your configuration thoroughly before using.

17 Background Mode is enabled and the merged document is attached to a DocuSign Envelope and automatically delivered.

When using Conga products and DocuSign in a fully automated fashion (such as using the background parameter/value pair &DS7=17, Conga Trigger, or Conga Batch) the DocuSign Username and Salesforce User Email must match. If not, you receive the error: Error: CreateEnvelope in DocuSignAPI. The UserID does not have a valid membership in this Account.

No preview is available for this parameter. Please test your configuration thoroughly before using.

DocuSignTag=1 does not work with DS7=17 for automatic delivery.

Prerequisites for using DS7=17

  • DocuSignEndPoint=Prod (or Demo)
  • DocuSignR1ID
  • DocuSignR1Role
  • DocuSignR1Type
  • DocuSign Credentials on the USER record
  • Same email address in Salesforce as in DocuSign
19 Background Mode is enabled and the merged document (Google Docs version) is saved to Google Drive.
24 Background Mode is enabled and the merged document is automatically delivered through Adobe eSign. The browser is redirected to the Adobe eSign Confirmation Page. (Requires Adobe eSign version 9.5 or higher.)

No preview is available for this parameter. Please test your configuration thoroughly before using.

111
Important: Specific value that integrates Composer and Contracts features.

Background mode is enabled and a Composer generated document is sent directly to Send for Negotiation email service in Contracts. The template is merged. The user is redirected to the email preview screen. The user can edit or verify the information before sending the negotiation email. A copy of the document is attached to the record as a Salesforce File.

112
Important: Specific value that integrates Composer and Contracts features.

Background mode is enabled and merges the template. The email is sent automatically without any additional user interaction. A copy of the document is attached to the record as a Salesforce File.

Using DS7=112 requires the congaemailtemplateid and EmailToId parameters.

301 Background Mode is enabled and the merged document is automatically delivered through Sertifi. The browser is redirected to the Sertifi Econtract. (Requires Sertifi version 5.87 or higher.)

No preview is available for this parameter. Please test your configuration thoroughly before using.

302 Background Mode is enabled and the merged document is automatically delivered via Sertifi. The browser is redirected to the Master Object. (Requires Sertifi version 5.87 or higher.)

No preview is available for this parameter. Please test your configuration thoroughly before using.

401 Background Mode is enabled and the merged document is attached to Chatter.
501 Background Mode is enabled and the merged document is automatically sent to eSignLive.
600 Background Mode is enabled and the merged document is automatically sent to Box.
700 Background Mode is enabled and the merged document is automatically sent to OneDrive.
900 Background mode is enabled and the merged document is automatically sent to BigTinCan.
1141 Background mode is enabled and the merged document is forwarded to Conga Sign at end of the merge, and a copy is saved under Salesforce Files.
1142 Background mode is enabled and merged document is sent to the Conga Sign API, and a copy is saved under Salesforce Files.
Note: This parameter value requires the &CSRecipient parameter.

Example:

&DS7=1