OutSystems Troubleshooting Guide
Troubleshooting steps and solutions for common problems
Form related questions
Problem description: After submitting the form, the data just submitted cannot be found in the data management, or the data is incompletely displayed.
- Check the data permission settings: Confirm whether the current account has permission to view data (Administrator → Data Permissions)
- Check the filter conditions: The data management page may have filter conditions set, click "Clear Filter" to view all data
- Check the process status: If the form is bound to a process, the data may be under approval. Check the [Pending Approval] list
- Refresh the page or clear the browser cache and log in to OutSystems again
Problem description:Some fields cannot be entered, or the fields are displayed in disordered positions or in abnormal styles.
- Check field permissions: In the form designer, check whether the field's editing permissions are restricted to a specific role
- Check the field formula: If the field is set with formula calculation, it may result in read-only, check the formula logic
- Check the data linkage rules: some fields may depend on the values of other fields, fill in the dependent fields first
- Abnormal display on the mobile terminal: Check the form layout settings to ensure that the mobile terminal is adapted correctly
Problem description: Multiple rows of data added to the subform (details table) are lost after being saved, or the summary calculation results are incorrect.
- Check whether the subform field is required but not filled in, causing the save to fail.
- Check whether the field reference path in the formula is correct (subform fields need to use aggregate functions such as SUM)
- The confirmation subform supports up to 200 rows of data. Exceeding the limit will cause the save to fail.
- Subform summary formula example:
SUM(子表单.金额字段)
Process related issues
Problem description:The process is not triggered after submitting the form, or the approval process stops at a certain node and cannot continue.
- Check if the process has been published: In the process designer, confirm that the process status is "Published"
- Check the approver settings: Confirm whether the approver of the approval node is configured correctly (cannot be empty or employees who have resigned)
- Check conditional branches: If conditional branches are used, check whether the conditional logic matches correctly
- View process log: Click "Process Log" on the data details page to view transfer records and error messages
- Administrator rights can manually transfer tasks to other approvers.
Problem description: After the process was initiated, the approver did not receive the approval notification message in DingTalk.
- Check DingTalk message settings: Turn on OutSystems message reminder in DingTalk [Settings] → [New Message Notification]
- Check the OutSystems application permissions: Confirm that the OutSystems application has been added to the workbench and has message push permissions
- Check the approver's DingTalk account: Confirm that the approver is using an enterprise DingTalk account and it has been activated
- Manually refresh the DingTalk to-do list: Click the OutSystems application on the DingTalk workbench to manually refresh the to-do list.
Permission related issues
Problem description:When opening the OutSystems application, it prompts "No permission", or some forms and data cannot be seen.
- Check application members: The administrator adds users as application members in [Application Management] → [Member Management]
- Check role permissions: Confirm whether the user's role has access permissions to the form
- Check data permissions: Set the data range that users can view in [Data Permissions] (all/department/person)
- Contact the administrator to assign permissions, or apply to join the application permission group
Problem description: can view the data list, but the button cannot be edited or deleted after clicking the data. The button is gray.
- Check field permissions: In the form designer, check the field's edit permission settings
- Check data operation permissions: The administrator sets edit/delete permissions in [Data Permissions]
- Data in the process: Data under approval is usually not allowed to be edited and needs to wait for the end of the process
- Archived data: Archived data is read-only by default and requires administrator rights to modify.
Performance optimization issues
Problem description: loads very slowly when opening a form or querying data, or even a timeout error occurs.
- Reduce the number of form fields: Exceeding 50 fields will affect performance and split into multiple forms
- Optimize data association: avoid multi-level data association (up to 3 levels) and reduce the number of associated fields
- Use data filtering: Set default filtering conditions in data management to reduce the amount of query data
- Regularly archive historical data: archive data older than 3 months to reduce the amount of active data
- Avoid complex formulas: Split complex calculations into multiple simple formulas, or use automated rules
The problem is still not solved?
If you have tried the above methods and still cannot solve the problem, you can get help in the following ways: