Set up and configure a single resource calendar

In order keep configuration simple, please perform the following steps in Salesforce Classic (Booker25 is Lightning-Ready, you may afterwards use the app in Salesforce Lightning as you please)

If you want to display a single Resource in more detail, or are only interested in one Resource and want the calendar to not load any unnecessary data, the Single Resource Calendar is a good choice. A Single Resource Calendar shows one Resource in a view that allows for a more detailed view of the resource.

Single resource calendar example


Make sure to enable the following Record Types on your Profiles and Permission Sets:

Calendar

Single Resource Calendar

Multi Resource Calendar

(Reservation) Titles 

Reservation Title

Resource Title

Views

Single Resource Calendar View

Multi Resource Calendar View


Create a Tab to make your Calendar accessible

If you haven't done so already, follow step 2 in Create a Calendar page for any object. This will make the Calendar accessible in a tab for yourself and your users.


Edit an existing Single Resource Calendar record

  1. Go to the Calendars tab
  2. Click Go! next to All



  3. Select Single Resource Calendar record you want to edit (the name starts with Single)
  4. Edit the fields according to the following information: Calendar record fields

Creating Reservation Titles

  1. Go to the Calendars tab
  2. Select the record representing the calendar you want to add Reservation Titles to
  3. Scroll down the Reservation Titles related list
  4. Click New
  5. You should now see the following page:

  6. Enter the desired title information and hit Save. For a explanation of each of the fields and their function, see the Reservation title record fields section.

Edit an existing view

  1. Go to the Views tab in the menu bar
  2. Click on Go! next to All
  3. Select the Single Resource Calendar View record you want to edit
  4. Enter the desired view configuration according to the view record fields section

Setting up a Hover for Reservations on the calendar

Booker25 allows you to define a popup window that appear at the users cursor when they hover over a reservation on the calendar



  1. Go to the View record for which you want to create a Hover
  2. Scroll down to the Reservation Display related list
  3. Click New
  4. You should now see the following page



  5. Fill the Resource Type field only if you want to create a Resource Type specific Hover (Display Reservation Time is deprecated and wil be removed in later booker25 versions)
  6. Click Save
  7. You should now be on the detail page of the reservation display object. For a detailed explanation of the hover setup see the Add fields and related lists to the hover.

Linking a view to a calendar

If you set up your own Calendar and View records, you need to connect them as follows.

  1. Go to the Calendars tab and select the calendar you want to link to the View.
  2. Scroll down to the Calendar Views related list
  3. Click New Calendar View
  4. You should now see this page



  5. For View, select the View object you want to link to this Calendar
  6. If this view should be selected by default, check Default View. (Only one view should ever by marked as Default. If a different view is already marked as Default, do not forget to uncheck it on that View)
  7. Enter a number to specify the order of this button on the calendar. The buttons on the calendar page are ordered from left to right, from lowest to highest
  8. Click Save

Configuring the reservation colors

For details on reservation colors see Reservation Statuses

More detailed field information

 Calendar record fields

Field name Description
calendar NameThe name of the calendar. This name is not used in the ui but is used to identify the calendar. This field has to be one of three values 'SingleResourceCalendar', 'SingleStaffCalendar',
'SingleGroupCalendar' used to configure resource staff and group calendars.
Reservation Field

Booker25 has three resource types resource staff and group. Based on what type you want this calendar to display pick either B25__Resource__c, B25__Staff__c or B25__Group__c.

Reservation Title FieldDeprecated and wil be removed from the page layout in future versions of Booker25. Just leave it at the default value.

The three fields under default colors specify the color of reservations on this calendar that do not have any more specific reservation color defined using reservation types and status.

Example:

Field nameexample value
Default Text Colorwhite
Default Background Colororange
Default Border Colorblue

Results in the following reservation appearance.

 Reservation title record fields

Field nameDescription
Title nameThe Api name of the field you want to display on the calendar. Starting point for this field is the reservation object.
BoldIf the value of the field should be made bold on the reservation
Font Size The font size the value should appear in on the reservation
CalendarThe calendar that the title belongs to.
OrderThe order in which the titles should appear on the calendar with lower numbers being first.

Example of a reservation with various titles with different settings.

 View record fields section

Views records are what specify ways to look at the calendar the available views are shown in the top right corner of the calendar

 

View fields:

Field name description
Slot duration
Slot height
View duration
Day Header Time Format

Specifies the format of the header on the calendar. The format needs to be specified according to these date format optionsExample with ddd MMMM yyyy.

LabelThe text displayed in the buttons to switch between views
Unique Identifier

Unique id for this view.

Hide Times Without Reservations 

Hides all times at the start and end of the day if there are no reservations there. Example calendar with and without the setting enabled.
Overrides Hide closed times without reservations. Example of the difference between Hide Times Without Reservations setting and Hide closed times without reservations

Time Range FormatThe format for the time range at the top of the calendar. It is posible to specify formats for the start and end date of the calendar. Using start{<formatting tokens>} and end{<formatting tokens>} for the formatting tokens use moment.js formatting tokens (http://momentjs.com/docs/#/displaying/format/). example: start{ddd MMM DD} - end{ddd MMM DD, YYYY} would result in Sat Sep 01 - Mon Oct 01, 2018
Hide closed times without reservationsHides all times where the resource is closed at the start and end of the day if there are no reservations there. Example calendar with and without the setting enabled.

Time header:

Field namedescription
Time header WidthThe width in pixels of the time header.
Time Header FormatThe time format of the sidebar containing the time of day on the Single Resource Calendar. Valid values: Clock12Hours, Clock24Hours, Auto. Auto wil use the users preferred time format set in salesforce.
Time Header durationThe increments of the time header should divide 60 without a remainder. Should also either divide slot duration or be divided by slot duration without a remainder.
 Date format options

  • yyyy - full year: 2013
  • MMMM - full month name string: January
  • MMM - short month name string: Jan
  • MM - two-digit month number: 01
  • M - month number: 1
  • dddd - day of week string: Monday
  • ddd - short day of week string: Mo
  • dd - two-digit day of month number: 09
  • d - day of month number: 9
  • HH - two-digit hours, 24-hour clock: 23
  • H - hours, 24-hour clock: 23
  • hh - two-digit hours, 12-hour clock: 11
  • h - hours, 12-hour clock: 11
  • tt - AM/PM string
  • mm - two-digit minutes: 08
  • m - minutes: 8
  • ss - two-digit seconds: 07
  • s - seconds: 7

On this page