# &Evolution; Calendaring Framework

2000 Helix Code, Inc.

The &Evolution; groupware suite provides a framework for developing calendaring applications, as well as a graphical calendar client and a personal calendar server. This white paper describes the architecture of the &Evolution; calendaring framework.

## Introduction

Calendaring is an important part of a groupware suite. A calendaring framework will allow a user to keep a personal calendar and have several applications use it. Such applications could be a graphical calendar client that the user employs to schedule appointments and keep track of his time, a Palm Pilot synchronization client, or a simple alarm or reminder utility. A comprehensive calendaring framework will also allow multiple users to schedule appointments between each other; for example, a project director may want to schedule a weekly meeting with the rest of the project members, or a person who owns a large house may want to schedule a big party with his friends. The attendees will then want to reply with messages such as, “I will attend”, or “I will attend only if the proposed time is changed”.

The &Evolution; groupware suite provides a framework for developing calendaring applications, as well as a graphical calendar client or calendar user agent (&CUA;) and a personal calendar server (&PCS;).

The following sections explain the basic calendaring framework, the functions of the calendar user agent and the personal calendar server, and the relationship between the two.

## Personal Calendar Server

The personal calendar server (&PCS;) provides centralized management and storage of a user's personal calendar. Multiple clients can connect to the &PCS; simultaneously to query and modify the user's calendar in a synchronized fashion. The main features of the &PCS; are as follows:

## Storage

The &PCS; is responsible for loading and saving calendars. Centralizing the loading and saving functionality allows multiple clients to use the same calendar at the same time without having to worry about each other.

## Basic Queries

The &PCS; provides functions to do basic queries on a calendar, for example, a client can ask the server for a list of all the appointments in the calendar, or for all the data for a specific appointment.

## Recurrence and Alarm Queries

Clients can ask the &PCS; for a list of the appointments that occur within a specified time range; for example a graphical client that has a per-week view could ask the &PCS; for all the appointments that occur in a particular week. This includes multiple occurrences of a single recurring event; for example, the object for “a 1-hour meeting that occurs on every Tuesday and Thursday” is represented inside the &PCS; as a single event with a recurrence rule. Similarly, clients can ask the &PCS; for a list of events that have alarms that trigger within a specified time range.

## Notification of Changes

This is the most important function of the &PCS;, as it allows multiple calendar clients to maintain a unified view of the calendar between the server and themselves. When a client asks the &PCS; to modify or remove an event, the &PCS; notifies all the clients that are connected to it about the change. The policy is that “the server is always right”; clients can act as dumb views onto the calendar's data and they will be notified by the &PCS; when something changes.

## Calendar User Agent

A calendar user agent (&CUA;) is a program that lets a user manipulate a calendar. &Evolution; provides an attractive, graphical calendar client that communicates with the &Evolution; personal calendar server.

The &Evolution; calendar client just provides a view onto the data that is stored and managed by the personal calendar server. The calendar client does not perform direct manipulations on a calendar's data; instead it offloads those requests to the calendar server, which takes care of making the appropriate modifications in the calendar and then notifies all the clients about the changes.

## Calendar Client Library

Communication between the personal calendar server and calendar clients is defined by a set of &Bonobo; &CORBA; interfaces. Clients can be written by implementing the client-side `Listener` interface, which defines the notification callbacks that the PCS uses to inform clients about changes to the calendar.

As a convenience for >K; programmers, &Evolution; also includes a library which provides a `CalClient` class which can be used for communication with the personal calendar server. Objects of this class automatically contact the PCS when they are created. `CalClient` provides functions to request changes in the calendar, and it also emits signals when it gets notification about changes from the PCS. This makes it easy and convenient to write calendar clients for &Evolution; using >K;.

The implementation of the `CalClient` class simply wraps the &Evolution; &CORBA; interfaces for calendaring with a familiar-looking >K; object. Calls to the `Listener` interface get translated to signal emissions from the `CalClient`, thus shielding programmers from the details of the &CORBA; interfaces.