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

Data Extraction Mappings

Accessing Default Data Extraction Mappings

To help you learn and configure Discovery AI custom flows faster, Discovery AI includes default data extraction mappings in the base package.

Discovery AI provides pre-configured data mappings to help administrators learn how to configure custom provision models by example.
  1. From Conga Start, click Admin Console > Discovery AI > Admin Dashboard.
  2. Click Data Extraction Setup in the left navigation bar.
    This raises the Data Extraction Setup page.
  3. Clicking the hypertext names of any of the mappings exposes pre-configured fields and clauses. Study these to discern the structure of well-formed data extraction mappings.
You can study, clone, modify, or even delete these default mappings. Consider cloning any especially useful ones and modifying them as you need.

Setting Up a New Data Extraction Mapping

You have selected the provisions you will extract from the Provision Library or you have created custom provision models for extraction.
Note:

If your organization uses custom provision models and has enabled X-Author on Salesforce, a data sync containing standard provisions and seed data (ID: 10ce17c4-ee2e-4351-8d1a-27c4e9e7877a) is already present for onboarding. In such cases, make sure the custom provision models are correctly mapped and included above the data sync configuration.

  1. Click the Data Extraction Setup tab in the left navigation bar to raise the Data Extraction Setup window.
  2. Click the New button.
    This raises the New Document Extraction Mapping pop-up.
  3. Give the new mapping a name, enter a brief description, and choose a record type from the Choose database record pull-down menu.
    The database record value corresponds to a particular contract or document type (such as MSA or SOW) to be imported by Discovery AI. For example, in a CLM deployment, this shows agreement records.
    CAUTION:

    Once a data extraction setup is created, you cannot modify the Database Record field to change from one record type to another, nor is the clone feature available. A mapping error may result in a complete rework with a new data extraction setup.

    In the Conga platform, database records, also called record types, are used to categorize contracts by type and to define which fields, clauses, and extraction logic to apply. Because each contract type has unique clauses and data fields, mapping each extraction to one record type ensures that extractions are performed based on the contract type selected.

    You can create only one data extraction setup for each database record type. To support different extractions of the same database record type (for example, "NDA-America" vs. "NDA-EMEA"), use multiple worksheets under the same data extraction mapping.
    CAUTION:

    Do not map a provision model to more than one field or clause. If a reviewer modifies a provision model mapped to multiple fields or clauses, there will be conflicts that affect the provision model's performance.

  4. Select review levels in the Choose review level pull-down menu.
    • To deactivate the requirement to review, select 0: Skip Review. Document review will be skipped and no contract summary will be generated or saved to CLM.
      Note:

      When a skipped document is successfully extracted, the Reviewed By field remains blank and the file is assigned a Completed status. If any field's extracted value cannot be normalized to match its data type, the file is assigned a Ready for Review status and must be reviewed. On review, the document's Reviewed By field is populated by the user name of the document's reviewer.

    • To use a single-stage review process, select 1: One level - Review and Complete from the Review Level pull-down menu. You must then select a reviewer from the resulting Reviewer pull-down.
    • For a more formal process, select 2: Two levels - Review and Approve from the Review Level pull-down menu. You must then select a reviewer from the Reviewer pull-down menu and an approver from the Approvers menu.
  5. To let users to check out batches of documents for review, slide the Allow reviewers to get next batch toggle on and then set the batch size. This enables users to check out a block of records of the designated number with a single "get batch" action. Users cannot request a new batch until they review or reassign all documents currently assigned to them.
  6. Under Import Options, select extraction options to make available to your users. These are:
    • OCR to import the document as searchable text
    • Automated Extraction to submit the document for AI-only extraction, or
    • Verified Extraction to submit the document for AI extraction with attorney review.
    These choices are not mutually exclusive.
  7. Depending on whether this is a purchase or vendor agreement, set the Organization Role? toggle to either Buyer or Seller.
    This setting contextualizes the generative AI prompt for Insights. Depending on this setting, the customer or user is presented to the AI engine as a buyer or seller. The default position is Seller.
  8. If you want reviewers to be able to extend the worksheet with additional detected provisions as described in Adding Unmapped Fields and Clauses, slide the Allow Worksheet Extension toggle on.
    Note: Adding an unmapped value links the identified passage to the appropriate provision map, associating it with the corresponding fields, clauses, or values defined in the CLM schema. Future document imports will recognize and extract these new provisions, but this update does not retroactively apply to previously imported documents.
  9. Click SAVE.
You are returned to the Data Extraction Setup window. The mapping you just created is listed.
You must populate the new mapping, defining its basic details and organizing provision models into worksheets, as described in Editing a Data Extraction Mapping.

Editing a Data Extraction Mapping

You have created at least one data extraction mapping as described in Setting Up a New Data Extraction Mapping.
  1. Click the Data Extraction Setup tab in the left navigation bar to raise the Data Extraction Setup window.
  2. Click the hypertext name of the map that you will edit in the Name column.
    This raises the worksheet mapping window.
  3. Click the WORKSHEETS tab.
  4. Select the worksheet you will edit from the Choose Worksheet pull-down menu.
  5. Select the Fields, Clauses, Tables, Insights, or Obligations tab, then click MANAGE PROVISIONS or NEW to raise the corresponding mapping pop-up.
    • For fields, click MANAGE PROVISIONS and continue to the next step.
    • For clauses, an Automatic Clause Comparison toggle appears. Activating this enables automatic clause comparison for all documents during import as described in Reviewing Imported Clauses and Fields. If this is turned off, the reviewer does not see the comparison summary, but it remains available on reviewer request. Click MANAGE PROVISIONS and skip to step 10.
    • For obligations, click NEW and skip to step 7.
    • For tables, a Default Orientation pull-down appears. Configure the anticipated table orientation as described in Horizontal and Vertical Tables. Click NEW and skip to step 8.
    • For insights, click NEW and follow the process described in Insights Setup.
  6. Click Select Field(s) to Map in the Map Fields window.
    1. Select one or more fields by clicking the adjacent check box in the Select Field(s) to Map pop-up.
    2. For each field you select, choose whether it is to be automatically or manually extracted.
      If the extraction is manual, no further configuration is required for this field: It will not be extracted automatically, and the reviewer will be responsible for selecting the text.
      CAUTION:

      Selecting Manual Extraction resets any automatic extraction configurations entered.

    3. Indicate each required field by checking the Make this Required Field check box.
    4. Some field types offer a Permit New Record Addition option. Check this box to enable reviewers to add new records. If you pick this, you must add the types of records a reviewer can add.
    5. Click Add/Edit Provision Mapping to select the provision model or models to associate with the field you are defining.
      Tip:

      If you choose multiple similar provision models, your mapping will be more likely to find a field, but also more likely to find an incorrect one. Your reviewers must assign the result to one provision model or another, so a more selective approach is usually indicated.

    6. Click DONE. You are returned to the WORKSHEETS tab view.
  7. Click Select Clause(s) to Map or Create a Clause to Map.
    You will add clauses to your mapping either by selecting existing ones or by creating your own.
    1. If you choose to select clauses, choose the pertinent clause from the Add Clauses from Library pop-up. If you elect to create a clause to map, you are taken directly to the Map Clauses window to configure your clause mapping.
    2. If you are creating a clause, you must name it. If you have selected one, it already has a name, which you cannot edit.
    3. For each clause you select or create, choose whether it is to be automatically or manually extracted.
      If the review is manual, no further configuration is required for this clause: It will not be extracted automatically, and the reviewer will be responsible for selecting the text.
      CAUTION: Selecting Manual Extraction resets any automatic extraction configurations entered.
    4. Indicate each required clause by checking the Make this Required Field check box.
    5. Click the Extract Complete Paragraph check box to extract the provision's full context when it is detected.
    6. Click Add/Edit Provision Mapping to select the provision model or models to associate with the clause you are defining.
      Tip: If you choose multiple similar provision models, your mapping will be more likely to find a clause, but also more likely to find an incorrect one. Your reviewers must assign the result to one provision model or another, so a more selective approach is usually indicated.
    7. Click DONE. You are returned to the WORKSHEETS tab view.
  8. For obligation extractions, clicking the Obligations tab raises a grid view of existing obligations. Click the obligation you will edit, then the More icon (), then select Edit to raise the obligation edit pop-up.
    You can choose either Auto-Extraction or Manual Extraction.
    Note:
    • Obligations are fully defined in CLM. This setting controls the one feature that Discovery AI introduces. For more on configuring obligation objects from CLM, see Obligation Management in the CLM user guide, which contains sections on Creating an Obligation and Obligation Fulfillment.
    • You can configure at most ten obligations in one mapping.
    • You can introduce at most five fields per obligation.

  9. Select the table provision and choose either the automatic or manual extraction method. Click SAVE to commit the table provision to the mapping.
    Selecting Manual Extraction ends the configuration. Reviewers must extract the table manually, and no further configuration is possible.
    Note: You can only map one CLM object per table mapping. You cannot map two tables with a common agreement line item in one mapping.You can configure at most ten tables in one mapping. You can configure at most ten columns per table.
  10. Click DONE to save the mapping.

Deleting a Data Extraction Mapping

From the Data Extraction Setup window, either click the trash can button next to any single mapping or click the checkbox next to one or multiple rows and click the DELETE button.

Cloning a Worksheet in a Data Extraction Mapping

  1. Click the Data Extraction Setup tab in the left navigation bar to raise the Data Extraction Setup window.
  2. Click the name of the map with the worksheet you want to clone.
  3. Click the Worksheets tab.
  4. Select the worksheet you want to clone from the Choose Worksheet drop-down menu.
  5. Click WORKSHEET ACTIONS > Clone.
  6. Enter a name for the worksheet, select the target record type, and check the component you want to clone.
    You can clone any or all of the clause, table, field, insight, and obligation components.
  7. Click SAVE.

The cloned worksheet appears in the destination record type.