Author Info
Chris Malek

Chris Malek is a PeopleTools® Technical Consultant with two decades of experience working on PeopleSoft enterprise software projects. He is available for consulting engagements.

About Chris Work with Chris
PeopleSoft Simple Web Services (SWS)
Do you need a quick way to create web services?

Introducing a small but powerful PeopleSoft bolt-on that makes web services very easy. If you have a SQL statement, you can turn that into a web service in PeopleSoft in a few minutes.

Read More & Purchase

About Listening Connectors

What is a Listening Connector?

A listening connector is a servlet running on the integration gateway that handles requests from clients. They are used for services that PeopleSoft is providing to an external system. It surfaces itself to the client as a path in the URL. For example, the HttpListeningConnector is reached by posted to https://host:port/PSngConnector and the REST connector is reach by posting to https://host:port/PSIGW/RESTListeningConnector

They are responsible for accepting the request pulling out any header information or security information and passing it to the back end PeopleSoft layers. There are several delivered listening connectors and each one is used for a different purpose and has different ways to pass the request and parameters.

Here is a simplified schematic.

graph TB subgraph Peoplesoft Web Server HttpListeningConnector RESTListeningConnector PeopleSoftServiceListeningConnector end subgraph HTTP Client ClientCode-->|HTTP POST|HttpListeningConnector end subgraph REST Client ClientCode2-->|HTTP Method|RESTListeningConnector end subgraph Application Server HttpListeningConnector-->|MIME Encoded|AppServer RESTListeningConnector-->|MIME Encoded|AppServer AppServer-->Handler["Handler PeopleCode"] end

The 2 you should really focus on are the HttpListeningConnector and the RESTListeningConnector. If you have to use SOAP then look at PeopleSoftServiceListeningConnector.

We will go over each one in detail in the sections below.

Creating you own Listening Connector

If you have custom requirements to create your own listening connector you can see these links: