Sending and Receiving PeopleCode

This section discusses the PeopleCode you use for sending messages from PeopleSoft Integration Broker to other systems, and the PeopleCode you use for receiving messages from other systems.

Sending PeopleCode

PeopleCode for sending messages can be located in PeopleCode events associated with records, record fields, and components, and in application engine programs.

The PeopleCode method used to send messages is highlighted in the following table.

Transmission Type	Sending PeopleCode	Comments
Synchronous	SyncRequest method.	The SyncRequest method belongs to the IntBroker class.
Asynchronous	Publish method.	The Publish method belongs to the IntBroker class.

To work with rowset-based messages in SOAP format, transform the SOAP documents into XML documents and then use the IntBroker class SyncRequest or Publish methods. To work with nonrowset-based messages in SOAP format use the SOAPDoc class.

Receiving PeopleCode

The PeopleCode that you use to receive a message must be associated with the message definition. The transmission type of the message determines the location of the PeopleCode program.

Implement the OnRequest method for synchronous messages. Implement the OnNotify method for asynchronous messages. Both methods are located in the PS_PT application package, in the Integration sub-package, in the IRequestHandler and INotificationHandler classes, respectively.

Transmission Type	Message Structure	Receiving PeopleCode	Comments
Synchronous	Rowset-based	Message is passed into the method.	Implement the OnRequest method in the IRequestHandler application interface.
Synchronous	Nonrowset-based	Message is passed into the method.	Implement the OnRequest method in the IRequestHandler application interface.
Asynchronous	Rowset-based	Message is passed into the method.	Implement the OnNotify method in the INotificationHandler application interface.
Asynchronous	Nonrowset-based	Message is passed into the method.	Implement the OnNotify method in the INotificationHandler application interface.

To get content data out of a request message, use the following guidelines.

Message Structure	PeopleCode	Comments
Rowset-based	GetRowSet method.	None.
Nonrowset-based	GetXMLDoc method.	You can also use Message class functionality with nonrowset-based messages. See Using Message Object Functionality With Nonrowset-Based Messages.