FAQ
What APEX version do I need?
Section titled “What APEX version do I need?”APEXlang is the native text export format introduced in Oracle APEX 26.1. Earlier APEX versions use .sql-based exports which uc-apx does not parse.
Do I need Go installed to use uc-apx?
Section titled “Do I need Go installed to use uc-apx?”No. uc-apx is distributed as a single static binary. You only need Go if you want to build from source.
Do I need SQLcl?
Section titled “Do I need SQLcl?”Only for validate --official. All read commands and scaffolding commands work without SQLcl. The --official flag wraps SQLcl’s apex validate which requires SQLcl 26.1.2+.
Can I use uc-apx with Docker / CI?
Section titled “Can I use uc-apx with Docker / CI?”Yes. Download the binary for your CI platform’s architecture and drop it on the PATH. No other dependencies needed (except SQLcl if you run validate --official).
What does “broken reference” mean in validate output?
Section titled “What does “broken reference” mean in validate output?”A broken reference means a construct contains @someName or @APEX$NNN that doesn’t resolve to any parsed construct in the app. Common causes:
- The reference targets a built-in theme component (
@/standard) — these are skipped by default. Pass--strict-system-refsto include them. - The referenced component was deleted but the reference wasn’t cleaned up.
- A typo in the reference name.
How does uc-apx differ from apex validate?
Section titled “How does uc-apx differ from apex validate?”uc-apx validate (local) does quick structural checks: broken references, duplicate IDs, missing names, empty pages. It’s fast but doesn’t know the full MMD schema — it can’t catch invalid property names or wrong value types. apex validate (via --official) is Oracle’s authoritative validator and is the source of truth.
Can I pipe uc-apx output to jq?
Section titled “Can I pipe uc-apx output to jq?”Yes. Every command supports --json. Example:
uc-apx pages --json | jq '.pages[] | select(.name | test("Emp"))'Does uc-apx modify my app files?
Section titled “Does uc-apx modify my app files?”Read commands (overview, pages, page, tree, search, lov, refs, component, list, deps, schema, validate) are read-only. Write commands (create, edit, delete) modify .apx files. All write commands reparse after writing and roll back to the original if the result doesn’t parse cleanly.
Where do I get help?
Section titled “Where do I get help?”See Support: community help via GitHub issues, plus enterprise support, training, and consulting from United Codes.