Search Results add_cx_button

Overview

APPS.CZ_UIOA_PVT is a private PL/SQL package belonging to the Oracle E-Business Suite product family commonly associated with Oracle Configurator and its user interface modeling extensions (the CZ schema prefix). In Oracle EBS 12.1.1 and 12.2.2 this package operates as a backend utility layer that manages UI object administration (UIOA) tasks — the creation, duplication, refresh, and deletion of user interface pages, subtrees, templates, and their associated elements. It acts as the engine beneath the public-facing model and developer utilities APIs, providing the low-level manipulation of UI metadata that Configurator runtime and design-time components depend upon. Because its API classification is PVT, the package is not intended for direct customer invocation; it is called by higher-level packages such as CZ_MODELOPERATIONS_PUB and CZ_DEVELOPER_UTILS_PVT.

Key Procedures and Functions

The package exposes 27 documented procedures and functions. The principal groups are:

• UI lifecycle: CREATE_UI, REFRESH_UI, and REFRESH_UI_SUBTREE generate or rebuild UI definitions and their descendant nodes.
• Page operations: CREATE_UI_PAGE, DELETE_UI_PAGE, DELETE_UI_PAGE_REF, and COPY_UI_PAGE manage individual UI pages and page references.
• Subtree operations: DELETE_UI_SUBTREE and COPY_UI_SUBTREE handle hierarchical UI structures as single units.
• Template operations: DELETE_LOCAL_TEMPLATE, DELETE_LOCAL_TEMPLATE_ELEM, COPY_LOCAL_TEMPLATE, COPY_LOCAL_TEMPLATE_ELEM, and CONVERT_TEMPLATE_REFERENCE manage locally defined UI templates and their element-level content.
• Document handling: PARSE_JRAD_DOCUMENT, SAVE_DOCUMENT, and COPY_JRAD_DOCUMENT deal with JRAD document ingestion, persistence, and duplication.
• Component helpers: CREATE_REGION_FROM_TEMPLATE and ADD_CX_BUTTON instantiate UI regions and Configurator extension buttons.

Together these routines provide the CRUD and copy semantics for the Configurator UI model, and are invoked as building blocks rather than being exposed directly to end users.

Tables Accessed

The package reads and writes a set of CZ_ tables through APPS synonyms:

• CZ_UI_PAGE_ELEMENTS — element-level definitions of UI pages.
• XMLDOM — XML DOM storage used during JRAD parsing and document saving.
• CZ_UI_ACTIONS / CZ_UI_ACTIONS_S — UI action definitions and their translations.
• CZ_UI_CONT_TYPE_TEMPLS — content-type to template mappings.
• CZ_LOCALIZED_TEXTS, CZ_INTL_TEXTS, CZ_INTL_TEXTS_S — internationalized and localized label text.
• CZ_EXPRESSION_NODES, CZ_RULES — expression and rule nodes tied to UI behavior.
• CZ_PS_NODES — product structure nodes associated with UI pages.
• CZ_MODEL_PUBLICATIONS, CZ_MODEL_REF_EXPLS — model publication records and reference expressions.
• CZ_DEVL_PROJECTS, CZ_DB_LOGS — developer project context and diagnostic logging.

It also references the view CZ_UITEMPLS_FOR_PSNODES_V to resolve templates applicable to product structure nodes.

Usage Notes

CZ_UIOA_PVT is never invoked directly from Oracle Forms or concurrent programs. It is reachable only through APPS.CZ_MODELOPERATIONS_PUB and APPS.CZ_DEVELOPER_UTILS_PVT, which call it during Configurator model publication, UI editing, and developer utility operations in both 12.1.1 and 12.2.2. Customizations should call the public CZ_MODELOPERATIONS_PUB entry points rather than the private package, because the internal procedure signatures and behavior are not part of the supported API surface and may change without notice. The package depends on PUBLIC.XMLDOM and SYS.STANDARD and must be installed in the APPS schema where the CZ synonyms are valid.