uc-apx edit page-item
Edit an existing pageItem <ID> ( ... ) on a page. Common rewrites:
- relabel an item (—label);
- switch a text field to a select list backed by an LOV (—type + —lov);
- add a PL/SQL function-body default (—default-plsql);
- mark an item required (—required) or read-only (—readonly);
- set or remove help text (—help-text).
Each flag corresponds to a single property or block. Combine flags to apply multiple changes in one shot; the item is re-parsed after the edits to fail-fast on a broken splice.
uc-apx edit page-item [flags]| Flag | Type | Default | Description |
|---|---|---|---|
--default-plsql | Set default.type: functionBody + plsqlFunctionBody: <body>. Body is wrapped in a `plsql code block. Accepts @path/to/file.plsql to read from disk; @@ escapes a literal leading @. | ||
--default-static | string | Set default.type: static + staticValue: <value>. | |
--dry-run | Print the rewritten file content to stdout without writing | ||
--help-text | string | Set help.helpText to this text. Pass an empty string (—help-text "") to remove the help block. | |
--item | string | Page item ID to edit (e.g. P7_CUSTOMER_NAME) [required] | |
--label | string | Rewrite label.label to this text. | |
--lov | string | Set lov.type: sharedComponent + lov: @<alias>. Strip a leading @ if present. | |
--lov-sql | string | Set lov.type: sqlQuery with the given SELECT (must return (display, return) pairs). Accepts @path/to/file.sql to read from disk; @@ escapes a literal leading @. | |
--lov-static | string | Set lov.type: staticValues with entries “Display1;Return1,Display2;Return2”. | |
--null-display-value | string | Set lov.nullDisplayValue. Only meaningful when the item uses an LOV. | |
--page | string | Target page (numeric ID, alias, or name) [required] | |
--readonly | Add readOnly { type: always } so end-users cannot edit the item. | ||
--required | Set validation.valueRequired: true. Pass —required=false to remove the property (tri-state: omitting the flag leaves valueRequired unchanged). | ||
--type | type: | Rewrite top type: property. Accepts kebab-case (text-field, select-list, radio-group, popup-lov, date-picker, number-field, display-only, hidden, textarea, switch, checkbox, checkbox-group, password, …) or the raw apexlang token. |
Global Flags
Section titled “Global Flags”| Flag | Type | Default | Description |
|---|---|---|---|
--app-dir | string | . | Path to the APEX application directory |
--json-pretty | Output in pretty-printed JSON (human-readable) instead of minified JSON | ||
--toon | Output in TOON format (human-readable, token-efficient) instead of JSON |
Examples (from help)
Section titled “Examples (from help)”uc-apx edit page-item --page 7 --item P7_CUSTOMER_NAME \ --label "Customer Full Name" --required
uc-apx edit page-item --page 7 --item P7_COUNTRY_CODE \ --type select-list --lov @countries-lov \ --null-display-value '- Select Country -'
uc-apx edit page-item --page 7 --item P7_NOTE \ --help-text "Enter any additional notes."