Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

An endpoint is a specific destination for a message. An endpoint definition within the mediation configuration defines an external service endpoint and any attributes or semantics that should be followed when communicating with that endpoint.

Follow the instructions below to add a new endpoint.

1. Sign in to the ESB Management Console.

2. Click on "Main" in the left menu to access the "Manage" menu.

Image Removed

3. In the "Manage" menu, click on "Endpoints" under "Service Bus."

Image Removed

4. The "Manage Endpoints" page appears.

Manage EndpointsImage Removed

Select an endpoint you want to add. The available options are:

...

An endpoint can be added as follows.

  1. Open the ESB management console.
  2. Click Endpoints under Service Bus in the left navigator to open the Manage Endpoints page.
  3. Click on the Add Endpoint tab.
  4. Click on the endpoint type you want to add. Available types are as follows.

...

...

    • endpoints that the service will try to connect to in case of a failure. This will take place in a round robin manner.

...

    • HTTP Endpoint - Defines a URI template based REST service endpoint.
    • Load Balance Endpoint  - Defines groups of endpoints for replicated services. The incoming requests will be directed to these endpoints in a round robin manner. These endpoints automatically handle the fail-over cases as well.
    • Recipient List Group -  Defines the list of endpoints a message will be routed to.
    • Template Endpoint  - Allows to create a custom Endpoint template.

...

...

    • Defines the

...

5. Specify the required details according to the type of endpoint. For the detailed description of special options see:

...

    • WSDL, Service and Port.

    Enter the required information for the endpoint depending on the type you selected. Click on the relevant link above to find detailed information on how to configure the endpoint you selected.
    Anchor
    Advanced
    Advanced
  1. Click Show Advanced Options if you want to configure advanced settings for the endpoint. Available advanced options are as follows. 

    Field Name

    Description

    Suspend Error Codes

...

  1. This parameter allows you to select one or more error codes from the List of Values. If any of the selected errors is received from the endpoint, the endpoint will be suspended.

    Initial Duration (

...

  1. in mili seconds))

    The time duration

...

  1. for which the endpoint

...

  1. will be suspended, when one or more suspend error codes are received from it for the first time.

    Max Duration (Millis)

    The maximum time duration

...

  1. for which the endpoint is

...

  1. suspended when suspend error codes are received from it.

    Factor

    The duration to suspend can vary from the first time suspension to the subsequent time. The factor value decides the suspense duration variance between subsequent suspensions.

    On Timeout Error codes

    A list of error codes. If these error codes are received from the endpoint, the request will be subjected to a timeout.

    Retry

    The number of re-tries in case of a timeout, caused by the above listed error codes.

    Retry Delay(

...

  1. in milliseconds)

    The delay between retries

...

  1. in milliseconds.

    Timeout Action

    The action to be done at a timeout situation. You can select from:

    • Never Timeout
    • Discard Message
    • Execute Fault Sequence

    Timeout Duration (

...

  1. in milliseconds)

    The duration in milliseconds before considering a request

...

  1. to be subjected to a time-out.

    WS-Addressing

    Adds WS-Addressing headers to the endpoint.

    Separate Listener

    The listener to the response will be a separate transport stream from the caller.

    WS-Security

    Adds WS-Security features as described in a policy key (referring to a registry location).

    Non Retry Error Codes

...

  1. Retry Error CodesWhen adding a child endpoint to a failover endpoint or load-balance endpoint, you can specify the error codes that trigger this node to be retried instead of suspended when that error is encountered. This is useful when you know that certain errors are transient and that the node will become available again shortly. Note that if you specify an error code as a Retry code on one node in the group but specify that same code as a Non Retry error code on another node in the group, it will be treated as a Non Retry error code for all nodes in the group.

...

  1. Click Add Property if you want to add any properties to an

...

Image Removed

7. Fill in the fields:

...

  • Synapse
  • Transport
  • axis2-client
  • Axis2

...

  1. endpoint. The page will expand to display the following parameters. 
     Image Added

    Parameter NameDescription
    NameThe name of the endpoint property.
    ValueThe value of the endpoint property.
    ScopeThe scope of the property. Possible values are as follows.
    • Synapse
    • Transport
    • Axis2
    • axis2-client

    See XPath Extension Functions for more information about these scopes.

    ActionThis parameter allows you to delete a property.

See more information in Properties Reference.

Image Removed

8. Click "Save."

Command ButtonsImage Removed

...

hiddentrue
  1. See Properties Reference for more information on properties that you can add to the endpoint.

  2. Click Save & Close to save the endpoint in the synapse configuration, or click Save in Registry if you want to save it as a dynamic endpoint in the Registry.