james.maes
ebc77b939c
* fix(template): complete QQQ 4.0 application migration * fix(ci): avoid interactive package restart prompts * docs: align guides and examples with QQQ 4.0 * docs(release): finalize QQQ 4.0 template instructions Refs QRun-IO/qqq#631.
1.2 KiB
Processes
Start with ExampleProcessMetaDataProducer and ExampleProcessStep. The producer defines the process, its table, inputs, and backend step; the step transforms PENDING records to PROCESSED and returns them in the output.
In QQQ 4.0, import MetaDataProducerInterface from com.kingsrook.qqq.backend.core.model.metadata. Define process inputs through withInputMetaData(new QFunctionInputMetaData().withField(...)). An AbstractTransformStep must implement both runOnePage(RunBackendStepInput, RunBackendStepOutput) and getProcessSummary(RunBackendStepOutput, boolean); keep the example's implementations when renaming it.
To make the process discoverable in navigation, add its registered name to a QAppSection through withProcesses(List.of(ExampleProcessMetaDataProducer.NAME)), then include the section in a QAppMetaData registered with qInstance.addApp(...). Use the actual registered name if you introduce a prefix. Add tests for record changes and failure cases when replacing the example business logic.