Approval Components
Initiate application component
The initiate application component serves as the entry point for approval workflows, enabling users to submit approval requests based on form data models. It collects user input, launches approval processes, displays workflow progress, and supports data refresh operations with event-driven notifications.
Creating initiate application component
In the page visual editor, click Insert Component and drag the Initiate Application component onto the page. Configure its parameters in the right-side configuration panel.
Parameter configuration
When using the initiate application component, you must specify an approval workflow instance element.
In the visual editor, select the initiate application component to access its configuration panel. Choose the corresponding approval workflow instance element from the dropdown. You can also toggle whether to display approval workflow records.
Approval workflows must be created before adding initiate application components. For setup instructions, see Approval Workflows.
You can also create a workflow by clicking Create New General Approval in the dropdown menu.
The approval workflow records shown by the component are prediction data generated from the selected workflow configuration.
If workflow prediction is disabled, no approval records will be displayed.
After processing/refresh events
The initiate application component emits After Processing and After Refresh events to handle post-submission and post-refresh workflows.
The After Processing event fires upon successful application submission. Common use cases include closing dialogs and refreshing table data.
The After Refresh event fires when the component refreshes and must be paired with the component's refresh function.
For example, when configuring a table to open a dialog and refresh the initiate application component, the component's After Refresh event will trigger accordingly.
Approval processing component
The approval processing component is the core UI element for handling workflow approval tasks. Built on the workflow engine, it loads pending tasks, displays approval history, manages task status, and processes user approval actions.
Creating approval processing component
In the page visual editor, click Insert Component and drag the Approval Processing component onto the page. Configure its parameters in the right-side configuration panel.
Parameter configuration
The approval processing component also requires an approval workflow instance element. Beyond selecting the workflow, you can configure whether to display the workflow visualization and whether to retain historical approval records.
Retaining historical approval records
Initiators can withdraw and re-submit approval requests. When Retain Historical Approval Records is enabled, these withdrawal and re-submission actions are preserved in the audit trail. When disabled, they are not recorded.
Approval workflows must be created before adding approval processing components. For setup instructions, see Approval Workflows.
Approval components cannot be previewed in the development environment—they must be tested in the runtime environment.
If the current user has no pending approvals, the component displays "No pending approval items currently available."
When Display Approval Workflow is disabled, workflow records are hidden regardless of the Retain Historical Approval Records setting.
If workflow prediction is disabled, the component only displays approval records that have already been processed.
The approval processing component requires a data source to function. Without one, the component will not operate.
As shown above, when combining tables with approval processing components, configure the data source in the table's event handlers.
After processing/refresh events
The approval processing component emits After Processing and After Refresh events to handle post-approval and post-refresh workflows.
The After Processing event fires upon completing an approval action. Common use cases include closing dialogs and refreshing table data.
The After Refresh event fires when the component refreshes and must be paired with the component's refresh function.