uc-apx create dynamic-action run-js

Splice a dynamicAction with a single executeJsCode action.

Pick exactly one trigger: —trigger-button @<id> — event defaults to click —trigger-item @<id> — event defaults to change (omitted in when block) —trigger-region @<id> — event defaults to change (omitted in when block)

—code accepts inline JavaScript or @path/to/file.js to slurp from disk.

Usage

uc-apx create dynamic-action run-js [flags]

Flags

Flag	Type	Default	Description
--code	string		JavaScript body, or @path/to/file.js [required]
--dry-run			Print rendered dynamicAction to stdout without writing
--fire-on-init			Emit fireOnInit: true on the action execution block
--name	string		Display name (default: “Run JS on <trigger>“)
--page	string		Target page (numeric ID, alias, or name) [required]
--sequence	int		execution.sequence (default: max existing dynamicAction sequence + 10)
--trigger-button	string		Button id (selectionType: button, event: click)
--trigger-event	string		Override the trigger event
--trigger-item	string		Page item id (selectionType: items)
--trigger-region	string		Region id (selectionType: region)

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

Example Generated APEXlang

Using --dry-run to preview the generated construct (no files are written):

uc-apx --app-dir examples/brookstrut create dynamic-action run-js --page 46 --name Refresh Results --trigger-button @reset --code apex.region('sales-history').refresh(); --dry-run

Generated APEXlang

dynamicAction run-js-reset (
        name: Refresh Results
        execution {
            sequence: 20
        }
        when {
            event: click
            selectionType: button
            button: @reset
        }

        action native-javascript-code (
            action: executeJsCode
            settings {
                jsCode:
                    ```javascript-browser
                    apex.region('sales-history').refresh();
                    ```
            }
            execution {
                sequence: 10
                fireOnInit: false
            }
        )

    )