Calendar Server WCAP Attendee: CUTYPE Parameter

If the attendee is an individual, set CUTYPE=INDIVIDUALin WCAP commands. If one of the attendees is a group, set CUTYPE=GROUP. An additional X-Token, X-S1CS-EXPAND, can be given to specify whether the group is to be expanded or not (TRUE, FALSE).

For example, for a storeevents command:

storeevents.wcap?id-$SEESSIONID&calid=testuser&dtstart=20060402T090000Z&
dtend=20060402T100000Z&method=2&attendee=PARSTAT=NEEDS_ACTION^RSVP=TRUE^
CUTYPE=GROUP^X-S1CS-EXPAND=TRUE^testgroup

When fetched, an expanded group invitation would return and individual record for each group member as well as a record for the group. For example:

ATTENDEE;ROLE=REQ-PARTICIPANT;CUTYPE=INDIVIDUAL
 ;PARTSTAT=NEEDS-ACTION;CN="Test User1"
 ;RSVP=TRUE
 ;X-NSCP-ATTENDEE-GSE-STATUS=2
 ;X-S1CS-EMAIL=testuser1@test.com
 ;MEMBER=testgroup
 :testuser1

ATTENDEE;ROLE=REQ-PARTICIPANT;CUTYPE=INDIVIDUAL
 ;PARTSTAT=NEEDS-ACTION;CN="Test User2"
 ;RSVP=TRUE
 ;X-NSCP-ATTENDEE-GSE-STATUS=2
 ;X-S1CS-EMAIL=testuser2@test.com
 ;MEMBER=testgroup
 :testuser2

X-S1CS-GROUP-ATTENDEE;CUTYPE=GROUP
 ;X-S1CS-EMAIL=testgroup@test.com
 ;X-S1CS-EXPAND=TRUE
 :testgroup

If the same group was invited in non-expanded mode, a fetch would result in only the group record being returned, as shown in the following example:

storeevents.wcap?id-$SEESSIONID&calid=testuser&dtstart=20060402T090000Z&
dtend=20060402T100000Z&method=2&attendee=PARSTAT=
NEEDS_ACTION^RSVP=TRUE^CUTYPE=GROUP^X-S1CS-EXPAND=False^testgroup

ATTENDEE;ROLE=REQ-PARTICIPANT;CUTYPE=GROUP
 ;PARTSTAT=ACCEPTED;CN="Test Group"
 ;RSVP=FALSE
 ;X-NSCP-ATTENDEE-GSE-STATUS=2
 ;X-S1CS-EMAIL=testgroup@test.com
 ;X-S1CS-EXPAND=FALSE
 :testgroup

If the EXPAND X-Token is not given in the WCAP command, the system will use the internal default, which is specified in the ics.conf parameter group.invite.expand. The request to expand might be overridden if the member size becomes greater than the value specified in the ics.conf parameter calstore.group.attendee.maxsize.

If the CUTYPE is not set in the command, the system will set CUTYPE internally when it discovers the whether the attendee is an individual or a group.