From 181979b2b9889a073c9ffb1aa8b4f774af62560f Mon Sep 17 00:00:00 2001 From: Federico Mena Quintero Date: Mon, 28 Feb 2000 05:20:23 +0000 Subject: Section for the personal calendar server. 2000-02-28 Federico Mena Quintero * calendar.sgml: Section for the personal calendar server. svn path=/trunk/; revision=1970 --- doc/white-papers/calendar/ChangeLog | 4 ++ doc/white-papers/calendar/calendar.sgml | 102 +++++++++++++++++++++++++++++++- 2 files changed, 103 insertions(+), 3 deletions(-) (limited to 'doc/white-papers/calendar') diff --git a/doc/white-papers/calendar/ChangeLog b/doc/white-papers/calendar/ChangeLog index 819f68905c..47b3e30c41 100644 --- a/doc/white-papers/calendar/ChangeLog +++ b/doc/white-papers/calendar/ChangeLog @@ -1,3 +1,7 @@ +2000-02-28 Federico Mena Quintero + + * calendar.sgml: Section for the personal calendar server. + 2000-02-25 Federico Mena Quintero * calendar.sgml: New file for the Evolution calendaring white paper. diff --git a/doc/white-papers/calendar/calendar.sgml b/doc/white-papers/calendar/calendar.sgml index a8c8e53ee6..6d6cb7da5e 100644 --- a/doc/white-papers/calendar/calendar.sgml +++ b/doc/white-papers/calendar/calendar.sgml @@ -1,5 +1,7 @@ Evolution"> +Evolution"> +CUA"> +PCS"> ]>
@@ -40,10 +42,104 @@ 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. This includes handling of - appointments, “to do” lists, and journal entries. + 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. + +
-- cgit v1.2.3