Work with Ardoq data in Lucidchart

Written by:  Morgan T
Last updated:  

Create powerful, data-driven visualizations of your enterprise architecture with Ardoq data in Lucidchart. By importing your datasets directly into Lucid’s Data Hub, you can drag components onto the canvas to instantly map out your application portfolio, discover hidden redundancies, and assess the impact of IT changes across your entire infrastructure. Read this article to learn more.

You can also work with enterprise architecture using LeanIX data. For more information, check out our Work with LeanIX data in Lucidchart article.

This feature is available for accounts with the Process Accelerator. Contact sales to purchase the Process Accelerator for your Enterprise account. This is also available for purchase for accounts on the FedRAMP environment.

Create Ardoq credentials in Lucid

To set up the integration, an account owner or account admin needs to generate an API token in Ardoq, then create a set of credentials in Lucid to authenticate the workspace for the entire account.

Generate an API Token in Ardoq

  1. In Ardoq, click the name of your workspace from the top-left corner.
  2. Hover your cursor over “Admin”.
  3. Select Access control.
  4. Under “User management”, select Service accounts.
  5. Create a new Service Account to generate a token, or regenerate the token for an existing Service Account.
  6. Copy the generated token. You’ll need this during the next steps to create credentials in the Lucid Data Hub.

Create credentials in the Lucid Data Hub

Create new credentials for Ardoq by following the steps below. You can only create one set of credentials.

  1. From the Lucid Home Page, select Data Hub in the navigation menu on the left side.
  2. Select Ardoq from the options that appear on the left side of the Data Hub.
  3. Click Create credential from the top-right of the page.
  4. Paste the API Token you generated in Ardoq.
  5. Enter your Ardoq organization URL.
  6. Optionally, edit the display name for the credentials. This is how the credentials are listed in Lucid’s Data Hub.
  7. Click Save credential.

Import data from Ardoq

After adding credentials, you can import data from Ardoq into multiple data sources tailored to different needs. For example, you can import a comprehensive organizational profile to track company-wide software compliance. In addition, you can import smaller, project-specific sources, allowing you to focus on specific business units rather than your entire enterprise architecture.

Import data by following these steps:

  1. From the Lucid Home Page, select Data Hub in the navigation menu on the left side.
  2. Select Ardoq from the options that appear on the left side of the Data Hub.
  3. Click Import Ardoq data source from the top-right corner of the page.
  4. Under “Data source name”, type a name for your data source.
  5. Under “Component types”, check the box to the left of any sub-types you want to include in the import.
    • Optionally, check the box next to any tags to only import components with those tags and narrow the import further.
  6. Click Import from the bottom-right of the panel.

Refresh imported data

To refresh data you’ve already imported from Ardoq, follow these steps:

  1. Select Data Hub from the navigation menu on the left side of the Lucid Home Page.
  2. Select Ardoq from the navigation menu on the left side.
  3. Open the three-dot menu to the right of a data source.
  4. Select Update data source from Ardoq.

The data source will be updated to match the most current data from Ardoq.

Share imported data

To share a data source with another user on your Lucid account, follow these steps:

  1. From the Lucid Home Page, select Data Hub in the navigation menu on the left side.
  2. Select Ardoq from the options that appear on the left side of the Data Hub.
  3. Check the box to the left of one or more data sources you want to share.
  4. Click Share data sources from the top-right corner.
  5. Enter the names, email addresses, or groups you want to share the data source with.
  6. Click Share.

Once a data source has been shared with a user, they can connect Ardoq data to their Lucidchart documents.

Build diagrams with data from Ardoq

Connect a data source to a Lucidchart document

To connect data you’ve imported from Ardoq to a Lucidchart document, follow these steps:

  1. Open a Lucidchart document.
  2. Click search-icon.png the search icon in the upper-left corner of the workspace to open the search panel.
  3. Search for and select enterprise-architecture-icon.png Enterprise architecture resources.
  4. Select Ardoq from the panel that opens.
  5. Select a data source from the list that appears.
  6. Click Add data.

For full instructions to connect a data source to a Lucidchart document in the classic Lucidchart editor, expand the dropdown below.

 

Click here for classic Lucidchart editor steps

To connect data you’ve imported from Ardoq to a Lucidchart document, follow these steps:

  1. Open a Lucidchart document.
  2. Click enterprise-architecture-icon.png the Enterprise architecture icon from the Primary Toolbar on the left side of the canvas.
  3. Select Ardoq from the panel that opens.
  4. Select a data source from the list that appears.
  5. Click Add data.


 

Tip: From search results in the right panel, hover over the Enterprise architecture resources icon and click the plus icon to add it to your Document tools for quick access.

Add data to the canvas

After you’ve connected a data source to the document, you can add objects to the canvas by dragging them onto the canvas.

Select a Ardoq object on the canvas to open the contextual panel on the right side. From here, you can see related resources and drag them onto the canvas. Relationships between objects will automatically appear.

Toggle relationship visibility

To show or hide different relationship lines on the canvas, follow these steps:

  1. Select the text of a relationship line on the canvas.
  2. Click Manage relation in the box that appears.
  3. Click Show all or Hide all, or click the toggle to the right of each relation type to show or hide them on the canvas.

Alternatively, you can right-click one or multiple selected lines, and select Hide relationships to hide specific lines (if all selected lines share the same relation type, this button will display that specific relation type instead of the generic word “relationships”).

For full instructions to toggle relationship visibility in the classic Lucidchart editor, expand the dropdown below.

 

Click here for classic Lucidchart editor steps

To show or hide different relationship lines on the canvas, follow these steps:

  1. Select the text of a relationship line on the canvas.
  2. Click All relationships.
  3. In the right-hand panel, under “Related resources”, select Manage relations.
  4. Click the toggle to the right of each relation type to show or hide them on the canvas.

Sync refreshed data to the document

After refreshing imported data in the Lucid Data Hub, you need to sync your Lucidchart document in order to see changes to any Ardoq shapes you’ve added. To sync the document, follow these steps:

  1. Select enterprise-architecture-icon.png Enterprise architecture resources from Document tools in the left panel.
  2. Click the ardoq-icon.png Ardoq icon from the top-right of the panel.
  3. Click Sync document from the bottom of the panel that appears.

Wait for the data source in the document to finish syncing. This will update the data on the canvas to reflect any changes.

For full instructions to sync refreshed data to the document in the classic Lucidchart editor, expand the dropdown below.

 

Click here for classic Lucidchart editor steps
  1. Select enterprise-architecture-icon.png the Enterprise architecture icon from the Primary Toolbar on the left side of the canvas.
  2. Click the ardoq-icon.png Ardoq icon from the top-right of the panel.
  3. Click Sync document from the bottom of the panel that appears.

Still need help

FAQ

Is data bi-directionally synced between Lucid and Ardoq?

No. The data is synced one way only—from Ardoq to Lucid. Changes made in Lucid won’t be reflected in Ardoq. If you make changes in Ardoq, refresh the data source and sync the document to see those changes in Lucid.

Give feedback on this article

Have feedback about this article? Tell us about your experience here.

Did you find what you were looking for?

Still have a question or want to share what you have learned? Visit our Community to get help and collaborate with others.