Scheduler: add Multilevel Grouping demo description - #35143
Scheduler: add Multilevel Grouping demo description#35143vladaskorohodova wants to merge 6 commits into
Conversation
There was a problem hiding this comment.
🟡 Changes recommended
The new description contains a groupOrientation documentation link that points to the root config section even though the demo configures groupOrientation per-view (should link to Configuration/views/#groupOrientation).
Once you've addressed the issues Copilot identified, you can request another Copilot review.
Pull request overview
Adds end-user documentation for the Scheduler “Multilevel Grouping” demo so the demo gallery can display an explanatory description and configuration guidance.
Changes:
- Added a new
description.mdfor the Scheduler Multilevel Grouping demo. - Documented how to configure hierarchical (parent/child) resources and how the demo customizes the appointment form.
File summaries
| File | Description |
|---|---|
| apps/demos/Demos/Scheduler/MultilevelGrouping/description.md | New demo description explaining multilevel resource grouping setup and related Scheduler options. |
Review details
- Files reviewed: 1/1 changed files
- Comments generated: 1
- Review effort level: Lite
💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.
There was a problem hiding this comment.
🟢 Approval recommended
The change is documentation-only for a demo description, with no functional code impact and only minor consistency nits noted.
Review details
Suppressed comments (1)
apps/demos/Demos/Scheduler/MultilevelGrouping/description.md:12
- For consistency with other demo descriptions, avoid wrapping property names in backticks inside markdown link text (for example, use [groupOrientation] instead of [
groupOrientation]).
Switch between **Vertical Grouping** and **Horizontal Grouping** to change the layout. Each view sets the [`groupOrientation`](/Documentation/ApiReference/UI_Components/dxScheduler/Configuration/views/#groupOrientation) property to control the layout.
The demo also customizes the appointment form in the [`onAppointmentFormOpening`](/Documentation/ApiReference/UI_Components/dxScheduler/Configuration/#onAppointmentFormOpening) handler. Select a room to filter the employee list, then assign one or more employees to the appointment. The resource's [`allowMultiple`](/Documentation/ApiReference/UI_Components/dxScheduler/Configuration/resources/#allowMultiple) property enables multiple employee selection.
- Files reviewed: 1/1 changed files
- Comments generated: 1
- Review effort level: Lite
There was a problem hiding this comment.
🟢 Approval recommended
The change is a self-contained documentation addition that matches existing demo description conventions and introduces no functional code risk.
Review details
- Files reviewed: 1/1 changed files
- Comments generated: 0 new
- Review effort level: Lite
There was a problem hiding this comment.
🟢 Approval recommended
The change is a new demo description file that aligns with the demo’s actual configuration and introduces no functional or behavioral code changes.
Review details
- Files reviewed: 1/1 changed files
- Comments generated: 0 new
- Review effort level: Lite
| @@ -0,0 +1,12 @@ | |||
| The DevExtreme Scheduler supports multilevel resource grouping to organize appointments in a hierarchy. The Scheduler groups employees by room in this demo, so you can view each employee's schedule within their assigned room. | |||
There was a problem hiding this comment.
| The DevExtreme Scheduler supports multilevel resource grouping to organize appointments in a hierarchy. The Scheduler groups employees by room in this demo, so you can view each employee's schedule within their assigned room. | |
| The DevExtreme Scheduler supports multilevel resource grouping to organize appointments as a hierarchy. in In this demo, the Scheduler groups employees by room, so you can view each employee's schedule based on their assigned room. |
|
|
||
| Follow these steps to configure multilevel grouping: | ||
|
|
||
| - Include parent and child records in the resource's [dataSource](/Documentation/ApiReference/UI_Components/dxScheduler/Configuration/resources/#dataSource). This demo uses rooms as parents and employees as children. |
There was a problem hiding this comment.
| - Include parent and child records in the resource's [dataSource](/Documentation/ApiReference/UI_Components/dxScheduler/Configuration/resources/#dataSource). This demo uses rooms as parents and employees as children. | |
| - Add parent and child records in the resource's [dataSource](/Documentation/ApiReference/UI_Components/dxScheduler/Configuration/resources/#dataSource). This demo uses rooms as parents and employees as children. |
| Follow these steps to configure multilevel grouping: | ||
|
|
||
| - Include parent and child records in the resource's [dataSource](/Documentation/ApiReference/UI_Components/dxScheduler/Configuration/resources/#dataSource). This demo uses rooms as parents and employees as children. | ||
| - Set [parentIdExpr](/Documentation/ApiReference/UI_Components/dxScheduler/Configuration/resources/#parentIdExpr) to the field that links each child to its parent. Each employee's `parentId` references a room's `id`. |
There was a problem hiding this comment.
| - Set [parentIdExpr](/Documentation/ApiReference/UI_Components/dxScheduler/Configuration/resources/#parentIdExpr) to the field that links each child to its parent. Each employee's `parentId` references a room's `id`. | |
| - Assign a field that links each child to its parent to the [parentIdExpr](/Documentation/ApiReference/UI_Components/dxScheduler/Configuration/resources/#parentIdExpr). In this demo, each employee's `parentId` references a room's `id`. |
|
|
||
| - Include parent and child records in the resource's [dataSource](/Documentation/ApiReference/UI_Components/dxScheduler/Configuration/resources/#dataSource). This demo uses rooms as parents and employees as children. | ||
| - Set [parentIdExpr](/Documentation/ApiReference/UI_Components/dxScheduler/Configuration/resources/#parentIdExpr) to the field that links each child to its parent. Each employee's `parentId` references a room's `id`. | ||
| - Set the resource's [fieldExpr](/Documentation/ApiReference/UI_Components/dxScheduler/Configuration/resources/#fieldExpr) to the appointment field that stores resource IDs, and add that field to the Scheduler’s [groups](/Documentation/ApiReference/UI_Components/dxScheduler/Configuration/#groups) array. This demo uses `assigneeId`. |
There was a problem hiding this comment.
| - Set the resource's [fieldExpr](/Documentation/ApiReference/UI_Components/dxScheduler/Configuration/resources/#fieldExpr) to the appointment field that stores resource IDs, and add that field to the Scheduler’s [groups](/Documentation/ApiReference/UI_Components/dxScheduler/Configuration/#groups) array. This demo uses `assigneeId`. | |
| - Set the resource's [fieldExpr](/Documentation/ApiReference/UI_Components/dxScheduler/Configuration/resources/#fieldExpr) to the appointment field that stores resource IDs, and add that field to the Scheduler [groups](/Documentation/ApiReference/UI_Components/dxScheduler/Configuration/#groups) array. This demo uses `assigneeId`. |
| - Set [parentIdExpr](/Documentation/ApiReference/UI_Components/dxScheduler/Configuration/resources/#parentIdExpr) to the field that links each child to its parent. Each employee's `parentId` references a room's `id`. | ||
| - Set the resource's [fieldExpr](/Documentation/ApiReference/UI_Components/dxScheduler/Configuration/resources/#fieldExpr) to the appointment field that stores resource IDs, and add that field to the Scheduler’s [groups](/Documentation/ApiReference/UI_Components/dxScheduler/Configuration/#groups) array. This demo uses `assigneeId`. | ||
|
|
||
| Switch between **Vertical Grouping** and **Horizontal Grouping** to change the layout. Each view sets the [groupOrientation](/Documentation/ApiReference/UI_Components/dxScheduler/Configuration/views/#groupOrientation) property to control the layout. |
There was a problem hiding this comment.
Let's move this part before the splitter.
|
|
||
| Switch between **Vertical Grouping** and **Horizontal Grouping** to change the layout. Each view sets the [groupOrientation](/Documentation/ApiReference/UI_Components/dxScheduler/Configuration/views/#groupOrientation) property to control the layout. | ||
|
|
||
| The demo also customizes the appointment form in the [onAppointmentFormOpening](/Documentation/ApiReference/UI_Components/dxScheduler/Configuration/#onAppointmentFormOpening) handler. Select a room to filter the employee list, then assign one or more employees to the appointment. The resource's [allowMultiple](/Documentation/ApiReference/UI_Components/dxScheduler/Configuration/resources/#allowMultiple) property enables multiple employee selection. |
There was a problem hiding this comment.
| The demo also customizes the appointment form in the [onAppointmentFormOpening](/Documentation/ApiReference/UI_Components/dxScheduler/Configuration/#onAppointmentFormOpening) handler. Select a room to filter the employee list, then assign one or more employees to the appointment. The resource's [allowMultiple](/Documentation/ApiReference/UI_Components/dxScheduler/Configuration/resources/#allowMultiple) property enables multiple employee selection. | |
| The demo also customizes the appointment form in the [onAppointmentFormOpening](/Documentation/ApiReference/UI_Components/dxScheduler/Configuration/#onAppointmentFormOpening) handler. Select a room to filter the employee list, then assign one or more employees to the appointment. The resource [allowMultiple](/Documentation/ApiReference/UI_Components/dxScheduler/Configuration/resources/#allowMultiple) property enables multiple employee selection. |
No description provided.