Agenda
The Agenda is a calendar surface that lets a resourceResourceAn entity that can carry out work - a person, vehicle, tool, or room - that you schedule on the planning board. - or anyone with the URL - consult the planning of one or more resources without opening the full planning boardPlanning boardThe main graphical scheduling surface where dispatchers drag tasks onto resources across a timeline.. It runs at https://app.dimescheduler.com/agenda and is read-only: it shows what was planned, and clicking an appointmentAppointmentA task scheduled to a resource for a specific period - the scheduled instance you see on the planning board. opens a details sheet, but nothing can be moved or edited here. The planning board stays the place where the schedule is made.
That makes the agenda the right surface for three situations: a technician who wants to see their week on a laptop, a dispatcher who wants a calendar-style view of a few people side by side, and a wallboard or back-office page that embeds a fixed view and never gets touched.
The viewsโ
The agenda has four view tabs: Day, Week, Month and List. Day and week lay appointments out on a time axis; month shows them as compact bars per day; list is a plain chronological list that picks its own span (day, week, month or year) from its own range menu.
A fifth view, the range view, is not a tab. It is a day-style time axis over an arbitrary span, and you enter it by picking a start and end date (see Jumping to a date range). When no end date has been picked the range spans 14 days.
Group by resourceโ
When the agenda shows two or more resources, the Group by resource toggle in the toolbar splits the day, week or range view into one column per resource, so you can read each person's day without untangling overlapping bars. With a single resource the toggle has nothing to split and the view stays stacked. The grouped layout is also the only place where availability shading and the column width slider apply, because only there is there a column per resource to shade or size.
Navigatingโ
The toolbar carries the date navigation on the left (Today, previous and next arrows) and the view tabs on the right. The arrows move one period at a time: a day, a week or a month, depending on the view. In the range view they slide the whole span forward or back by its own length, so a 10-day range stays a 10-day range.
A collapsible sidebar on the left holds a mini date picker for jumping to any day of the month, and the resource selection described below. The panel toggle at the left end of the toolbar hides and shows it.
Jumping to a date rangeโ
In the week and range views the toolbar shows a Select date range button next to the date navigation. It opens the same date range picker the planning board uses, with quick ranges at the bottom. Applying a range switches the agenda into the range view over exactly those days. Today in the range view keeps the span's length and re-anchors it on today.
Keyboard shortcutsโ
Shortcuts work whenever focus is not inside an input and the appointment details sheet is closed:
| Key | Action |
|---|---|
โ | Previous period |
โ | Next period |
T | Today |
D | Day view |
W | Week view |
M | Month view |
L | List view |
R | Refresh |
Modifier-key combinations (Ctrl, Cmd, Alt) are ignored so they don't collide with browser shortcuts.
Swipe gesturesโ
On a touch screen, a quick horizontal swipe across the calendar moves one period: swipe left for the next period, swipe right for the previous one. This is the intended way to page a tablet on the wall or a phone in the field.
Choosing resourcesโ
The agenda scopes itself to a set of resources, and an empty set means "all resources". Because a tenant can have hundreds of resources, picking happens in a dialog rather than in a dropdown.
The Resources button in the sidebar opens the resource picker: a paged, sortable and filterable grid with the columns Resource No, Name, Display Name, Type, Team Name and Department. Tick the rows you want (selection survives paging and filtering), then click Apply. The picked resources appear as a checklist in the sidebar, where each checkbox toggles that resource's appointments on and off without removing it from the picked set. The Clear all cross next to the button empties the set and takes the agenda back to all resources.
The selection is written to the URL as ?resources=A,B,C, so a filtered view can be bookmarked or shared. Resources can also be supplied up-front through three other channels, in this priority order:
- The legacy
?resource=Aquery string, still accepted and mapped ontoresources. - The URL path
/agenda/<resourceNo>. - The
data-resourcenoattribute on the host element, used when the agenda is embedded in another page.
Whatever the source, the toolbar emits the canonical ?resources=... form the first time you change the selection.
Settingsโ
Most display controls live behind the Settings gear at the right end of the toolbar. It opens a popover that closes when you click outside it or press Escape.
- Zoom is a slider that sets the height of one hour on the time axis, from 40 to 150 pixels. It only acts on the time-axis views (day, week and range); elsewhere it is shown but disabled.
- Column width is a second slider that sets how wide each resource column is in the grouped day and week views. It only appears there.
- Pin to now keeps the current time in view. Like zoom, it only applies to the time-axis views.
- Show weekends toggles whether Saturday and Sunday are rendered.
- Travel Time draws the travel buffers before and after appointments that have them. It starts off in the stacked views, where the buffers add noise, and on in the grouped views, where dispatchers plan around drive time. Once you touch the switch, your choice wins. The row only appears in the time-axis views.
- Availability shades each resource's non-working time, taken from the resource calendarsCalendarA definition of when work can happen, for the whole tenant or for specific resources: business hours, weekends and holidays. Calendars shade non-working time on the planning board and skip it in Gantt durations.. It is on by default and only exists in the grouped views, which is also the only place the row shows up.
- Resource avatars puts the assigned resource's initials on each appointment bar in the time-axis and month views, and the resource names in the list view.
- The time range input bounds the visible hours of the day (for example 07:00 to 19:00). Outside those hours the time axis is hidden.
- Export to Excel downloads the visible appointments as a spreadsheet with the resource, subject, start and end. Export to PDF asks the server for a timeline PDF of the visible date range for the selected resources (or all of them when nothing is selected); it uses the same renderer as the planning board exports, so the output matches the product's styling. An overlay shows while the PDF is generated.
The Refresh button next to the gear re-fetches the appointments; R does the same.
Appointment details sheetโ
Clicking an appointment opens a side sheet with the full record:
- Subject, body and categoryCategoryA visual indicator (a color) applied to appointments to classify or label them. color accent.
- Start and end, formatted in your locale.
- Assigned resources. Each resource name is clickable: clicking adds or removes that resource from the agenda's filter, so you can pivot the agenda onto the people of the appointment you're inspecting.
- Linked taskTaskA unit of work that belongs to a job. It appears in the open task list until it is scheduled to a resource. and jobJobA high-level container, comparable to a project, that bundles related tasks together with common information such as customer, billing, and address. numbers.
- Category and time markerTime markerA visual indicator on an appointment, separate from its category, used to flag a status or condition at a point in time., with their color swatches.
- Site address, when the linked job has one.
- Planning quantityPlanning quantityThe amount of work an appointment represents, by default its duration in hours. A conversion factor can express it in another unit, and the capacity view compares it against resource load. and priority.
- Created and last-modified metadata, with the user who made the change.
Keyboard shortcuts stand down while the sheet is open.
When something failsโ
An empty calendar and a failed fetch look the same, so the agenda says which one you are looking at. If the appointments cannot be loaded, an error pill appears over the grid with a Try again link that refetches. A PDF export that fails shows the same kind of alert, with Try again and a dismiss button. If availability shading is on but the resource calendars could not be loaded, a warning pill says so, because shading that is silently missing would read as "no unavailability". When the fetch succeeds and there is simply nothing planned, the agenda shows No results.
Kiosk and embed modeโ
For wallboards, embedded views inside back-office systems, or any case where the chrome should be hidden, append ?hideToolbar=true to the URL. The toolbar and the sidebar disappear entirely and the calendar fills the viewport edge to edge. Keyboard shortcuts and swipe gestures keep working, so a touch screen can still be paged.
Combine this with the query string parameters to hard-code the desired view:
https://app.dimescheduler.com/agenda
?view=day
&resources=LINDA,JOHN
&minTime=07:00:00
&maxTime=19:00:00
&pinToNow=true
&groupByResource=true
&showAvatars=true
&hideToolbar=true
Configuration parametersโ
The settings that matter for a shared or embedded link are read from the query string on load and written back to it when you change them in the toolbar, so the URL in the address bar is always a link to what you are looking at. Parameter names are matched case-insensitively.
| Parameter | Type | Notes |
|---|---|---|
view | string | day, week, month, list or range. Defaults to day. |
date | string | YYYY-MM-DD. Defaults to today. In the range view, the first day of the span. |
endDate | string | YYYY-MM-DD. The last day of the span; only used with view=range. |
minTime | string | hh:mm:ss. Defaults to 00:00:00. |
maxTime | string | hh:mm:ss. Defaults to 24:00:00. |
showWeekend | boolean | Defaults to true. |
pinToNow | boolean | Defaults to false. Only effective in the time-axis views. |
groupByResource | boolean | Defaults to false. Only effective with two or more resources. |
showAvailability | boolean | Defaults to true. Only written to the URL when you switch it off. Only effective in the grouped views. |
showAvatars | boolean | Defaults to false. |
resources | string | Comma-separated resource numbers. The canonical multi-resource form. |
resource | string | Legacy. Single resource number, mapped onto resources and stripped from the URL on the first change. |
hideToolbar | boolean | Defaults to false. When true, the toolbar and sidebar are hidden entirely (kiosk mode). |
Older links that use the previous view names (timeGridDay, timeGridWeek, dayGridMonth, listWeek) still open the matching view. The zoom level and the column width are not part of the URL; they reset when the page is reloaded.
Mobile users typically prefer the mobile app over the agenda for daily use - it's purpose-built for the on-the-go workflow.