Search Results process_api

Overview

The APPS.HR_PER_DEPLYMT_EIT_SWI package body is a Surrogate Wrapper Interface (SWI) shipped with Oracle E-Business Suite Human Resources. It sits between the public HR_PER_DEPLYMT_EIT_API business interface and the underlying DML logic for the person deployment Extra Information Type (EIT) entity. Person deployment EITs store additional, flexfield-defined deployment attributes for an employee, and this wrapper enforces the standard EBS API conventions: validation control via hr_api.g_false_num, surrogate key registration, multi-message detection, and savepoint/rollback handling.

The package header comment (hrpdeswi.pkb 120.1, dated 2012/01/20) identifies it as a generated wrapper consistent with the Oracle HRMS API architecture used in both 12.1.1 and 12.2.2. Its ETRM classification is OTHER, meaning it is a supporting internal interface rather than a standalone public API.

Key Procedures and Functions

• CREATE_PER_DEPLYMT_EIT — Creates a person deployment EIT record. The documented excerpt shows it accepts a validation flag, the parent p_person_deployment_id, the p_person_extra_info_id identifying the EIT definition, and the surrogate p_per_deplymt_eit_id, returning an object version number and a return status. Internally it converts the constant validation value to boolean, calls hr_pde_ins.set_base_key_value to register the surrogate ID, then delegates to hr_per_deplymt_eit_api.create_per_deplymt_eit.
• DELETE_PER_DEPLYMT_EIT — Removes an existing person deployment EIT record, applying the same wrapper pattern: savepoint issuance, multi-message enablement, surrogate key registration, and delegation to the corresponding hr_per_deplymt_eit_api delete routine.
• PROCESS_API — The generic SWI entry point used by the HRMS surrogate wrapper framework to dispatch a requested DML action (create, update, or delete) against the person deployment EIT entity. It centralizes the object version number and return status handling required by the Dataloader and other generic callers.

All three procedures follow the standard wrapper sequence: enable hr_multi_message, issue a savepoint, set the base key value, invoke the underlying API, and propagate validation errors back to the caller.

Tables Accessed

ETRM documents two referenced objects via APPS synonyms: XMLDOM and XMLPARSER. These are Oracle XML Developer's Kit (XDK) PL/SQL packages rather than HRMS tables, and their presence indicates that the wrapper, or the underlying API it calls, performs XML parsing — typically for validating or transforming flexfield EIT content before it is persisted. Actual DML against the person deployment EIT entity is performed by HR_PER_DEPLYMT_EIT_API, not by this wrapper; the base table (PER_DEPLYMT_EITS and its _TL/_VL variants) is therefore touched indirectly through that API and through HR_PDE_INS surrogate key handling.

Usage Notes

• Invoked indirectly by the Person Deployment form and by the HRMS Dataloader (both the generic PROCESS_API path and named procedure calls).
• Custom concurrent programs and integrations that create or delete deployment EIT rows should call the public HR_PER_DEPLYMT_EIT_API rather than this SWI; the SWI is intended for Oracle-internal framework dispatch.
• Callers must initialize the HRMS environment (HR_UTILITY savepoints, message list) as the wrapper does, and handle the p_return_status value of HR_API.G_RET_STS_ERROR by inspecting HR_MULTI_MESSAGE.
• Because ETRM reports zero referencing packages, the SWI is a leaf dependency; in 12.2.2 the same signature applies, and no Online Patching–specific changes affect its callable interface.