Calendar Items

Tip

The Calendar module includes Calendar Items (this topic) and Time-Off Limits.

The toolbar buttons are across the top of the window. The Agents and Activities trees are at the Objects pane.

Use the Calendar Items module to add, and edit agents' exceptions, preferences, and time off.

Exceptions are periods of time when agents are engaged in non-work activities.
Preferences are agent and supervisor requests for particular shifts, days off, availability, and time off.
Rotating patterns are rotating work weeks of shifts, working days, working hours, and/or work activities. A rotating pattern can be assigned to an agent.

Calendar Module Controls

Toolbar Buttons

Select a view from the Calendar drop-down (on the left side of the toolbar): Calendar Items or Time-Off Limits.

Icon	Name	Description
	Filter	Filter the display.
	Add	Add an item (in this view, a calendar item).
	Edit	Edit the selected calendar item(s).
	Prefer	Change the status of the selected agent request(s) to Preferred.
	Grant	Change the status of the selected agent request(s) to Granted.
	Decline	Decline the selected agent request(s).
	Delete	Remove the selected calendar item(s).
	Update Schedule	Insert time-off items and meeting-specific criteria to the master schedule. (You must be a supervisor with edit rights to the master schedule.)
	Option menu	Select whether to include these columns in the table: Site, Team, Shared Transport, Site Date, Reason, Comments/Memo, Paid Hours, Hire Date, Submitted, Site Time Zone. This menu is displayed on the right side of toolbar.
	Help	Display context-sensitive help.

Time Zone

Select the time zone for this instance of WFM by using the drop-down list that appears on the right side of the toolbar buttons and above the calendars. The following choices appear in the list:

User’s—Specifies the time zone of the current user, as configured for that user in WFM Web.
- If no time zone is configured for the current user, this option is absent.
BU/Site—
- Specifies the time zone of the BU that is selected on the Object pane.
- Specifies the time zone of the site that is selected on the Object pane. If more than one site is selected, then WFM specifies the time zone of the BU that is selected on the Object pane.
Local —Specifies that data for every site will be returned in that site's local time zone.
Configured time zones—Specifies the time zone that you choose from the remainder of items in this list.
- Each remaining item is a configured time zone (and its relationship to GMT). For example, Pacific Standard Time, which is 8 hours earlier than Greenwich Mean Time, is presented in the Internet Assigned Numbers Authority (IANA) standard as (GMT -08.00) US/Pacific.

Objects Pane

The Objects pane, on the left side of the WFM window, displays the database objects that you can retrieve.

Agents Tree

The Agents tree displays agents in the Enterprise. The tree is hierarchical from top to bottom: Business Units, Sites, Teams, and Agents.

Activities Tree

The Activities tree displays activities in the Enterprise. The tree is hierarchical from top to bottom: Business Units, Multi-site Activities, Activity groups, Sites, and Activities.

Each item in the Object trees has a check box, which is either cleared or selected. Checking an item, in one of the trees causes a reaction in the other tree: selecting an agent automatically selects the corresponding activities, and selecting an activity automatically selects the corresponding agent(s)/team(s)/site(s)/business unit.

Tip

You can simultaneously select items that are located below different sites within the same business unit. Nothing is selected by default.

About the Calendar Items Module

The Calendar Items module displays agents' shifts, days off, time off, exceptions, and availabilities. You can filter this display. You can add and edit most types of Calendar items from this display, and you can edit exceptions, working hours, shifts, and availabilities.

Rotating pattern information is read-only. Rotating patterns appear with an RP: prefix. To change rotating pattern settings, you must use the Rotating Patterns pane in the Policies module as described in the Workforce Management Web for Supervisors Help (Classic).

Calendar Module Security

The WFM Web defines security access permissions. Users may have full security access to this module, or they may only be able to work with preferred Calendar items.

If you have limited access, then the Grant, Prefer, and Decline buttons are disabled. You can only add, edit, or delete calendar items in Preferred status.

Displaying the Calendar View

To view Calendar items:

If the Calendar Items module is not displayed, select Calendar from the Views menu.
In the three-month Calendar display, select the date(s) to view. Shift-click selects multiple dates.
Click Get data below the Object pane.

Calendar View Columns

Name	Description
Site	Displays the site to which the Agent in this row belongs.
Team	Displays the team to which the Agent in this row belongs.
Agent	Displays the name of the agent who has the Calendar item. Calendar items can be applied to sites or teams, but they are displayed and edited agent-by-agent.
Shared Transport	Displays the shared transport to which the agent in this row is joined
Type	Displays the type of the Calendar item (for example, part-day exception).
Item	Displays the name of the Calendar item (for example, Team Meeting or Shift_1).
Site Date	Displays the date of the Calendar item in the Site Time Zone.
Start	Displays the time the Calendar item begins. Some full-day rotating pattern items (Day Off, Any Shift, and Flexible Shift) do not have start or end times. For this reason, the Start time and End time columns are empty for these items.
End	Displays the time the Calendar item ends. +1 indicates the day after the start time; +2 indicates two days after the start time. Some full-day rotating pattern items (Day Off, Any Shift, and Flexible Shift) do not have start or end times. For this reason, the Start time and End time columns are empty for these items.
Status requested	Displays the status of a Calendar item for a period that has not yet been included in a schedule, as set by the user: Granted, Declined, or Preferred. See Change Preference Status for an explanation of the statuses. See Requested Status vs. Actual Status for an explanation of the status that appears in the status requested and Status actual columns.
Status actual	Displays the status of the Calendar item as resolved by Workforce Manager: Granted, Declined, Preferred, Scheduled, or Not Scheduled. See Change Preference Status for an explanation of the statuses. See Requested Status vs. Actual Status for an explanation of the status that appears in the status requested and Status actual columns.
Reason	Explains why WFM has set an item's actual status to Declined. You can display/hide this column by using the Option menu.
Comments/Memo	Displays any comments or additional information associated with the Calendar item, including ones that might have been entered by agents when requesting the item using WFM Web for Agents. You can display/hide this column by using the Option menu. This column is not sortable.
Paid Hours	Displays the number of paid hours for the calendar item. You can display or hide this column by using the Option menu.
Hire Date	Displays the date that the Agent began work for the company.
Submitted	Displays the date and time that the Calendar item was submitted (by either an Agent or a Supervisor, depending on the type of Calendar item).
Site Time Zone	Displays the Site Time Zone.

How to Use the Calendar

Select any single date by clicking it.
Select multiple dates by holding down Ctrl while clicking them.
Select a range of dates by holding down Shift while clicking them or by clicking the first day and then dragging the mouse to the last day before releasing the mouse button.
Select the same day of the week throughout a month by clicking that day's header. For example, to display all Mondays, click Mon.
Display a different year or month by clicking the year or month drop-down arrow.
Go back a month by clicking <, or advance to the next month by clicking >.

To retrieve specific data:

Select a date or range of dates.
Select one or more sites, one or more teams, or one or more agents (within one Business Unit) from the Objects pane.
Click Get data.

The table displays Calendar items for the selected site, teams, or agents. You can sort the display by clicking the header for any column.

You can search the table for particular agents by using the Search button. To search for agents, select the table to search and then enter the agent name, and press Enter. If the full text is too long to appear in a calendar cell, hover your mouse pointer over that cell. The full text appears in a tooltip.
Important
By default, if another user adds a new exception type while you have the Calendar open, the new exception type is not selected in the Filter dialog box. To see agents who have an exception of the new type assigned, open the Filter dialog box and select the check box for the new exception type.

Calendar Object Hierarchy

When you enter more than one kind of Calendar item for an agent at the same time, a hierarchy determines which takes precedence. The higher priority item appears as Granted, and incompatible lower-priority items appear as Declined.

The order of priority for exceptions and preferences is:

Granted full-day exceptions.
Granted days off.
Granted full-day time off.
Granted availability.
Granted shifts.
Granted paid (working) hours.
Granted part-day exceptions, granted part-day time off.
Rotating patterns.
Preferred items (including exceptions, paid hours, and time off with preferred status).

Consistency Checks

After you add an exception or preference in the Calendar, the Calendar performs consistency checks to determine whether it is valid.

To be valid, an exception or preference must:

Fall within the agent's Contract availability hours.
Fall within activity hours of operation for activities that the agent can perform.
Be consistent with the Contract paid hours requirements. Unpaid exceptions are added to the paid hours if they do not violate the Contract availability hours.

In addition, if you are entering multiple part-day exceptions, part-day time off, or a mix of part-day exceptions and time off, these:

Cannot overlap.
Must be compatible with a qualifying shift's settings, including meal parameters. (This limitation does not apply to full-day time off or days off.)

Preference and Exception Considerations

You can enter multiple compliant Calendar items for the same day. For example, you can enter a shift and a day off for the same day. Or you can enter an availability and a shift for the same day if the shift fits into the availability parameter. WFM Web assigns the item that best fits the agent’s schedule.
You can enter only one full-day exception of a single type per day. However, you can enter multiple part-day exceptions of the same type. (WFM Web sets the status of incompatible Calendar items to Declined.)
You can add or edit preferences and exceptions even after a schedule has been created for the affected days. However, if you make changes after building the schedule, you must rebuild the schedule to pick up the changes.

Explanation of Calendar Colors

The Calendar uses two basic cell colors, light blue and grey, and two colors for selected items, yellow and white.

Light blue indicates a selected cell for which data has not been requested. There may be data for that day or there may not.
Grey indicates a selected cell for which data was requested previously and it was selected again. That is, at some point earlier in this session, you selected this date and clicked Get data.
Yellow indicates a selected cell for which data was requested previously.
White indicates a non-selected cell for which data has not been requested. There may be data for that day or there may not.

The calendar uses two text colors, black and red.

Black indicates that you have not yet requested data for a day, and that cells are not selected.
Red replaces black when a cell is selected.

Contents