Managing Services

This chapter provides an overview of managing services and discusses how to:

• Access and view service definitions.

• Add service definitions.

• Configure service definitions.

• Restrict write access to service definitions.

• Rename and delete service definitions.

• Activate and deactivate services in bulk.

Note. Before you can provide or consume services in a PeopleSoft system, you must configure the system for handling services.

See Also

Configuring PeopleSoft Integration Broker for Handling Services

Understanding Managing Services

Services are used to logically group a set of service operations.

For example, if you have a number of service operations that are related to customers, such as those pertaining to customer information, adding customers, updating customers, deleting customers, and so on, you can create a customer web service and then associate the related service operations with that service.

Warning! PeopleSoft delivers two services with PeopleSoft Integration Broker: IB_GENERIC and IB_UTILITY. These services are used internally by the system. Do not delete or modify these services.

Common Elements Used in This Chapter

Accessing and Viewing Service Definitions

This section discusses how to.

• Access service definitions.

• View WSDL documents generated for services.

• View service operation information.

• View messages defined for services.

Accessing Service Definitions

Service definitions appear on the Services page (IB_SERVICEDEFN) in the Service component (IB_SERVICEDEFN).

To access the Services page, select PeopleTools, Integration Broker, Integration Setup, Services. The following example shows the Services page:

The top of the Service page displays general information about the service, including the name of the service, its description, its alias name, and so on.

Viewing WSDL Documents Generated for Services

Click the View WSDL link to display the WSDL Repository page (IB_SERVICEDEFN_SEC). This page provides a summary of all the WSDL documents that are generated for the service, as well as the service operations, request messages, response messages, and fault messages that are contained in each.

Note. Service operations must exist for a service to view WSDL documents for the service.

Click the View WSDL link to view the contents of the document.

Click the Return button to return to the Services page.

Viewing Service Operation Information

The Existing Service Operations section of the Services page contains an Operation tab that displays service operations and service operation versions that are associated with the service. It also displays descriptions of the service operations, the type of operation, and whether the service operation is active.

When you click the name of a service operation, the operation opens on the Service Operations page, where you can view and modify service operations information, work with the service operation handlers, routing definitions, and do much more.

See Also

Managing Service Operations

Viewing Messages Defined for Service Operations

The Existing Service Operations section of the Services page contains a Messages Links tab that displays the request and response messages defined for each service operation.

The following example shows the Message Links tab displaying request and response messages for the service operation that is associated with the IB_EXAMPLES service:

Click the request or response message name to open the message in the Message Definitions page, where you can view and modify message definition information, message schema information, and more.

See Also

Managing Messages

Adding and Configuring Service Definitions

To add a service definition to the system, use the Add a New Value tab on the Services search page. To access this page, select PeopleTools, Integration Broker, Integration Setup, Services. Then select the Add a New Value tab.

Note. Before you can add a service, you must configure PeopleSoft Integration Broker to handle services using the Service Configuration page.

See Understanding Configuring PeopleSoft Integration Broker for Handling Services.

After you add a service definition to the system, the Services page appears and you can configure the service definition.

To configure a service, use the Services page (IB_SERVICEDEFN) in the Services component (IB_SERVICEDEFN) in the PeopleSoft Pure Internet Architecture. The following example shows the Services page:

To add and configure a service definition:

1. Access the Services page (PeopleTools, Integration Broker, Integration Setup, Services).

2. Click the Add a New Value tab.

3. In the Service field, enter a name for the service.

4. Click the Add button.

   The Services page appears.

5. In the Description field, enter a description for the service.

6. (Optional.) In the Comments field, enter comments about the service or the service.

7. (Optional.) In the Service Alias field, enter an alias name for the service.

8. (Optional.) From the Object Owner ID drop-down list box, select the owner of the service.

9. Enter a namespace URI for the service.

   The default value is the namespace that is declared in the Service Namespace field on the Service Configuration page.

10. Click the Save button.

See Also

Adding Service Operations to Service Definitions

Adding Service Operations to Service Definitions

This section discusses how to:

• Add an existing service operation to a service definition.

• Define a new service operation for a service definition.

Understanding Adding Service Operations to Service Definitions

You can add a service operation that already exists in the database to a service definition, or you can add and configure a new service operation and then add it to a service.

Adding Existing Service Operations to Services

To add an existing service operation to a service:

1. Access the Add Existing Operations page (PeopleTools, Integration Broker, Integration Setup, Services. Click the Link Existing Operations link).

   The Add Existing Operations page appears.

2. Select a service operation to add to the service.

   1. In the Service Operation field, enter the name of the service operation to add to the service and click the Search button. The service operation appears in the Available Service Operations grid.

      Check the box next to the service operation name.

   2. In the Service Operation field, click the Lookup button. The Look Up Service Operation page appears.

      Select a service operation from the list to add to the service.

   3. Click the Search button to show a list of service operations in the database.

      Select one or more service operations to add to the service.

3. On the Adding Existing Operations page, click the Save button.

   The Services page appears and the service operations that you added appear in the Existing Operations grid.

4. On the Services page, click the Save button.

Adding and Configuring New Service Operations for Services

To add and configure a new service operation for a service:

1. Access the Add Existing Operations page (PeopleTools, Integration Broker, Integration Setup, Services).

   The Services page appears.

2. In the Service Operations section, locate the Service Operation field and enter a name for the new service operation.

3. From the Operation Type drop-down list, select the type of service operation you are adding.

   See Service Operation Types.

4. Click the Add button.

   The Service Operations-Definitions page appears. Use the page to configure the service operation.

   See Configuring Service Operation Definitions.

Restricting and Enabling Write Access to Service Definitions

This section provides an overview of restricting access to services and discusses how to:

• Restrict write access to services.

• Enable write access to services.

Understanding Restricting Write Access to Service Definitions

When you restrict write access to a service, sensitive fields of the service definition and of associated service operations appear in read-only mode. The following table lists the components and pages that contain fields and data that are related to services and describes the impact that restricting access to services has to each of them.

You cannot delete or rename a restricted service. In addition, you cannot change, rename or delete any service operation that is defined as part of a restricted service.

Restricting Write Access to Service Definitions

Use the Restricted Service page (IB_SVCSETUP3) in the Service Configuration component (IB_SVCSETUP) to restrict a service. The following example shows the Restricted Services page.

To restrict write access to services:

1. Select PeopleTools, Integration Broker, Service Configuration. Click the Restricted Services tab. The Restricted Services page appears.

2. In the Service field, enter a service name and click the Search button, or click the Lookup button to search for a service.

   The service name or search results display in the Services list.

3. Check the Restricted Service check box next to the service name to which you want to restrict access.

4. Click the Save button.

Enabling Write Access to Service Definitions

To enable write access to services that you previously restricted:

1. Select PeopleTools, Integration Broker, Service Configuration. Click the Restricted Services tab.

   The Restricted Services page appears.

2. Select the service to write-enable using one of the following methods:

   • In the Service field, enter a service name and click the Search button.

   • Click the Lookup button to search for a service.

   • Check the Restricted Services check box, and click the Search button to display and select from all currently restricted services in the system.

   The service name or search results appear in the Services list.

3. Clear the check box next to the service name to write access enable.

4. Click the Save button.

Renaming and Deleting Service Definitions

You can rename and delete services using the Services tab in the Service Administration component (IB_HOME_PAGE). The Services tab contains two sections: a Delete section that enables you to delete services and a Rename section that enables you to rename services.

When you first access the Services tab, both sections are collapsed. Click the section header arrow buttons to expand and collapse each section.

The following example shows the Services tab with both Delete and Rename sections expanded.

Renaming Service Definitions

The service system status that you set on the Services Configuration page affects the ability to rename services.

See Setting Service Configuration Properties.

To rename a service:

1. Select PeopleTools, Integration Broker, Service Utilities. Click the Service tab.

   The Service page displays.

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

3. In the Service field, enter the service to rename, or click the Lookup button to search for and select the service to rename.

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

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 Service Definitions

You can delete services only when the service has no service operations associated with it. When you search for a service to delete, only such services that have no service operations associated with them are retrieved from the system.

To delete a service:

1. Select PeopleTools, Integration Broker, Service Utilities. Click the Service tab.

   The Service tab displays.

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

3. In the Service field, enter the service name to delete, and click the Search button.

   Search results display in the results grid.

4. In the results grid, check the check box next to the service or services to delete.

5. Click the Delete button.

Activating and Deactivating Services in Bulk

The Service Activate/Deactivate page (IB_HOME_PAGE9) in the Service Administration component enables you to activate and deactivate services in bulk.

This page enables you to quickly activate or deactivate services. If any problems occur during activation, the system displays a message indicating a problem activating a certain object, for example routing, handler, and so on. If such a message occurs, you must look on the corresponding object definition to determine the problem. This page is not intended to be used to debug activation problems or problems with integration metadata definitions.

The following example shows the Service Activate/Deactivate page:

When you activate one or more services, all of the default service operation associated with the services become active. In addition, the handlers, routings and queues associated with the service operations become active as well.

When you deactivate one or more services, all selected services become deactivated. The default service operations for the services become deactivated as well. In addition, the handlers, routings and queues associated with the service operations become deactivated.

To activate or deactivate services in bulk:

1. Access the Service Activate/Deactivate page (PeopleTools, Integration Broker, Service Utilities, Service Administration).

2. In the Service field, enter part or all of the service name you want to activate or deactivate.

3. Click the Search button.

4. Check the Select box next to each service to activate or deactivate.

5. Click the Activate button to activate the selected services; click the Deactivate button to deactivate the selected services.

   When the system has performed the selected action, the Results column displays Success for each service you activated or deactivated.