Understanding Worklist Entries from External Systems

The PeopleSoft PT_WORKLIST web service enables third-party systems to create and monitor PeopleSoft worklist entries using web services. This web service provides the capability for the Workflow application to receive a worklist entry from an external system for a task that is to be completed by a PeopleSoft Enterprise application. When the worklist entry is marked complete, the Workflow application returns a reply message to the external system.

The following scenario provides an overview for PeopleSoft Enterprise receiving an external worklist entry and sending a reply message to the originating third-party system when the worklist entry is marked Worked:

  1. A third-party system creates a worklist entry for a task that is internal to a PeopleSoft Enterprise application and invokes the PT_WORKLIST web service.

  2. PeopleSoft Integration Broker receives the web service request, returns an HTTP acknowledgement to the third-party system indicating receipt of the request, and sends the web service request to the Workflow application.

  3. The Workflow application receives the worklist entry request and generates the worklist item on the assigned user's worklist.

  4. The assigned user completes the task, and the worklist entry is marked as Worked.

  5. When the worklist entry is marked Worked, the Workflow application sends a reply message through the PeopleSoft Integration Broker to the originating system.

  6. PeopleSoft Integration Broker receives the web service reply, sends the reply to the third-party system that originated the worklist entry request, and tracks that the third-party system acknowledged receipt of the web service reply.

The PT_WORKLIST web service also provides the capability for the third-party system to track the status of the worklist entry before and after the entry is marked Worked.