SLA Endpoint Lookup mediation primitive properties

You can specify values for mediation primitive properties either by using the property fields in the IBM® Integration Designer user interface or by using an XML format. The property field names displayed in IBM Integration Designer are generally different from the property names used when building a mediation flow using XML code. In the following information, icons are used to identify each property name used in IBM Integration Designer and the corresponding XML name. (Where applicable, XML names that are required, but not shown in IBM Integration Designer, are also described.) Consult your WSRR Administrator for more information on which values to use for each of these parameters.

Registry Name

Identifies the WSRR definition to be used by the SLA Endpoint Lookup mediation primitive. A WSRR definition is created using the server administrative console and provides connection information for a WSRR instance. At least one WSRR definition must exist on the server to which your SCA module is installed. If the Registry Name is absent, the default WSRR definition is used.

Field detail	Value and notes
Required	No
Valid values	String Note:

Consumer ID

This field is either a literal string value or an XPath expression that indicates the location in the message to be interpreted as the consumer identifier. The consumer identifier is an identifier that the consumer can pass in the header of the service invocations it attempts.

The SLA Endpoint Lookup mediation primitive uses the consumer identifier to find the consumer in the SLA. Because most interactions will be through web services and that the consumer identifier will not be part of the message payload itself, the default value for this field is /headers/SOAPHeader[name='GEPGatewayHeader']/value/consumerID. The GEPGatewayHeader is a supplied schema specifically used for this purpose; the XPath expression indicating that the value for the endpoint classification should be taken from this particular field of a specific SOAP header in the incoming message. You must enable the GEPGatewayHeader in the mediation module dependencies section. This usage pattern can be overridden with another XPath expression or literal value if necessary.

Field detail	Value and notes
Required	Yes
Valid values	XPath Note:
Default	/headers/SOAPHeader[name='GEPGatewayHeader']/value/consumerID

Context ID

This field is either a literal string value or an XPath expression which indicates the location in the message to be interpreted as the context identifier. The context identifier is an identifier that the consumer can provide in the header of the service invocations it attempts.

The SLA Endpoint Lookup mediation primitive uses the context identifier to locate the exact SLA for a particular consumer. Because most interactions will be through web services and that the context identifier will not be part of the message payload itself, the default value for this field is /headers/SOAPHeader[name='GEPGatewayHeader']/value/contextID. The GEPGatewayHeader is a supplied schema specifically used for this purpose; the XPath expression indicating that the value for the context identifier should be taken from this particular field of a specific SOAP header in the incoming message. You must enable the GEPGatewayHeader in the mediation module dependencies section. This usage pattern can be overridden with another XPath expression or literal value if necessary.

Field detail	Value and notes
Required	Yes
Valid values	XPath Note:
Default	/headers/SOAPHeader[name='GEPGatewayHeader']/value/contextID

Endpoint Classification

This field is either a literal string value or an XPath expression that indicates the location in the message to be interpreted as the endpoint classification.

The SLA Endpoint Lookup mediation primitive uses this classification to further refine the selection of endpoints associated with a particular SLA. Because most interactions will be through web services and that the endpoint classification will not be part of the message payload itself, the default value for this field is http://www.ibm.com/xmlns/prod/serviceregistry/6/1/GovernanceProfileTaxonomy#Development. When deploying to different environments, change the default by using the Promoted Properties function.

Field detail	Value and notes
Required	Yes
Valid values	XPath Note:
Default	http://www.ibm.com/xmlns/prod/serviceregistry/6/1/GovernanceProfileTaxonomy#Development

User Properties

These extra fields are either literal string values or XPath expressions that indicate the location in the message where the parameter value is located.

Field detail	Value and notes
Value value The value of the parameter can be specified as either a literal or an XPath expression. Description description A description of the parameter. It is used solely for documentation, and plays no part in the selection of the endpoint.

Sample XML code

<node displayName="slaEndpointLookup" name="slaEndpointLookup" type="SLAEndpointLookup">
  <property name=registryName" value="myRegistry"/>
  <inputTerminal/>
  <outputTerminal>
    <wire targetNode="nextNode"/>
  </outputTerminal>
  <failTerminal/>
</node>