Link the Form to a UserTask and Start the Process

Oct 13, 2025 by magicalceylontours.com 146 views

Describe the Bug

In the SaaS environment, a critical issue arises when a reference to a document preview is added as an array. This seemingly minor modification causes the userTask to break, resulting in a blank task. The problem is not just limited to the task being blank; it also freezes, making it impossible for users to interact with it.

To Reproduce

To replicate this issue, follow these steps:

Create a Form with 'Document Preview': Begin by creating a new form in your SaaS environment. Ensure that the form includes a 'document preview' feature.
Enter an Array in 'Document Reference': Under the 'General' section, enter an array in the 'Document reference' field. For example, you can enter '[doc]'.
Link the Form to a UserTask and Start the Process: Link the form to a userTask and start the process. This will trigger the creation of a new task.
Open the Created Task: Once the task is created, open it to observe the issue.

Actual Behavior

When you follow the steps outlined above, you will notice that the userTask is blank. This is not the expected behavior, as the task should not freeze or become unresponsive.

Expected Behavior

The expected behavior is that the task does not freeze, and the preview is empty. This means that the task should be functional, even if the document preview is not displayed.

Environment

The issue was encountered in the following environment:

OS: MacOS
Browser: Chrome
Tasklist Version: 8.7, 8.8

Additional Context

To better understand the issue, it is essential to provide additional context. The following information may be helpful:

JSON File: The JSON file used to create the form and userTask.
BPMN: The BPMN file used to design the workflow.

Acceptance Criteria

To ensure that the issue is resolved, the following acceptance criteria must be met:

The bug is reproducible in the provided environment.
The issue has a meaningful title, description, and testable acceptance criteria.
Necessary screenshots, screen recordings, or files are attached to the bug report.

Definition of Ready - Checklist

Before assigning the issue to a developer, ensure that the following checklist is completed:

The Bug Has Been Reproduced: The assignee has reproduced the bug in an environment compatible with the provided one.
Meaningful Title and Description: The issue has a meaningful title, description, and testable acceptance criteria.
Necessary Attachments: Necessary screenshots, screen recordings, or files are attached to the bug report.

After Solving the Issue

Once the issue is resolved, answer the following questions in the comments:

Root Cause: What was the root cause of this bug?
Prevention: Is there anything that can be done to prevent this error from happening again in the future?

Solution

To resolve this issue, the following steps can be taken:

Review the Code: Review the code to identify the root cause of the issue.
Fix the Bug: Fix the bug by modifying the code to handle arrays correctly.
Test the Fix: Test the fix to ensure that it resolves the issue.
Verify the Fix: Verify that the fix does not introduce any new issues.

By following these steps, the issue can be resolved, and the userTask will no longer break when an array of documents is used in the 'documents preview' feature.

Conclusion

Q: What is the root cause of this bug?

A: The root cause of this bug is the incorrect handling of arrays in the 'documents preview' feature. When an array is entered in the 'Document reference' field, the code fails to handle it correctly, resulting in the userTask breaking.

Q: How can this bug be prevented in the future?

A: To prevent this bug from happening again in the future, the following steps can be taken:

Review the Code: Review the code to ensure that it handles arrays correctly.
Implement Array Handling: Implement array handling in the code to prevent it from breaking when an array is entered in the 'Document reference' field.
Test the Fix: Test the fix to ensure that it resolves the issue.
Verify the Fix: Verify that the fix does not introduce any new issues.

Q: What are the symptoms of this bug?

A: The symptoms of this bug include:

Blank Task: The userTask becomes blank and unresponsive.
Freezing Task: The task freezes and becomes unresponsive.
Empty Preview: The document preview is empty.

Q: How can this bug be reproduced?

A: To reproduce this bug, follow these steps:

Create a Form with 'Document Preview': Create a new form in your SaaS environment that includes a 'document preview' feature.
Enter an Array in 'Document Reference': Enter an array in the 'Document reference' field.
Link the Form to a UserTask and Start the Process: Link the form to a userTask and start the process.
Open the Created Task: Open the created task to observe the issue.

Q: What is the expected behavior?

A: The expected behavior is that the task does not freeze, and the preview is empty. This means that the task should be functional, even if the document preview is not displayed.

Q: What are the acceptance criteria for this bug?

A: The acceptance criteria for this bug include:

The Bug is Reproducible: The bug is reproducible in the provided environment.
Meaningful Title and Description: The issue has a meaningful title, description, and testable acceptance criteria.
Necessary Attachments: Necessary screenshots, screen recordings, or files are attached to the bug report.

Q: What is the definition of ready for this bug?

A: The definition of ready for this bug includes:

The Bug Has Been Reproduced: The assignee has reproduced the bug in an environment compatible with the provided one.
Meaningful Title and Description: The issue has a meaningful title, description, and testable acceptance criteria.
Necessary Attachments: Necessary screenshots, screen recordings, or files are attached to the bug report.

Q: What are the steps to resolve this bug?

A: To resolve this bug, follow these steps:

Review the Code: Review the code to identify the root cause of the issue.
Fix the Bug: Fix the bug by modifying the code to handle arrays correctly.
Test the Fix: Test the fix to ensure that it resolves the issue.
Verify the Fix: Verify that the fix does not introduce any new issues.

By following these steps, the issue can be resolved, and the userTask will no longer break when an array of documents is used in the 'documents preview' feature.