Contents
Contents

Real-Time and Streaming: What Integration Broker Cannot Do

“Real-time integration” is a buzzword that gets thrown around in almost every architecture review.

To a modern web developer, it means WebSockets, Server-Sent Events (SSE), or long-lived streaming connections. To a PeopleSoft administrator, it usually means “how quickly can we complete this synchronous request/response transaction?”

PeopleSoft Integration Broker expects a standard, short HTTPS exchange: a request comes in, a response goes out, and the connection closes immediately.

If your design depends on holding connections open, streaming data incrementally, or pushing server-initiated messages to a browser, Integration Broker is the wrong tool.

Two of the four root constraints make real-time streaming impossible in IB:

  • Constraint #1: REST is Synchronous Request/Reply Only. There is no native mechanism to hold a response channel open, push updates to a connected client, or consume an active stream.
  • Constraint #3: HTTP/1.1-Era Transport. Connectors are built strictly around HTTP/1.1 semantics. There is no WebSocket upgrade path, no HTTP/2 multiplexing for server-initiated frames, and no HTTP/3.

Let’s examine why these real-time patterns fail in Integration Broker, and how to build clean workarounds at the edge.


WebSockets

WebSockets keep a persistent, bidirectional TCP connection open between the client and the server. This is the industry standard for chat applications, live monitoring dashboards, and real-time collaboration.

Why IB Cannot Serve WebSockets

The listening connector is designed to terminate the HTTP transaction as soon as the response is written. It has no upgrade handler, no way to retain the TCP socket, and no application thread model that would allow a service operation to stay alive across multiple asynchronous frame exchanges.

Why IB Cannot Consume WebSockets

The outbound target connector is strictly transactional: it opens an HTTPS connection, sends a request, reads the response, and closes the connection. It does not maintain socket state, and there is no event loop in PeopleCode to listen for and handle inbound WebSocket frames.

The Workaround

Put a lightweight proxy service (written in Go, Node.js, or Python) in front of PeopleSoft:

  • If PeopleSoft is the Data Source: The proxy service manages the persistent WebSocket connections to the end clients. When a change occurs in PeopleSoft, PeopleSoft makes a standard, rapid REST call to the proxy, which then fans the update out to the active WebSockets.
  • If PeopleSoft is the Data Sink: The proxy service connects to the external WebSocket feed. When an event of interest occurs, the proxy extracts the payload and sends it to PeopleSoft using standard REST/JSON or the staged-webhook pattern.

Server-Sent Events (SSE)

SSE is a lightweight, one-way streaming protocol. The server keeps an HTTP response open and writes data chunks with a text/event-stream Content-Type as events happen.

Why IB Cannot Serve SSE

An Integration Broker handler must build a response object and return it. The gateway then serializes it and closes the connection. There is no API in PeopleCode to flush a response buffer incrementally or hold a response open.

Even if you attempted to sleep in PeopleCode to delay returning, the web server or application server would hit a transaction timeout long before the client expects.

Why IB Cannot Consume SSE

The outbound target connector reads the response stream to completion before returning. The PeopleCode handler only sees the data as a single, massive string after the connection closes. If the upstream stream runs indefinitely, the PeopleCode call will hang until it times out.

The Workaround

Handle the stream externally. Let an edge service subscribe to the SSE stream, extract the events, and post them individually to PeopleSoft via standard REST.


HTTP Long Polling

In long polling, the client requests data, and the server intentionally delays responding until new data is available or a timeout occurs. Once the client receives a response, it immediately opens a new request.

Why IB Cannot Serve Long Polling

Long polling is a thread-killer for classic application servers. If you have 100 clients long polling, you must hold 100 active handler threads open.

PeopleSoft application servers have a fixed, relatively small pool of handler threads. Holding these threads open waiting for data shifts will quickly exhaust your server capacity, slowing down all other users and integrations.

The Workaround

If you are considering long polling, the actual requirement is usually “notify me when something changes.” Two better options:

  1. Outbound Webhooks: When the database change occurs, have PeopleSoft POST the update to a registered client URL.
  2. Sensible Polling: Have the client poll a standard REST service operation on a sensible interval (e.g., every 30 seconds or 5 minutes). Because Integration Broker processes standard, short request/reply cycles very quickly, this is highly efficient and rarely notices any functional delay.

Chunked Transfer and Streaming Responses

Under Transfer-Encoding: chunked, a server can start sending response body chunks before it knows the total payload size. This is common for large reporting datasets or streaming AI responses.

Why IB Buffers Everything

  • Outbound: Outbound REST responses must be fully assembled as a string or XML document in PeopleCode before the handler returns. You cannot stream blocks of data as they are generated.
  • Inbound: When PeopleSoft calls an external API that returns a chunked response, the Integration Gateway buffers the entire response in memory. It only passes the final, completed string to PeopleCode. For massive datasets, this buffering introduces significant latency and can cause Out of Memory (OOM) errors on the application server.

The Workaround

Keep response sizes small by using date-range filters or pagination. If you must process massive streams, let an edge service download, split, and batch the files into PeopleSoft incrementally.


HTTP/2 Server Push and WebPush

HTTP/2 server push allows a server to send resources to a client cache proactively. WebPush is the standard for pushing notifications to mobile devices and browsers.

Why IB Cannot Do It

Both require server-initiated push over persistent connections. Integration Broker only initiates outbound requests as a client; it cannot push to an unrequested client channel.

The Workaround

Run a dedicated notification service (like Firebase Cloud Messaging) externally, and have PeopleSoft call it via outbound REST when a notification needs to be sent.


What to Ask When the Requirement is “Real-Time”

When stakeholders insist on a streaming or real-time integration, ask these three questions to find out if you really need the extra infrastructure:

  1. What is the actual latency budget? Most dashboards and reporting databases are perfectly happy with a 5-second or 1-minute delay. Polling on a short interval is dramatically simpler than managing WebSockets.
  2. Is push actually required? Synchronous pull-with-cache is far more reliable and easier to debug than a push-with-fan-out topology.
  3. Is the trigger a user action? If the update is triggered by a user clicking a button, standard synchronous request/reply is all you need.

If the answer is still “we need sub-second, server-initiated streaming,” keep Integration Broker out of the hot path. Let a dedicated edge service terminate the connections, and use PeopleSoft solely as the transactional system of record behind it.


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