Contents
Contents

OnRequestSend Handlers

Struggling to bridge the legacy gap? Cedar Hills Group provides specialized PeopleSoft integration consulting to help teams design, build, and optimize their connection strategies.

The OnRequestSend handler executes on the publishing node before outbound message delivery or transformation takes place. In PeopleTools metadata, this handler type corresponds to Handler ID SEND and is labeled “On Send”.

It can be applied to both synchronous and asynchronous outbound service operations, allowing you to manipulate the message payload or dynamically override connector properties specific to the receiving node.

  • Types of Operations: Synchronous and Asynchronous
  • Direction: Outbound
  • Inputs: In-flight outbound Message object
  • Outputs: Modified Message object returned to Integration Broker for transport
  • Interface: PS_PT:Integration:ISend

Interface Definition

Handlers configured for OnRequestSend must implement PS_PT:Integration:ISend:

import PS_PT:Integration:ISend;

interface ISend
   method OnRequestSend(&message As Message) Returns Message;
   method OnError(&request As Message);
end-interface;

Common Use Cases

  • Connector Property Overrides: Dynamically changing HTTP target URLs, query parameters, proxy settings, or timeouts per outbound message.
  • Header and Security Token Injection: Calculating API HMAC signatures, OAuth bearer tokens, or custom HTTP headers based on message body content.
  • Payload Customization: Injecting timestamps, tracking UUIDs, or node-specific envelope attributes before gateway transmission or outbound XSLT transformation.

Implementation Example

import PS_PT:Integration:ISend;

class OutboundHttpSendHandler implements PS_PT:Integration:ISend
   method OnRequestSend(&Msg As Message) Returns Message;
   method OnError(&request As Message);
end-class;

method OnRequestSend
   /+ &Msg as Message +/
   /+ Returns Message +/
   /+ Extends/implements PS_PT:Integration:ISend.OnRequestSend +/

   /* Enable connector property overrides */
   &Msg.IBInfo.ConnectorOverride = True;
   
   /* Inject custom HTTP headers or override target parameters */
   Local array of string &propNames = CreateArray("Header", "Content-Type");
   Local array of string &propValues = CreateArray("X-Correlation-ID", %TransactionId);
   &Msg.IBInfo.IBConnectorInfo.AddConnectorProperties("Header", "X-Correlation-ID", %TransactionId);
   
   /* Optionally mutate the outbound XML / JSON payload */
   Local XmlDoc &xmlDoc = &Msg.GetXmlDoc();
   If &xmlDoc <> Null And &xmlDoc.DocumentElement <> Null Then
      &xmlDoc.DocumentElement.AddAttribute("publishedDttm", String(%Datetime));
      &Msg.SetXmlDoc(&xmlDoc);
   End-If;

   Return &Msg;
end-method;

method OnError
   /+ &request as Message +/
   /+ Extends/implements PS_PT:Integration:ISend.OnError +/
   
   /* Outbound send error handling / logging */
end-method;
psLens Platform
psLens Operations & Intelligence

Look up any record, field, page, or component, audit security, and monitor Integration Broker across every database — in seconds.

  • 30+ object types browsable
  • 16 real-time alert types
  • Read-only by design
  • No App Designer or SQL required
Learn More
psLens Platform
psLens Operations & Intelligence

A web console built for the PeopleSoft community — operational monitoring, security auditing, and metadata browsing in one tool.

  • Sub-second object search
  • Catch stuck IB messages before users do
  • Audit service permissions from one screen
  • Works in any browser
Learn More
psLens Platform
psLens Operations & Intelligence

On-demand security and operational reports for your PeopleSoft environment — no client install required.

  • 14 on-demand reports
  • Markdown export for AI/LLM workflows
  • No shared tenancy
  • Built on 25+ years of PeopleSoft expertise
Learn More
psLens Platform
psLens Operations & Intelligence

Research any PeopleSoft object and monitor system health from a single browser tab — no App Designer, no SQL.

  • 30+ PeopleSoft object types browsable
  • Real-time alerts before users report problems
  • Read-only and secure
  • Private alpha — early access now
Learn More
Author Profile
Chris Malek

Chris Malek is a PeopleTools® Technical Consultant with over two decades of experience. He is available for consulting engagements.

Work with Chris
Subscribe to Updates
SWS Bolt-On
PeopleSoft Simple Web Services

SWS turns SQL into production REST APIs — ready for AI, modern apps, and partner integrations. One install, unlimited potential.

  • Configuration-driven, no coding required
  • JSON, XML, and CSV output
  • Works across all PeopleSoft pillars
  • Built on 25+ years of PeopleSoft expertise
Read More & Purchase
SWS Bolt-On
PeopleSoft Simple Web Services

A powerful PeopleSoft bolt-on that makes REST web services easy. You bring the SQL, SWS handles the rest.

  • Go from idea to production in minutes
  • Zero code migrations after install
  • JSON, XML, and CSV output supported
  • No PeopleCode or Integration Broker expertise required
Read More & Purchase
SWS Bolt-On
PeopleSoft Simple Web Services

Traditional PeopleSoft web services cost $3,600–$13,000 each to develop. SWS deploys production REST APIs in under 5 minutes through configuration alone.

  • No PeopleCode or Integration Broker expertise required
  • Works across Campus Solutions, HCM, and Financials
  • Built-in pagination, caching, and nested data structures
  • Trusted by institutions across higher education and government
Read More & Purchase
SWS Bolt-On
PeopleSoft Simple Web Services

Turn PeopleSoft data into clean REST APIs for AI integrations, modern applications, and vendor data feeds. Configuration-driven — no PeopleCode required.

  • Deploy production APIs in under 5 minutes
  • AI and LLM ready (RAG, chatbots, intelligent search)
  • JSON, XML, and CSV output
  • Zero modifications to delivered PeopleSoft objects
Read More & Purchase