WebSphere brand IBM WebSphere Telecom Web Services Server, Version 7.1

Group Resolution

Resolves group URIs to their collection of member URIs when a Web service implementation accepts group URIs within a list of targets for a given operation.

The expanded group contents are placed into the SOAP headers for downstream processing.

This mediation primitive performs group resolution using the queryMembers() operation, which is part of the Parlay X 2.1 Address List Management interface. The Access Gateway group resolution mediator currently requires that the Address List Management group resolution service be configured. To disable group resolution, edit the SCA Module properties for the given flow and blank out the GroupResolution.endpoint. If the endpoint is not valid, the Group Resolution mediation primitive returns a fault error.

The Group Resolution mediation primitive requires the Parlay X Address List Manager over XCAP Web service implementation.

Policy configuration

This mediation primitive uses the following policy for runtime configuration:

message.groups.MaxGroupSize

The maximum number of members that can be in a group that is returned by the group list server, for message processing to continue. If the number of members exceeds this number, the Group Resolution mediation primitive generates a fault at its fault terminal. If this policy is not present, there is no limit to the number of group members.
  • Type: integer

Mediation primitive properties

This mediation primitive uses the following configuration properties. These properties can be modified using WebSphere® Integration Developer (WID) tooling. Properties that are promoted can be configured using the Integrated Solutions Console.

groupResolutionEndpoint

The endpoint used to call the Parlay X Address List Management interface to perform group resolution. (Refer to the topic Finding the IBM® XDMS XCAP root for help with locating this value.) Default: http://localhost:9080/TWSS/ParlayX21/AddressListManagement/IMS/services/Group
  • Type: String
  • Promoted: Yes

Upstream SOAP headers

The following SOAP header elements are expected from upstream mediation primitives:
<twss:twssHeaders>
  ...
  <twss:policies>
    <twss:policy attribute="" value=""/>
    <twss:policy attribute="" value=""/>
    ...
  </twss:policies>
  ...
</twss:twssHeaders>

Added SOAP headers

The following SOAP header elements are added or modified for downstream mediation primitives:
<twss:twssHeaders>
  ...
  <twss:operationTargets>
    <!-- The number of targets for this operation after all groups
         have been resolved. Duplicates are included in this count.
         Downstream components assume a default value of ‘1'
         if this header is not present. -->
  </twss:operationTargets>
  <twss:resolvedGroups>
    <twss:GroupList groupURI="">
      <member>member1@domain</member>
      <member>member2@domain</member>
      ...
    </twss:GroupList>
    <twss:GroupList groupURI="">
      ...
    </twss:GroupList>
    ...
  </twss:resolvedGroups>
  ...
</twss:twssHeaders>

Message handling

Messages that are successfully processed by the Group Resolution mediation primitive are passed to the output terminal of the mediation primitive. If an error occurs in processing the message or if the maximum size of a resolved group is exceeded, the message is redirected to the fault terminal:

Compatibility

The Group Resolution mediation primitive interacts with the Parlay X Address List Manager over XCAP Web service implementation. To resolve group URIs, the Web service implementation interacts with the IBM WebSphere XML Document Management Server Component (XDMS) product.




Terms of use
(C) Copyright IBM Corporation 2009. All Rights Reserved.