Sun Java System Calendar Server 6 2005Q4 Developer's Guide

Recurring Components–Deleting

When you delete a recurring component, specify the recurrence ID and whether to delete the recurrences as well as the original event or todo.

Use the mod parameter to select which occurrences to delete:

Value  

Option  

1

Delete or modify this instance only. 

2

Delete or modify this and all future recurrences. 

3

Delete or modify this and all prior recurrences. 

4

Delete or modify all instances. 

A setting of 2 deletes only as many instances as exist on the server.

Examples Using deleteevents_by_id

To delete just the single instance of the event, the mod parameter should be set to 1. For example, this URL would delete just the event that occurs on the date March 1, 2002 11:22:33 AM GMT.


http://webcalendarserver/deleteevents_by_id.wcap
              ?id=23423423434abc
              &calid=jdoe
              &uid=001
              &rid=20020301T112233Z
              &mod=1

To delete the event and all future instances of the event, the mod parameter should be set to 2. For example, this URL would delete the event that occurs on the date March 1, 2002 11:22:33 AM GMT and all future instances of this event (uid 001).


http://webcalendarserver/deleteevents_by_id.wcap
              ?id=23423423434abc
              &calid=jdoe
              &uid=001
              &rid=20020301T112233Z
              &mod=2

To delete the event and all prior instances of the event, the mod parameter should be set to 3.

For example, this URL would delete the event that occurs on the date March 1, 200211:22:33 AM GMT and all prior instances of this event (uid 001).


http://webcalendarserver/deleteevents_by_id.wcap
              ?id=23423423434abc
              &calid=jdoe
              &uid=001
              &rid=20020301T112233Z
              &mod=3

To delete all instances of the event, the mod parameter should be set to 4. For example, this URL would delete ALL instances of the event (uid 001).


http://webcalendarserver/deleteevents_by_id.wcap
              ?id=23423423434abc
              &calid=jdoe
              &uid=001
              &rid=20020301T112233Z
              &mod=4