Search Results hxc_approval_report_pkg




Overview

APPS.HXC_APPROVAL_REPORT_PKG is a PL/SQL package body in the Oracle E-Business Suite APPS schema that supports the Time and Labor (HXC) approval reporting infrastructure. It functions primarily as a code-generation and data-retrieval utility used by the Oracle Time and Labor self-service timecard approval workflow and associated approval reports. In Oracle EBS 12.1.1 and 12.2.2, this package concentrates on resolving the many foreign-key references embedded within timecard and time-building-block records into human-readable descriptive values, so that approval reports and approval notification pages can present meaningful information to managers and approvers rather than internal identifiers.

Because the package is defined in the APPS schema and references public synonyms, it is intended to be invoked from within the Oracle Time and Labor application pages, concurrent report programs, and workflow notification generation. The package is documented in ETRM as having an API classification of OTHER, meaning it is not a formally published public API but an internal supporting package used by the Time and Labor approval reporting layer.

Key Procedures and Functions

ETRM documents eleven documented procedures/functions within this package. Each is a lookup-oriented routine that returns a descriptive name for a stored identifier:

  • GET_EMPLOYEE_NAME — returns the formatted name of the employee associated with a timecard or approval record, resolving against the person/assignment tables.
  • GET_LAST_APRV — returns the last approver associated with an approval record, identifying the most recent approver in the approval chain.
  • GET_PROJECT_NAME — returns the descriptive name of a project referenced by a time or project-related attribute, resolved against the online projects view.
  • GET_TASK_NAME — returns the descriptive name of a project task, resolved against the online tasks view.
  • GET_ELEMENT_NAME — returns the name of a payroll element type referenced by a time attribute or building block.
  • GET_APPLICATION_NAME — returns the translated application name from the application views, typically used to describe the source application of a time attribute.
  • GET_SUPERVISOR_NAME — returns the name of the supervisor associated with an employee or approval record.
  • GET_ORGANIZATION_NAME — returns the descriptive name of an organization unit referenced in the time data.
  • GET_COST_CENTER — returns the cost center / cost allocation key flexflex description associated with a time attribute or building block.
  • GET_PAYROLL_NAME — returns the descriptive name of a payroll referenced by an attribute or element, resolved against the payroll definitions.
  • GET_BUSINESS_GROUP_NAME — returns the business group name associated with a person, assignment, or attribute record.

Tables Accessed

The package reads from the following documented tables (typically through APPS synonyms):

Usage Notes

HXC_APPROVAL_REPORT_PKG is not referenced by any other database object and is not a published API, which indicates it is invoked directly by Oracle Time and Labor approval reporting mechanisms — most likely the Time and Labor approval report concurrent program and the self-service approval notification pages. In 12.1.1 and 12.2.2 the calling context is the timecard approval workflow, where descriptive lookups are needed to render readable approval summaries.

Because the package is undocumented as a public API and its status is VALID but internal, customizations should avoid calling its routines directly; instead, developers requiring similar lookups should build their own queries against the underlying tables to avoid dependency on an object Oracle may change between releases. Any custom report that mimics approval report output should treat the documented procedure list as a functional catalog rather than a stable integration interface.