--- title: "Set up visual analytics integration" slug: "set-up-visual-analytics-integration" description: "Set up visual analytics integration." updated: 2025-08-01T17:12:11Z published: 2025-08-15T13:00:09Z canonical: "docs.zilliant.com/set-up-visual-analytics-integration" --- > ## Documentation Index > Fetch the complete documentation index at: https://docs.zilliant.com/llms.txt > Use this file to discover all available pages before exploring further. # Set up visual analytics integration To integrate visual analytics through Tableau, follow these steps: 1. [Set up your AWS environment.](/v1/docs/set-up-visual-analytics-integration#set-up-your-aws-environment) 2. [Enable visual analytics in CPQ.](/v1/docs/set-up-visual-analytics-integration#enable-visual-analytics-in-cpq) 3. [Open visual analytics in CPQ.](/v1/docs/set-up-visual-analytics-integration#open-visual-analytics-in-cpq) ## Set up your AWS environment The integration uses [Zilliant Report API](https://documenter.getpostman.com/view/8744824/T1DsAbVE#6018b8cd-97fc-448f-8d1f-24aae920de2e) ![External link indicator](https://cdn.document360.io/24f960e8-3c1c-4c18-a2c6-83b6ae4aab84/Images/Documentation/external-link-svgrepo-com.svg?sv=2026-02-06&spr=https&st=2026-11-01T14%3A30%3A53Z&se=2026-11-01T15%3A30%3A53Z&sr=c&sp=r&sig=W1%2F1OBA%2BSNGXvFB%2FxUlhrhqB8MKVJSiJ2vcbRzYzt5E%3D) to securely retrieve Tableau report URLs and embed them in CPQ. To enable CPQ to authenticate against Report API, add your credentials in the AWS environment where your CPQ application is running. 1. Sign in to the AWS access portal with your administrator credentials. 2. On the top navigation bar, ensure that the correct region is selected. 3. Select your system. 4. Select **Elastic Beanstalk**, then select your environment. 5. Select **Configuration**, then in the **Environment properties** section, enter the following values: - ZORG_API_URL—Report API URL with your API hostname. - ZORG_CLIENT_ID—OAuth client ID for authentication. - ZORG_CLIENT_SECRET—OAuth client secret. - ZORG_USERNAME—Username. - ZORG_PASSWORD—Password. ## Enable visual analytics in CPQ Define which Tableau reports and where in the UI you want to display. You can embed multiple analytics reports at the same launch point. For example, at the agreement header level, you can add several reports and display them in a tabbed layout, so users can easily switch between different insights. 1. From the CPQ left navigation area, select **Administration**. 2. From the top navigation bar, select **Destination Configuration**. 3. Select ![](https://cdn.document360.io/24f960e8-3c1c-4c18-a2c6-83b6ae4aab84/Images/Documentation/add_42dp_1A1A1A%20(1).png?sv=2026-02-06&spr=https&st=2026-11-01T14%3A30%3A53Z&se=2026-11-01T15%3A30%3A53Z&sr=c&sp=r&sig=W1%2F1OBA%2BSNGXvFB%2FxUlhrhqB8MKVJSiJ2vcbRzYzt5E%3D) to add a destination, defining where to enable visual analytics. 4. In the **Create New Destination** dialog, enter values to define a destination: - **Destination Name**—System name for the visual analytics report. - **URL**—Report API URL without path and query parameters. For details on the URL syntax, read [How View URLs Are Structured](https://help.tableau.com/current/pro/desktop/en-us/embed_structure.htm) ![External link indicator](https://cdn.document360.io/24f960e8-3c1c-4c18-a2c6-83b6ae4aab84/Images/Documentation/external-link-svgrepo-com.svg?sv=2026-02-06&spr=https&st=2026-11-01T14%3A30%3A53Z&se=2026-11-01T15%3A30%3A53Z&sr=c&sp=r&sig=W1%2F1OBA%2BSNGXvFB%2FxUlhrhqB8MKVJSiJ2vcbRzYzt5E%3D) in Tableau’s documentation. 5. Select **Create**. 6. Select the new destination from the list. 7. In the **Additional Properties** section, select ![](https://cdn.document360.io/24f960e8-3c1c-4c18-a2c6-83b6ae4aab84/Images/Documentation/add_42dp_1A1A1A%20(1).png?sv=2026-02-06&spr=https&st=2026-11-01T14%3A30%3A53Z&se=2026-11-01T15%3A30%3A53Z&sr=c&sp=r&sig=W1%2F1OBA%2BSNGXvFB%2FxUlhrhqB8MKVJSiJ2vcbRzYzt5E%3D) to define path and query parameters for the URL. In the new row, define each parameter using the left field for the key and the right field for the value. - **LaunchPoint**—Define where the report appears in CPQ. Use one of the following values: - QT_HEADER_CVA_CONFIG—Quote header level. - QT_LINE_CVA_CONFIG—Quote line item level. - AG_NEG_HEADER_CVA_CONFIG—Header level of agreements under negotiation. - AG_NEG_LINE_CVA_CONFIG—Line item level of agreements under negotiation. - PUB_AG_HEADER_CVA_CONFIG—Header level of published agreements. - PUB_AG_LINE_CVA_CONFIG—Line item level of published agreements. - **Title**—Name of the report tab as it appears in the UI. - **Sequence**—Order number of the report’s tab in the UI. - **WorkbookName**—Name of the Tableau workbook. - **WorksheetName**—Name of the Tableau worksheet. - (Optional.) Add standard Tableau query parameters to control how the embedded report behaves. For example, you can pass the `:showDataDetails` : `yes` key-value pair to display additional information in the analytics view. For details on the query parameter syntax, read [How View URLs Are Structured](https://help.tableau.com/current/pro/desktop/en-us/embed_structure.htm) ![External link indicator](https://cdn.document360.io/24f960e8-3c1c-4c18-a2c6-83b6ae4aab84/Images/Documentation/external-link-svgrepo-com.svg?sv=2026-02-06&spr=https&st=2026-11-01T14%3A30%3A53Z&se=2026-11-01T15%3A30%3A53Z&sr=c&sp=r&sig=W1%2F1OBA%2BSNGXvFB%2FxUlhrhqB8MKVJSiJ2vcbRzYzt5E%3D) and [Embed Code Parameters for Views](https://help.tableau.com/current/pro/desktop/en-us/embed_list.htm) ![External link indicator](https://cdn.document360.io/24f960e8-3c1c-4c18-a2c6-83b6ae4aab84/Images/Documentation/external-link-svgrepo-com.svg?sv=2026-02-06&spr=https&st=2026-11-01T14%3A30%3A53Z&se=2026-11-01T15%3A30%3A53Z&sr=c&sp=r&sig=W1%2F1OBA%2BSNGXvFB%2FxUlhrhqB8MKVJSiJ2vcbRzYzt5E%3D) in Tableau’s documentation. - (Optional.) Add query parameters to dynamically filter Tableau report data based on the context of the currently opened quote or agreement in CPQ. These parameters fetch live values, such as customer account ID, sales region, or selected product, and pass them to Tableau at runtime. Tableau then returns data filtered according to those parameters. Each parameter value must align with the attribute names defined in the CPQ schema model. To fetch live data correctly, use the corresponding CPQ application metadata path. > [!NOTE] > Tip > > To pass data from the quote header, start the parameter value with `Quote.`. To pass data from line items, start with `SalesItem.`. For example, to pass the account ID as a query parameter, add the `account_id` : `Quote.quoteContainedBy.objectERPId` key-value pair. 8. On the bottom button bar, select **Save**. 9. Repeat Steps 1–8 for each visual analytics report and CPQ UI destination where you want to enable it. ## Open visual analytics in CPQ After you enable the integration, users can open visual analytics in agreements or quotes. For details, read: - [View visual analytics in agreements](/v1/docs/view-visual-analytics) - [View visual analytics in quotes](/v1/docs/view-visual-analytics-in-quotes)