Group Expansion Router (Aspire 2)

The Group Expansion Router component is configured as a pipeline stage and is responsible for taking a single group expansion request and forwarding it to one or more group expansion stages (such as the SharePoint Group Expansion), combining the results and then returning the combined list back to the requestor. All communication is performed by group expansion requests and group expansion results.

On startup, the component reads a list of default routes from the configuration. However, routes for a specific group expansion request may be included with that request and these will override the default.

For each route, a sub-job is created, a new group expansion request attached and the job routed. The component then waits for the result of these requests (timing out after a configurable period) before combining the groups returned by the expansion components, removing any duplicates and returning the group expansion result.

Expansion Requests containing routes

If you wish to add the expansion routes to the group expansion request, this can be done using the addExpanders(AspireObject doc, List<String> expanderComponents) method. The request will then have the following form:

 <doc type="groupExpansion">
   <username dn="CN=Steve Denny,CN=Users,DC=search,DC=local">Steve Denny</username>
   <groupExpander>
     <expanders>
       <route>/SharePointConnector</route>
       <route>/DocumentumConnector</route>
     </expanders>
   </groupExpander>
 </doc>