Contents
Contents
Synchronous Service Operation (non-REST)
The Synchronous service operation (non-REST) is one of the most common service operations types that has been implemented historically in PeopleSoft. In the future, you will likely see REST services take over as the most popular.
These service operations can be both inbound and outbound in direction. The inbound synchronous SOs are generally submitted to the HttpListeningConnector using the HTTP Post Method.
In this interaction model, a client sends a request message and it is handled in real-time and a response is generated. You use this type of service operation when the client needs a response to the request and it “waits on the wire” for a response. Some examples of this type are service might be in this form:
- Give me information on this employee ID.
- Update a person address and tell me that is succeeded.
- Create a new Person and tell me the new EMPLID created.
Here I am referring to providing a web service to an external system not PeopleSoft calling an external web service. This is referred to as an “inbound” operation.
There are a few types of handlers for synchronous inbound service operations.
- OnRequest (Inbound)
- This is the handler that replies to the inbound request. This is always implemented for an inbound SO.
- OnRouteReceive (Inbound)
- Optional handler for inbound. This is not often implemented but allows you to filter the message and stop it from processing.
For outbound synchronous service operations the available handlers are:
- OnRouteSend (outbound)
- Optional handler for outbound. This is not often implemented.
- OnRequestSend (PeopleBooks Calls this OnSend)
- Optional
An outbound SO is one where PeopleSoft is asking an external system for data over a web service.
Invoking an Inbound Synchronous Service Operation
To invoke a inbound synchronous SO on the HttpListeningConnector you always do an HTTP Post. The minimum HTTP signature without any security looks like this.
POST /PSIGW/HttpListeningConnector HTTP/1.1
Host: hcm-856.c.peoplesoftdemo-1470578694381.internal:8000
OperationName: CHG_SYNC_UTEST.v1We have no payload in this message and no authorization. The HTTP response would look something like this.
HTTP/1.1 200 OK
status: 200
date: Sun, 29 Oct 2017 16:21:07 GMT
content-length: 78
content-type: text/xml; charset=UTF-8
transactionid: 2b2e2d56-bcc5-11e7-8c89-f1fdee7c0e02
<?xml version="1.0"?>
<response>
<helloworld>greetings</helloworld>
</response>The transactionid header is the unique ID of the request that is logged in PeopleSoft.
Chris Malek
Chris Malek is a PeopleTools® Technical Consultant with over two decades of experience. He is available for consulting engagements.
Work with ChrisSubscribe to Updates
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
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
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
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
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
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
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
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