Loading.....

Definition

To read a single Employee Leave Request by ID.

Business Context and Use

Examples of the use of this operation include the following situations:

• An employee has sent a leave request to his or her approver for approval. After some time the employee is unsure whether the data he or she sent is correct. The employee decides to check the leave request and correct the data if necessary.

• An employee's leave request was rejected by his or her approver. You or the employee want to view the request for information purposes.
• You want to provide time administrators with all versions of a leave request to assist them in resolving errors by tracking changes.

Related Operations

The following operations provide similar functions to Read Employee Leave Request :

• Find Employee Leave Request by Participant
  This operation lists employee leave requests in their most recent version
• Find Leave Employee Time for Employee by Employee In cases where the leave request has already been approved, posted, and converted into an employee time (absence) this operation can be used

Features

The Read Employee Leave Request inbound operation reads specified versions of an employee leave request with a specified ID.

This means that you can obtain all versions of an employee leave request that have ever existed by using this operation. Details for each employee leave request version include the following:

• Leave type and category
• Leave timeframe
• Terms specifying conditions for the time evaluation of the planned absence
• Activity allocation and cost assignment information relevant for further processing (for example, work break-down structure information)
• Service provision and resource consumption information, such as cost center information, relevant for the accounting of resource consumption by personnel
• Information relevant to logistics, such as specific order information
• Information relevant to payroll processes, such as special hourly overtime rates
• Additional, customer-specific information (defined in Customizing)

• Owner and approver information.
• Any additional notes that have been added.
• Reference to an existing employee time (in other words, a posted leave request, or 'absence'), if applicable.

• Information about the actions that can be performed on the leave request. (Note that actions can be restricted by the life cycle status of the request.) For more information, see the Employee Leave Request Configuration business object documentation.

Error Handling

• If no data is determined for an existing employee leave request, check that the data record does not have a time limit that is expired at the key date. If you have entered the IDs of both the employee and the work agreement, and no data is found, check that the work agreement belongs to the employee. You can use the Find Work Agreement by Elements inbound operation to determine the work agreements of an employee.
• If no data is found for a leave request, check whether the record has been archived.

Prerequisites

The employee for which the information is to be read must be active for the given key-date.

Constraints

The system uses the system user to determine the requester of the query. It then checks whether the requester is the owner or the approver of the request. If the requester is neither the owner or the approver, the system issues an error message.

Notes on SAP Implementation

Configuration

Refer to the configuration described in the Employee Leave Request business object documentation.

ES Bundles

This operation is contained in the following ES Bundles:

• HCM Time Management
• Resource and Supply Chain Planning for Healthcare Providers