11 Managing Calendar Holidays

This chapter describes the different tasks involved in managing holidays within a calendar server node network.

This chapter contains the following sections:

• About Holidays

• Assigning Holiday Administration Rights

• Creating Holidays

• Modifying Holidays

About Holidays

Holidays are special events that appear in the calendars of all users and event calendars in a node. Holidays can be created one-by-one by any user with the proper administrative rights, through the Oracle Calendar administrator, an Oracle Calendar desktop client, or on the command line using the $ORACLE_HOME/ocal/bin/uniical utility.

Assigning Holiday Administration Rights

The SYSOP, by default, has holiday management rights. The administrator can also assign holiday administration rights to a regular Calendar user. This can be done either through the Calendar Administrator or the command line.

You can assign holiday administration rights using the Oracle Calendar administrator web GUI, or by using the uniadmrights utility.

Oracle Calendar Administrator

Use the Oracle Calendar administrator to assign holiday administrative rights to a user.

1. Sign in as the SYSOP user.

2. Click the Calendar Management tab.

3. Click on the Users secondary tab.

4. Search for the user, or click Go to list all users.

5. Select the Pencil icon in the Actions column next to the user who's administration rights you want to modify.

6. Click Administrative Rights from the menu on the left.

   
   

   Note: The Administrative Rights option will only appear if you are signed in to the Oracle Calendar administrator as the SYSOP, or as a user with the right to manage other users' administrative rights.

   
   

7. Scroll down to the Node Management section.

8. Check the Manage Holidays checkbox, the click Apply.

UNIADMRIGHTS Utility

Use the uniadmrights utility to assign holiday administration rights. For more information about the use and syntax of the uniadmrights utility, see "Calendar Server Utilities" in Chapter 6 of Oracle Calendar Reference Manual.

For example:

% uniadmrights -u "S=Sitchin/G=Zechariah" -n 165 -node "holiday=true" 

Creating Holidays

You can create holidays using the Oracle Calendar desktop client, the Oracle Calendar administrator, or the uniical utility.

Oracle Calendar Desktop Client

Use the Oracle Calendar desktop client to create holidays.

1. Sign in as a user who has been granted holiday administration rights.

2. Select the holiday management menu item (Tools | Manage Holidays...).

See the Oracle Calendar desktop client online Help for more details.

Oracle Calendar Administrator

Use the Oracle Calendar administrator to create holidays.

1. Sign in to the Calendar administrator as the SYSOP user or as a user who has been granted holiday administration rights.

2. Click the Server Administration tab.

3. Click on the Nodes secondary tab.

4. Search for the node if it is not already listed.

5. Click the node's Manage Holiday icon in the Actions column.

6. A calendar will be displayed in which you can add, modify, or delete holidays.

7. Click the Create Holiday icon at the top to add new holidays.

8. Enter the holiday title in the Title text box, and the holiday date in the Start Time drop-down list, then click Apply.

UNIICAL Utility

Use the $ORACLE_HOME/ocal/bin/uniical utility to import multiple holidays from a file.

1. Create a file that will be used to import the holidays. The contents of the file must include iCAL VEVENT objects that conform to the following standards for each holiday entry:

   BEGIN:VCALENDAR
   VERSION:2.0
   PRODID:Oracle/Calendar
   BEGIN:VEVENT
   X-ORACLE-EVENTTYPE:Holiday
   SUMMARY:<Name of the Holiday>
   DTSTART;VALUE=DATE:20061231
   DTEND;VALUE=DATE:20061231
   END:VEVENT
   END:VCALENDAR
   

   
   

   Notes: In order for the event to appear as a holiday in Oracle Calendar, the X-ORACLE-EVENTTYPE attribute must be set to Holiday. Specify the DTSTART and DTEND values in the YYYYMMDD format. Do not include time in the string.

   
   

   Multiple iCAL VEVENTS can appear in the same file.

2. Save and exit the file.

3. Import the file using the following command line utility and options:

   % uniical -import -f filename -u holiday -n NodeID
   
   

   Where filename is the name of the file saved in Step 2, and NodeID is the node to which the holidays will be added.

Note: For more information about the $ORACLE_HOME/ocal/bin/uniical utility, see "UNIICAL" in Chapter 6 of the Oracle Calendar Reference Manual.

Modifying Holidays

You can modify holidays using the Oracle Calendar desktop client, the Oracle Calendar administrator, or the uniical utility.

Oracle Calendar Desktop Client

Use the Oracle Calendar desktop client to modify holidays.

1. Sign in to the Oracle Calendar desktop client as a user who has been granted holiday administration rights.

2. Select the holiday management menu item (Tools | Manage Holidays...).

See your Oracle Calendar desktop client online Help for more details.

Oracle Calendar Administrator

Use the Oracle Calendar administrator to modify holidays.

1. Sign in as the SYSOP or as a user who has holiday administration rights.

2. Select the Server Administration tab.

3. Click on the Nodes secondary tab.

4. Search for the node if it is not already listed.

5. Click the node's Manage Holiday icon in the Actions column.

6. A calendar will be displayed in which you can add, modify or delete holidays. To modify an existing holiday, find it using the navigation links (Previous or Next) on the top right and then click its link in the calendar.

7. Once you have found the holiday you wish to modify, click on its title.

8. Modify the holiday, then click Apply.

UNIICAL Utility

Use the $ORACLE_HOME/ocal/bin/uniical utility to modify multiple holidays from a file.

1. Locate the UID values for the holidays that require modification. To do this, use the uniical utility with the -export option. For more information about exporting events using uniical see "UNIICAL", in Chapter 6 of the Oracle Calendar Reference Manual.

2. Create a new import file with the holidays that require modification. The UID attribute value must be specified for each holiday within the import file. If a UID is not specified, a new event will be created.

   Include the X-ORACLE-EVENT-TYPE, SUMMARY, DTSTART, and DTEND attributes with any the necessary modifications. In this example, the SUMMARY attribute has been modified to "National Holiday" from its previous value:

   BEGIN:VCALENDAR
   VERSION:2.0
   PRODID:Oracle/Calendar
   BEGIN:VEVENT
   UID = 20060515T185134Z-401-8848-746085f3-Oracle
   X-ORACLE-EVENTTYPE:Holiday
   SUMMARY:National Holiday
   DTSTART;VALUE=DATE:20061231
   DTEND;VALUE=DATE:20061231
   END:VEVENT
   END:VCALENDAR
   
   

3. Save and exit the file.

4. Import the file saved in Step 3 using the following command line utility and options:

   % uniical -import -f filename -u holiday -n NodeID
   
   

   Where filename is the name of the file saved in Step 3, and NodeID is the node on which the holidays will be modified.

Note: For more information about the $ORACLE_HOME/ocal/bin/uniical utility, see "UNIICAL" in Chapter 6 of the Oracle Calendar Reference Manual.