Reservation Waitlist data model
Summarize
Summary of Reservation Waitlist data model
The Reservation Waitlist data model in ServiceNow’s Workplace Reservation Management supports managing waitlist requests, space allocation, and reservation fulfillment for employees. It tracks waitlist statuses, links waitlist records to reservations, and allows prioritization and manual fulfillment by event planners, enabling efficient handling of space demand.
Show less
Key Features
- Reservation Waiting Lists Table (snwsdrsvwaitlist): Stores waitlist requests with important columns such as Neighborhood, Reservable Module, Fulfilled by, and Status to manage waitlist lifecycle.
- Status Management: Waitlist records can have these statuses:
- Queued: Initial status when an employee submits a waitlist request.
- Confirmed: When a queued request is fulfilled and space is assigned.
- Expired: Automatically set by a scheduled job for stale or past waitlist records; records are retained for 30 days before purge.
- Canceled: Status when a queued request is canceled by an employee or event planner.
- Workplace Reservation Table (snwsdrsvreservation): Includes a Waitlist origin column indicating if a reservation originated from a fulfilled waitlist request.
- Reservable Module and Neighborhood: Employees can join waitlists for specific reservable modules (e.g., desks, meeting rooms) or neighborhoods to receive preferred space allocations when available.
- Priority and Allocation: Event planners can assign a Weight (priority) to queued waitlist records; higher weight records are fulfilled first. Without weight, FIFO based on creation time applies.
- Manual Fulfillment: The Fulfilled by column records when event planners manually assign spaces to queued waitlist requests.
- Reservable Module Configuration: To enable waitlist functionality, administrators must activate:
- Enable Waitlist – allows employees to join waitlists.
- Enable browse by Neighborhood – allows waitlisting on neighborhoods for preferred space allocation.
Practical Benefits
This data model empowers ServiceNow customers to efficiently manage high demand for workplace spaces by automating waitlist handling, prioritizing requests, and providing event planners tools for manual intervention. It ensures transparent tracking of waitlist statuses and their fulfillment, helping optimize space utilization and employee satisfaction.
The Reservation Waitlist data model describes the tables and configuration options that support waitlist requests, space allocation, and reservation fulfillment for employees.
Reservation Waiting Lists
The Reservation Waiting Lists table (sn_wsd_rsv_waitlist) is updated with Neighborhood, Reservable Module, and Fulfilled by columns for manual event planner fulfillment. Navigate to .
- Queued: When an employee submits a waitlist request, the system creates a record in the Reservation Waitlist [sn_wsd_rsv_waitlist] table with the status set to Queued
- Confirmed: The queued waitlist request is approved or fulfilled, a space is assigned for reservation, and the status changes from Queued to Confirmed.
- Expired: Stale or past waitlist records are removed by the nightly Waitlist Expiration scheduled job. The scheduled job identifies waitlist records in Queued state. The scheduled job
detects past or stale timestamps for waitlist records. Waitlist records with a past start time are set to Expired. Expired records are retained for 30 days before being permanently purged.
For more information, see Create a schedule job for waitlist.
- Canceled: An employee or the Reservation Event Planner cancels a Queued waitlist record. The status changes from Queued to Canceled.
Workplace Reservation
The Workplace Reservation Table (sn_wsd_rsv_reservation) is updated with Waitlist origin column. By default, the value in this column is set to False. When a Queued waitlist record is fulfilled and confirmed, a space is assigned and a reservation is created. When a reservation record is created, the Waitlist origin column value changes to True. This column shows how many waitlist records are fulfilled, supporting waitlist management.
- Reservable Module Record: Workplace users can join a waitlist only for a reservable module — for example, desks or meeting rooms. For more information, see Configure a reservable module.
- Neighborhood: Workplace users can also waitlist on a neighborhood so that preferred neighborhood space allocation is done when the space is free and available for reservation.
- Weight (Priority): Only event planners can update the weight of a queued waitlist record. Records with the highest weight move to the top of the queue and are allocated a space first. For more information, see Manage reservation waitlist records.
- Created: If no weight value is set, space allocation follows first-in, first-out (FIFO) logic based on the date and time the waitlist record was created. Records with an earlier start time are prioritized.
- Fulfilled by: The Fulfilled by column value is updated only when a Workplace Reservation Event Planner manually assigns a space to an employee whose waitlist is in a Queued state. For more information, see Manage reservation waitlist records.
Reservable Module Configuration
The following configuration options must be enabled in the Reservable Module Configuration for employees to join a waitlist. For more information, see Configure a reservable module.
- Enable Waitlist: When selected, enables employees to join a waitlist.
- Enable browse by Neighborhood: When selected, enables employees to join a waitlist for a neighborhood space and have a preferred neighborhood space assigned when one is available.
For more information, see Create a reservation waitlist.