The following is a list of commands supported in WCAP. For a detailed description of each command, see Chapter 7, WCAP Command Reference
Table 5–1 WCAP Command Overview
WCAP Command |
Description |
---|---|
Administrator only: Check if user’s session ID is valid. |
|
Create a new calendar. |
|
Delete an existing calendar. |
|
Delete both events and todos in a calendar(s) over a specific time period. |
|
Delete events given a specific calid and uid or recurrence-ID pair. |
|
Delete events in a calendar(s) over a specific time period. |
|
Delete todos given a specific calid and uid or recurrence-ID pair. |
|
Deletes todos in a calendar(s) over a specific time period. |
|
Exports a calendar to a file. |
|
Queries for components that have alarms to trigger over a specific time period. |
|
Queries for components that had errors while sending group scheduling messages. |
|
Queries for components that have changed, during the specified time range. |
|
Queries the deletelog database for deleted components. |
|
Queries for components over a specific time period, with filtering attributes. |
|
Queries for one or more events by a unique identifier (UID, Recurrence ID, modifier). |
|
Queries for one or more todos by a unique identifier (UID, Recurrence ID, modifier). |
|
Returns all the time zones the server supports. |
|
Returns calendar properties. |
|
Returns calendar free-busy time. |
|
Returns a set of random UID's. |
|
Returns the server times for the requested calids. |
|
Returns user preferences and some server settings. |
|
Imports a calendar from a file to a user’s calendar. |
|
Lists all calendars owned by a user. |
|
Lists all calendars subscribed to by a user. |
|
Authenticates a user and redirects to first HTML view. |
|
Terminates the current user’s session and return to login screen. |
|
Administrator only: Pings the calendar server. |
|
Searches for a calendar with the specified parameter values. |
|
Sets calendar properties. |
|
Sets user preferences. |
|
Stores events that are specified in application or URL encoded manner. For storing an even by passing properties in a URL. |
|
Stores todos that are specified in the application or URL encoded manner. |
|
Adds calendars to a users subscription list. |
|
Removes calendars from a user’s subscription list. |
|
Fetches events and returns the uid or rid of events not in the database. |
|
Fetches todos and returns the uid or rid of todos not in the database. |
|
Returns the WCAP version that the server supports. |
For many WCAP commands, you must specify the session identifier (id) that is returned by the login command. The session identifier ensures that data is accessible only to authenticated users with the required level of privilege or ownership.
When logging into the system, a user provides authentication of identity. The default authentication mechanism uses plain-text passwords and user names. Calendar Server generates the session identifier only when authentication is successful. The identifier then serves as proof of authentication in subsequent calendaring operations.
You can customize the authentication mechanism to use a local or external authentication scheme, see API: csIAccessControl.
For more information about how to configure authentication, see chapter 10 in the Calendar Server Administration Guide: Sun Java System Calendar Server 6 2005Q4 Administration Guide.
If you are using hosted (virtual) domains, all WCAP commands you issue must have fully qualified user ID's (uid) and calendar ID's (calid), for example jdoe@example.com.
In order to be in hosted domain mode, several parameters in the ics.conf file must be configured as specified in chapter 12 in the Calendar Server Administration Guide: Sun Java System Calendar Server 6 2005Q4 Administration Guide.
See your Calendar Server administrator if you do not know whether you are using hosted domains.
The following two example WCAP commands demonstrate the difference between calid values for non-hosted domain mode and hosted domain mode.
Non-hosted domain mode:
http://webcalendarserver/get_userprefs.wcap ?id=b5q2o8ve2rk02nv9t6 &calid=jdoe &fmt-out=text/calendar |
In hosted domain mode:
http://webcalendarserver/get_userprefs.wcap ?id=b5q2o8ve2rk02nv9t6 &calid=jdoe@example.com &fmt-out=text/calendar