Managing agent calendar

  • Release version: Zurich
  • Updated July 31, 2025
  • 3 minutes to read
  • Summarize
    Summarized using AI
    This content was generated using new OpenAI-powered functionality. Results are provided on an as is basis and are not guaranteed to be accurate or complete.

    Summary of Managing agent calendar

    The agent calendar in ServiceNow enables customer service agents and field service technicians to view their work schedules, assignments, and add personal events like meetings or appointments. It supports managing fixed or varied work schedules and shifts, including rotating patterns by week or month. The calendar setup is managed by an agent calendar administrator, who configures schedules and event types displayed on the calendar.

    Show full answer Show less

    Agent calendar data integrates with other ServiceNow features, such as the assignment workbench, central dispatch, and auto assignment. These features use agent availability and work schedules to optimize case and task assignments.

    Key Features

    • Calendar Views: Agents can view their calendar by day, week, or month with navigation controls to move through time periods.
    • Event Management: Agents can add, move, and view details of personal and work-related events directly on the calendar.
    • Administrator Configuration: Administrators can configure event types, work schedules, personal events, and overall schedules to tailor the calendar to organizational needs.
    • Mobile Support: The agent calendar is accessible via the ServiceNow mobile app and mobile web.
    • Role-Based Access: Users with the agentscheduleuser role can access and update their calendars; administrators with agentscheduleadmin configure the calendar.

    Technical Components

    • Plugin: The Agent Schedule plugin (com.snc.agentschedule) is included with Customer Service Management and Field Service Management plugins and provides calendar functionality.
    • Key Tables:
      • agentworkschedule: Stores agent work schedules with date ranges and types.
      • agentevents: Stores personal event data like training or personal time off.
      • agentscheduletaskconfig: Configures task types displayed on the calendar.
      • agentscheduleuserpref: Stores user calendar personalization data.
      • Additional tables manage relationships between configurations and calendar display themes.
    • User Roles:
      • agentscheduleuser: Access and update personal calendars.
      • agentscheduleadmin: Configure calendar settings and schedules.

    Practical Use for ServiceNow Customers

    By implementing the agent calendar, customers can efficiently manage agent and technician schedules, improve assignment accuracy by considering agent availability, and provide agents with a unified view of work and personal commitments. This streamlined scheduling enhances workforce management and supports better service delivery.

    Administrators can customize the calendar to reflect organizational scheduling practices and task types, ensuring relevant information is visible and actionable. The calendar's integration with assignment features automates resource allocation, reducing manual effort and improving responsiveness.

    Customer service agents and field service technicians can use the agent calendar to see work schedules and assignments and also add personal events such as meetings or appointments.

    The agent calendar provides a tool for maintaining different work schedules or shifts and assigning agents and technicians to shifts for specific time periods. The calendar has the flexibility to accommodate work schedules that are fixed or varied and shifts that rotate by week, month, or other patterns. The agent calendar administrator creates the calendar configuration, including a schedule configuration for each calendar user and the types of tasks to display on the calendar.

    The schedule information stored in the agent calendar is used by other ServiceNow applications and features, such as the assignment workbench, central dispatch, and auto assignment. The assignment workbench uses agent availability, based on upcoming work schedules and personal time off, when evaluating predefined criteria and recommending agents for case assignment. Auto assignment in Service Management core applications, such as Field Service Management and Facilities Service Management, evaluate agent work schedules before assigning tasks.

    The agent calendar administrator has access to the Agent Schedule menu in the application navigator. This menu includes the following modules:
    • Event Configuration: create a configuration for each type of event or task displayed on the agent calendar.
    • Work Schedule: create one or more work schedules for each calendar user.
    • Agent Personal Events: create personal schedules for each agent and add events to those schedules.
    • Schedule: create or modify schedules. For more information, see Schedules.

    Viewing the calendar

    Customer service agents and field service technicians with the agent_schedule_user role can access their personal calendars in the following ways:
    • Customer Service > My Schedule
    • Field Service > Agent > My Schedule
    Note:
    The agent calendar is supported in the mobile application and the mobile web.
    Figure 1. Agent Calendar
    Calendar displaying an agent's schedule and daily assignments including work hours, tasks, personal meetings, and appointments.

    The calendar can display a single day, a week, or a month. Buttons in the calendar header allow you to switch views as well as go backward or forward in time. An agent's scheduled work hours are highlighted in gray and the current day is highlighted in blue. The agent calendar displays work or tasks assigned to the agent as well as personal events. Each type of event is displayed on the calendar using a different color.

    Agents can add events to their calendars by double-clicking a specific time slot and entering the details in the New Event popup window or by clicking and dragging. Agents can also move events by dragging and dropping. Click an event to display a popup with event details and double-click an event to open the event record.

    Plugins

    The Agent Schedule plugin (com.snc.agent_schedule) is activated as part of the Customer Service Management and Field Service Management plugins.

    Tables

    The Agent Schedule plugin adds the following tables.
    Table 1. Tables installed with the Agent Schedule plugin
    Table Description
    Agent Work Schedule

    [agent_work_schedule]

    Stores one or more work schedules for each agent, including the date range for the schedule and the schedule type.
    Agent Personal Schedule

    [agent_events]

    Stores personal calendar events for each agent, such as training, personal time off, or meetings.
    Event Configuration

    [agent_schedule_task_config]

    Stores a configuration for each type of task displayed on the agent calendar, such as case tasks or work order tasks.
    Agent Schedule User Config

    [agent_schedule_user_pref]

    Stores the agent’s personalization data for the calendar. A user configuration is created automatically when a user with the agent_schedule_user role accesses their personal calendar.
    Agent Schedule Relationship

    [agent_schedule_task_config_rel_user_pref]

    Stores the relationships between agent configurations and event configurations. Relationship entries are created automatically based on a user's read access to the task tables selected in the event configurations.
    Agent Schedule Definition Theme

    [agent_schedule_definition_theme]

    Stores the colors used to display different types of tasks on the agent calendar.

    User Roles

    The following user roles are included with the Agent Schedule (com.snc.agent_schedule) plugin.
    Table 2. Roles included with Agent Schedule plugin
    Role Description
    Agent schedule administrator

    [agent_schedule_admin]

    Sets up the Agent Calendar configuration. Contains roles:
    • agent_schedule_user
    • schedule_admin
    Agent schedule user

    [agent_schedule_user]

    Allows customer service agents and field service technicians to access and update their personal calendars.