You can create a new inbound endpoint or import an existing inbound endpoint from an XML file, such as a Synapse configuration file using WSO2 EI tooling.
Using WSO2 EI Tooling
You need to have WSO2 EI tooling installed to create a new inbound endpoint or to import an existing inbound endpoint via tooling. For instructions on installing WSO2 EI tooling, see Installing Enterprise Integrator Tooling.
Creating a new inbound endpoint
Follow the steps below to create a new inbound endpoint.
- In Eclipse, click the Developer Studio menu and then click Open Dashboard. This opens the Developer Studio Dashboard.
- Click Inbound Endpoint on the Developer Studio Dashboard. Alternatively, you can right-click on the ESB Config project and then click New > Inbound Endpoint.
- Select Create a New Inbound Endpoint and click Next.
- Give a name for the inbound endpoint, select the protocol type and click Finish.
- The created inbound endpoint opens in the Graphical Editor as shown below:
- Drag and drop a sequence and an
onError
sequence from the tool palette as shown below: - If you want to browse a sequence from the registry, right-click on the sequence and click Show Properties View.
- Point to an existing sequence in the registry in the Static Reference Key property.
- Right-click on the inbound endpoint and click Show Properties View to open the Property window.
- Update the parameters as preferred and the changes will be saved in the inbound endpoint configuration.
Importing an existing inbound endpoint
Follow the steps below to import an existing inbound endpoint from an XML file such as a Synapse configuration file, into an ESB Config project.
- In Eclipse, click the Developer Studio menu and then click Open Dashboard. This opens the Developer Studio Dashboard.
- Click Inbound Endpoint on the Developer Studio Dashboard. Alternatively, you can right-click on the ESB Config project and then click New > Inbound Endpoint.
- Select Import Inbound Endpoint and click Next.
- Specify the inbound endpoint file by typing its full path name or clicking Browse and navigating to the file.
- In the Save Inbound Endpoint Infield, specify an existing ESB Config project in your workspace where you want to save the inbound endpoint, or click Create new ESB Project to create a new ESB Config project and save the endpoint there.
- Click Finish. The inbound endpoint you selected is created in the
inbound-endpoints
folder under the ESB Config project you specified, and the inbound endpoint opens in the editor.
Using the management console
You can add, edit and delete inbound endpoints via WSO2 EI Management Console. You can also enable/disable statistics as well as enable/disable tracing for inbound endpoints via the Management console.
Adding an inbound endpoint
Follow the steps given below to add an inbound endpoint.
- Click the Main tab on the Management Console and then go to Manage -> Service Bus and click Inbound Endpoints to open the Inbound Endpoints page.
- On the Inbound Endpoints page, click Add Inbound Endpoint to open the New Inbound Endpoint page.
- Specify a name for the inbound endpoint, select the inbound protocol type for the new inbound endpoint , and click Next. This displays all the parameters applicable to the new inbound endpoint depending on the protocol type you selected.
- Specify values for all the required parameters. Following are the available inbound protocol types. Click on a required protocol type for information on the parameters you need to specify as well as to view a sample configuration for an inbound endpoint of the relevant protocol type.
Click Show Advanced Options if you want to configure advanced settings for the inbound endpoint. The parameters displayed under advanced options also depend on the protocol type you selected for the inbound endpoint.
- Click Save. You will see the new inbound endpoint you added displayed under Available Defined Inbound Endpoints on the Inbound Endpoints page.
Editing an inbound endpoint
Follow the steps given below to edit an inbound endpoint.
- Click the Main tab on the Management Console and then go to Manage -> Service Bus and click Inbound Endpoints to open the Inbound Endpoints page.
- On the Inbound Endpoints page, you will see all the inbound endpoints that you have added under Available Defined Inbound Endpoints.
- Click Edit to make necessary changes to a required inbound endpoint.
- Change the existing parameter values based on your requirement and click Update. The changes will be applied to the inbound endpoint.
Deleting an inbound endpoint
Follow the steps below to delete an inbound endpoint.
- Click the Main tab on the Management Console and then go to Manage -> Service Bus and click Inbound Endpoints to open the Inbound Endpoints page.
- On the Inbound Endpoints page, you will see all the inbound endpoints that you have added under Available Defined Inbound Endpoints.
- Click Delete to discard an inbound endpoint that you no longer need. A message appears to confirm that you want to proceed with deleting the inbound endpoint.
- Click Yes. The inbound endpoint will be deleted and will no longer appear under Available Defined Inbound Endpoints on the Inbound Endpoints page.
Enabling/disabling statistics
Follow the steps below to enable or disable statistics for inbound endpoints.
- Click the Main tab on the Management Console and then go to Manage -> Service Bus and click Inbound Endpoints to open the Inbound Endpoints page.
- On the Inbound Endpoints page, you will see all the inbound endpoints that you have added under Available Defined Inbound Endpoints. You will see the Enable Statistics link displayed for inbound endpoints that have statistics currently disabled, and the Disable Statistics link displayed for inbound endpoints that have statistics currently enabled.
- If you want to enable statistics for an inbound endpoint, click Enable Statistics for the particular inbound endpoint.
- If you want to disable statistics for an inbound endpoint, click Disable Statistics for the particular inbound endpoint.
Enabling/disabling tracing
Follow the steps below to enable or disable tracing for inbound endpoints.
- Click the Main tab on the Management Console and then go to Manage -> Service Bus and click Inbound Endpoints to open the Inbound Endpoints page.
- On the Inbound Endpoints page, you will see all the inbound endpoints that you have added under Available Defined Inbound Endpoints. You will see the Enable Tracing link displayed for inbound endpoints that have tracing disabled, and the Disable Tracing link displayed for inbound endpoints that have tracing enabled.
- If you want to enable tracing for an inbound endpoint, click Enable Tracing for the particular inbound endpoint.
- If you want to disable tracing for an inbound endpoint, click Disable Tracing for the particular inbound endpoint.