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

download

Inserting Clauses as Bookmarks (FX2)

When managing a contract, there is often legal language that may be required to exist in the agreement document in multiple locations. Using the standard workflow when designing an agreement template, the Template Administrator inserts clauses directly into the template, which are rendered in the agreement document when it is generated. Contract managers and negotiators then open the generated document and insert, modify or delete clauses as needed. The limitation with the standard workflow is that when numerous occurrences of the same clause are needed in a contract, each must be manually added to the template by either the Template Admin or the Contract Manager.

This feature provides Template Administrators with the ability to instead insert bookmarks into the Agreement Template. Each bookmark contains a reference to a single clause in the template library. When the agreement document is generated, clauses inserted as bookmarks are not populated in the agreement document. Instead, when a Contract Manager works with the document, they have the option to automatically insert the content of a clause at every location in the document with the same bookmark using a single click . This provides greater flexibility and less work when multiple occurrences of the same clause are required in a document.

The Clause Bookmark feature requires X-Author Contracts for Word version 8.5.0713 or later and a connected org with Apttus Contract Management package version 8.5.0346 or later installed. Clause bookmarks only work with FX2 format templates and documents.

Configuring Clause Bookmark Functionality

Adding Clause Bookmark functionality to X-Author Contracts requires configuration of the Admin properties described in the following table.

Admin Property

Description

Possible Values

APTS_AllowBookmarkInsertion

Enables the "Insert Clause as Bookmark" check box in Playbook for X-Author Templates.

True/False

APTS_HighlightClauseOnBookmarkInsertion

Automatically highlights all clauses immediately after being inserted from bookmark locations in X-Author Contracts.

True/False

APTS_BookmarkHighlightColor

Defines the color to use when highlighted clauses are inserted as bookmarks after generating the agreement.

Recommended values (specify one): wdBlack, wdBlue, wdBrightGreen, wdDarkBlue, wdDarkRed, wdGreen (default), wdGray25, wdGray50, wdPink, wdRed, wdTeal, wdTurquoise, wdViolet, wdWhite, wdYellow.

To configure Admin Properties

  1. Log in to the connected Salesforce org.
  2. Go to the Admin tab in Apttus Contract Management.
  3. Click New to add a new Admin property.
  4. Enter the Admin Property name into the Name field (e.g., "APTS_AllowBookmarkInsertion").
  5. Enter the property's value into the Value field.
  6. Click Save.
  7. Repeat steps 3 – 6 for each property you want to configure.


    Note:

    Only APTS_AllowBookmarkInsertion is required to enable this feature.

Inserting Clauses as Bookmarks in Agreement Templates

Before Contract Managers can take advantage of the Clause Bookmark feature, Template Administrators must insert clause references as bookmarks in the agreement template.

Note:

Please note at this time the following limitations for clause bookmarks:

  • although you can insert clauses as bookmarks in any template, there is no support for bookmarked nested clauses.
  • clause bookmarks inserted in repeat tables will only appear once in the generated document, appended to the end of the table content.

To insert a clause as a bookmark

  1. Open Microsoft Word and log in to X-Author Contracts.
  2. From the X-Author Templates ribbon, select Playbook.
    The Playbook pane is displayed to the right of the document.


  3. Use the Playbook search dialog to search for one or more clauses you want to insert.
  4. At the top of the Playbook pane, select the check box to Insert Clause as bookmark.
  5. Place your cursor where you want to insert the bookmark into your agreement template.
  6. Click Insert next to the clause you want to insert.
    The following confirmation dialog is displayed.
  7. Repeat Steps 5 – 7 to insert the same clause as a bookmark in other locations or to insert other clauses as bookmarks.
  8. Check-In your agreement template to update the template in Salesforce with the bookmarked clause references.
    Note:

    A Note on Publishing and Bookmarks. When a clause is inserted into a template as bookmark, it is inserting a reference to that clause into the corresponding template. Therefore, if the clause associated with the bookmark is changed, the corresponding template will not need publishing. When working with an agreement document, the most recent version of the clause is always inserted.

Making Bookmarks Visible in the Template Document

After inserting clauses as bookmarks, you may find it easier to confirm insertion of bookmarks by making them visible in the Word document. To make bookmarks visible:

  1. Go to File > Options > Advanced.
  2. Scroll down to the Show Document Content section.
  3. Select the "Show bookmarks" checkbox.


  4. Return to your document and confirm that bookmarks are present.


Updating References

The Update References button lets you update the clause references, table of contents, headers and footers, cross-references, bookmarks, and formulas in tables. To update references in your document:

  1. Go to X-Author Contracts tab in Microsoft Word ribbon.
  2. Click Update References.