PROCESIO
OverviewPlatform ActionsIntegrations & DemosCustom ActionsDeveloperโ€™s Guide

Approval

The Approval element is a purpose-built control for formalizing review decisions within Procesio Forms. It presents the reviewer with a clear Approveโ€ฆ

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 NameDescriptionTypeDefaultNotes
labelDisplay label above the approval controlstringโ€”โ€”
tooltipHelp text shown alongside the labelstringโ€”โ€”
descriptionInstructional text for the reviewerstringโ€”โ€”
infotextSupplementary info displayed below the elementstringโ€”โ€”
visibleControls element visibilitybooleantrueโ€”
commentThe reviewer's written comment โ€” readable at runtimestringโ€”โ€”
responsedateTimestamp of when the decision was madestring|date|nullโ€”โ€”
responseuserThe user who made the decision (id, name, email)object|nullโ€”โ€”
responseThe decision outcome โ€” Approve or Rejectstring|nullโ€”approve, reject
nameUnique element namestringโ€”โ€”
idUnique element IDstringโ€”โ€”
iscommentrequiredonapproveForces a comment when approvingbooleanfalseโ€”
iscommentrequiredonrejectForces a comment when rejectingbooleanfalseโ€”

For support, please join our Discord community for further assistance and support.

On this page