Forms & Tasks Designerπ π§¨
Elements
Approval
3 min
the approval element is a purpose built control for formalizing review decisions within procesio forms it presents the reviewer with a clear approve / reject action pair and optionally requires them to leave a comment before their decision is recorded β enforcing accountability and audit readiness in approval workflows unlike a generic button or radio button, the approval element captures rich metadata alongside the decision the reviewer's user object (responseuser), the timestamp of the decision (responsedate), their written comment (comment), and the outcome itself (response) all of this data is part of the element's data model and flows directly into your process for downstream actions such as notifications, escalations, or document generation comment requirements can be made conditional per outcome β you can require a justification on rejection but make it optional on approval, or vice versa, giving you fine grained control over the governance policy your workflow enforces key use cases β’ document, purchase order, or leave request approval workflows β’ multi level approval chains where each reviewer's response is captured and stored β’ requiring a written reason for rejection (iscommentrequiredonreject true) for compliance β’ reading responseuser and responsedate at runtime to stamp a document or send a notification β’ pre filling the description with context sensitive instructions based on the record being reviewed runtime api β attributes in procesio forms all attributes below are accessible and modifiable at runtime via the element's data model in procesio forms β on any available event such as onload, onchange, or custom triggers api name description type default notes label display label above the approval control string β β tooltip help text shown alongside the label string β β description instructional text for the reviewer string β β infotext supplementary info displayed below the element string β β visible controls element visibility boolean true β comment the reviewer's written comment β readable at runtime string β β responsedate timestamp of when the decision was made string|date|null β β responseuser the user who made the decision (id, name, email) object|null β β response the decision outcome β approve or reject string|null β approve, reject name unique element name string β β id unique element id string β β iscommentrequiredonapprove forces a comment when approving boolean false β iscommentrequiredonreject forces a comment when rejecting boolean false β for support, please join our https //discord com/invite/cebukgjefv for further assistance and support
