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:
<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:
<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.
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.