This documentation applies to older versions of WSO2 ESB connectors. To find the documentation relevant to the version you are using, select the connector from the WSO2 Connector Store and click Documentation.

All docs This doc
Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 7 Next »

Introduction

This guide gives basic requirements to implement and publish connectors in WSO2 Connector Store.

Basic Implementation Requirements

1) Firstly decide on which API you will be writing the connector. This can be one of the following.

  • REST-based connectors
  • SOAP-based connectors
  • Java API-based connectors

    Rest based connectors are preferred if the api vendor provides one.

2) For each connector there needs to be a method called init(). Using this method user should be able to manage authentication with the vendor API.

    This can be a call to the external API or simple setting the access tokens within ESB context to be used by other methods.

3) We strongly recommend the non-use of GPL or LGPL licensed libraries in the development of connectors. However if there is a valid reason to use these licenses, a justification for the usage of these licenses need to be submitted along with the connector submission. Hosting connectors that use GPL or LGPL licenses on WSO2 Connector Store will be done at the discretion of WSO2. 

More information on writing connectors can be found with WSO2 ESB Documentation

Integration test coverage

All the methods should be covered with integration test with latest released ESB version. Above is to enforced validity of connector functionality periodically and with new ESB product versions.

More information can be found with WSO2 Test Automation Documentation

Images required for publishing

We require PNG images with following sizes to be used in connector store and developer studio.

  1. 580x300
  2. 220x200
  3. 55x47
  4. 25x25

Publishing the connector

Once completed send the pull request to following GIT Repository.

https://github.com/wso2-dev/esb-connectors

Also create a JIRA under project ESB Connectors. If GPL or LGPL licensed connectors are used please also include reasons for the use of such libraries. 

 

  • No labels