IBM Integration Bus, Version 9.0.0.8 Operating Systems: AIX, HP-Itanium, Linux, Solaris, Windows, z/OS

See information about the latest product version

EndpointLookup node output

Use an EndpointLookup node to retrieve the endpoint addresses for WSDL service definitions held in WebSphere® Service Registry and Repository (WSRR).

The input message is not changed by the EndpointLookup node. Instead, the local environment is updated to contain details of the endpoints retrieved by the query specified by the node and any local environment overrides.

You can configure the EndpointLookup node to dynamically set the service endpoint address for services that will be invoked by a subsequent SOAP or HTTP request node. The EndpointLookup node sets the destination URL in the local environment overrides for those nodes. See the following sample for an example of how to do this:

WebSphere Service Registry and Repository Connectivity

You can view information about samples only when you use the product documentation that is integrated with the IBM® Integration Toolkit or the online product documentation. You can run samples only when you use the product documentation that is integrated with the IBM Integration Toolkit.

EndpointLookup node output if the Match Policy property is set to One

If the Match Policy property of the node is set to One, theEndpointLookup node inserts the endpoint URL retrieved by the query into the local environment in an ITService entry in the local environment under ServiceRegistry, and sets the destination overrides for the SOAP and HTTP request nodes that can be connected directly to its output terminal. The following locations are updated:

LocalEnvironment.Destination.SOAP.Request.Transport.HTTP.WebServiceURL
LocalEnvironment.Destination.HTTP.RequestURL

These settings override the Web service URL property of the SOAPRequest, SOAPAsyncRequest, and HTTPRequest nodes, allowing a dynamic call to a Web service provider.

The following example shows typical output from the EndpointLookup node when the Match Policy is set to One. (Other entries might exist in the local environment depending on previous processing in the flow.)

<LocalEnvironment>
  <Destination>
    <SOAP>
      <Request>
        <Transport>
          <HTTP>
            <WebServiceURL>http://localhost:9081/DemoCustomerWeb/
              services/DemoCustomer</WebServiceURL>
          </HTTP>
        </Transport>
      </Request>
    </SOAP>
    <HTTP>
      <RequestURL>http://localhost:9081/DemoCustomerWeb/
        services/DemoCustomer
    </RequestURL>
	  </HTTP>
  </Destination>
  <ServiceRegistry>
    <ITService>
      <Endpoint>
        <Address>http://localhost:9081/DemoCustomerWeb/
          services/DemoCustomer</Address>
        <PortType>
          <name>DemoCustomer</name>
          <namespace>http://demo.sr.eis.ibm.com</namespace>
          <version>1.0</version>
        </PortType>
        <Property>
          <name>policy</name>
          <value>RM</value>
        </Property>
        <Property>
          <name>country</name>
          <value>China</value>
        </Property>
        <Classification>http://eis.ibm.com/ServiceRegistry/
          GenericObjecttypes#Routing</Classification>
      </Endpoint>
    </ITService>
  </ServiceRegistry>
</LocalEnvironment>

EndpointLookup node output if the Match Policy property is set to All

If the Match Policy is set to All the EndpointLookup node writes an ITService entry in the local environment location ServiceRegistry for each endpoint retrieved by the query.

The following example shows typical output from the EndpointLookup node when the Match Policy is set to All. (Other entries might exist in the local environment depending on previous processing in the flow.)

<LocalEnvironment>
  <ServiceRegistry>
    <ITService>
      <Endpoint>
        <Address>http://localhost:9081/DemoCustomerWeb/
          services/DemoCustomer</Address>
        <PortType>
          <name>DemoCustomer</name>
          <namespace>http://demo.sr.eis.ibm.com</namespace>
          <version>1.0</version>
        </PortType>
        <Property>
          <name>policy</name>
          <value>RM</value>
        </Property>
        <Property>
          <name>country</name>
          <value>China</value>
        </Property>
        <Classification>http://eis.ibm.com/ServiceRegistry/
          GenericObjecttypes#Routing</Classification>
      </Endpoint>
    </ITService>
    <ITService>
      <Endpoint>
        <Address>http://localhost:9081/DemoCustomerWeb/
          services/DemoCustomer2</Address>
        <PortType>
          <name>DemoCustomer2</name>
          <namespace>http://demo.sr.eis.ibm.com</namespace>
          <version>1.0</version>
        </PortType>
      </Endpoint>
    </ITService>
  </ServiceRegistry>
</LocalEnvironment>

ac56310_.htm |

Last updated Friday, 21 July 2017