Conga Product Documentation

Welcome to the new doc site. Some of your old bookmarks will no longer work. Please use the search bar to find your desired topic.

Show Page Sections

Admin Settings for X-Author for Contracts on the Conga Platform

In order for certain X-Author for Contracts on the Conga Platform features to be enabled, you need to run specific APIs. The following sections explain the different API endpoints that need to be executed for some selected features.

User Action Permissions

The following user action permissions allow you to view and access certain X-Author Contracts on the Conga Platform features for a specific user profile. Execute the following API to update the required user action permission.

API Details:

Method

URL

PUT

https://<RLP Base URL>/api/user-management/v1/objectpermissions/{objectPermissionId}

Pass the following parameters to allow access to the required feature. Please note that the following action permissions have to be passed on the Contract Object.

URL Parameter

Parameter Name

Description

Value

Object permission ID

This is a URL parameter. Enter the object permission ID on which you can enable the following action permissions. This must be the Contract Object permission ID.

Enter the Object permission ID

Request Body Parameter

Parameter Name

Description

Default Value

Id

This is a request body parameter. This refers to the Contract Object permission ID that was passed in the URL.

Contract Object permission ID

ObjectName

This is a request body parameter. This refers to the name of the object which is Contract.

Contract

PermissionGroupName

This is a request body parameter. This refers to the name of the permission group name.

ModifyAllPermissionGroup

Pass the following field values on the Action Permission parameter.

Action permission

Description

Default value

SHOW_CONTRACTS_MENU

Set this action permission to True to allows users to view the Contracts tab in X-Author Contracts on the Conga Platform.

True

SHOW_TEMPLATES_MENU

Set this action permission to True to allows users to view the Templates tab in X-Author Contracts on the Conga Platform.

Warning:

This must be set on the Templates object.

True

ALLOW_CHECKIN_AS_FINAL

Set this action permission to True to allows users to view the following save options on the Check-in document page:

  • With Redlines
  • Without Redlines
  • Final - to be signed

True

ALLOW_CHECKIN_WITHOUT_REDLINES

Set this action permission to True to allows users to view the following save options on the Check-in document page:

  • Update Current Version
  • With Redlines
  • Without Redlines

True

ALLOW_CHECKIN_WITH_REDLINES

Set this action permission to True to allows users to view the following save options on the Check-in document page:

  • Update Current Version
  • With Redlines

True

ALLOW_UNPROTECT_DOCUMENT

Set this action permission to True provides full access to all the documents irrespective of protection type enforced at the document level.

True

HIDE_CHECKOUT_MENU

Set this action permission to True to hide the Open and Open and Update option from the users.

False

DISABLE_AUTO_CHECKOUT

Set this action permission to True to disables the auto check out option for the user when they perform the following actions:

  • Create and check in offline document
  • check in contract document
  • check in template
  • Send document for review
  • Compare and merge document
  • Regenerate/regenerate with redlines

False

Connect to CRM

You can connect X-Author for Contracts Advanced to a Salesforce or Conga Platform Org based using the X-Author Connect to CRM feature. X-Author for Contracts Advanced for Salesforce customers only have access to this feature if they have purchased an additional AI package and have been provisioned with Conga for Advantage Platform Admin access.
Note: After performing this action, you must login to the application again.
  1. In the Conga Advantage Platform Admin Console, click the Switch Apps icon in the upper left and click Contract Apps.
  2. Click the CLM Admin icon on the left menu.
  3. Under CLM ADMIN SETUP, click X-Author Configuration Settings.
  4. Under X-Author Connect to CRM, select either Advantage Platform or Salesforce from the dropdown menu.
    OptionDescription
    Advantage PlatformWhen you select this option, you connect X-Author for Contracts Advanced to the Conga Advantage Platform. Your data in the Conga Advantage Platform is synced into your X-Author for Contracts Advanced application. Additionally, here you can enable or disable features like Auto Enable PDF for Final Docs.
    SalesforceWhen you select this option, you connect X-Author for Contracts Advanced to your Salesforce Org. Your data in your Salesforce Org is synced into your X-Author for Contracts Advanced application.
  5. Click Save.
  • To view which platform you are currently synced to within the X-Author for Contracts Advanced application, navigate to Menu > App Details Under Connected to CRM, you will see either Advantage Platform or Salesforce.

  • If auto-provisioning is enabled and a non-onboarded user has Configuration permission, the system will connect to either Salesforce or Conga Advantage Platform based on the selected Connect to CRM option. If a user does not have Configuration permission, the system will always connect to Salesforce. If auto-provisioning is disabled, non-onboarded users will be unable to log in.

Custom permissions specific to X-Author for Contracts on the Conga Platform

Custom permissions are used to control the System Properties pertaining to a contract. Execute the following API to enable the required custom permissions.

API Details:

Method

URL

PUT

https://<RLP Base URL>/api/config-management/v1/configurations

Pass the following parameters in the request body enable the required custom permission.

Request Body Parameter

Parameter Name

Description

Default Value

Category

This is a request body parameter. This refers to the category on which the system properties are being set. Since, these are custom permissions specific to X-Author, you need to enter category as X-Author.

XAuthor

Name

This is a request body parameter. This refers to the name of the property.

SystemProperties

Pass the following field values on the Value parameter.

System Property

Description

Default value

AutoEnablePDFForFinalDocs

Set this parameter to True to make sure the Create PDF Attachment checkbox is always selected when you choose to save as Final - to be signed from the check-in dialog. This field is used when you want to finalize a contract document.

False

AllowPDFSelectionOverride

Set this parameter to True to override PDF selection. This is applicable when Auto Enable PDF For Final Docs is selected.

False

AutoEnableReconciliation

Set this parameter to True and the Reconcile Document option is always selected when you go to check-in a contract document.

False

AllowReconcileSelectionOverride

The following applies when you set this parameter to True. This is only applicable when Auto Enable Reconciliation is selected.
  • If Auto Enable Reconciliation is True and Allow Reconciliation Selection Override is True, the Reconcile checkbox is by default selected on check-in. The user can also deselect (override) the Reconcile button.
  • If Auto Enable Reconciliation is True and Allow Reconciliation Selection Override is False, the Reconcile checkbox is by default selected on check-in. The user cannot deselect (override) the Reconcile button.
  • If Auto Enable Reconciliation is False, the user can select or deselect the Reconcile checkbox on check-in. However, the Reconcile checkbox is disabled if there is no smart field in the contract document.

False

AutoEnablePrivateIndicator

Set this parameter to True if you want to auto-enable private indicator for documents. If set to True, the Make this document private checkbox for any contract document is auto-selected.

False

AllowPrivateSelectionOverride

Set this parameter to True if you want allow the user to override the private document selection. This setting is applicable only when the Auto Enable Private Indicator is selected for documents.

False

RestrictCheckinDocuments

Set this parameter to True if you want restrict documents under certain Status Category and Statuses for which Check-in and Check-out actions will be restricted.

False

AllowRegenerate

Set this parameter to True if you want display the Regenerate button on the X-Author toolbar.

False

UnlockSmartElements

Set this parameter to True and the user can delete smart elements from the generated document.

False

AutoEnableAsynchronousCheckin

Set this parameter to True to auto-select the Asynchronous Check-in checkbox available on the X-Author Contracts Check-in pop-up window.

False

AsynchronousCheckinRecipient

Set this parameter to True to enter a recipient role (Contract Owner, Logged in XAC user or Both) to receive Asynchronous Check-in email notification.

False

HideContentControlBorder

Set this parameter to True to hide smart boundaries (for smart fields and clauses) in generated documents.

False

AllowHighlightFields

Set this parameter to True to highlight all the fields inserted in the document.

False

XAAddInLoadType

Select a load type for the X-Author for Contracts add-in.

  • Select Centralized if users install the X-Author for Contracts 2.0 add-in using Centralized Deployment through the Office 365 Admin Center.
  • Select Appsource if users access the X-Author for Contracts 2.0 add-in through the Microsoft Store.

2

Custom permissions specific to CLM for X-Author for Contracts on the Conga Platform

Custom permissions are used to control System Properties, Document Version Settings, and PDF Security settings. Execute the following API to enable the custom permissions. For more information, also see CLM Admin Setup.

API Details:

Method

URL

PUT

https://<RLP Base URL>/configurations/Clm/SystemProperties

Pass the following parameters in the request body enable the required custom permissions.

Request Body Parameter

Parameter Name

Description

Default Value

Category

This is a request body parameter. This refers to the category on which the system properties are being set. Since, these are custom permissions specific to CLM, you need to enter category as CLM.

Clm

Name

This is a request body parameter. This refers to the name of the property.

SystemProperties

Pass the following field values on the Value parameter.

System Property

Description

Default value

DocumentNamingConvention

Specify a value to apply a custom naming convention for all contract documents at generation, check-in and signature events.

The following attributes permitted when formulating a document naming convention are:

  • %checkintype%
  • %action%
  • %templatename%
  • %user%
  • %timestamp%
  • %version%

Contract attributes such as %:Name%. Note: any variable prefixed by ':' represents a field on the Contract object.

If the property contains a null value (i.e., if left blank), the current default naming convention will be used: %:Name%_%action%_%templatename%_%timestamp%

Example contract document name using the default naming convention: SOW_Regenerated_SOW ABC_2015-08-07

%:Name%_%action%_%templatename%_%timestamp%

Document Password

Specify a document password.

NA - If the value is not configured then it should error out.

PDF Security Settings

Description

Default value

PDFSecurityEnabled

Set this to True to enable PDF security that lets the users apply security settings to PDF documents and protect them with a password.

False

AllowPrinting

Set this to True to allow the users to print the PDF.

True

AllowCopying

Set this to True to allow the users to copy the PDF.

False

AllowCommenting

Set this to True to give permission for the users to comment in the PDF.

False

AllowFormFilling

Set this to True to allow the users to fill forms using the PDF.

False

AllowAssembling

Set this to True to allow the users to assemble the PDF.

False

AllowChangingContent

Set this to True to give permission to the users to modify content in the PDF.

False

Document Version Settings

Description

Default value

InitialVersion

Specify the initial version number of a newly generated or uploaded document. If you want the document versioning to start from 0.0.0, specify 0 and if you want to start the document versioning to start from 1.0.0, specify 1.

1.0

IncrementCheckinWithRedlines

Specify the document version increment factor when the document is checked in using the option With Redlines from X-Author Contracts for Microsoft Word. Specify Major if you want to increment the major version number of the document and specify Minor if you want to increment the minor version number of the document.

Minor

IncrementCheckinWithoutRedlines

Specify the document version increment factor when the document is checked in using the option Without Redlines from X-Author Contracts for Microsoft Word. Specify Major if you want to increment the major version number of the document and specify Minor if you want to increment the minor version number of the document.

Major

IncrementCheckinFinal

Specify the document version increment factor when the document is checked in as Final- to be signed from X-Author Contracts for Microsoft Word. Specify Major if you want to increment the major version number of the document and specify Minor if you want to increment the minor version number of the document.

Major

DocumentRegenerate

Specify the document version increment factor when the document is regenerated with the same template as of the original contract, from Contract Management. Specify Major if you want to increment the major version of the document and specify Minor if you want to increment the minor version of the document

Major