<p>Property Name: ATTENDEE</p>
public class Attendee extends PropertyBaseAttendee<java.net.URI,Attendee>
<h2>3.8.4.1. Attendee</h2>
<p>Property Name: ATTENDEE</p>
<p>Purpose: This property defines an "Attendee" within a calendar component.</p>
<p>Value Type: CAL-ADDRESS</p>
<p>Property Parameters: IANA,non-standard
,language
,calendar user type
,group or list membership
,participation role
,participation status
,RSVP expectation
,delegatee
,delegator
,sent by
,common name
, ordirectory entry reference
property parameters can be specified on this property.</p>
<p>Conformance: This property MUST be specified in an iCalendar object that specifies a group-scheduled calendar entity. This property MUST NOT be specified in an iCalendar object when publishing the calendar information (e.g., NOT in an iCalendar object that specifies the publication of a calendar user's busy time, event, to-do, or journal). This property is not specified in an iCalendar object that specifies only a time zone definition or that defines calendar components that are not group-scheduled components, but are components only on a single user's calendar.</p>
<p>Description: This property MUST only be specified within calendar
components to specify participants, non-participants, and the
chair of a group-scheduled calendar entity. The property is
specified within an "EMAIL" category of the VALARM
calendar
component to specify an email address that is to receive the email
type of iCalendar alarm.</p>
<p>The property parameterCN
is for the common or displayable name associated with the calendar address;ROLE
, for the intended role that the attendee will have in the calendar component;PARTSTAT
, for the status of the attendee's participation;RSVP
, for indicating whether the favor of a reply is requested; CalendarUser CUTYPE, to indicate the type of calendar user; {@link GroupMembership MEMBER}, to indicate the groups that the attendee belongs to; {@link Delegatees DELEGATED-TO}, to indicate the calendar users that the original request was delegated to; and {@link Delegators DELEGATED-FROM}, to indicate whom the request was delegated from; {@link SentBy SENT-BY}, to indicate whom is acting on behalf of the {@link Attendee ATTENDEE}; and {@link DirectoryEntry DIR}, to indicate the URI that points to the directory information corresponding to the attendee. These property parameters can be specified on an {@link Attendee ATTENDEE} property in either a {@link VEvent VEVENT}, {@link VTodo VTODO}, or {@link VJournal VJOURNAL} calendar component. They MUST NOT be specified in an {@link Attendee ATTENDEE} property in a {@link VFreeBusy VFREEBUSY} or {@link VAlarm VALARM} calendar component. If the {@link Language LANGUAGE} property parameter is specified, the identified language applies to the {@link CommonName CN} parameter.</p>
<p>A recipient delegated a request MUST inherit the {@link RSVP} and {@link ParticipationRole ROLE} values from the attendee that delegated the request to them.</p>
<p>Multiple attendees can be specified by including multiple {@link Attendee ATTENDEE} properties within the calendar component.</p>
<p>Format Definition: This property is defined by the following notation: <ul> <li>attendee <ul> <li>"ATTENDEE" attparam ":" cal-address CRLF </ul> <li>attparam <ul> <li>The following are OPTIONAL, but MUST NOT occur more than once. <ul> <li>";" {@link CalendarUser Calendar user type} <li>";" {@link Delegators} <li>";" {@link Delegatees} <li>";" {@link CommonName Common name} <li>";" {@link DirectoryEntry Directory entry} <li>";" {@link GroupMembership Group or list membership} <li>";" {@link Language Language for text} <li>";" {@link RSVP} <li>";" {@link ParticipationRole Participation role} <li>";" {@link ParticipationStatus Participation status} <li>";" {@link SentBy Sent by} </ul> <li>The following are OPTIONAL, and MAY occur more than once. <ul> <li>other-param <ul> <li>";" {@link NonStandardParameter} <li>";" {@link IANAParameter} </ul> </ul> </ul> </ul>
<p>Example: The following is an example of this property: <ul> <li>The following are examples of this property's use for a to-do: <ul> <li>ATTENDEE;MEMBER="mailto:DEV-GROUP@example.com":mailto:joecool@example.com <li>ATTENDEE;DELEGATED-FROM="mailto:immud@example.com":mailto:ildoit@example.com </ul> <li>The following is an example of this property used for specifying multiple attendees to an event: <ul> <li>ATTENDEE;ROLE=REQ-PARTICIPANT;PARTSTAT=TENTATIVE;CN=Henry Cabot:mailto:hcabot@example.com <li>ATTENDEE;ROLE=REQ-PARTICIPANT;DELEGATED-FROM="mailto:bob@example.com";PARTSTAT=ACCEPTED;CN=Jane Doe:mailto:jdoe@example.com </ul> <li>The following is an example of this property with a URI to the directory information associated with the attendee: <ul> <li>ATTENDEE;CN=John Smith;DIR="ldap://example.com:6666/o=ABC%20Industries,c=US???(cn=Jim%20Dolittle)":mailto:jimdo@example.com </ul> <li>The following is an example of this property with "delegatee" and "delegator" information for an event: <ul> <li>ATTENDEE;ROLE=REQ-PARTICIPANT;PARTSTAT=TENTATIVE;DELEGATED-FROM="mailto:iamboss@example.com";CN=Henry Cabot:mailto:hcabot@example.com <li>ATTENDEE;ROLE=NON-PARTICIPANT;PARTSTAT=DELEGATED;DELEGATED-TO="mailto:hcabot@example.com";CN=The Big Cheese:mailto:iamboss@example.com <li>ATTENDEE;ROLE=REQ-PARTICIPANT;PARTSTAT=ACCEPTED;CN=Jane Doe:mailto:jdoe@example.com </ul> <li>The following is an example of this property's use when another calendar user is acting on behalf of the "Attendee": <ul> <li>ATTENDEE;SENT-BY=mailto:jan_doe@example.com;CN=John Smith:mailto:jsmith@example.com </ul> </ul> </p> RFC 5545 iCalendar September 2009
calendarUserProperty, delegateesProperty, delegatorsProperty, groupMembershipProperty, participationRoleProperty, participationStatusProperty, rsvpProperty
commonNameProperty, directoryEntryReferenceProperty, sentByProperty
languageProperty
propertyNameProperty, valueProperty, valueTypeProperty
commonNameProperty, directoryEntryReferenceProperty, sentByProperty
languageProperty
valueProperty, valueTypeProperty
Constructor and Description |
---|
Attendee(Attendee source)
Create deep copy of source Attendee
|
Attendee(java.net.URI value)
Create new Attendee with property value set to input parameter
|
Modifier and Type | Method and Description |
---|---|
static Attendee |
parse(java.lang.String unfoldedContent)
Create new Attendee by parsing unfolded calendar content
|
calendarUserProperty, delegateesProperty, delegatorsProperty, getCalendarUser, getDelegatees, getDelegators, getGroupMembership, getParticipationRole, getParticipationStatus, getRSVP, groupMembershipProperty, participationRoleProperty, participationStatusProperty, rsvpProperty, setCalendarUser, setCalendarUser, setDelegatees, setDelegatees, setDelegators, setDelegators, setGroupMembership, setGroupMembership, setParticipationRole, setParticipationRole, setParticipationStatus, setParticipationStatus, setRSVP, setRSVP, withCalendarUser, withCalendarUser, withCalendarUser, withDelegatees, withDelegatees, withDelegatees, withDelegators, withDelegators, withDelegators, withGroupMembership, withGroupMembership, withGroupMembership, withParticipationRole, withParticipationRole, withParticipationRole, withParticipationStatus, withParticipationStatus, withParticipationStatus, withRSVP, withRSVP, withRSVP
commonNameProperty, directoryEntryReferenceProperty, getCommonName, getDirectoryEntryReference, getSentBy, sentByProperty, setCommonName, setCommonName, setDirectoryEntryReference, setDirectoryEntryReference, setSentBy, setSentBy, withCommonName, withCommonName, withDirectoryEntryReference, withDirectoryEntryReference, withDirectoryEntryReference, withSentBy, withSentBy, withSentBy
getLanguage, languageProperty, setLanguage, setLanguage, withLanguage, withLanguage
compareTo, copyInto, copyValue, equals, errors, getConverter, getNonStandard, getParent, getPropertyValueString, getUnknownValue, getValue, getValueType, hashCode, name, nonStandardParameter, parseContent, propertyNameProperty, propertyType, setConverter, setConverterByClass, setNonStandard, setParent, setPropertyName, setValue, setValueType, setValueType, setValueType, toContent, toString, valueContent, valueProperty, valueTypeProperty, withNonStandard, withNonStandard, withNonStandard, withPropertyName, withValue, withValueType, withValueType
childrenUnmodifiable, copyIntoCallback, orderer, setContentLineGenerator
clone, finalize, getClass, notify, notifyAll, wait, wait, wait
commonNameProperty, directoryEntryReferenceProperty, getCommonName, getDirectoryEntryReference, getSentBy, sentByProperty, setCommonName, setDirectoryEntryReference, setSentBy
getLanguage, languageProperty, setLanguage
getNonStandard, getValue, getValueType, nonStandardParameter, propertyType, setNonStandard, setValue, setValueType, valueProperty, valueTypeProperty
childrenUnmodifiable, copyInto
public Attendee(java.net.URI value)
Create new Attendee with property value set to input parameter
public Attendee(Attendee source)
Create deep copy of source Attendee
public static Attendee parse(java.lang.String unfoldedContent)
Create new Attendee by parsing unfolded calendar content