Adding an Event

To add an event to the calendar, users select the Add event option from the day view page. The code for the day view page—which is stored as the dayview.jsp file—contains the following tag: <util:link>. This tag points to the eventSess.jsp file, which creates a new event. This new event—which at this point does not have any information entered by the user—is added to user sessions. For more information about user sessions, see <util:session> section in the session in Sun Java System Portal Server Mobile Access 7.1 Tag Library Reference guide. From user sessions, the tag <util:forward> passes control to the editEvent.jsp file and is displayed on screen as a series of individual prompts. Users are prompted for event information, such as Start (for start time), End (for end time), Title, Location, and Details. After filling in the required information, users see the following options in their browsers: Submit, Repeat, Invite, Remind, and Compose.

Submit

The Submit option submits the newly created event. When users select the Submit option, control flows to the doUpdateEvent.jsp file. This action brings up a success or failure confirmation message. Furthermore, this action brings up an option users can select to return to the day view page.

Repeat

The Repeat option allows users to specify the repeat frequency (daily, weekly, monthly, or yearly) for the event. Beyond the initial repeat frequency options, users have more specific options from which to select, as follows:

• For the daily repeat frequency, users can specify that the event repeat every day, on alternate days, or on a group of days, such as Monday, Wednesday, and Friday; Tuesday and Thursday; or Saturday and Sunday.

• For the weekly repeat frequency, users can specify that the event repeat every week, on alternate weeks, or once per week on a particular day.

• For the monthly repeat frequency, users can specify that the event repeat every month, on alternate months, or once per month on a specified date.

• For the yearly repeat frequency, users can specify that the event repeat every year, on alternate years, or once per year on a specified date.

After users select a repeat frequency and supply repeat information, they have the option of supplying one final parameter: the “Repeat until” value. As its name implies, this value sets the duration of time that the repeat should continue.

The choices are to repeat until: Forever, Number of Instances, or Date.

The JSP files responsible for the repeat process begin with the prefix repeat, as in repeatFreq.jsp. The files involved are: repeatFreq.jsp, repeatInt.jsp, repeatInterval.jsp, repeatIntOK.jsp, repeatOn.jsp, repeatOnOK.jsp, repeatOnMonthly.jsp, repeatOnWeekly.jsp, repeatOnYearly.jsp, repeatUntil.jsp, repeatUntilDate.jsp, repeatUntilDateOK.jsp, repeatUntilNumber.jsp, and repeatUntilNumOK.jsp.

To see exactly which files control the repeat behavior, consult the control flow reference charts for Calendar in the Sun Java System Portal Server Mobile Access 7.1 Developer’s Reference guide.

Invite

The Invite option allows users to invite another person (the invitee) to the event. Selecting this option presents users with a number of methods for specifying the invitee, including: Quick Invite, Search, and Enter calID (calendar ID). When users select the Invite option, control flows from the dayview.jsp file to the rsvp.jsp file, to the doRSVP.jsp file, and then back to the eventHm.jsp file.

This feature is not supported when connecting to servers other than Sun Java System Calendar Server.

Remind

The Remind option enables users to set up email reminders. When users select this option, they are prompted for additional reminder data, (with one prompt per screen), as follows: the recipient’s email address, the time (prior to the event) to send the email reminder, and a message to be included with the reminder. After users select the Remind option, control flows through the following files: remindMail.jsp, remindTime.jsp, remindInterval.jsp, remindMsg.jsp, doRemind.jsp, and then back to eventHm.jsp.

This feature is not supported when connecting to servers other than Sun Java System Calendar Server.

Compose

The Compose option allows users to modify the event being created. When users select the Compose option, control flows to the editEvent.jsp file.