Creating Time Off Territory in My Schedule

  • Browser
  • iPad
  • iPhone

To block off personal time in My Schedule—for example, vacation, sick days, or jury duty—users create Time Off Territory (TOT) entries. TOT entries display in My Schedule in all statuses.

iPhone users can view Time Off Territory in My Schedule, but they cannot create or edit Time Off Territory entries from the iPhone platform.

Configuring Time Off Territory

Ensure initial configuration is complete before enabling this functionality.

To enable Time Off Territory, grant admins and users the following permissions:

Object

OLS

Record Types

Fields

FLS

Time_Off_Territory_vod

 

at least CR

 

n/a

 
  • Date_vod
  • Hours_off_vod
  • Reason_vod
  • Start_Time_vod
  • Territory_vod
  • Time_vod

Edit
  • Hours_vod
  • Status_vod

Read

Users must have at least Create and Read OLS for the Time_Off_Territory_vod object to create and view TOT in My Schedule. To enable users to edit or delete TOT entries, grant Update and/or Delete OLS for the Time_Off_Territory_vod object as well.

Configuring Hourly Time Off Territory

For hourly employees or specific time off requests, users can capture and manage TOT by the hour. To enable hourly TOT entries:

  1. Ensure the picklist value of Hourly is available in the Time_vod picklist on the Time_Off_Territory_vod object.
  2. Edit the field dependencies for the controlling Time_vod picklist on the Time_Off_Territory_vod object:
  • Edit the Start_Time_vod field dependency to include all available Start Time values for the Hourly column

  • Edit the Hours_off_vod field dependency to include all available Hours off values for the Hourly column

Custom picklist values are not supported for the Time_vod field on the Time_Off_Territory_vod object.

Creating Time Off Territory Entries

To create a TOT entry:

  1. Select the plus icon in the calendar header.
  2. Select the Time Off Territory option.

  3. Complete the new TOT record and select Save. By default, the Date_vod and Reason_vod fields are required.

iPhone users cannot create Time Off Territory records.

Users cannot create a Time Off Territory entry lasting more than five days.

All business logic for Time Off Territory is handled by the VeevaTimeOffTerritoryTrigger Apex Trigger and the VeevaTimeOffTerritoryTriggerHandler Apex Class.

Scheduling Hourly Time Off Territory

To create an hourly Time Off Territory entry:

  1. Select the Hourly option from the Time_vod picklist to unlock the Start_Time_vod and Hours_off_vod fields.
  2. Select the appropriate start time. By default, options display in half hour increments from 8 AM to 5 PM.
  3. Select the appropriate number of hours off. By default, options display in one hour increments from None to seven hours.

    Users cannot create an hourly Time Off Territory entry spanning multiple days.

  4. Select Save to create the TOT entry.

Scheduling Morning Time Off Territory

To create a morning Time Off Territory entry, select the AM Off option from the Time_vod picklist. The Time Off Territory entry is created from 8 AM to 12 PM for the selected date.

Scheduling Afternoon Time Off Territory

To create an afternoon Time Off Territory entry, select the PM Off option from the Time_vod picklist. The Time Off Territory entry is created from 1 PM to 5 PM for the selected date.

Platform Specific Details

Browser

To create a TOT entry from Lightning for My Schedule, select the appropriate time slot in any view to display a menu with the Add Time Off Territory option.

Viewing Time Off Territory

Saved TOT records display in My Schedule. In order for the Time Off Territory to display, the current user must be the Owner on the Time_Off_Territory_vod record. All-day or multi-day entries display at the top of the calendar. To edit or view a TOT record, select the TOT entry. A popover displays with View and Edit options.

TOT does not change based on the user’s time zone. For example, Sarah Jones creates an ‘AM Off’ TOT record for Tuesday while in the U.S. Eastern time zone. She later travels to the West Coast for a conference. When Sarah is in the U.S. Pacific time zone, the TOT entry does not adjust to display later in the day based on Sarah’s new time zone. The TOT entry continues to display for 8 AM-12 PM Tuesday morning, regardless of her time zone.

Multi-day Time Off Territory on Weekends

If users schedule a multi-day Time Off Territory entry spanning the weekend, the system bypasses the weekend days (based on the user’s locale) when calculating and displaying the TOT in My Schedule.

For example, Sarah Jones creates a TOT record starting on Thursday and continuing for three days. Because her user locale is en_US, My Schedule does not include Saturday or Sunday as working days, and so the TOT entry displays on Thursday, Friday, and Monday. If Sarah’s locale is iw (Israel) and she creates the same three-day TOT record, My Schedule displays the TOT on Thursday, Sunday, and Monday because Israel has a Sunday through Thursday work week.

For information on including weekends in TOT calculations, see Including Weekend Days in Time Off Territory.

Fixed Reports does not contain logic to skip the hard coded weekend days when calculating the TOT hours for a given week in the Average Calls Per Day report.

Work weeks and weekends for Israeli locales are listed in the table below.

Locale Name

Locale ID

First Working Day

Weekends

First Day of the Week

Israel

iw

Sunday

Friday, Saturday

Sunday

Israel (Hebrew)

iw_IL

Sunday

Friday, Saturday

Sunday

Customizing Time Off Territory

To meet organization requirements for Time Off Territory records, admins can add fields to the Time_Off_Territory_vod object.

To modify the options displayed to users for the TOT reason, configure the list of values in the Reason_vod field on the Time_Off_Territory_vod object.

Related Topics