home

Advantage Platform Administration

Adobe Sign ServicesAdvantage Platform AdministrationApprovals for Advantage PlatformApprovals for SalesforceBilling for Advantage PlatformBilling for SalesforceCLM for Advantage PlatformCLM for SalesforceContracts for SalesforceCollaborateComposer for Advantage PlatformComposer for SalesforceContractsConga for Google DocsConga Upgrade ProgramContract Intelligence (Standalone)Conga CopilotCPQ for Advantage PlatformCPQ for SalesforceDeal MaximizerDigital Commerce for Advantage PlatformDigital Commerce for SalesforceDiscovery AI for Advantage PlatformDiscovery AI for SalesforceDocusign ServiceseSignature Integration with Advantage PlatformGridInvoice GenerationMix FormsOrchestrateOrder Management for Advantage PlatformOrder Management for SalesforcePartner Commerce for Advantage PlatformPartner Commerce for SalesforceQuote GenerationSign for Advantage PlatformSign for SalesforceSmart SearchTest AuthorTurboEnginesX-Author for Contracts 1.0 (Classic)X-Author for ContractsX-Author for Contracts Advanced for Advantage PlatformX-Author for Contracts Advanced for SalesforceX-Author for ExcelX-Author for Migration Manager for Advantage PlatformX-Author for Migration ManagerRelease NotesGeneral
Adobe Sign ServicesAdvantage Platform AdministrationApprovals for Advantage PlatformApprovals for SalesforceBilling for Advantage PlatformBilling for SalesforceCLM for Advantage PlatformCLM for SalesforceContracts for SalesforceCollaborateComposer for Advantage PlatformComposer for SalesforceContractsConga for Google DocsConga Upgrade ProgramContract Intelligence (Standalone)Conga CopilotCPQ for Advantage PlatformCPQ for SalesforceDeal MaximizerDigital Commerce for Advantage PlatformDigital Commerce for SalesforceDiscovery AI for Advantage PlatformDiscovery AI for SalesforceDocusign ServiceseSignature Integration with Advantage PlatformGridInvoice GenerationMix FormsOrchestrateOrder Management for Advantage PlatformOrder Management for SalesforcePartner Commerce for Advantage PlatformPartner Commerce for SalesforceQuote GenerationSign for Advantage PlatformSign for SalesforceSmart SearchTest AuthorTurboEnginesX-Author for Contracts 1.0 (Classic)X-Author for ContractsX-Author for Contracts Advanced for Advantage PlatformX-Author for Contracts Advanced for SalesforceX-Author for ExcelX-Author for Migration Manager for Advantage PlatformX-Author for Migration ManagerRelease NotesGeneral

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 Contents

Show Page Sections

Advantage Platform Administration

Data Sync

Object Mappings

Object Mapping is a process of defining the relationship between objects and entities in the Conga Advantage Platform. The Object Mapping feature enables you to establish a correlation between the properties of objects and data structures.

The initial list of objects to be synced is gathered from the tenant profile and displayed on the Object Mappings page. When you need to add new objects or fields to the sync or update the existing data structure, you can do so from the Data Sync UI on the Conga Advantage Platform. When adding new objects or managing existing objects, you can also select which fields to include or exclude from the sync operation.

You can not only map target fields to source fields but also transform target field values to match the format the Conga Advantage Platform can handle if they are written differently or in an incompatible format.

Note:

  • You must set up your data synchronization infrastructure before object mapping. For more details on configuring data sync infrastructure, see Data Sync Configuration.

  • Out-of-the-box (OOTB) objects and fields are automatically mapped during customer onboarding. However, the currency field is not mapped by default. If your organization uses multiple currencies, you must manually map the currency field for the relevant objects before initiating data sync.

Creating Object Mapping

This task guides you through the process of creating object mappings within the Advantage Platform. Object mappings are essential for synchronizing data between different systems, ensuring data consistency and integrity.

Before you begin, ensure you have administrative access to the Advantage Platform and are familiar with the data sync processes. Understanding the source and target systems, as well as the specific fields and criteria for mapping, is crucial for successful object mapping.

  1. Log in to the Conga Advantage Platform as an admin user.
  2. Click the App Launcher () icon from the top-left corner, then Admin Console > Data Sync.
    This raises the Mapped Objects for Data Sync page.
  3. Click Create Object Mapping.
    A Create Object Mapping page appears.
  4. Enter values in the following fields:

    Field

    Description

    Source Object Name

    Enter the source object name.

    Target Object Name

    Enter the name of the target object that you want to map to the source object.

    Sequence

    Enter the sequence to indicate how important an object is. When syncing data, the system considers this number to decide which objects should be synced first.

    Sync API Path

    Enter the relative API path to invoke the custom API during data sync.

    Source Filter Criteria

    Enter a query condition based on the source system to define the criteria for filtering records for synchronization.

    • For forward sync from Salesforce to the Platform: Use Salesforce Object Query Language (SOQL) to define a query condition.

      EmailTemplate Object ETL sync: 

      "EmailTemplate.FolderId IN (SELECT Id FROM Folder WHERE AccessType = 'Public') AND ( TemplateType = 'text' OR TemplateType = 'html')"
    • For reverse sync from the Platform to Salesforce: Use platform expression format (formula syntax) to define a query condition.

      Conditional status evaluation for Syncing Data to Salesforce:

      (ProductConfiguration.OldValue.BusinessObjectId == null AND ProductConfiguration.BusinessObjectId != null) OR (ProductConfiguration.OldValue.Status != \"Finalized\" AND ProductConfiguration.Status == \"Finalized\")

      In the above example, OldValue represents the previous value of a record. To compare the previous value, use {ObjectName}.OldValue.FieldName.

    Category

    Select the application to which the object belongs, such as CLM, CRM, CPQ, etc.

    Sync Direction

    Select the direction of sync from the dropdown list:

    • Forward: Near Realtime from Salesforce to Conga Advantage Platform
    • Reverse: Near Realtime from Conga Advantage Platform to Salesforce
    • ETL: Extract, Transform, and Load through Data Sync.
    Note:

    Forward Sync: Forward sync, whether full or incremental, does not update null values for any column from Salesforce to the Conga Advantage Platform. Additionally, it does not synchronize objects with complex designs that require custom logic for data transfer to the RLC.

    Reverse Sync: To include system audit fields (CreatedDate, CreatedBy, UpdatedDate, and UpdatedBy) in the reverse data sync from Conga Advantage Platform to Salesforce, you need to:

    Custom Query

    Enter the query, including fields and criteria-based filters, to retrieve specific records. It is useful for the Postgres system as a source.

    Source Type

    Select the type of source system a data sync establishes a connection with. It supports Salesforce and Postgres at the moment.

    Skip Delete Sync?

    Enable this toggle to skip the synchronization of deleted records from the source object to the target object. By default, this feature is turned off. For an incremental sync, if a record gets deleted in the source object, the corresponding record must be removed from the target object.

    Is Protected

    Enable this toggle to prevent any modifications to the object and mark it as an OOTB schema object mapping.

    Is Enabled?

    Enable this toggle if you want the system to consider the object when syncing data.

    Note:

    This applies to manual data sync. In the case of scheduled data sync, it considers the specific objects you have chosen when creating a sync schedule. For more details on scheduling data sync, see Scheduling Data Sync.

    Is Document Sync Required?

    Enable this toggle to sync the documents. This is for the CLM application documents and Proposal object documents.

    Is Translation Object

    Enable this toggle to sync translation data of multiple languages used on the source platform. For more information, see Syncing Translation Data.

    Is Complex Array Type?

    Enable this toggle to indicate that an object supports the Complex Array type. Once enabled, you must specify values for the Complex Array Type Field Name and Complex Array Parent ID Field Name from the platform schema.

    This is useful for the Approvals use cases.

  5. Click Save
  6. Map the source objects' fields to the target objects' fields.
    1. Click the required object mapping from the list, then click Create Field Mapping, raising the Field Mappings page.
    2. Enter values in the following fields.

      Field

      Description

      Source Field Name

      Enter the keyword to search and select the source field name.

      Source Field Type

      This field's value is automatically filled based on the selected source field name, but you can edit it if needed.

      Target Field Name

      Enter the keyword to search and select the target field name that you want to map to the source field.

      Target Field Type

      This field's value is automatically filled based on the selected target field name, but you can edit it if needed.

      Target Lookup Object Name

      Enter the name of the lookup object if the target field is lookup.

      Rule Name

      Search and select the rule name used to execute the specific transformation name that is needed as part of data sync while bringing data from the source to the destination system.

      Is Image Field

      Enable this toggle to indicate that a field is intended to store the image information in URL format.

      Is ID Column

      Enable this toggle to mark a field as the Primary ID field for the associated object. This is useful for the Conga Contract use cases.

      Is Primary Name Field

      Enable this toggle to mark a field as the Primary Name Field for the associated object. This is useful for the Conga Contract use cases.

      Is Reverse Sync Enabled

      Enable this toggle to indicate that a field is a part of transaction data that needs to be synced from the platform to an external system.

      Note:

      Do not enable this toggle for formula fields, as Reverse Sync does not support them. This is by design, as SFDC does not support inserting or updating formula fields.

      Is Enabled?

      Enable this toggle if you want the system to consider the field when syncing data.

    3. Click Save, creating a new field mapping for the object.
      Note:

      You might encounter field data that are written differently or in a format that doesn't match what the Conga Advantage Platform can work with. In that case, you can convert source field data into a format that matches the requirements of the Conga Advantage Platform. For more information, see Transforming Field Values.

    A new object mapping is created.

Editing Object Mapping

  1. Log in to the Conga Advantage Platform as an admin user.
  2. Click the App Launcher () icon from the top-left corner, then Admin Console > Data Sync. The Mapped Objects for Data Sync page appears with a list of objects.
  3. Click the More () icon next to the object.
  4. Click Edit.
  5. Edit the fields as required and click Save.

Similarly, you can edit field mapping.

Note:

You can only modify synced object mappings.

Deleting Object Mapping

  1. Log in to the Conga Advantage Platform as an admin user.
  2. Click the App Launcher () icon from the top-left corner > Admin Console > Data Sync. The Mapped Objects for Data Sync page appears with a list of objects.
  3. Click the More () icon next to the object.
  4. Click Delete.

Similarly, you can delete field mapping.

Note:

You can not delete if the object mapping is not synchronized and marked as Is Protected.

Administrator Guide
Conga Advantage Platform Administration

September 8, 2025