.. _configure_time_schedules:

Time Schedules
---------------

Overview
..........

A time schedule includes a group of time periods. Time schedules are
assigned to partitions to set up time-of-day call routing. Time schedules
determine the partitions where calling devices search when they are
attempting to complete a call during a particular time of day. Multiple
time schedules can use a single time period.


Configure Time Schedules 
.........................

This procedure assigns a time period to a time schedule. 


**Prerequisites**:

* Configure a time period. You can only assign the time period to a time schedule 
  after you have configured a time period. 

.. note::

   VOSS Automate provides one 'All the time' schedule. The 'All the time' schedule
   is a special, default time schedule that includes all days and hours, and
   cannot be deleted.



**Perform these steps**:

1. Log in to the Admin Portal as a Provider, Reseller, or Customer administrator.
2. Set the hierarchy path to the node where you want to create the new time schedule.
3. Choose an appropriate option, based on your login:

   * Provider or Reseller administrator? Go to (default menus) **Apps Management > CUCM > Time Schedules**.
   * Customer administrator? Go to (default menus) **Apps Management > Advanced > Time Schedules**.
     
4. Choose an appropriate action: 

   * To add a new time schedule, click **Add**, then go to Step 5.
   * To edit an existing time schedule, choose the time schedule to be
     updated by clicking it in the list of time schedules. Go to Step 6.
     
5. If the **Network Device List** popup window appears, select the NDL for
   the time schedule from the drop-down menu. The window appears when you
   are on a nonsite hierarchy node. If you are at a site hierarchy node,
   the NDL associated with the site is automatically used.
   
   .. note:: 

     The **Network Device List** drop-down only appears when a time schedule is added; it does not appear when you edit a time schedule.

6. Enter a unique name for the new time schedule in the **Name** field, or
   modify the existing Name if desired. This field is mandatory. The name
   can comprise up to 50 alphanumeric characters. The name of the time
   schedule can contain any combination of spaces, periods (.), hyphens
   (-), and underscore characters (_).
7. (Optional) Enter a description for the time schedule in the **Description** field.
8. Click the Plus icon (+) to open the **Time Periods** form.
9. From the **Time Period** drop-down box, choose a time period for the time schedule.
10. Repeat Steps 8 and 9 to add another time period to the time schedule.

    .. note:: 

       * If multiple time periods are associated with a schedule where the time
         periods overlap, time periods with Day of Year settings take precedence
         over time periods with Day of Week settings. Day of Year is applicable
         when Year Start value is set and the End value is left blank.

         Example: If a Time Period configured for January 1 is configured as No
         Office Hours and another time period is configured for the same day of the
         week (for example, Sunday to Saturday) as 08:00 to 17:00, the time period
         for January 1 is used. In this example, No Office Hours takes precedence.

       * Time interval settings take precedence over No Office Hour settings for the
         same day of the year or day of the week.

         Example: One time period specifies for Saturday as No Office Hours. Another
         time period specifies Saturday hours of 08:00 to 12:00. In this example,
         the resulting time interval specifies 08:00 to 12:00 for Saturday.

       * If multiple time periods are associated with a schedule where the time
         periods overlap, time periods with Day of Week settings take precedence over
         time periods with Range of Days settings. Range of Days applies to when Year
         Start and End values are set, even if they are configured for the same day.

         Example: If a Time Period configured for Day of Week (for example, Sunday
         to Saturday) is configured as No Office Hours and another time period is
         configured for January 1 until December 31 as 08:00 to 17:00, the time period
         for Day of Week is used. In this example, No Office Hours takes precedence.

11. To save the new time schedule, click **Save**, or to update time schedule, click **Update**.
12. Repeat Steps 3 to 11 to configure another time schedule.


.. rubric:: Next Steps

You cannot delete time schedules that partitions are using. Before deleting a time
schedule that is currently in use, perform either or both of the following tasks:

* Assign a different time schedule to any partitions that are using the
  time schedule that you want to delete.
* Delete the partitions that are using the time schedule that you want to delete.

.. warning::

   Before you delete a time schedule, check carefully to ensure that you are
   deleting the correct time schedule. You cannot retrieve deleted time schedules.
   If you accidentally delete a time schedule, you must rebuild it.