Creating integration connectors

You can add integration connector classes into your application in two ways:

Creating connectors in the App_Code folder

  1. Open your Kentico web project in Visual Studio.
  2. Create a new class in the App_Code folder (or Old_App_Code if you installed Kentico as a web application project).
  3. Set the class to inherit from BaseIntegrationConnector.
  4. Override the Init() method and set the ConnectorName property within this method.
    • The value of the ConnectorName property must match the code name of the connector object registered in the administration interface.



using CMS.Synchronization;
using CMS.SynchronizationEngine;

public class CMSIntegrationConnector : BaseIntegrationConnector
{
    /// <summary>
    /// Initializes the connector name.
    /// </summary>
    public override void Init()
    {
        // Initializes the connector name (must match the code name of the connector object in the system)
        // GetType().Name uses the name of the class as the ConnectorName
        ConnectorName = GetType().Name;
    }
}


  1. Ensure that the system loads the appropriate class when working with the connector using the RegisterCustomClass assembly attribute. See Loading custom classes from App_Code for more information.

    
    
    
     using CMS;
    
     [assembly: RegisterCustomClass("CMSIntegrationConnector", typeof(CMSIntegrationConnector))]
    
    
    
     
  2. On web application projects, build the solution.

With the connector class prepared, you now need to:

You can find an example of a basic connector class on the Example - Integration connector page.

Creating connectors in a separate project or assembly

  1. Open your Kentico web project in Visual Studio (using the WebSite.sln or WebApp.sln file).
  2. Add a new project Class Library to the solution (name it e.g. CustomIntegrationConnector).
    • This ensures that the connector has its own DLL assembly.
  3. Add references to the project:
    1. Right-click the project and select Add reference…

    2. Click Browse…

    3. Add at least the following references from the project’s Lib directory:

      • CMS.Synchronization
      • CMS.SynchronizationEngine
      • CMS.DocumentEngine
      • CMS.Helpers
      • CMS.DataEngine
      • CMS.SiteProvider
      • CMS.WorkflowEngine
      • CMS.Base
  4. Edit and rename the default class in the project and set the class to inherit from *BaseIntegrationConnector**.*
  5. Override the Init() method and set the ConnectorName property within this method.
  6. Build the solution.

With the connector class prepared, you now need to:

  • Implement outgoing and/or incoming synchronization
  • Register the connector in the system

Registering connectors in the system

Once the connector’s class is ready, you need to register the connector as an object in the system:

  1. In the Kentico administration interface, open the Integration bus application.

  2. Select the Connectors tab.

  3. Click New connector.

  4. Fill in the Display name, Assembly name and Class and select the Enabled check box.

    Property

    Description

    Display name

    The name of the connector displayed in the user interface.

    Code name

    Sets a unique identifier for the connector. Must match the value of the ConnectorName property declared in the connector’s class.

    Provider class

    Specifies the class where the connector class is implemented:

    • Assembly name - the assembly (project) containing the connector class. Select (custom classes) for connectors implemented in the App_Code (or Old_App_Code) folder.
    • Class - the exact class (including any namespaces) that defines the functionality of the connector. For App_Code classes, the value must match the first parameter of the RegisterCustomClass attribute that loads the class.

    Enabled

    Indicates if the connector logs and processes integration tasks. Logging and processing of tasks must also be enabled in Settings -> Integration -> Integration bus.

  5. Click Save.

Note: When you add, edit or delete a connector, the system re-initializes all defined connectors.

The system displays a warning icon () next to connectors that are not registered correctly. The most common causes of problems are:

  • The value of the ConnectorName property in the connector class’s Init method does not match the Code name.
  • Incorrect assembly or class name.
  • App_Code classes are not loaded correctly. See Loading custom classes from App_Code for more information.