From 4c8ca01740b8934245ee9d95050b3b352c069d0e Mon Sep 17 00:00:00 2001 From: usama9500 <96994784+usama9500@users.noreply.github.com> Date: Mon, 1 Apr 2024 19:06:48 +0500 Subject: [PATCH] Loop and Nested forms (#1282) * Loop and Nested forms * Updates * Removed Implementation steps * Removed Implementation steps * remove conflict marker --------- Co-authored-by: burnettk --- docs/Building_Diagrams/Forms.md | 48 +++++++++++- .../images/Loop_Settings.png | Bin 0 -> 36382 bytes .../images/Nested_form_display.png | Bin 0 -> 52889 bytes .../images/loop_example1.png | Bin 0 -> 15470 bytes .../images/loop_example2.png | Bin 0 -> 35632 bytes docs/Building_Diagrams/multiinstance.md | 72 +++++++++++++----- 6 files changed, 99 insertions(+), 21 deletions(-) create mode 100644 docs/Building_Diagrams/images/Loop_Settings.png create mode 100644 docs/Building_Diagrams/images/Nested_form_display.png create mode 100644 docs/Building_Diagrams/images/loop_example1.png create mode 100644 docs/Building_Diagrams/images/loop_example2.png diff --git a/docs/Building_Diagrams/Forms.md b/docs/Building_Diagrams/Forms.md index dfbc989f0..cc871452c 100644 --- a/docs/Building_Diagrams/Forms.md +++ b/docs/Building_Diagrams/Forms.md @@ -382,19 +382,17 @@ Below is an example JSON schema that includes the numeric range field: "numericRange": { "type": "object", "title": "Numeric Range", - "properties": { - "min": { + "minimum": { "type": "number", "title": "Minimum Value" }, - "max": { + "maximum": { "type": "number", "title": "Maximum Value" } } } } -} ``` This schema defines a numeric range object with `min` and `max` properties, both of which are required. @@ -412,3 +410,45 @@ This schema defines a numeric range object with `min` and `max` properties, both #### Validation This will automatically validate that the max value cannot be less than the min value. + + +### Adding a New Button for Repeating Sections in Forms + +Nested forms or repeating sections are designed to collect an array of objects, where each object represents a set of related information. For instance, in a task management form, you might need to collect multiple tasks, each with its title and completion status. + +This structure can be represented in the form's schema as follows: + +```json +{ + "title": "Nested Form / Repeating Section", + "description": "Allow the form submitter to add multiple entries for a set of fields.", + "type": "object", + "properties": { + "tasks": { + "type": "array", + "title": "Tasks", + "items": { + "type": "object", + "required": ["title"], + "properties": { + "title": { + "type": "string", + "title": "Title", + "description": "Please describe the task to complete" + }, + "done": { + "type": "boolean", + "title": "Done?", + "default": false + } + } + } + } + } +} +``` +**Form Preview**: + +![Nested Forms](images/Nested_form_display.png) + +By usign this feature, you can effectively implement new buttons for nested forms or repeating sections improving the form's usability for collecting multiple related entries from users. diff --git a/docs/Building_Diagrams/images/Loop_Settings.png b/docs/Building_Diagrams/images/Loop_Settings.png new file mode 100644 index 0000000000000000000000000000000000000000..a8bedc1fac4dd8df621168c4e2ffc27d72316b20 GIT binary patch literal 36382 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 literal 0 HcmV?d00001 diff --git a/docs/Building_Diagrams/images/loop_example1.png b/docs/Building_Diagrams/images/loop_example1.png new file mode 100644 index 0000000000000000000000000000000000000000..deb412960993524ddaba7ef603609a582cf13fab GIT binary patch literal 15470 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 Qn_Rwe)$|J95E}V^0A%Y`)&Kwi literal 0 HcmV?d00001 diff --git a/docs/Building_Diagrams/images/loop_example2.png b/docs/Building_Diagrams/images/loop_example2.png new file mode 100644 index 0000000000000000000000000000000000000000..eecb8a8b97435db2440ff5a4d3de076c8b6db08e GIT binary patch literal 35632 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%0DJ)K3G?lpfd`oAG4*0KC)IO^>4f7op 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 literal 0 HcmV?d00001 diff --git a/docs/Building_Diagrams/multiinstance.md b/docs/Building_Diagrams/multiinstance.md index 218d4020e..2003ac1b8 100644 --- a/docs/Building_Diagrams/multiinstance.md +++ b/docs/Building_Diagrams/multiinstance.md @@ -1,7 +1,7 @@ # Multi-instance Tasks -Multi-instance tasks in BPMN (Business Process Model and Notation) represent a powerful tool for modeling processes that require repetitive actions over a collection of items. - -These tasks automate the iteration over a list, array, or collection, executing the specified activity for each element within. Multi-instance tasks can be configured to run either in parallel, where all instances are executed simultaneously, or sequentially, where each instance is executed one after the other. +Multi-instance tasks in BPMN (Business Process Model and Notation) are a powerful tool for modeling processes that require repetitive actions over a collection of items. +These tasks automate the iteration over a list, array, or collection, executing the specified activity for each element within. +Multi-instance tasks can be configured to run either in parallel, where all instances are executed simultaneously, or sequentially, where each instance is executed one after the other. ## **Sequential Execution** @@ -43,13 +43,10 @@ Specifically, the process manages a list of composers, their names, and genres, ### Process Overview: + 1. **Start Event**: Marks the initiation of the process. #### 1. **Start Event**: -Marks the initiation of the process. - -#### 2. **Script Task - Create Dictionary**: - -This task initializes a list (array) of dictionaries, each representing a composer with their name and associated genre. The script effectively sets up the data structure that will be manipulated in subsequent steps of the process. +2. **Script Task - Create Dictionary**: This task initializes a list (array) of dictionaries, each representing a composer with their name and associated genre. The script effectively sets up the data structure that will be manipulated in subsequent steps of the process. ![Multi_instance_example](images/multiinstance_example2.png) @@ -63,9 +60,7 @@ This task initializes a list (array) of dictionaries, each representing a compos ] ``` -#### 3. **Multi-Instance Task - Edit Composer**: - -This task is configured as a parallel multi-instance task that iterates over the `composers` array created by the previous script task. It allows for the editing of each composer's information within the array. +3. **Multi-Instance Task - Edit Composer**: This task is configured as a parallel multi-instance task that iterates over the `composers` array created by the previous script task. It allows for the editing of each composer's information within the array. ![Multi_instance_example](images/multiinstance_ex.png) @@ -80,9 +75,7 @@ This task is configured as a parallel multi-instance task that iterates over the ⚠ The completion condition and output element are left unspecified, indicating that the task completes after iterating over all elements in the input collection without additional conditions. ``` -#### 4. **Manual Task - Display Edited Composers**: - -This task presents the edited list of composers and their genres, using a loop to display each composer's name and genre in the format provided. +4. **Manual Task - Display Edited Composers**: This task presents the edited list of composers and their genres, using a loop to display each composer's name and genre in the format provided. ![Multi_instance_example](images/multiinstance_ex1.png) @@ -96,10 +89,55 @@ This task presents the edited list of composers and their genres, using a loop t This templating syntax iterates over the `composers` array, displaying each composer's name and genre in a formatted list. -5. **End Event**: - -Signifies the successful completion of the process instance, after the list of composers has been edited and displayed. +5. **End Event**: Signifies the successful completion of the process instance, after the list of composers has been edited and displayed. ### Summary: This multi-instance example in a BPMN process highlights the capability to dynamically handle collections of data through scripting and manual tasks. By iterating over a list of composers, allowing for the editing of each item, and finally displaying the edited list, the process demonstrates how data can be manipulated and presented in a structured workflow, showcasing the flexibility and power of BPMN for data-driven processes. + +## Loops + +Standard loops in Business Process Model and Notation (BPMN) are a fundamental mechanism to model repetitive tasks within a workflow. These loops allow for the execution of a specific task or sequence of tasks repeatedly until a predefined condition is met, mirroring traditional loop constructs found in programming languages. + +### Key Concepts +![Loop Configuration](images/Loop_Settings.png) + +1. **Loop Marker**: A visual indicator (a small loop symbol) placed at the bottom center of an activity to denote that the activity is subject to repeated execution. +2. **Loop Condition**: A Boolean expression evaluated before or after each iteration of the loop. The loop continues as long as this condition evaluates to true. +3. **Loop Maximum**: An upper limit on the number of iterations a loop can execute, preventing infinite looping and ensuring process termination. + + +### Implementing a Standard Loop + +To model a standard loop in BPMN, determine the activity or sequence of activities that need to be executed repeatedly. The next steps are: + +1. **Configure the Loop Characteristics**: + - Add the loop marker to the activity symbol. + - Define the loop condition within the activity’s properties. This condition dictates the continuation of the loop. + +3. **Loop Execution**: + - The process engine evaluates the loop condition. If true, the looped activity is executed. + - After execution, the loop condition is re-evaluated to decide whether another iteration is required. + +### Example: Incrementing a Counter + +Consider a process designed to increment a counter variable until it reaches a specific value. This scenario is effectively managed using a standard loop in BPMN. + +#### Process Overview + +![Loop Example](images/loop_example1.png) + + +1. **Start Event**: Initiates the workflow. + +2. **Script Task - Initialize Counter**: Initializes a counter variable, `counter`, to 0 and Script: `counter = 0;` + +3. **Script Loop Task - Increment Counter**: Implement the Script Loop Task with a loop marker and configure the loop condition (`counter < 10`) and increment script (`counter = counter + 1;`). The process engine will increment the `counter` by 1 on each iteration. + +![Loop Example](images/loop_example2.png) + +The task is marked with a loop indicator, and the loop condition ensures the task repeats until `counter` reaches 10. + +4. **End Event**: Marks the completion of the process once the loop condition is no longer satisfied. + +This example illustrates the use of a standard loop in BPMN to model repetitive actions within a workflow, showcasing how loops can automate iterative tasks based on dynamic conditions.