Gateway Services
This section describes the gateway services that the gateway manager uses.
XML Parsing
Most IBRequest objects and IBResponse objects that are processed in the system contain a content section that represents the actual business content sent.
Most of the time, these content sections contain XML data. Consequently, often connectors must parse and traverse XML. The standard Java XML objects are cumbersome for manipulating XML, so the integration gateway includes an XML parsing service consisting of objects that provide an intuitive interface for manipulating XML objects. This service is delivered as a set of three classes: XmlDocument, XmlNode and XmlNodeList.
See the product documentation for PeopleCode API Reference.
Integration Broker Objects
Two objects comprise the messaging objects service in the integration gateway:
-
IBRequest
-
IBResponse
These objects represent the request and response that enter and exit PeopleSoft Integration Broker.
Connector Management
The connector management service is a composite of several services that manage connectors. The gateway processes each IBRequest to determine the appropriate connector to call in each situation. This is primarily a message routing function that has varying levels of complexity abstracted from the connectors. The connector management service also processes the IBResponse returned by each connector.
WS-Security
WS-Security is an extension to the concept of the SOAP envelope header that enables applications to construct secure SOAP message exchanges. It also provides a means for associating security tokens with messages.
See Integration Broker Administration: Implementing Web Services Security.
Error and Service Operation Logging
Most components in the system use a standard error logging interface.
Each PeopleSoft-delivered connector uses the logging API in the same fashion, ensuring that an administrator can quickly drill down on problems or simply review the logs to see the IBRequest object, the IBResponse object, and even the raw data exchanged with integration participants.
See Understanding Error Handling, Logging, Tracing and Debugging.
Error Handling
The integration gateway provides a standard error handling interface that is exposed to each connector. This service provides error handling and error logging for most connectors delivered with PeopleSoft Integration Broker.
Message Validation
Messages that pass into PeopleSoft Integration Broker must contain certain elements to be processed. Because the integration gateway is the first component that processes messages sent to a PeopleSoft application, it performs basic validation—such as making sure that the message identifies its requestor and service operation name—to ensure that the integration engine and the target application can process them.