Connector

Overview

A Connector is a pre-built integration plug-in for the XMPro App Designer that allows you to connect to third-party data sources without having to write code. They can be used when integrating data from data sources such as a database into an Application. This can include real-time data from machines, websites, other streaming data, or contextual data such as the make or model of a certain item.
Connectors are useful if you want to use the data within an Application or display the data to the user on a page of an Application.
Data Sources can include databases, Data Streams, or Recommendations. See the Data Integration article for more details on Data Integration. You can assume that Connectors have already been set up by your Administrator.
A list of App Designer Connectors can be found here.

Finding Connectors

The search bar can be used to find any specific Connectors that you may be looking for. There is a dropdown option where you can specify to search through everything in App Designer, or only for Connectors.

Category

Connectors can be grouped into categories. This category is separate from the App and Data Stream Categories.

Uploading a Connector

Connectors can be added by uploading their XMP file on the connectors page. Each version of a Connector has its own XMP file. When uploading, if you have any missing Connectors in XMPro that the app needs, you will be required to update or upload the necessary Connectors in order for the app to be imported successfully.

Versions

Connectors can have multiple versions. For example, a new version of a Connector can be created if there are any changes or updates made to it. Changes or updates made to new versions of a Connector will not affect the previous versions.
Each version of a Connector has its own XMP file. When uploading a Connector, a specific version of that Connector will be uploaded. To upload a different version, you will need to upload the XMP file for that specific version you want to use.
When you view a Connector, you will be able to see the list of specific versions for that Connector. The number of apps using each version will be shown next to the version number. Apps that you do not have access to will not show on the list. When you upload a new version, the new version will be displayed in this list.
When selecting a Connector to use in an app, the application will automatically choose the latest version available.
When a new version of a Connector is uploaded, any apps using older versions may need to be upgraded. See the Data Integration article for more information on how to upgrade an app's connection.

View and Edit Applications

There is an alternative way to view or edit Applications directly from the Connectors page. When viewing a Connector, you will be able to see the number of Applications using each version of the Connector. This can be expanded to see the full list of Applications, which can be viewed by clicking on the Application. They can also be edited by selecting the edit button.

Publish and Unpublish Apps

You can also publish or unpublish an Application that uses that version of the Connector.
As an Admin, this is useful if you need to unpublish an Application and you don't have access to it. See the How to Admin Unpublish Override article for more details.

Actions on the Connector

Action
Description
Add
Adds a new Connector.
Select
Selects multiple Connectors.
Delete
Deletes the Connector.
Manage Categories
Creates and edits categories to organize the Connectors. These categories are separate from the App and Data Stream Categories.
Save
Saves any changes made to the Connector up to this point.
Discard
Discards any changes made to the Connector up to this point.
Delete Versions
Deletes a selected version of a Connector. You can only delete versions that don't have any apps using that version of the Connector. If you don't have access to an app that a version is using, you still cannot delete the version.

Further Reading