Skip to main content

Connected components

The components that were discussed earlier are connected. Actions on one component may have an impact on another. This section aims to cover the interactions between the moving parts in the planning view of Dime.Scheduler.

The following actions have consequences for components other than the ones they are executed in:

Connected actionComponent(s)
Select a recordPlanning board, planned tasks, open tasks, Gantt chart, route sequence
Drag and dropOpen tasks
Bulk updatePlanned tasks
Quick updateIndicators
Select range in date pickerDate picker
Draw routeMap
Change route sequenceRoute sequence
Apply resource filterResource filters
Apply resource for taskOpen tasks, planned tasks, Gantt chart
Show resources for selectionPlanned tasks
Open projectOpen tasks
Double clickPlanned tasks
Highlight planned tasksPlanned tasks

In what follows is a description of the result of these actions. Before we do that, it's worth noting that there is more than these interconnected components. The profile settings also have an impact on the components, as described here. For example, the settings panel enables the planner to set the start date of all the planning boards in the profile, irrespective of their state. This behavior is similar to the actions described in this document, as an external trigger will cause the behavior of other components to change.

Selecting a recordโ€‹

Selecting a task or appointment triggers a series of events that will force other components to take action:

  • Show details
  • Show notifications
  • Show pin on map

Show details for the selected entityโ€‹

Each time when the selection changes in any of the open/planned tasks grids, planning boards, Gantt charts or route sequence grids, the details component will be updated to show more information of that particular record.

When the planning view is loaded, the application will load the fields that were configured in the setup view. To configure what information to show in the details component, consult the settings documentation. The grid is composed with a fixed set of records and columns - as defined by the administrator. From then on, only the "Value" column will change when the described event occurs.

Show notifications for selected entityโ€‹

Each time when the selection changes in any of the open/planned tasks grids, planning boards, Gantt charts or route sequence grids, the notifications component will be updated. When no records are selected, the general notifications (those without a link to a record) will be displayed.

For appointments in the planning board, a visual indicator will indicate if there is a notification for the appointment and if so, it will show a different color depending on the severity of the notification.

Show pin on map for a selected entityโ€‹

Shows the pin on the map for an open/planned task or appointment, if that entity is backed by a job. Depending on the application and/or profile settings, this may invoke the routing feature to connect the active pins on the map.

Drag and drop open tasksโ€‹

One of the most vital features is the ability to create appointments by dragging and dropping items from the open task list on the planning board. Given the task is not a project task (this can be deduced from the "Task Type" column), an open task record can be dropped on a time slot in the planning board. This time slot has two dimensions: the time and the resource. Both parameters are required to convert a task in an appointment.

When a task is dropped and validation has passed, the application will save the appointment and broadcast it to the plugins, chief among which the back-office application, which in return may send updated information of the appointment and/or task back to Dime.Scheduler. When an open task is fully scheduled, it will disappear from the open task grid.

Draw routeโ€‹

Whether the application setup or the profile enables the automatic route calculation or not, the route sequence components will be updated when a route is drawn on the map. When a route is drawn on the map, the route will also be displayed in the route sequence grid. The route as a list may provide additional insights, and it may be used to reshuffle the order of the waypoints in the route.

Change route sequenceโ€‹

The route sequence grid - as its name suggests - allows users to reorder the stops in the route that is drawn on the map. Every modification done in this grid will trigger the map to recalculate the route.

Date picker selectionโ€‹

The date picker is there to allow the user to select a custom range to display in the planning board and capacity pivot grid. The date picker itself is only set by other components when the user executes a task that modifies the dates of the planning board. Note that such changes may be applied indirectly. Besides obvious actions on the planning board such as navigating to the next period or changing the view, date changes may originate from the profile settings, where users can define default start dates and ranges.

Apply resource filterโ€‹

The filter icon that appears in many of the grids provide a shortcut to filter the resources in the planning board.

Open projectโ€‹

The context menus of the open/planned task and route sequence grids offer - depending on the task type - the user the possibility to open the project in the Gantt chart.

Open project

Bulk updateโ€‹

The contextual toolbar actions in the planned tasks grid reveal actions that involve inter-component interactions. Two of them are dedicated to update the category and time marker of the selected planned tasks.

Quick updateโ€‹

The indicators component allows you to drag categories and time markers from this component and drop them on appointments in the planning board. This is a quick and easy way to modify the category or time marker of an appointment.

Show resources filterโ€‹

The contextual toolbar actions in the planned tasks grid reveal actions that involve inter-component interactions. Two of them are dedicated to filter the resources in the planning board. This is not to be confused with the resource filter. This filter is much simpler: it will only show the resources that were selected in the planned tasks grid. However, the two filter types may coincide, resulting in a composite filter where resources have to match both requirements. Moreover, these filters can coincide with filters in the resource grid of the planning board. This produces ultimate flexibility for the planner. It may be confusing at first, but if applied correctly, it can be extremely powerful.

Double click planned taskโ€‹

Double clicking on a row in the planned tasks grid will highlight the appointment in the planning board. If the appointment is not in the visible timeline, the component will navigate to that particular date. However, it is still possible - due to filters, sorting and paging - that the resource is still not visible. In that case, the planner is forced to modify the planning board's settings so the appointment can be visualized. Otherwise, the appointment will be highlighted automatically.

Highlight planned tasksโ€‹

The selection of planned tasks can be highlighted on the planning board. Not only are the appointments displayed differently, they are treated as a subset of records. For example, the drag-select feature will only consider the highlighted appointments.