Creating and Managing Integration Groups

This section provides and overview of integration groups and discusses how to:

  • Add integration groups.

  • Add integration subgroups.

  • Add services to integration groups and subgroups.

  • Rename and delete integration groups.

  • Copy integration groups using Project Copy.

PeopleSoft provides you with the ability to great groups and subgroups of integrations that you can then deploy using the Integration Network. Your PeopleSoft integration partners can then use the Integration Network to introspect and activate those integrations on their systems.

You can assign services to one or more integration groups or subgroups. However, there can only be one instance of a service within a group or subgroup assignment.

To add an integration group to the system, use the Integration Group search page. To access the page select PeopleTools > Integration Broker > Integration Setup > Integration Groups.

Image: Integration Groups – Add a New Value tab

This example shows the Integration Groups – Add a New Value tab.

Integration Groups - Add a New Value page

After you name the integration group, the Integration Group Definitions page (IB_INTGROUPDEFN) appears where you can add an optional description for the group and save the definition.

Image: Integration Group Definitions page

This example illustrates the Integration Group Definitions page.

Integration Group Definitions page

To add a service integration group:

  1. Select PeopleTools > Integration Broker > Integration Setup > Integration Groups.

    The Integration Group search page appears.

  2. Click the Add a New Value tab.

  3. In the Integration Group Name field, enter a name for the integration group.

  4. Click the Add button.

    The Integration Group Definitions page appears.

  5. In the Description field, add a description for the group.

  6. (Optional.) From the Object Owner ID field, select the owner of the object.

  7. Click the Save button.

After you have added the definition to the system you can proceed to add services to the integration group, as well as create integration subgroups and add services to them.

The process for adding services to integration groups and to integration subgroups is identical and is described elsewhere in this section.

See Adding Services to Integration Groups.

Use the Integration Group Definitions page shown in the previous section to add services to integration groups.

Note: The information presented in this section for searching for services to add to an integration group also applies to searching for services to add to integration subgroups.

You can search for the services to add to a group (or subgroup) by using the Add Services link on the Integration Group Definitions page to access the Add Services page (IB_INTGROUP_SEC).

Image: Add Services page

This example illustrates the Add Services page.

Add Services page

You can search for a service by entering a partial or complete service name in the Service Name field and then clicking the Search button. You can also leave the Service Name field blank and click the Search button to display a list of all services in the database.

After you locate the service or services to add to the group, select the Select check box next to each service name to add to the group and click the OK button.

To add services to an integration group:

  1. Access the Integration Group Definitions page (PeopleTools > Integration Broker > Integration Setup > Integration Groups).

  2. Click the Add Services link.

    The services search page appears.

  3. Search for one or more services to add to the integration group, as described previously in this section.

  4. Click the OK button to return to the Integration Group Definitions page.

  5. Click the Save button.

The Integration Group Definitions page features a Subgroups section where you define subgroups for an integration group and then add services to the subgroups.

Image: Integration Group Definitions page

This example shows the Subgroups section of the Integration Group Definitions page. Use this section of the page to add subgroups to an integration group.

Integration Group Definitions page

To add a service integration subgroup:

  1. Access the Integration Group Definitions page (PeopleTools > Integration Broker > Integration Setup > Integration Groups).

  2. Locate the Subgroup section of the page.

  3. In the Integration Subgroup Name field, enter a name for the subgroup.

  4. In the Description field, enter a description for the subgroup.

  5. Click the Add Services link to add services to the subgroup.

    The process for adding services to integration groups and to integration subgroups is identical and is described elsewhere in this section.

    See Adding Services to Integration Groups.

  6. Click the Save button.

To add additional subgroups to the integration group, in the Subgroups section title, click the Add Row button (+) to add another subgroups grid to the page and repeat the steps described in this section to define the subgroup and add services to it.

To delete a service from an integration group or an integration subgroup:

  1. Access the Integration Group Definition page (PeopleTools > Integration Broker > Integration Setup > Integration Groups).

  2. In the Services or Subgroup Services section of the page, click the Delete Row button (-) next to the name of the service to delete.

  3. Click the Save button.

This section discusses how to:

  • Rename integration groups.

  • Delete integration groups.

Understanding Renaming and Deleting Integration Groups

You can rename and delete integration groups using the Integration Groups tab (IB_INTGROUPADM) in the Service Administration component (IB_HOME_PAGE).

The Integration Group tab contains two sections: a Delete section that enables you to delete integration groups and a Rename section that enables you to rename integration groups. When you first access the Integration Groups tab, both sections are collapsed. Click the section header arrow buttons to expand and collapse each section.

Image: Service Administration – Integration Groups tab

This example illustrates the Service Administration – Integration Groups page. The example shows the Delete section and Rename section expanded.

Service Administration - Integration Groups page

The service system status has no impact on renaming or deleting integration groups.

Renaming Integration Groups

To rename and integration group:

  1. Access the Service Administration – Integration Groups page (PeopleTools > Integration Broker > Service Utilities > Service Administration and click the Integration Groups tab).

  2. Click the arrow next to the Rename section header to expand the section.

  3. In the Integration Group Name field, enter the service to rename, or click the Lookup button to search for and select the group to rename.

  4. In the New Name field, enter the new name for the integration group.

  5. Click the Rename button.

After you click the Rename button, the Results field displays a message that the action was successful or displays a warning or error message with a description of the problem.

Deleting Integration Groups

To delete and integration group:

  1. Access the Service Administration – Integration Groups page (PeopleTools > Integration Broker > Service Utilities > Service Administration and click the Integration Groups tab).

  2. Click the arrow next to the Delete section header to expand the section.

  3. In the Integration Group Name field, enter the integration group to delete, and click the Search button. Search results display in the results grid.

  4. In the results grid, select the check box next to the integration group or groups to delete.

  5. Click the Delete button.

You can copy integration groups between PeopleSoft databases using Project Copy.

When using Project Copy to copy integration groups select the Integration Groups as one of the definition types. To copy all of the service information, such as service, service operation, handler, and so on, select all of the definitions in the Related Definitions box.

Note: At a minimum you must select Services in the Related Definitions box.