Work with LeanIX and Ardoq data in Lucidchart

Create LeanIX or Ardoq credentials in Lucid

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

Generate an API token in LeanIX

1. In LeanIX, click your profile image or initials from the top-right corner.
2. Select Administration.
3. Under “Discovery and Integrations”, select Technical Users from the navigation menu on the left side of the page.
4. Create a new Technical User to generate a token, or regenerate the token for an existing Technical User.
5. Copy the generated access token. You’ll need this during the next steps.

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 LeanIX or 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 LeanIX or 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 LeanIX or Ardoq.
5. Enter your LeanIX workspace URL or your Ardoq organization URL.
   • Example: https://demo.leanix.net/ or https://demo.ardoq.com
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 LeanIX or Ardoq

After adding credentials, you can import data from LeanIX or 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.

Check out the sections below for details on importing from LeanIX and Ardoq.

From LeanIX

1. From the Lucid Home Page, select Data Hub in the navigation menu on the left side.
2. Select LeanIX from the options that appear on the left side of the Data Hub.
3. Click Import LeanIX data source from the top-right corner of the page.
4. Under “Data source name”, type a name for your data source.
5. Under “Fact sheet 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 fact sheets with those tags and narrow the import further.
6. Click Import from the bottom-right of the panel.

From Ardoq

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 LeanIX or Ardoq, follow these steps:

1. Select Data Hub from the navigation menu on the left side of the Lucid Home Page.
2. Select LeanIX or 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 LeanIX or Update data source from Ardoq.

The data source will be updated to match the most current data from LeanIX or 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 LeanIX or 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 LeanIX and Ardoq data to their Lucidchart documents.

Build diagrams with data from LeanIX or Ardoq

Connect a data source to a Lucidchart document

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

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

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 LeanIX or 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 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.

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”).

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 LeanIX or Ardoq shapes you’ve added. To sync the document, follow these steps:

1. Select the Enterprise architecture icon from the Primary Toolbar on the left side of the canvas.
2. Click the SAP or 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.

FAQ

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

Give feedback on this article