Calendars

On this page

The Web App has three standalone calendars: My Calendar, the Change Calendar, and the Team Calendar. Each header shows Calendars followed by the calendar's name. Use its drop-down list to open another calendar. Available calendars always appear in this order: My Calendar, Change Calendar, Team Calendar. When only one is available, the header shows its title without a drop-down arrow.

What you can see and change

Who may create, edit, and delete an event depends on the calendar. Your calendar-event right has three levels:

Calendar You may create, edit, and delete events when
My Calendar your calendar-event right is above its lowest level
Change Calendar you may edit Change Requests
Team Calendar on your own row: your calendar-event right is above its lowest level; on anyone's row: your calendar-event right is at its highest level

On the Team Calendar, when your right covers only your own events, it is checked against the row you click or drop onto, not against the event's owner. You cannot create an event while the unassigned row is selected, and an event dropped onto the unassigned row, or onto no row, moves back.

Events you add in the event dialog, including Change Management Events on the Change Calendar, can be dragged or resized when you may edit them. A drop or resize saves the new times at once, with no separate Save step, and the event moves back if the save returns an error. Change Requests, Work Orders, Project Tasks, and the record dates shown on My Calendar cannot be dragged or resized.

In the Web App

Calendar views

All three calendars share one toolbar: Today, back and forward arrows, and Day, Week, and Month. The button of the open view is filled. My Calendar and the Change Calendar show a day or week time grid and a month grid, and read as a diary. The Team Calendar shows the same three ranges as a resource timeline with one row per technician (see Team Calendar rows and toggles), and reads as a scheduling board. No other range is offered, so you cannot choose a custom span of days. In the month grid, a day that holds more events than fit shows a "more" link.

To the right of the calendar, a sidebar holds a month picker, the Other calendars panel, and a filter list headed Calendar Events on My Calendar and Filters on the other calendars. Picking a date in the month picker moves the calendar to that date and, in the month grid, selects that day. The month picker marks today with a filled blue circle and shades the picked day. In the week views the month picker highlights the whole selected week instead of the single day. The month picker can collapse to a strip that shows only its header row.

In the day and week grids, My Calendar and the Change Calendar shade non-working hours from your own work calendar, except while the work calendar loaded for the shown dates holds an all-day entry for a specific date. On the Team Calendar, each row loads that technician's working hours instead.

Whether a whole day counts as working is decided from the work calendar: a day with timed entries is a working day when it holds more working minutes than non-working minutes, and a day with no entries follows the weekly working hours, or Monday to Friday when there are none. An all-day entry for the date, or an all-day event that does not stand for a record and is neither a holiday nor an Outlook event, decides the day instead; on the Team Calendar it decides the day for that technician's row.

On the Change Calendar and the Team Calendar, the Filters list narrows the events shown. Each filter starts with (Select All) and <Unassigned>. The Web App remembers which filter groups you expanded or collapsed.

  • Change Calendar: the Change Requests' type, category, and status (without the inactive status), the project, and the assignee.
  • Team Calendar, Work Orders: the type, category, and status, and the project.
  • Team Calendar, Project Tasks: the project, the task type, and the task status.

The Team Calendar's assignee and group filters are in the toolbar instead (see Team Calendar rows and toggles).

The Team Calendar and My Calendar keep separate view, date, and filter settings.

My Calendar event types

My Calendar shows dates from records. Which dates it shows is your own list of event types: the first time the Calendar Events list loads, you get a copy of the shared list. As shipped, the shared list holds ten event types, each a single date:

  • the due date of change requests, incidents, problems, and work orders assigned to you;
  • the warranty expiration date and the lease return date of assets you own, the required date of purchase orders you own, and the expiration date of software licenses you own;
  • the end date of contracts and the expiration date of SLAs.

Event types of a class that your license does not include are left out.

The Calendar Events list in the sidebar has one group per class, with a check box for each of your event types. An event type is labeled with its description, or with the name of its date field, followed by "to" and the end-date field when it has one.

To show or hide an event type:

  1. In Calendar Events, select or clear the event type's check box. An Apply and Cancel bar appears at the foot of the sidebar.
  2. Click Apply. The calendar reloads its events, and the check boxes are disabled until it is done. Cancel puts the check boxes back.

A hidden event type is hidden for you alone, and it stays hidden in later sessions and in other browsers. The groups in the list cannot be collapsed one by one: clicking the pane's header folds the whole list, and the list is expanded again after a reload.

On My Calendar only, the pane's header also has a customize button. It opens a drawer where you manage your event types:

  • Add an event type: choose a class, then a start-date field and, if you want, an end-date field from that class's date fields. Choosing the same field for both clears the other. Without a title, the event type is named after its fields, as <start field> to <end field>, or after its single field. A show-by-default check box sets whether it starts checked.
  • Edit an event type. Its class cannot be changed once it exists.
  • Delete an event type. A class left with no event types is removed from the list. The last remaining event type cannot be deleted: the drawer keeps it and shows a message.
  • Save the drawer to save the check state of every event type. The Calendar Events list and the calendar's events then reload.

The same drawer holds the button that copies your calendar's share link; see Outlook and Team Calendars.

Events on the calendars

An event that stands for a record is titled with the record's ID in brackets followed by its name. A Change Request on the Change Calendar and a Work Order on the Team Calendar run from their start date, or their scheduled start date when they have none, to their completion date, or their scheduled end date when they have none. A Project Task runs from its actual start date, or its planned start date when it has none, to its actual end date, or its planned end date when it has none. A Change Management Event runs from its start time to its stop time.

An event with no color of its own is drawn in the calendar's default color; an event you gave a color is drawn in that color. The text color is always chosen automatically to contrast with the event's color.

A single click selects and highlights an event; an event that carries a link also opens that link. Outlook events and Outlook free/busy blocks do not respond to a click. A double-click, or Open from the event's menu, works only when you may edit the event, and then:

  • An Outlook event opens read-only in the calendar's event dialog (see The Outlook connection on screen).
  • An event that stands for a record opens that record, in the current tab or a new one according to your preference for opening records in a new window.
  • An event you added in the event dialog opens in that dialog for editing.

Right-click an event to open its menu. The menu depends on the event:

  • An Outlook event: Open in Outlook, which opens the event's link in a new tab, and Open. Both are disabled when you may not edit. The menu has no delete entry, so an Outlook event cannot be deleted from the calendar.
  • An event that stands for a record: Open, an entry that opens the record the other way (in a new tab or in the current tab), and Details, in an order that follows your preference for opening records in a new window.
  • An event you added in the event dialog and may edit: Open and Delete.
  • A holiday or an event from a calendar feed: no event actions.

The right-click menu also carries Add event.

Add or edit an event

Before you begin: you need the right to create events on the calendar (see What you can see and change).

  1. Right-click the calendar and choose Add event. The dialog is titled Add Change Event on the Change Calendar and Add Personal Event on the other calendars.
  2. If a Category list is shown, choose a category. The list appears only when you create an event and more than one category exists. The Change Calendar has one category, Change Management Event; the other calendars list the work-calendar exception categories.
  3. In Title, enter the event's title.
  4. On the Change Calendar, pick a color from the fixed palette of 30 colors.
  5. Set Start Date and End Date. Times are shown unless All day is selected. A new event starts with All day selected unless its category says otherwise.
  6. In Description, enter a description.
  7. Click Submit. Submit is disabled while the title is empty. The dialog also has Cancel.

A new event is saved to the Web App calendar. The dialog creates no event in Outlook, whether or not you are signed in to your Microsoft account. On the Change Calendar the event is saved as a Change Management Event; on the other calendars it is saved as a work-calendar exception (see Work Calendars).

When you open an event to edit it, the dialog is titled with the event's category name.

Hover card

Pointing to an event shows a card.

  • For an event that stands for a record, the card shows the class icon, the caption (up to three lines), the class name with the record's ID, the assigned person's photo and name with the field's name in brackets, the start and, when it differs to the minute, the end, and the status as a badge when there is one.
  • For any other event, the card shows its title, its time span (marked as all day for a one-day all-day event), and its description when that differs from the title. An Outlook event or free/busy block also carries an Outlook badge.

The card's footer repeats the event's menu actions as icon buttons, without Add event.

Team Calendar rows and toggles

Two toggle buttons, Project Tasks and Work Orders, decide which classes the Team Calendar's timeline draws. Your browser remembers the toggles, and a reload restores them. In a browser that has no toggles stored, they start from the class your account last saved; until your account has saved Team Calendar settings, its saved class is Project Tasks. With both toggles on, the sidebar's filter list splits into a Project Tasks section and a Work Orders section; with one toggle on, it shows a single list. That single list shows the filters of the class your account last saved, while the events follow the lit toggle, so a browser that remembers a different toggle than your account holds can show the Project Tasks filters under a lit Work Orders toggle. A click that leaves a single toggle lit saves that class, and the filters then match it; a click that leaves both toggles lit, or neither, does not change the saved class.

The rows come from the Team Calendar's own Assignee and Group filters, not from a separate picker; those two filters are not in the sidebar. On the Team Calendar, the toolbar starts with a filter menu that has an Assignee tab and, when group filter items exist, a Group tab.

  • Every person you check on the Assignee tab becomes a row linked to that person's Person record.
  • Every group you check on the Group tab adds a row for each active technician in the group, not for every member. The Group tab lists only active user groups flagged for technicians only; an ordinary user group does not appear there.
  • A person who already has a row does not get a second one.
  • Checking <Unassigned> on the Assignee tab adds one row that is not linked to a person, sorted above the named rows.
  • Checking (Select All) checks every item on that tab; checking or clearing any other item clears (Select All). The select-all entry and the <Manager> entry add no row of their own. While <Manager> is checked, the checkbox of every assignee who is a manager is disabled.
  • Your changes take effect when you click Apply. Cancel restores the selection as it was at the last Apply.

Each row is a fixed height, unless the timeline is tall enough for the rows to share its height evenly. A row loads its working hours and, while your Outlook calendar is checked under Other calendars, that technician's Outlook free/busy blocks when the row scrolls into view. It shows a spinner while loading and an error icon when the free/busy lookup fails, so a wide Team Calendar fills in progressively rather than all at once.

Free/busy blocks marked free are not shown. The others are drawn in the color you gave your Outlook calendar, or, when it has none, in a color for their status (for example, busy, tentative, out of office, or working elsewhere).

The Outlook connection on screen

The sidebar's Other calendars panel is where you connect your Outlook calendar. Click the panel's title or the arrow beside it to expand or collapse it. The panel starts collapsed until you expand it, and your browser remembers whether it is expanded. The ⋮ button in the panel's header opens a menu with Add Outlook calendar and, on My Calendar and the Change Calendar, Add other calendar for a calendar feed (see Add a calendar feed). With nothing connected, the panel reads "No calendars connected. Use the menu [⋮] to add one."

Add Outlook calendar is disabled in these cases:

  • The Microsoft 365 feature is turned off. The hover text reads "This feature is currently disabled."
  • The feature is on but no Microsoft 365 registration (client ID and tenant ID) exists. A tooltip points administrators to the Microsoft Graph settings.
  • You already have an Outlook calendar. The hover text reads "Outlook calendar is already added".

To connect your Outlook calendar:

  1. In the sidebar, click the ⋮ button of Other calendars and choose Add Outlook calendar.
  2. In the Add Outlook calendar panel, sign in with your Microsoft account.
  3. In Calendar name, keep the prefilled name Outlook or enter another one.
  4. Pick a color from the fixed palette of 30 colors.
  5. Click Add.

The Microsoft sign-in button has four states: a placeholder while the sign-in state is loading; a sign-in button when you are not signed in, which starts the Microsoft sign-in; once you are signed in, a signed-in label with your account's e-mail address in brackets, and a menu whose only entry is Sign out; and an error state when you are signed in but your events fail to load. In the error state the error text appears in the button's tooltip and in the error tooltip on the Outlook calendar's row under Other calendars, which offers Sign in again for an authentication error and Sign in when you are not signed in.

When loading Outlook events fails with an authorization error, Alloy Navigator shows its own message. When a Team Calendar free/busy lookup cannot find the mailbox, Alloy Navigator shows its own message with the mailbox address when the address is known, and otherwise the error text as Microsoft returns it. Any other Microsoft error is shown as Microsoft returns it.

A calendar you add is listed checked, and the list of other calendars is saved in your Web App profile on the server.

Each connected calendar is listed under Other calendars as a checkbox labeled with its name and tinted with its color when checked. Check or clear it to show or hide its events; the change is saved at once, with no Apply step. Point to a row to reveal its Options button, whose menu offers Edit, which opens the panel, titled Edit calendar, filled in from that calendar, with Save in place of Add, and Delete, which asks "Are you sure you want to delete the selected item(s)?" and removes the calendar when you confirm. The Outlook calendar is listed only while the Microsoft 365 feature is on and a registration exists.

Outlook events appear only while your Outlook calendar is checked under Other calendars and you are signed in with your Microsoft account. Outlook events are drawn in the color you gave your Outlook calendar, or in a fixed blue when it has none. An Outlook event without a subject reads Untitled. Opening an Outlook event shows it read-only in the event dialog: the title is the subject followed by a Microsoft 365 calendar note in brackets, the time span is shown as text, the description cannot be edited, and the dialog has no Submit button. The dialog lists the attendees grouped by their response, with those who have not responded last, and each group can be collapsed.

The Team Calendar takes its Other calendars list from My Calendar: an Outlook connection made on My Calendar appears on the Team Calendar, while a calendar feed added on My Calendar does not. Once My Calendar has saved settings, each time the Team Calendar loads it replaces its Other calendars list with My Calendar's, so a change made to that list on the Team Calendar is back to My Calendar's list after a reload.

For the Microsoft 365 integration behind the Outlook connection, see Outlook and Team Calendars.

Add a calendar feed

On My Calendar and the Change Calendar, Add other calendar shows the events of another calendar, such as a Google, iCloud, or Outlook calendar, from the calendar's iCalendar feed. The events are shown only: an event from a calendar feed has no event actions.

Get the feed address

The Web App server downloads the feed without signing in to the calendar, so use an address that opens without a sign-in, and the feed's host must be reachable from the Web App server. Copy the address in the calendar app:

  • Google Calendar. In Google Calendar, open Settings, select the calendar under Settings for my calendars, and click Integrate calendar. For a private calendar, copy the link in Secret address in iCal format. Anyone who has this address can see the calendar's events, so do not share it; if you shared it by mistake, click Reset there to create a new one. For a calendar you made public, copy the link in Public address in iCal format. See Google's Sync Google Calendar with other calendar apps and Make your Google calendar public.
  • iCloud Calendar. On iCloud.com, open Calendar, point to the calendar in the sidebar, select its Calendar Information button, turn on Public Calendar, and select Copy. Anyone who has the link can view the calendar, without an iCloud account. See Apple's Share a calendar on iCloud.com.
  • Outlook calendar. In Outlook on the web, in Calendar view, open Settings and select Shared calendars. Under Publish a calendar, choose the calendar and how much detail people can see, select Publish, and copy the ICS link. See Microsoft's Share your calendar in Outlook on the web. To show your own Outlook calendar, you can also use Add Outlook calendar, which connects it through your Microsoft sign-in (see The Outlook connection on screen).

Add the feed

  1. On My Calendar or the Change Calendar, in the sidebar, click the ⋮ button of Other calendars and choose Add other calendar. The Add new calendar panel opens.
  2. In Link, paste the calendar's feed address.
  3. In Calendar name, enter a name.
  4. Pick a color from the fixed palette of 30 colors.
  5. Click Add. Add is disabled while the name or the link is empty.

The calendar is listed, checked, under Other calendars, where you can show, hide, edit, or delete it as described in The Outlook connection on screen.

If a checked calendar feed fails to load, an error icon can appear beside its name. Point to the icon to see the reason. Check that the address returns an iCalendar feed and that the Web App server can reach it. The icon disappears when the feed loads successfully.