Step 1: Build a Connector with the Confluence Native Source
Read through the Data Connectors Overview module to learn how the Connectors framework works.
Set up your Confluence Data Connector
- First, navigate to Knowledge Graph > Connectors and select Add New Connector. Then, select the Confluence source.
- Next, designate the operation you would like to perform (Fetch Content). You will need to provide the following inputs:
- Subdomain (the first part of your Confluence account URL, e.g.,
[[confluenceSubdomain]].atlassian.net/wiki/home
) - Username (the email address you use to log into your Confluence account)
- Password (the API Token that you already generated)
- Subdomain (the first part of your Confluence account URL, e.g.,
- Select the type of content that you would like to pull in: Pages or Blog Posts.
- Click Continue.
- You can preview the raw response to make sure content is being pulled in by clicking Pull and then View Raw Response.
Specify Selectors Based on your Content Type
On the next page, you will need to specify the selectors that you want as fields on your entity type. This includes selecting any data you want to extract from the API response and creating any necessary transforms.
If you choose to Add Default Selectors, the connector will pull in all identified selectors. However, you also have the option to make any adjustments to those as needed.
Map your Data to Entity Fields
Once you have specified your selectors, you will map the data to entity fields in the Knowledge Graph on the Map Fields screen.
Select the entity type that you want to map the data to. Note that if this is a custom entity type, it will need to be created and enabled in the Knowledge Graph prior to mapping fields and running the connector. Similarly to custom entity types, any custom fields that you want to map to need to be configured prior to running the connector.
In the Fields tab, once you have selected your Entity Type, map any data added via the selectors and transforms to the appropriate fields. To learn more about mapping fields, read the Load - Map & Run module.
Once you have all the fields mapped, click Save and give your connector a name. You can either save the connector to run later or click Save & Run Now to run the connector upon creation. Remember that you can schedule your Confluence data connector to run at whichever frequency you see fit in the Connector Summary section.