IBM BPM, V8.0.1, All platforms > Authoring services in Integration Designer > Services and service-related functions > Building mediation flows > Selecting endpoints dynamically > Selecting endpoints dynamically from WSRR
Return all matching endpoints and set routing targets
The first match is used as the target and the rest are used as alternate targets. This is useful if you have multiple services which perform the same operation.
When multiple endpoints are returned, the first match is set as the Target and the rest of the matches populate the AlternateTarget(s) in the SMOHeader. If a match is found the result of the lookup is put into the EndpointLookup Primitive Context.
If no matches are found, the noMatch terminal is fired and both the Target and AlternateTarget(s) are left unchanged.
Follow these steps to create a mediation flow which retrieves endpoints from the WSRR and routes the message to the retrieved endpoints.
Procedure
- Create a mediation flow component, and add a source interface that contains the source operation.
- Click the source operation to open its implementation.
- Drop a callout or service invoke primitive onto the editor.
- Select the reference and operation that you want to invoke.
- In order for the runtime to implement dynamic routing on a request, the callout node or service invoke primitive must be set to use the dynamic endpoint. Select the callout node or service invoke primitive, and click the details page in the properties view. Ensure that the Use dynamic endpoint check box is selected.
- Drop an Endpoint Lookup primitive on the canvas and select the Return all matching endpoints and set alternate routing targets Match Policy in its Properties view.
- Wire the primitive to the rest of the mediation flow.
- Optional: Promote the Use dynamic endpoint property so that the administrator can change it at run time. Click the Promoted properties page, and select the promoted check box for the property.
- Optional: Promote the query properties of Endpoint Lookup such as User properties so that you can change the query to the registry at run time without re-deploying the mediation module. Click the Promoted properties page, and select the promoted check box for the property
- Optional: You can specify a default endpoint that the runtime uses if it cannot find a dynamic endpoint. You specify a default endpoint by wiring an import to the mediation flow component.
- Optional: If there are no endpoints matching the search criteria in the WSRR, the message is propagated to the noMatch terminal of the Endpoint Lookup primitive. You can wire the noMatch terminal to a mediation primitive for notification, such as a Message Log or Event Emitter.