SAP Knowledge Base Article - Preview

3366733 - Time Off Request (TOR) Scripts


There is a script based API that gives the ability to read from, create, and edit time off requests.

Requirements Gathering and System Design

It is possible to have a script on a regular basis that reads and exports Time Off Requests (TORs) or reads and imports TORs. It is not recommended to have a script that updates existing TORs due to potential difficulties with matching existing TORs in the system after they have been created or already imported. The exception would be if a customer’s source system can accurately provide TOR ID values that are consistent for the same time off request.  


TOR scripts using the API run with the permissions of the user executing the script.
This means that likely you will need to create a special user for approving and managing TORs via a script and ensure that it has the correct permissions. To run the job as that user, you will need to use the JOB_QUEUE_API. Inside the API Guide there is an example of using the job queue API to run a job as another user. It would be a 2 stage process where your Job Queue script sets the user and runs your TOR API job.


Testing TORs is critical to ensuring the success of a custom written script. Test that the script imports and creates TORs that are the correct status and are viewable by the users and employees that are supposed to have access. If the script is editing or deleting TORs that should be tested too.

Go-Live and Support

A custom TOR script is conforming as long as it follows conforming rules using the TIME_OFF_REQUEST_API, but it should be noted to the Go Live Review Board and to the support handover documentation that this is in use in the instance.

There is an excellent API guide for the JavaScript TOR API. It can be found on the portal.



SAP Absence & Leave Management by Workforce Software (All versions)


KBA , XX-PART-WFR-ACT , SAP Absence & Leave Management (ACT) by Workforce Software , Problem

About this page

This is a preview of a SAP Knowledge Base Article. Click more to access the full version on SAP for Me (Login required).

Search for additional results

Visit SAP Support Portal's SAP Notes and KBA Search.