Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Migrated to Confluence 5.3

When a connector is enabled in your ESB instance, you can access its functionality by adding a reference to it from your ESB configuration (such as in a sequence) and then calling its operations. To see the operations available in a connector, display your list of connectors (on the Main tab of the ESB Management Console, under Connectors click List), and then click the connector name.

For example, if the JIRA connector is enabled in your ESB instance and you want to use it in a sequence, you would add the following entry to your sequence configuration to connect to JIRA:

Code Block
languagehtml/xml
<jira.config>
     <username>myname@mycompany.com</username>
     <password>{wso2:vault-lookup('xxxx.email.login')}</password>
     <uri>https://xxx:xx/xx</uri>
</jira.config>

Then, if you want to get an issue, you can use the JIRA connector's getIssue operation and pass in the issue ID as follows:

Code Block
languagehtml/xml
<jira.getIssue [configKey="Ref Local Entry"]>
  <issueIdOrKey>ESBJAVA-2095</issueIdOrKey>
</jira.getIssue>

...

Using connectors in Developer Studio

If you are using Developer Studio, you can import a connector into your ESB config project by right-clicking the project, choosing Import Connector, and then navigating to the connector's ZIP file (for a list of predefined ESB connectors you can download, see ESB Connectors). The operations in the connector are then displayed in the graphical ESB editor, allowing you to drag them to your proxy service, sequence, or other configuration.

Image Added

Notice that the first operation in the workflow is init, which initializes and establishes the connection to the service (in this example, it contains the authentication information for connecting to Google Spreadsheets). This connection is used by all subsequent operations in the flow unless you specify a different init configuration for a specific operation. To specify an init that has been saved as a local entry, enter its name in the Config Ref property. To create a new init for this operation, click the New Config property row, click the browse button that appears, and then enter the initialization parameters. 

For more information on using connectors in Developer Studio, see Working with Connectors in the Developer Studio documentation.