KickJava   Java API By Example, From Geeks To Geeks.

Java > Open Source Codes > org > columba > calendar > model > api > ICALENDAR


1 package org.columba.calendar.model.api;
2
3
4 /**
5  * All iCalendar features Columba is able to handle.
6  * <p>
7  * These are the actually used xml-tags, which are mapped to the corresponding
8  * iCalendar properties.
9  *
10  * @author fdietz
11  */

12 public interface ICALENDAR {
13
14     public final static String JavaDoc ICALENDAR = "icalendar";
15
16     /**
17      * Description: A "VEVENT" calendar component is a grouping of component
18      * properties, and possibly including "VALARM" calendar components, that
19      * represents a scheduled amount of time on a calendar. For example, it can
20      * be an activity; such as a one-hour long, department meeting from 8:00 AM
21      * to 9:00 AM, tomorrow. Generally, an event will take up time on an
22      * individual calendar. Hence, the event will appear as an opaque interval
23      * in a search for busy time. Alternately, the event can have its Time
24      * Transparency set to "TRANSPARENT" in order to prevent blocking of the
25      * event in searches for busy time.
26      * <p>
27      * The "VEVENT" is also the calendar component used to specify an
28      * anniversary or daily reminder within a calendar. These events have a DATE
29      * value type for the "DTSTART" property instead of the default data type of
30      * DATE-TIME. If such a "VEVENT" has a "DTEND" property, it MUST be
31      * specified as a DATE value also. The anniversary type of "VEVENT" can span
32      * more than one date (i.e, "DTEND" property value is set to a calendar date
33      * after the "DTSTART" property value).
34      */

35     public final static String JavaDoc VCALENDAR = "vcalendar";
36
37     /**
38      * Property Name: PRODID
39      *
40      * Purpose: This property specifies the identifier for the product that
41      * created the iCalendar object.
42      *
43      * Value Type: TEXT
44      *
45      * Property Parameters: Non-standard property parameters can be specified on
46      * this property.
47      *
48      * Conformance: The property MUST be specified once in an iCalendar object.
49      *
50      * Description: The vendor of the implementation SHOULD assure that this is
51      * a globally unique identifier; using some technique such as an FPI value,
52      * as defined in [ISO9070].
53      *
54      * This property SHOULD not be used to alter the interpretation of an
55      * iCalendar object beyond the semantics specified in this memo. For
56      * example, it is not to be used to further the understanding of non-
57      * standard properties.
58      */

59     public final static String JavaDoc VCALENDAR_VERSION = "version";
60
61     /**
62      * Property Name: VERSION
63      *
64      * Purpose: This property specifies the identifier corresponding to the
65      * highest version number or the minimum and maximum range of the iCalendar
66      * specification that is required in order to interpret the iCalendar
67      * object.
68      *
69      * Value Type: TEXT
70      *
71      * Property Parameters: Non-standard property parameters can be specified on
72      * this property.
73      *
74      * Conformance: This property MUST be specified by an iCalendar object, but
75      * MUST only be specified once.
76      */

77     public final static String JavaDoc VCALENDAR_PRODID = "prodid";
78
79     /**
80      * Property Name: METHOD
81      *
82      * Purpose: This property defines the iCalendar object method associated
83      * with the calendar object.
84      *
85      * Value Type: TEXT
86      *
87      * Property Parameters: Non-standard property parameters can be specified on
88      * this property.
89      *
90      * Conformance: The property can be specified in an iCalendar object.
91      *
92      * Description: When used in a MIME message entity, the value of this
93      * property MUST be the same as the Content-Type "method" parameter value.
94      * This property can only appear once within the iCalendar object. If either
95      * the "METHOD" property or the Content-Type "method" parameter is
96      * specified, then the other MUST also be specified.
97      *
98      * No methods are defined by this specification. This is the subject of
99      * other specifications, such as the iCalendar Transport-independent
100      *
101      * Interoperability Protocol (iTIP) defined by [ITIP].
102      *
103      * If this property is not present in the iCalendar object, then a
104      * scheduling transaction MUST NOT be assumed. In such cases, the iCalendar
105      * object is merely being used to transport a snapshot of some calendar
106      * information; without the intention of conveying a scheduling semantic.
107      */

108     public final static String JavaDoc VCALENDAR_METHOD = "method";
109
110     public final static String JavaDoc VEVENT = "vevent";
111
112     /**
113      * Description: A "VTODO" calendar component is a grouping of component
114      * properties and possibly "VALARM" calendar components that represent an
115      * action-item or assignment. For example, it can be used to represent an
116      * item of work assigned to an individual; such as "turn in travel expense
117      * today".
118      * <p>
119      * The "VTODO" calendar component cannot be nested within another calendar
120      * component. However, "VTODO" calendar components can be related to each
121      * other or to a "VTODO" or to a "VJOURNAL" calendar component with the
122      * "RELATED-TO" property.
123      */

124     public final static String JavaDoc VTODO = "vtodo";
125
126     /**
127      * Property Name: UID
128      *
129      * Purpose: This property defines the persistent, globally unique identifier
130      * for the calendar component.
131      *
132      * Value Type: TEXT
133      *
134      * Property Parameters: Non-standard property parameters can be specified on
135      * this property.
136      *
137      * Conformance: The property MUST be specified in the "VEVENT", "VTODO",
138      * "VJOURNAL" or "VFREEBUSY" calendar components.
139      *
140      * Description: The UID itself MUST be a globally unique identifier. The
141      * generator of the identifier MUST guarantee that the identifier is unique.
142      * There are several algorithms that can be used to accomplish this. The
143      * identifier is RECOMMENDED to be the identical syntax to the [RFC822]
144      * addr-spec. A good method to assure uniqueness is to put the domain name
145      * or a domain literal IP address of the host on which the identifier was
146      * created on the right hand side of the "@", and on the left hand side, put
147      * a combination of the current calendar date and time of day (i.e.,
148      * formatted in as a DATE-TIME value) along with some other currently unique
149      * (perhaps sequential) identifier available on the system (for example, a
150      * process id number). Using a date/time value on the left hand side and a
151      * domain name or domain literal on the right hand side makes it possible to
152      * guarantee uniqueness since no two hosts should be using the same domain
153      * name or IP address at the same time. Though other algorithms will work,
154      * it is RECOMMENDED that the right hand side contain some domain identifier
155      * (either of the host itself or otherwise) such that the generator of the
156      * message identifier can guarantee the uniqueness of the left hand side
157      * within the scope of that domain.
158      *
159      * This is the method for correlating scheduling messages with the
160      * referenced "VEVENT", "VTODO", or "VJOURNAL" calendar component.
161      *
162      * The full range of calendar components specified by a recurrence set is
163      * referenced by referring to just the "UID" property value corresponding to
164      * the calendar component. The "RECURRENCE-ID" property allows the reference
165      * to an individual instance within the recurrence set.
166      *
167      * This property is an important method for group scheduling applications to
168      * match requests with later replies, modifications or deletion requests.
169      * Calendaring and scheduling applications MUST generate this property in
170      * "VEVENT", "VTODO" and "VJOURNAL" calendar components to assure
171      * interoperability with other group scheduling applications. This
172      * identifier is created by the calendar system that generates an iCalendar
173      * object.
174      *
175      * Implementations MUST be able to receive and persist values of at least
176      * 255 characters for this property.
177      */

178     public final static String JavaDoc UID = "uid";
179
180     /**
181      * Property Name: DTSTAMP
182      *
183      * Purpose: The property indicates the date/time that the instance of the
184      * iCalendar object was created.
185      *
186      * Value Type: DATE-TIME
187      *
188      * Property Parameters: Non-standard property parameters can be specified on
189      * this property.
190      *
191      * Conformance: This property MUST be included in the "VEVENT", "VTODO",
192      * "VJOURNAL" or "VFREEBUSY" calendar components.
193      *
194      * Description: The value MUST be specified in the UTC time format.
195      *
196      * This property is also useful to protocols such as [IMIP] that have
197      * inherent latency issues with the delivery of content. This property will
198      * assist in the proper sequencing of messages containing iCalendar objects.
199      *
200      * This property is different than the "CREATED" and "LAST-MODIFIED"
201      * properties. These two properties are used to specify when the particular
202      * calendar data in the calendar store was created and last modified. This
203      * is different than when the iCalendar object representation of the
204      * calendar service information was created or last modified.
205      */

206     public final static String JavaDoc DTSTAMP = "dtstamp";
207
208     /**
209      * Property Name: DTSTART
210      *
211      * Purpose: This property specifies when the calendar component begins.
212      *
213      * Value Type: The default value type is DATE-TIME. The time value MUST be
214      * one of the forms defined for the DATE-TIME value type. The value type can
215      * be set to a DATE value type.
216      *
217      * Property Parameters: Non-standard, value data type, time zone identifier
218      * property parameters can be specified on this property.
219      *
220      * Conformance: This property can be specified in the "VEVENT", "VTODO",
221      * "VFREEBUSY", or "VTIMEZONE" calendar components.
222      *
223      * Description: Within the "VEVENT" calendar component, this property
224      * defines the start date and time for the event. The property is REQUIRED
225      * in "VEVENT" calendar components. Events can have a start date/time but no
226      * end date/time. In that case, the event does not take up any time.
227      *
228      * Within the "VFREEBUSY" calendar component, this property defines the
229      * start date and time for the free or busy time information. The time MUST
230      * be specified in UTC time.
231      *
232      * Within the "VTIMEZONE" calendar component, this property defines the
233      * effective start date and time for a time zone specification. This
234      * property is REQUIRED within each STANDARD and DAYLIGHT part included in
235      * "VTIMEZONE" calendar components and MUST be specified as a local
236      * DATE-TIME without the "TZID" property parameter.
237      */

238     public final static String JavaDoc DTSTART = "dtstart";
239
240     /**
241      * Property Name: DTEND
242      *
243      * Purpose: This property specifies the date and time that a calendar
244      * component ends.
245      *
246      * Value Type: The default value type is DATE-TIME. The value type can be
247      * set to a DATE value type.
248      *
249      * Property Parameters: Non-standard, value data type, time zone identifier
250      * property parameters can be specified on this property.
251      *
252      * Conformance: This property can be specified in "VEVENT" or "VFREEBUSY"
253      * calendar components.
254      *
255      * Description: Within the "VEVENT" calendar component, this property
256      * defines the date and time by which the event ends. The value MUST be
257      * later in time than the value of the "DTSTART" property.
258      *
259      * Within the "VFREEBUSY" calendar component, this property defines the end
260      * date and time for the free or busy time information. The time MUST be
261      * specified in the UTC time format. The value MUST be later in time than
262      * the value of the "DTSTART" property.
263      */

264     public final static String JavaDoc DTEND = "dtend";
265
266     /**
267      * Property Name: SUMMARY
268      *
269      * Purpose: This property defines a short summary or subject for the
270      * calendar component.
271      *
272      * Value Type: TEXT
273      *
274      * Property Parameters: Non-standard, alternate text representation and
275      * language property parameters can be specified on this property.
276      *
277      * Conformance: The property can be specified in "VEVENT", "VTODO",
278      * "VJOURNAL" or "VALARM" calendar components.
279      *
280      * Description: This property is used in the "VEVENT", "VTODO" and
281      * "VJOURNAL" calendar components to capture a short, one line summary about
282      * the activity or journal entry.
283      *
284      * This property is used in the "VALARM" calendar component to capture the
285      * subject of an EMAIL category of alarm.
286      */

287     public final static String JavaDoc SUMMARY = "summary";
288
289     /**
290      * Property Name: DESCRIPTION
291      *
292      * Purpose: This property provides a more complete description of the
293      * calendar component, than that provided by the "SUMMARY" property.
294      *
295      * Value Type: TEXT
296      *
297      * Property Parameters: Non-standard, alternate text representation and
298      * language property parameters can be specified on this property.
299      *
300      * Conformance: The property can be specified in the "VEVENT", "VTODO",
301      * "VJOURNAL" or "VALARM" calendar components. The property can be specified
302      * multiple times only within a "VJOURNAL" calendar component.
303      *
304      * Description: This property is used in the "VEVENT" and "VTODO" to capture
305      * lengthy textual decriptions associated with the activity.
306      *
307      * This property is used in the "VJOURNAL" calendar component to capture one
308      * more textual journal entries.
309      *
310      * This property is used in the "VALARM" calendar component to capture the
311      * display text for a DISPLAY category of alarm, to capture the body text
312      * for an EMAIL category of alarm and to capture the argument string for a
313      * PROCEDURE category of alarm.
314      */

315     public final static String JavaDoc DESCRIPTION = "description";
316
317     /**
318      * Property Name: CLASS
319      *
320      * Purpose: This property defines the access classification for a calendar
321      * component.
322      *
323      * Value Type: TEXT
324      *
325      * Property Parameters: Non-standard property parameters can be specified on
326      * this property.
327      *
328      * Conformance: The property can be specified once in a "VEVENT", "VTODO" or
329      * "VJOURNAL" calendar components.
330      *
331      * Description: An access classification is only one component of the
332      * general security system within a calendar application. It provides a
333      * method of capturing the scope of the access the calendar owner intends
334      * for information within an individual calendar entry. The access
335      * classification of an individual iCalendar component is useful when
336      * measured along with the other security components of a calendar system
337      * (e.g., calendar user authentication, authorization, access rights, access
338      * role, etc.). Hence, the semantics of the individual access
339      * classifications cannot be completely defined by this memo alone.
340      * Additionally, due to the "blind" nature of most exchange processes using
341      * this memo, these access classifications cannot serve as an enforcement
342      * statement for a system receiving an iCalendar object. Rather, they
343      * provide a method for capturing the intention of the calendar owner for
344      * the access to the calendar component.
345      */

346     public final static String JavaDoc CLASS = "class";
347
348     /**
349      * Property Name: TRANSP
350      *
351      * Purpose: This property defines whether an event is transparent or not to
352      * busy time searches.
353      *
354      * Value Type: TEXT
355      *
356      * Property Parameters: Non-standard property parameters can be specified on
357      * this property.
358      *
359      * Conformance: This property can be specified once in a "VEVENT" calendar
360      * component.
361      *
362      * Description: Time Transparency is the characteristic of an event that
363      * determines whether it appears to consume time on a calendar. Events that
364      * consume actual time for the individual or resource associated with the
365      * calendar SHOULD be recorded as OPAQUE, allowing them to be detected by
366      * free-busy time searches. Other events, which do not take up the
367      * individual's (or resource's) time SHOULD be recorded as TRANSPARENT,
368      * making them invisible to free-busy time searches.
369      */

370     public final static String JavaDoc TRANSP = "transp";
371
372     /**
373      * Property Name: CATEGORIES
374      *
375      * Purpose: This property defines the categories for a calendar component.
376      *
377      * Value Type: TEXT
378      *
379      * Property Parameters: Non-standard and language property parameters can be
380      * specified on this property.
381      *
382      * Conformance: The property can be specified within "VEVENT", "VTODO" or
383      * "VJOURNAL" calendar components.
384      *
385      * Description: This property is used to specify categories or subtypes of
386      * the calendar component. The categories are useful in searching for a
387      * calendar component of a particular type and category. Within the
388      * "VEVENT", "VTODO" or "VJOURNAL" calendar components, more than one
389      * category can be specified as a list of categories separated by the COMMA
390      * character (US-ASCII decimal 44).
391      */

392     public final static String JavaDoc CATEGORIES = "categories";
393     public final static String JavaDoc ITEM = "item";
394     /**
395      * Property Name: RRULE
396      *
397      * Purpose: This property defines a rule or repeating pattern for recurring
398      * events, to-dos, or time zone definitions.
399      *
400      * Value Type: RECUR
401      *
402      * Property Parameters: Non-standard property parameters can be specified on
403      * this property.
404      *
405      * Conformance: This property can be specified one or more times in
406      * recurring "VEVENT", "VTODO" and "VJOURNAL" calendar components. It can
407      * also be specified once in each STANDARD or DAYLIGHT sub-component of the
408      * "VTIMEZONE" calendar component.
409      *
410      * Description: The recurrence rule, if specified, is used in computing the
411      * recurrence set. The recurrence set is the complete set of recurrence
412      * instances for a calendar component. The recurrence set is generated by
413      * considering the initial "DTSTART" property along with the "RRULE",
414      * "RDATE", "EXDATE" and "EXRULE" properties contained within the iCalendar
415      * object. The "DTSTART" property defines the first instance in the
416      * recurrence set. Multiple instances of the "RRULE" and "EXRULE" properties
417      * can also be specified to define more sophisticated recurrence sets. The
418      * final recurrence set is generated by gathering all of the start
419      * date/times generated by any of the specified "RRULE" and "RDATE"
420      * properties, and excluding any start date/times which fall within the
421      * union of start date/times generated by any specified "EXRULE" and
422      * "EXDATE" properties. This implies that start date/times within exclusion
423      * related properties (i.e., "EXDATE" and "EXRULE") take precedence over
424      * those specified by inclusion properties (i.e., "RDATE" and "RRULE").
425      * Where duplicate instances are generated by the "RRULE" and "RDATE"
426      * properties, only one recurrence is considered. Duplicate instances are
427      * ignored.
428      *
429      * The "DTSTART" and "DTEND" property pair or "DTSTART" and "DURATION"
430      * property pair, specified within the iCalendar object defines the first
431      * instance of the recurrence. When used with a recurrence rule, the
432      * "DTSTART" and "DTEND" properties MUST be specified in local time and the
433      * appropriate set of "VTIMEZONE" calendar components MUST be included. For
434      * detail on the usage of the "VTIMEZONE" calendar component, see the
435      * "VTIMEZONE" calendar component definition.
436      *
437      * Any duration associated with the iCalendar object applies to all members
438      * of the generated recurrence set. Any modified duration for specific
439      * recurrences MUST be explicitly specified using the "RDATE" property.
440      */

441     public final static String JavaDoc RRULE = "rrule";
442
443     /**
444      * Property Name: ORGANIZER
445      *
446      * Purpose: The property defines the organizer for a calendar component.
447      *
448      * Value Type: CAL-ADDRESS
449      *
450      * Property Parameters: Non-standard, language, common name, directory entry
451      * reference, sent by property parameters can be specified on this property.
452      *
453      * Conformance: This property MUST be specified in an iCalendar object that
454      * specifies a group scheduled calendar entity. This property MUST be
455      * specified in an iCalendar object that specifies the publication of a
456      * calendar user's busy time. This property MUST NOT be specified in an
457      * iCalendar object that specifies only a time zone definition or that
458      * defines calendar entities that are not group scheduled entities, but are
459      * entities only on a single user's calendar.
460      *
461      * Description: The property is specified within the "VEVENT", "VTODO",
462      * "VJOURNAL calendar components to specify the organizer of a group
463      * scheduled calendar entity. The property is specified within the
464      * "VFREEBUSY" calendar component to specify the calendar user requesting
465      * the free or busy time. When publishing a "VFREEBUSY" calendar component,
466      * the property is used to specify the calendar that the published busy time
467      * came from.
468      *
469      * The property has the property parameters CN, for specifying the common or
470      * display name associated with the "Organizer", DIR, for specifying a
471      * pointer to the directory information associated with the "Organizer",
472      * SENT-BY, for specifying another calendar user that is acting on behalf of
473      * the "Organizer". The non-standard parameters may also be specified on
474      * this property. If the LANGUAGE property parameter is specified, the
475      * identified language applies to the CN parameter value.
476      */

477     public final static String JavaDoc ORGANIZER = "organizer";
478
479     /**
480      * Property Name: ATTENDEE
481      *
482      * Purpose: The property defines an "Attendee" within a calendar component.
483      *
484      * Value Type: CAL-ADDRESS
485      *
486      * Property Parameters: Non-standard, language, calendar user type, group or
487      * list membership, participation role, participation status, RSVP
488      * expectation, delegatee, delegator, sent by, common name or directory
489      * entry reference property parameters can be specified on this property.
490      *
491      * Conformance: This property MUST be specified in an iCalendar object that
492      * specifies a group scheduled calendar entity. This property MUST NOT be
493      * specified in an iCalendar object when publishing the calendar information
494      * (e.g., NOT in an iCalendar object that specifies the publication of a
495      * calendar user's busy time, event, to-do or journal). This property is not
496      * specified in an iCalendar object that specifies only a time zone
497      * definition or that defines calendar entities that are not group scheduled
498      * entities, but are entities only on a single user's calendar.
499      *
500      * Description: The property MUST only be specified within calendar
501      * components to specify participants, non-participants and the chair of a
502      * group scheduled calendar entity. The property is specified within an
503      * "EMAIL" category of the "VALARM" calendar component to specify an email
504      * address that is to receive the email type of iCalendar alarm.
505      *
506      * The property parameter CN is for the common or displayable name
507      * associated with the calendar address; ROLE, for the intended role that
508      * the attendee will have in the calendar component; PARTSTAT, for the
509      * status of the attendee's participation; RSVP, for indicating whether the
510      * favor of a reply is requested; CUTYPE, to indicate the type of calendar
511      * user; MEMBER, to indicate the groups that the attendee belongs to;
512      * DELEGATED-TO, to indicate the calendar users that the original request
513      * was delegated to; and DELEGATED-FROM, to indicate whom the request was
514      * delegated from; SENT-BY, to indicate whom is acting on behalf of the
515      * ATTENDEE; and DIR, to indicate the URI that points to the directory
516      * information corresponding to the attendee. These property parameters can
517      * be specified on an "ATTENDEE" property in either a "VEVENT", "VTODO" or
518      * "VJOURNAL" calendar component. They MUST not be specified in an
519      * "ATTENDEE" property in a "VFREEBUSY" or "VALARM" calendar component. If
520      * the LANGUAGE property parameter is specified, the identified language
521      * applies to the CN parameter.
522      *
523      * A recipient delegated a request MUST inherit the RSVP and ROLE values
524      * from the attendee that delegated the request to them.
525      *
526      * Multiple attendees can be specified by including multiple "ATTENDEE"
527      * properties within the calendar component.
528      */

529     public final static String JavaDoc ATTENDEE = "attendee";
530
531     /**
532      * Property Name: URL
533      *
534      * Purpose: This property defines a Uniform Resource Locator (URL)
535      * associated with the iCalendar object.
536      *
537      * Value Type: URI
538      *
539      * Property Parameters: Non-standard property parameters can be specified on
540      * this property.
541      *
542      * Conformance: This property can be specified once in the "VEVENT",
543      * "VTODO", "VJOURNAL" or "VFREEBUSY" calendar components.
544      *
545      * Description: This property may be used in a calendar component to convey
546      * a location where a more dynamic rendition of the calendar information
547      * associated with the calendar component can be found. This memo does not
548      * attempt to standardize the form of the URI, nor the format of the
549      * resource pointed to by the property value. If the URL property and
550      * Content-Location MIME header are both specified, they MUST point to the
551      * same resource.
552      */

553     public final static String JavaDoc URL = "url";
554
555     /**
556      * Property Name: FREEBUSY
557      *
558      * Purpose: The property defines one or more free or busy time intervals.
559      *
560      * Value Type: PERIOD. The date and time values MUST be in an UTC time
561      * format.
562      *
563      * Property Parameters: Non-standard or free/busy time type property
564      * parameters can be specified on this property.
565      *
566      * Conformance: The property can be specified in a "VFREEBUSY" calendar
567      * component.
568      *
569      * Property Parameter: "FBTYPE" and non-standard parameters can be specified
570      * on this property.
571      *
572      * Description: These time periods can be specified as either a start and
573      * end date-time or a start date-time and duration. The date and time MUST
574      * be a UTC time format.
575      *
576      * "FREEBUSY" properties within the "VFREEBUSY" calendar component SHOULD be
577      * sorted in ascending order, based on start time and then end time, with
578      * the earliest periods first.
579      *
580      * The "FREEBUSY" property can specify more than one value, separated by the
581      * COMMA character (US-ASCII decimal 44). In such cases, the "FREEBUSY"
582      * property values SHOULD all be of the same "FBTYPE" property parameter
583      * type (e.g., all values of a particular "FBTYPE" listed together in a
584      * single property).
585      */

586     public final static String JavaDoc FREEBUSY = "freebusy";
587
588     /**
589      * Property Name: PRIORITY
590      *
591      * Purpose: The property defines the relative priority for a calendar
592      * component.
593      *
594      * Value Type: INTEGER
595      *
596      * Property Parameters: Non-standard property parameters can be specified on
597      * this property.
598      *
599      * Conformance: The property can be specified in a "VEVENT" or "VTODO"
600      * calendar component.
601      *
602      * Description: The priority is specified as an integer in the range zero to
603      * nine. A value of zero (US-ASCII decimal 48) specifies an undefined
604      * priority. A value of one (US-ASCII decimal 49) is the highest priority. A
605      * value of two (US-ASCII decimal 50) is the second highest priority.
606      * Subsequent numbers specify a decreasing ordinal priority. A value of nine
607      * (US-ASCII decimal 58) is the lowest priority.
608      *
609      * A CUA with a three-level priority scheme of "HIGH", "MEDIUM" and "LOW" is
610      * mapped into this property such that a property value in the range of one
611      * (US-ASCII decimal 49) to four (US-ASCII decimal 52) specifies "HIGH"
612      * priority. A value of five (US-ASCII decimal 53) is the normal or "MEDIUM"
613      * priority. A value in the range of six (US- ASCII decimal 54) to nine
614      * (US-ASCII decimal 58) is "LOW" priority.
615      *
616      * A CUA with a priority schema of "A1", "A2", "A3", "B1", "B2", ..., "C3"
617      * is mapped into this property such that a property value of one (US-ASCII
618      * decimal 49) specifies "A1", a property value of two (US- ASCII decimal
619      * 50) specifies "A2", a property value of three (US-ASCII decimal 51)
620      * specifies "A3", and so forth up to a property value of 9 (US-ASCII
621      * decimal 58) specifies "C3".
622      *
623      * Other integer values are reserved for future use.
624      *
625      * Within a "VEVENT" calendar component, this property specifies a priority
626      * for the event. This property may be useful when more than one event is
627      * scheduled for a given time period.
628      *
629      * Within a "VTODO" calendar component, this property specified a priority
630      * for the to-do. This property is useful in prioritizing multiple action
631      * items for a given time period.
632      */

633     public final static String JavaDoc PRIORITY = "priority";
634
635     /**
636      * Property Name: ATTACH
637      *
638      * Purpose: The property provides the capability to associate a document
639      * object with a calendar component.
640      *
641      * Value Type: The default value type for this property is URI. The value
642      * type can also be set to BINARY to indicate inline binary encoded content
643      * information.
644      *
645      * Property Parameters: Non-standard, inline encoding, format type and value
646      * data type property parameters can be specified on this property.
647      *
648      * Conformance: The property can be specified in a "VEVENT", "VTODO",
649      * "VJOURNAL" or "VALARM" calendar components.
650      *
651      * Description: The property can be specified within "VEVENT", "VTODO",
652      * "VJOURNAL", or "VALARM" calendar components. This property can be
653      * specified multiple times within an iCalendar object.
654      */

655     public final static String JavaDoc ATTACH = "attach";
656
657     /**
658      * Property Name: LOCATION
659      *
660      * Purpose: The property defines the intended venue for the activity defined
661      * by a calendar component.
662      *
663      * Value Type: TEXT
664      *
665      * Property Parameters: Non-standard, alternate text representation and
666      * language property parameters can be specified on this property.
667      *
668      * Conformance: This property can be specified in "VEVENT" or "VTODO"
669      * calendar component.
670      *
671      * Description: Specific venues such as conference or meeting rooms may be
672      * explicitly specified using this property. An alternate representation may
673      * be specified that is a URI that points to directory information with more
674      * structured specification of the location. For example, the alternate
675      * representation may specify either an LDAP URI pointing to an LDAP server
676      * entry or a CID URI pointing to a MIME body part containing a vCard
677      * [RFC2426] for the location.
678      */

679     public final static String JavaDoc LOCATION = "location";
680     
681     public final static String JavaDoc X_COLUMBA_CALENDAR = "x-columba-calendar";
682
683
684
685 }
686
Popular Tags