---
sourceDocument: Brazil Sales Customer Relationship Management
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/order-management

 Release :

    - brazil

ft:locale :

    - en-US

ft:publication_title :

    - Brazil Sales Customer Relationship Management

ft:clusterId :

    - omgmt

bundleId :

    - omgmt

workflow :

    - Customer and Industry


---

# Integrating CDS or other third-party visualization tools

# Integrating CDS or other third-party visualization tools {#ariaid-title1}

Release version: Brazil  
Updated March 12, 2026  
![](https://www.servicenow.com/docs/portal-asset/ico-clock) 6 minutes to read
Summarize  
![AI sparkle icon](https://servicenow.com/docs/portal-asset/ai-sparkle-icon) Summarized using AI  
This content was generated using new OpenAI-powered functionality. Results are provided on an as is basis and are not guaranteed to be accurate or complete.  

## Summary of Integrating CDS or other third-party visualization tools

This guide explains how ServiceNow CPQ customers can integrate the CDS Visual tool or other third-party visualization tools to enable real-time, interactive technical visualizations such as CAD drawings, 2D images, and 3D models.
The integration enhances user experience by synchronizing configuration inputs in ServiceNow CPQ with visual updates in the external tool.
Show full answer Show less  

## Integration Approach

The integration is configured within the Blueprint layout definition of the ServiceNow CPQ configurator. Administrators define where the CDS visualization renders in the UI by editing and uploading a CSV layout file that includes CDS layout element fields. These fields specify the CDS environment, domain, and the ServiceNow CPQ field data to exchange.

The layout editor allows the addition of a new CDS section and setting properties through a JSON editor for fine-tuning the integration behavior.

## Key Configuration Properties

* **eventFields:** Specifies ServiceNow CPQ fields sent to CDS as an array or key-value pairs for field name mapping.
* **eventSets:** Allows sending sets of data (up to 25 indexes) to CDS, either as arrays or mapped objects.
* **eventProductPickers:** Sends product picker data arrays to CDS with similar mapping options.
* **domain:** The CDS project domain name, required for integration.
* **env:** CDS environment name (defaults to "qa" if omitted).
* **setActiveTriggers:** Defines boolean fields to indicate active indexes in repeated sets, necessary for certain UI container types.
* **height and width:** Controls the size of the visualization window in pixels (default 500x500).

## Data Exchange and Communication Modes

The integration supports two-way communication:

* **One-way:** ServiceNow CPQ updates CDS visualization based on user input.
* **Two-way:** Users can manipulate the CDS visualization, which updates corresponding ServiceNow CPQ fields in real time.

For two-way sync involving sets, ServiceNow CPQ administrators must define event fields to receive set data from CDS. CDS administrators configure these fields as destinations, and ServiceNow CPQ uses determination rules to parse and populate the sets accordingly.

## Practical Benefits for ServiceNow Customers

* Enable dynamic, real-time visual representation of product configurations within ServiceNow CPQ.
* Improve accuracy and user experience by synchronizing visual and configuration data bidirectionally.
* Customize visualization placement and size within the CPQ interface for optimal usability.
* Leverage flexible JSON configuration to map ServiceNow CPQ fields, sets, and product pickers to CDS variables.

## Next Steps

ServiceNow CPQ administrators should:

* Download and edit the layout CSV file to add CDS layout elements.
* Configure the JSON properties for CDS integration based on their environment and data mapping needs.
* Coordinate with CDS administrators to finalize two-way communication setup if needed.
* Use advanced rules in ServiceNow CPQ to parse JSON responses from CDS for further automation.  
Integrate CDS Visual or other third-party tools for technical visualization. Sync configuration inputs with visual updates to enhance user experience.

ServiceNow CPQ can be implemented to share field values with third-party visualization tools so that visualization is updated in real time as the user changes configuration inputs. This article discusses integrating the CDS
Visual tool as an example. Depending on the CDS model setup, the visualization may render as CAD drawings, 2D images and 3D interactive images.

The integration between ServiceNow CPQ and CDS is accomplished in the Blueprint layout definition. The following layout CSV file contains a sample of how the ServiceNow CPQ administrator defines where the CDS visualization will be rendered. It also specifies the CDS environment and ServiceNow CPQ field data to be sent.

[Layout_CDS_in_sidebar \[Google Sheet\]](https://docs.google.com/spreadsheets/d/1UooX9WcinGssN4VpzEzu0pGTq4n_aTQ_Vp2epyI0kSk/edit?usp=sharing)

## Step-by-step guide {#cds_visualization_integration__step-by-step_guide}

This article can help you decide how to add the CDS configuration.

1. Open the layout editor in your ServiceNow CPQ configurator.
2. Download your CSV layout file.
3. Open your CSV layout file, and add the CDS layout element fields (highlighted in detail below).
4. Re-upload your CSV layout file to ServiceNow CPQ. Your CDS layout element should now be present in the layout.
5. Open the configuration options for your CDS layout element and add in the necessary JSON data lines.
{#cds_visualization_integration__ol_aft_rbn_fhc}

## Technical configuration options {#cds_visualization_integration__technical_configuration_options}

The integration between ServiceNow CPQ and CDS is accomplished in the Blueprint layout definition. The following layout CSV file helps demonstrate how the administrator defines where in the UI the CDS visualization will be rendered. It also
specifies the CDS environment and the ServiceNow CPQ field data to be sent.

The layout can be updated directly in the layout editor. In the layout editor, create a new section named CDS in your CSV file using the fields highlighted in red below, and upload the new file to layout.

From here, you can open the settings for this layout element, and configure the following fields using the CDS Properties JSON editor:

![Menu]()

These properties can be configured in this element. The following table provides the name and description for each element.
{#cds_visualization_integration__technical_configuration_options__entry__3}

| Property name | Required | Description |
|-|-|-|
| eventFields | no | Array or object of fields to send to CDS. An array will assume the contained strings are both ServiceNow CPQ variable names, and CDS variable names. An object will have key:value pairs. The Key is the ServiceNow CPQ variable name, and the value is the CDS variable name. Set fields are allowed to be defined here, using the format: `set.{setVariableName}.{fieldVariableName}` |
| eventSets | no | Array or object of sets to send to CDS. An array will assume the contained strings are both ServiceNow CPQ variable names, and CDS variable names. An object will have key:value pairs. The Key is the ServiceNow CPQ variable name, and the value is the CDS variable name. The set will be sent as a whole, up to 25 indexes long: setVariableName: [ { field1: 'value', field2: 'value' } { field1: 'value', field2: 'value' } ] |
| eventProductPickers | no | Sends the entire product picker's data as an array of objects to CDS. An array will assume the contained strings are both ServiceNow CPQ variable names, and CDS variable names. An object will have key:value pairs. The Key is the ServiceNow CPQ variable name, and the value is the CDS variable name. The product picker will be sent as a whole, up to 25 indexes long. Option #1: { "eventProductPickers": [ "productPicker1", "productPicker2" ] } Option #2: { "eventProductPickers": { "logikProductPicker1": "cdsProductPickerName1", "logikProductPicker2": "cdsProductPickerName2"    } } |
| domain | yes | Domain of CDS visualization |
| env | no | Defaults to"qa" if not provided |
| setActiveTriggers | no | An array of variable names corresponding to a boolean field in a set. The listed fields will serve as a trigger for denoting which index of the set is active when being used in a set repeater. These are required if using a Basic Container or Expandable Section as the repeated tier type |
| height | no | Height of the visualization window in px - defaults to 500 |
| width | no | Width of the visualization window in px - defaults to 500 |
[Table 1. Properties of the CDS layout element]

## JSON string formatting {#cds_visualization_integration__json_string_formatting}

The final JSON string formatting should resemble the following:

    {

    "domain": "exampleDomain", "env": "qa"

    "eventFields": ["field1", "field2", "field3"]

    }

## Notes {#cds_visualization_integration__section_fwc_5cn_fhc}

* In the layout definition sample, the CDS rendering will display in a BasicContainer sidebar positioned in the upper right.
  * CDS can pass ServiceNow CPQ a JSON object to a text field.
  * Use advanced rules to parse the JSON responses from CDS.
  {#cds_visualization_integration__ul_ozk_xcn_fhc}
* The JSON provided in the 'value' column (column I) of the CDS element row contains the following syntax:

      {
      "eventFields": [ "FIELD1",
      "FIELD2", "FIELD3"
      ],
      "domain": "CDS_DOMAIN", "env": "CDS_ENV_SECTOR"
      }

  `domain`: the name of the domain serving your project, as provided by CDS.

  `env`: the name of the environment service for your project, as provided by CDS. Example: "qa".

  The eventFields array contains the variable names of the ServiceNow CPQ fields that are passed to CDS. In the past, the norm has been that CDS will match their variables to the ServiceNow CPQ variable names. Confirm that this is the case for your implementation with CDS.

  `eventFields` must contain all fields that will be communicated between ServiceNow CPQ and CDS (that is, both ServiceNow CPQ fields that control the CDS visual and fields that are passed back to ServiceNow CPQ based on changes made in the CDS visualization).
* Sets can also be passed to CDS, although only the first 25 indexes can be sent. This mirrors the above process except the property name is `eventSets` instead of `eventFields`.
* Array or object of sets to send to CDS:
  * An array will assume the contained strings are both ServiceNow CPQ variable name and CDS variable names.
  * An object will have key:value pairs. The key is the ServiceNow CPQ variable name, and the value is the CDS variable name.
  * This will be sent as a whole, up to 25 indexes long using the following syntax:

        setVariableName: [
        {
        field1: 'value', field2: 'value'
        },
        {
        field1: 'value', field2: 'value'
        },
        ]

  {#cds_visualization_integration__ul_m2n_fdn_fhc}
* Product pickers can also be passed to CDS with a restriction of only the first 25 indexes being able to be sent. This mirrors the above process, except the property name is `eventProductPickers` instead of `eventFields` or `setFields`. The following two syntaxes work:

      {
        "eventProductPickers": ["productPicker1", "productPicker2"]
      }

      {
        "eventProductPickers": {
          "logikProductPicker1": "cdsProductPickerName1",
          "logikProductPicker2": "cdsProductPickerName2"
        }
      }

* CDS can be set up for two-way communication. One-way communication updates the CDS graphic when the user updates relevant ServiceNow CPQ fields. The second mode allows the user to manipulate the CDS graphic, and CDS will update the relevant ServiceNow CPQ field inputs. For standard fields, CDS writes back to the mapped ServiceNow CPQ field. If ServiceNow CPQ sets are being used in a two-way communication setup, ServiceNow CPQ and CDS administrators will need to coordinate the following setup:
  * The ServiceNow CPQ Admin will define a distinct event field to which set data will be written from CDS.
  * The CDS admin will specify this field as the destination for set data.
  * The ServiceNow CPQ Admin will define determination rules that parse the field and populate the set.
  {#cds_visualization_integration__ul_hw3_kdn_fhc}
{#cds_visualization_integration__ul_bwx_vcn_fhc}

