Search Results yes_flag




Overview

APPS.CZ_UI_GENERATOR is a configuration engine package body belonging to the Oracle E-Business Suite Configure-to-Order (CTO) module, delivered with the Oracle Configurator / ETRM (Enterprise Territory and Rules Management) toolset. Its principal business function is the programmatic construction and maintenance of the user interface node hierarchy that represents a configured model. The package translates the structural definition of a configuration model — stored across the CZ_PS_NODES property structure tables, CZ_UI_NODES, and related internationalization tables — into the runtime user interface tree presented to end users during a Configurator session. In Oracle EBS 12.1.1 and 12.2.2, this package is a core component of the Configurator runtime, invoked when a model is compiled, published, or refreshed. The excerpt provided from the package source reveals the internal record types used to carry UI node data: UIStructure, featureStructure, optionStructure, and refBOMStructure. Each record type mirrors the columns of CZ_UI_NODES and CZ_PS_NODES, including identifiers, caption text, sequence, minimum/maximum cardinality, reference identifiers, and flags such as ui_omit, virtual_flag, counted_options_flag, and atp_flag. The atp_flag members are Boolean fields indicating Available-to-Promise handling at the option and feature level, while the virtual_flag distinguishes virtual nodes from concrete ones.

Key Procedures and Functions

The package exposes six documented entry points, split between uppercase legacy aliases and mixed-case implementations.

  • CREATEUI / CREATE_UI — Builds the complete UI node hierarchy for a configuration model. CREATEUI is the legacy wrapper; CREATE_UI performs the actual generation, walking the PS node structure and inserting corresponding records into CZ_UI_NODES.
  • REFRESHUI / REFRESH_UI — Regenerates or synchronizes an existing UI hierarchy after the underlying model structure, labels, or properties have changed. REFRESHUI is the legacy alias for REFRESH_UI.
  • CLONE_IT — Duplicates an existing UI node structure, typically to support model versioning or copying a model definition into a new development project.
  • UPDATE_LABELS — Refreshes caption and localization text associated with UI nodes, reading from CZ_INTL_TEXTS and CZ_LOCALIZED_TEXTS and propagating the resolved text_str values into the UI structure. This is the procedure most relevant when searching for text-related flags during UI label troubleshooting.

Tables Accessed

All tables are addressed through APPS synonyms. The package reads and writes CZ_PS_NODES (the core property-structure node definition, including parent_id, tree_seq, maximum, minimum, and the various flags), CZ_UI_NODES (the generated UI hierarchy), and CZ_INTL_TEXTS / CZ_INTL_TEXTS_S for captions and localized text. It consults CZ_PROPERTIES, CZ_PS_PROP_VALS, and CZ_MODEL_REF_EXPLS to resolve property values and reference expressions. Model and project context come from CZ_DEVL_PROJECTS. Item-related validation draws on CZ_ITEM_MASTERS, CZ_ITEM_PROPERTY_VALUES, and CZ_ITEM_TYPE_PROPERTIES. CZ_EXPRESSION_NODES and CZ_FUNC_COMP_SPECS support expression and functional compatibility handling. CZ_LOCALIZED_TEXTS provides localized caption strings, while CZ_DB_SETTINGS and CZ_DB_LOGS supply configuration parameters and diagnostic logging, respectively.

Usage Notes

CZ_UI_GENERATOR is normally invoked indirectly by the Oracle Configurator UI engine rather than being called directly by end users. It is triggered during model publication and compilation in the Configurator Developer, and during runtime refresh when a configuration session detects stale UI definitions. Because the documented API classification is OTHER, it is not published as a supported public API; custom code should avoid direct invocation. The two packages that reference it in the documented metadata perform the surrounding orchestration. When debugging a missing UI element, the ui_omit and virtual_flag columns of CZ_PS_NODES should be inspected first, since these flags suppress nodes from generation; text-related resolution questions such as "yes_flag" behaviour are typically handled through UPDATE_LABELS and the CZ_INTL_TEXTS / CZ_LOCALIZED_TEXTS tables.