Using Connections

The Connections tab is the central place where all connections between BlueConic and other systems (CRM systems, CMS systems, Authentication systems etc.) are configured. The connections may have two directions:

  1. BlueConic seeks connection with another system.
  2. The other system seeks connection to the BlueConic REST API.

Depending on the type and direction of the connection, the Connection will contain configuration to successfully make the connection.

Connections that have BlueConic seeking connection with another system the setup is typically done in configuring the connection itself. See the individual documentation for the connection itself for instructions on how to set up a working connection. The "Read more" link in connection's description in BlueConic typically links to the documentation for that connection.

In case another system wants to access the BlueConic REST API:

  • The developer of the external software application will implement oAuth, as described in the BlueConic REST API.
  • The BlueConic Application Manager will create and activate a BlueConic API Access Connection and will let the developer know the Consumer Key and Consumer Secret he needs to finish implementing oAuth.

 


Creating a new Connection

When you enter the Connections tab for the first time, you end up on the existing connections navigation list. This list displays connections that are configured in your BlueConic environment:

To add a new connection, click the Add connection button to select the type of connection from the gallery:

connection.png

Search and select the type of connection that you want to add, and click it to start configuring it.

The list only shows the types of connections currently installed in BlueConic. Activate "Show all" to see all types of connections that are available in the Plugins Gallery. Selecting a new connection will automatically install it in BlueConic.

There is also the option to have the BlueConic help you set up connections. Click the link to fire up the Connection Discovery wizard.

 


Change the meta data of a Connection

Status

A connection can be switched 'On' or 'Off' with the On/Off toggle to the right of the name of the connection. If the connection is switched off, the connection will not be triggered for visitors of your channels. You can enable or disable a connection by changing the status:

Name, Favorites and Labels

You can change the name of the connection by simply clicking on the name and editing it.

By clicking the favorites icon you can add/remove the connection from the Favorites. If a connection is added to the Favorites it is shown in the Favorites list on the Home tab.

By selecting one or more labels for a connection, you make navigating to items with the same label really easy. Once you've selected a label for a connection, click on the label: a dropdown menu opens that lists all other items with the same label. Clicking an item will navigate you to the clicked item.

 

"Where": Channel selection

At the "where" section, you select the channels on which you want this connection to be active. You select a channel by entering a few characters of that channel in the search box. Channels that match your criteria will appear in a list to select from. If needed you can also open the advanced search to find the right channel. By default connections are running on "all channels".

If you want to fine tune the scope of the connection on a channel, you first need to select the channel. Once the channel is selected you can add 'rules' to limit the scope of the connection within the channel.

In the above screenshot, the connection is only active for the channel "BlueConic.com" and is only available on the pages that start with "/support/", except for the page "/support/contact.html".

The number of restrictions in a channel is mentioned behind the channel, and can be viewed and edited by clicking on it.


Modifying or Deleting a Connection

Like other domain objects, Connections can be saved and deleted using the Save button. For an in depth instruction, see Save, Save As and Delete.


Related items

In the right hand sidebar, the "related items"-widget is displayed. It shows the other objects in BlueConic that are directly related to the connection that you are managing.

Connections can have the following types of related items:

  • Plugin: The plugin on which this connection is based.
  • Channels: The channels on which this connection is active.