Index: openacs-4/packages/acs-events/www/doc/design.html =================================================================== RCS file: /usr/local/cvsroot/openacs-4/packages/acs-events/www/doc/design.html,v diff -u -r1.1.1.1 -r1.1.1.1.28.1 --- openacs-4/packages/acs-events/www/doc/design.html 12 Jun 2001 03:56:20 -0000 1.1.1.1 +++ openacs-4/packages/acs-events/www/doc/design.html 22 Jun 2016 08:19:32 -0000 1.1.1.1.28.1 @@ -15,7 +15,7 @@
The package doesn't provide for any interpretation of events, leaving @@ -52,24 +52,24 @@ requirements for each of these areas in the following ways:
-Events: The service creates a new subtype of acs_object: +Events: The service creates a new subtype of acs_object: acs_event. It creates an auxiliary table for mapping events to parties. It provides an API for manipulating and querying events and their associated time interval sets, activities, recurrences, and parties.
-Time Intervals: The service creates tables for storing time +Time Intervals: The service creates tables for storing time intervals and sets of time intervals. It provides an API for manipulating and querying time intervals and time interval sets.
-Activities: The service creates a new subtype of acs_object: +Activities: The service creates a new subtype of acs_object: acs_activity. It creates an auxiliary table for mapping activities to objects. It provides an API for manipulating activities, their properties, and their associated objects.
-Recurrences: The service creates a table for storing +Recurrences: The service creates a table for storing information on how an event recurs, including how the event recurs and when it stops recurring. It provides an API for manipulating recurrence information and recurring events. This includes a function @@ -157,15 +157,15 @@
The 4.0 ACS Events service doesn't enforce a particular policy to prevent problems, but it does provide mechanisms that a well-designed -application can use. The keys are the event_recurrence.insert_events -procedure and the partially_populated_events view. +application can use. The keys are the event_recurrence.insert_events +procedure and the partially_populated_events view.
-insert_events takes either an event_id or a recurrence_id and a +insert_events takes either an event_id or a recurrence_id and a cutoff date. It either uses the recurrence_id, or gets it from the event_id, to retrieve the information needed to generate the dates of the recurrences. When inserting a recurring event for the first time, -the application will need to call insert_events with a +the application will need to call insert_events with a reasonable populate_until date. For calendar, for example, this could be sysdate + the lookahead limit.
@@ -200,7 +200,7 @@ For the days_of_week column, the representation chosen, a space-delimited list of integers, has a number of advantages. First, it is easy and reasonably efficient to generate the set of dates -corresponding to the recurrences. insert_events takes each +corresponding to the recurrences. insert_events takes each number in the list in turn and adds it to the date of the beginning of the week. Second, the Tcl and Oracle representations are equivalent and the translations to and from UI are straightforward. In @@ -275,33 +275,33 @@-This is the main abstraction in the package. acs_event is a -subtype of acs_object. In addition to the -acs_events table, there is an acs_event_party_map -table which maps between parties and events. The acs_event -package defines new, delete, various procedures to -set attributes and recurs_p indicating whether or not a +This is the main abstraction in the package. acs_event is a +subtype of acs_object. In addition to the +acs_events table, there is an acs_event_party_map +table which maps between parties and events. The acs_event +package defines new, delete, various procedures to +set attributes and recurs_p indicating whether or not a particular event recurs.
Because time interval sets are so simple, there is no need to make -them a subtype of acs_object. Interval sets are represented +them a subtype of acs_object. Interval sets are represented with one table to represent time intervals, and a second table which groups intervals into sets, with corresponding PL/SQL packages -defining new, delete, and additional manipulation functions. +defining new, delete, and additional manipulation functions.
-This is the secondary abstraction in the package. acs_activity is a -subtype of acs_object. In addition to the -acs_activities table, there is an acs_activity_object_map -table which maps between objects and activities. The acs_activity -package defines new, delete, and various procedures to +This is the secondary abstraction in the package. acs_activity is a +subtype of acs_object. In addition to the +acs_activities table, there is an acs_activity_object_map +table which maps between objects and activities. The acs_activity +package defines new, delete, and various procedures to set attributes and mappings.
@@ -310,15 +310,15 @@Since recurrences are always associated with events, there seemed to be no need to make them objects. The information that determines how -an event recurs is stored in the event_recurrences table. +an event recurs is stored in the event_recurrences table.
-The event_recurrence package defines new, -delete, and other procedures related to recurrences. The key -procedure is insert_events. +The event_recurrence package defines new, +delete, and other procedures related to recurrences. The key +procedure is insert_events.
-A view, partially_populated_events, is created which hides +A view, partially_populated_events, is created which hides some of the details of retrieving recurrences that need to populated further.
@@ -412,10 +412,10 @@Document Revision # | -Action Taken, Notes | +
---|
Document Revision # | +Action Taken, Notes | When? | By Whom? |
---|