Confluence

Introduction to the Feature

Integrate Confluence with Catalog to enable seamless synchronization of data documentation content. This integration ensures:

  • A constantly updated and comprehensive knowledge base for the Data Governance Team

  • A powerful AI Assistant that utilizes the content to provide the best responses to your questions

Why Synchronize Your Confluence Pages in Catalog?

Advantage 1: Enhanced AI Assistant Intelligence

All imported content feeds the Assistant, significantly boosting its intelligence. This empowers your teams to gain independence and efficiency in their work.

Advantage 2: Always Up-to-Date Content

Currently, users manually copy and paste content from Confluence into Catalog, leading to redundant maintenance efforts and potential inconsistencies. With this feature, these issues are eliminated. The synchronized content becomes the single source of truth, always up-to-date and read-only in Catalog.

How to Perform the Synchronization

Follow these steps to set up the integration:

  1. Create a Confluence account for Catalog This account, with the permissions you assign to it in the Confluence space (and therefore the visibility of pages), will be used to synchronize content with Catalog. Location: Your Internal Confluence Space

  2. Navigate to the pages or spaces you want to share

    Location: Your Internal Confluence Space

  3. Grant permissions

    Location: Your Internal Confluence Space

  4. Complete the integration process

    Location: In Catalog

    Please note that we are expecting a base_url on this format "https://xxxxx.atlassian.net/"

Account Id

To find your Account Id, here is a helpful link https://community.atlassian.com/t5/Jira-questions/where-can-i-find-my-Account-ID/qaq-p/976527

Base Url

The Base Url can be found here as well. Please note that we are expecting a base_url on this format "https://xxxxx.atlassian.net/"

API Token

To find your API Token, here is a helpful link https://id.atlassian.com/manage-profile/security/api-tokens

FAQ

Questions About Page Synchronization

  1. Q: If I select a parent page, are all its children automatically ingested? A: Yes, all child pages are automatically ingested.

  2. Q: If I want to select only one child page out of 10 ingested, do I need to "desynchronize" the other 9? A: Yes, you'll need to manually desynchronize the unwanted child pages. Or, you directly synchronise the good one in the first place.

  3. Q: How can I ingest only a single page without its children? A: You need to manually desynchronize its child pages.

  4. Q: What are the ingestion rules for private pages? A: Private pages within a public parent page are ingested. To prevent this, manually desynchronize the private pages.

Questions About Rights and Permissions

  1. Q: Are the permissions on Confluence pages reflected in Catalog? A: No, not currently. If User A doesn't have rights to view a page in Confluence, but that page is synchronized to Catalog and User A has access to Catalog, they will be able to see the page content. This content will also be used by the AI Assistant.

Last updated

Was this helpful?