# Configuration

All settings are related to a specific Boomi Account, as well as all links are saved *per Boomi Account* in your personal browser local storage.

{% hint style="success" %}
It is highly recommended \
to setup a [**Boomi API Token**](https://help.boomi.com/docs/Atomsphere/Platform/int-Adding_API_tokens_d788aee3-026f-41c5-bebb-bf7f94500db3) for *Linked-Pages for Boomi Integration!*
{% endhint %}

<figure><img src="https://4037333503-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZTIvYZCXmIwyQ0DXmM4w%2Fuploads%2FNKonsTpnLcpZYjPfiMkY%2Fimage.png?alt=media&#x26;token=1233da7c-9130-41b0-9596-3fa5f244b31b" alt=""><figcaption><p>Extension Settings</p></figcaption></figure>

## Boomi API Settings

It is highly recommended (even if not required) to setup a [Boomi API Token](https://help.boomi.com/docs/Atomsphere/Platform/int-Adding_API_tokens_d788aee3-026f-41c5-bebb-bf7f94500db3) for *Linked-Pages for Boomi Integration* so that it can query component metadata information from Boomi AtomSphere.

{% hint style="warning" %}
If you don't provide an API token *Linked-Pages for Boomi Integration* cannot display component names, neither can it query or display path (component directory) information or component types.
{% endhint %}

<figure><img src="https://4037333503-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZTIvYZCXmIwyQ0DXmM4w%2Fuploads%2FWNtmrWu4cLUXnfmPuYPa%2Fimage.png?alt=media&#x26;token=72560ae7-61e4-4b55-9911-dfd91578967a" alt=""><figcaption><p>Boomi API User and Token</p></figcaption></figure>

## Team Sync - share your documentation

*Linked-Pages for Boomi Integration* stores all links in the browser's local storage. If you want to synchronize your links - share your documentation - with other team members, you will need to [obtain a *Team Token.*](https://boomi.markusschmidt.pro/power-tools/licensing) :moneybag:

The *Team Token* is used to synchronize the local links with an Azure Web-Service - per Boomi Account - so that all team members with the same Team Token on the same Boomi Account can use these links (shared documentation)

<figure><img src="https://4037333503-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZTIvYZCXmIwyQ0DXmM4w%2Fuploads%2F30wydktScJUoOnzpoP3F%2Fimage.png?alt=media&#x26;token=e79e36f3-4ca3-4ce0-a0f7-5bef71a688ce" alt=""><figcaption><p>Team Sync Settings</p></figcaption></figure>

## Other Settings

### Confluence Settings

Confluence requires special handling because Confluence-Links to documents are not *permanent*. Means: Confluence links to a document page can become orphaned and be replaced by new ones. *Linked-Pages for Boomi Integration* is able to handle this behaviour, if you provide a **semi-colon separated list of Confluence roots.**

<figure><img src="https://4037333503-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZTIvYZCXmIwyQ0DXmM4w%2Fuploads%2FbdTIfh7alpwHHDn5XyxJ%2Fimage.png?alt=media&#x26;token=cc5e26cc-3e1f-45c8-b372-214fa29ea591" alt=""><figcaption><p>Confluence special handling</p></figcaption></figure>

### Titel Cleansing

Link titles are read from the browser url, and such titles can become very long, containing unwanted information. Use the *Title Cleansing* RegEx to advise Linked-Pages for Boomi Integration to remove part of (recurring) titles.

I recommend using `(\s-\sConfluence)` to strip off unnecessary Confluence information.

<figure><img src="https://4037333503-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZTIvYZCXmIwyQ0DXmM4w%2Fuploads%2FkL3n8cLjDMm5wc4RWsnk%2Fimage.png?alt=media&#x26;token=729b478e-5ae6-4646-b970-515d4583fc5b" alt=""><figcaption></figcaption></figure>