Class MicrosoftGraphEvent


public final class MicrosoftGraphEvent extends MicrosoftGraphOutlookItem
event.
  • Constructor Details

    • MicrosoftGraphEvent

      public MicrosoftGraphEvent()
      Creates an instance of MicrosoftGraphEvent class.
  • Method Details

    • allowNewTimeProposals

      public Boolean allowNewTimeProposals()
      Get the allowNewTimeProposals property: True if the meeting organizer allows invitees to propose a new time when responding, false otherwise. Optional. Default is true.
      Returns:
      the allowNewTimeProposals value.
    • withAllowNewTimeProposals

      public MicrosoftGraphEvent withAllowNewTimeProposals(Boolean allowNewTimeProposals)
      Set the allowNewTimeProposals property: True if the meeting organizer allows invitees to propose a new time when responding, false otherwise. Optional. Default is true.
      Parameters:
      allowNewTimeProposals - the allowNewTimeProposals value to set.
      Returns:
      the MicrosoftGraphEvent object itself.
    • attendees

      public List<MicrosoftGraphAttendee> attendees()
      Get the attendees property: The collection of attendees for the event.
      Returns:
      the attendees value.
    • withAttendees

      public MicrosoftGraphEvent withAttendees(List<MicrosoftGraphAttendee> attendees)
      Set the attendees property: The collection of attendees for the event.
      Parameters:
      attendees - the attendees value to set.
      Returns:
      the MicrosoftGraphEvent object itself.
    • body

      public MicrosoftGraphItemBody body()
      Get the body property: itemBody.
      Returns:
      the body value.
    • withBody

      Set the body property: itemBody.
      Parameters:
      body - the body value to set.
      Returns:
      the MicrosoftGraphEvent object itself.
    • bodyPreview

      public String bodyPreview()
      Get the bodyPreview property: The preview of the message associated with the event. It is in text format.
      Returns:
      the bodyPreview value.
    • withBodyPreview

      public MicrosoftGraphEvent withBodyPreview(String bodyPreview)
      Set the bodyPreview property: The preview of the message associated with the event. It is in text format.
      Parameters:
      bodyPreview - the bodyPreview value to set.
      Returns:
      the MicrosoftGraphEvent object itself.
    • end

      Get the end property: dateTimeTimeZone.
      Returns:
      the end value.
    • withEnd

      Set the end property: dateTimeTimeZone.
      Parameters:
      end - the end value to set.
      Returns:
      the MicrosoftGraphEvent object itself.
    • hasAttachments

      public Boolean hasAttachments()
      Get the hasAttachments property: Set to true if the event has attachments.
      Returns:
      the hasAttachments value.
    • withHasAttachments

      public MicrosoftGraphEvent withHasAttachments(Boolean hasAttachments)
      Set the hasAttachments property: Set to true if the event has attachments.
      Parameters:
      hasAttachments - the hasAttachments value to set.
      Returns:
      the MicrosoftGraphEvent object itself.
    • hideAttendees

      public Boolean hideAttendees()
      Get the hideAttendees property: The hideAttendees property.
      Returns:
      the hideAttendees value.
    • withHideAttendees

      public MicrosoftGraphEvent withHideAttendees(Boolean hideAttendees)
      Set the hideAttendees property: The hideAttendees property.
      Parameters:
      hideAttendees - the hideAttendees value to set.
      Returns:
      the MicrosoftGraphEvent object itself.
    • iCalUId

      public String iCalUId()
      Get the iCalUId property: A unique identifier for an event across calendars. This ID is different for each occurrence in a recurring series. Read-only.
      Returns:
      the iCalUId value.
    • withICalUId

      public MicrosoftGraphEvent withICalUId(String iCalUId)
      Set the iCalUId property: A unique identifier for an event across calendars. This ID is different for each occurrence in a recurring series. Read-only.
      Parameters:
      iCalUId - the iCalUId value to set.
      Returns:
      the MicrosoftGraphEvent object itself.
    • importance

      public MicrosoftGraphImportance importance()
      Get the importance property: importance.
      Returns:
      the importance value.
    • withImportance

      public MicrosoftGraphEvent withImportance(MicrosoftGraphImportance importance)
      Set the importance property: importance.
      Parameters:
      importance - the importance value to set.
      Returns:
      the MicrosoftGraphEvent object itself.
    • isAllDay

      public Boolean isAllDay()
      Get the isAllDay property: Set to true if the event lasts all day.
      Returns:
      the isAllDay value.
    • withIsAllDay

      public MicrosoftGraphEvent withIsAllDay(Boolean isAllDay)
      Set the isAllDay property: Set to true if the event lasts all day.
      Parameters:
      isAllDay - the isAllDay value to set.
      Returns:
      the MicrosoftGraphEvent object itself.
    • isCancelled

      public Boolean isCancelled()
      Get the isCancelled property: Set to true if the event has been canceled.
      Returns:
      the isCancelled value.
    • withIsCancelled

      public MicrosoftGraphEvent withIsCancelled(Boolean isCancelled)
      Set the isCancelled property: Set to true if the event has been canceled.
      Parameters:
      isCancelled - the isCancelled value to set.
      Returns:
      the MicrosoftGraphEvent object itself.
    • isDraft

      public Boolean isDraft()
      Get the isDraft property: The isDraft property.
      Returns:
      the isDraft value.
    • withIsDraft

      public MicrosoftGraphEvent withIsDraft(Boolean isDraft)
      Set the isDraft property: The isDraft property.
      Parameters:
      isDraft - the isDraft value to set.
      Returns:
      the MicrosoftGraphEvent object itself.
    • isOnlineMeeting

      public Boolean isOnlineMeeting()
      Get the isOnlineMeeting property: True if this event has online meeting information, false otherwise. Default is false. Optional.
      Returns:
      the isOnlineMeeting value.
    • withIsOnlineMeeting

      public MicrosoftGraphEvent withIsOnlineMeeting(Boolean isOnlineMeeting)
      Set the isOnlineMeeting property: True if this event has online meeting information, false otherwise. Default is false. Optional.
      Parameters:
      isOnlineMeeting - the isOnlineMeeting value to set.
      Returns:
      the MicrosoftGraphEvent object itself.
    • isOrganizer

      public Boolean isOrganizer()
      Get the isOrganizer property: Set to true if the calendar owner (specified by the owner property of the calendar) is the organizer of the event (specified by the organizer property of the event). This also applies if a delegate organized the event on behalf of the owner.
      Returns:
      the isOrganizer value.
    • withIsOrganizer

      public MicrosoftGraphEvent withIsOrganizer(Boolean isOrganizer)
      Set the isOrganizer property: Set to true if the calendar owner (specified by the owner property of the calendar) is the organizer of the event (specified by the organizer property of the event). This also applies if a delegate organized the event on behalf of the owner.
      Parameters:
      isOrganizer - the isOrganizer value to set.
      Returns:
      the MicrosoftGraphEvent object itself.
    • isReminderOn

      public Boolean isReminderOn()
      Get the isReminderOn property: Set to true if an alert is set to remind the user of the event.
      Returns:
      the isReminderOn value.
    • withIsReminderOn

      public MicrosoftGraphEvent withIsReminderOn(Boolean isReminderOn)
      Set the isReminderOn property: Set to true if an alert is set to remind the user of the event.
      Parameters:
      isReminderOn - the isReminderOn value to set.
      Returns:
      the MicrosoftGraphEvent object itself.
    • location

      public MicrosoftGraphLocation location()
      Get the location property: location.
      Returns:
      the location value.
    • withLocation

      public MicrosoftGraphEvent withLocation(MicrosoftGraphLocation location)
      Set the location property: location.
      Parameters:
      location - the location value to set.
      Returns:
      the MicrosoftGraphEvent object itself.
    • locations

      public List<MicrosoftGraphLocation> locations()
      Get the locations property: The locations where the event is held or attended from. The location and locations properties always correspond with each other. If you update the location property, any prior locations in the locations collection would be removed and replaced by the new location value.
      Returns:
      the locations value.
    • withLocations

      public MicrosoftGraphEvent withLocations(List<MicrosoftGraphLocation> locations)
      Set the locations property: The locations where the event is held or attended from. The location and locations properties always correspond with each other. If you update the location property, any prior locations in the locations collection would be removed and replaced by the new location value.
      Parameters:
      locations - the locations value to set.
      Returns:
      the MicrosoftGraphEvent object itself.
    • onlineMeeting

      public MicrosoftGraphOnlineMeetingInfo onlineMeeting()
      Get the onlineMeeting property: onlineMeetingInfo.
      Returns:
      the onlineMeeting value.
    • withOnlineMeeting

      public MicrosoftGraphEvent withOnlineMeeting(MicrosoftGraphOnlineMeetingInfo onlineMeeting)
      Set the onlineMeeting property: onlineMeetingInfo.
      Parameters:
      onlineMeeting - the onlineMeeting value to set.
      Returns:
      the MicrosoftGraphEvent object itself.
    • onlineMeetingProvider

      public MicrosoftGraphOnlineMeetingProviderType onlineMeetingProvider()
      Get the onlineMeetingProvider property: onlineMeetingProviderType.
      Returns:
      the onlineMeetingProvider value.
    • withOnlineMeetingProvider

      public MicrosoftGraphEvent withOnlineMeetingProvider(MicrosoftGraphOnlineMeetingProviderType onlineMeetingProvider)
      Set the onlineMeetingProvider property: onlineMeetingProviderType.
      Parameters:
      onlineMeetingProvider - the onlineMeetingProvider value to set.
      Returns:
      the MicrosoftGraphEvent object itself.
    • onlineMeetingUrl

      public String onlineMeetingUrl()
      Get the onlineMeetingUrl property: A URL for an online meeting. The property is set only when an organizer specifies an event as an online meeting such as a Skype meeting. Read-only.
      Returns:
      the onlineMeetingUrl value.
    • withOnlineMeetingUrl

      public MicrosoftGraphEvent withOnlineMeetingUrl(String onlineMeetingUrl)
      Set the onlineMeetingUrl property: A URL for an online meeting. The property is set only when an organizer specifies an event as an online meeting such as a Skype meeting. Read-only.
      Parameters:
      onlineMeetingUrl - the onlineMeetingUrl value to set.
      Returns:
      the MicrosoftGraphEvent object itself.
    • organizer

      public MicrosoftGraphRecipient organizer()
      Get the organizer property: recipient.
      Returns:
      the organizer value.
    • withOrganizer

      public MicrosoftGraphEvent withOrganizer(MicrosoftGraphRecipient organizer)
      Set the organizer property: recipient.
      Parameters:
      organizer - the organizer value to set.
      Returns:
      the MicrosoftGraphEvent object itself.
    • originalEndTimeZone

      public String originalEndTimeZone()
      Get the originalEndTimeZone property: The end time zone that was set when the event was created. A value of tzone://Microsoft/Custom indicates that a legacy custom time zone was set in desktop Outlook.
      Returns:
      the originalEndTimeZone value.
    • withOriginalEndTimeZone

      public MicrosoftGraphEvent withOriginalEndTimeZone(String originalEndTimeZone)
      Set the originalEndTimeZone property: The end time zone that was set when the event was created. A value of tzone://Microsoft/Custom indicates that a legacy custom time zone was set in desktop Outlook.
      Parameters:
      originalEndTimeZone - the originalEndTimeZone value to set.
      Returns:
      the MicrosoftGraphEvent object itself.
    • originalStart

      public OffsetDateTime originalStart()
      Get the originalStart property: The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 would look like this: '2014-01-01T00:00:00Z'.
      Returns:
      the originalStart value.
    • withOriginalStart

      public MicrosoftGraphEvent withOriginalStart(OffsetDateTime originalStart)
      Set the originalStart property: The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 would look like this: '2014-01-01T00:00:00Z'.
      Parameters:
      originalStart - the originalStart value to set.
      Returns:
      the MicrosoftGraphEvent object itself.
    • originalStartTimeZone

      public String originalStartTimeZone()
      Get the originalStartTimeZone property: The start time zone that was set when the event was created. A value of tzone://Microsoft/Custom indicates that a legacy custom time zone was set in desktop Outlook.
      Returns:
      the originalStartTimeZone value.
    • withOriginalStartTimeZone

      public MicrosoftGraphEvent withOriginalStartTimeZone(String originalStartTimeZone)
      Set the originalStartTimeZone property: The start time zone that was set when the event was created. A value of tzone://Microsoft/Custom indicates that a legacy custom time zone was set in desktop Outlook.
      Parameters:
      originalStartTimeZone - the originalStartTimeZone value to set.
      Returns:
      the MicrosoftGraphEvent object itself.
    • recurrence

      public MicrosoftGraphPatternedRecurrence recurrence()
      Get the recurrence property: patternedRecurrence.
      Returns:
      the recurrence value.
    • withRecurrence

      public MicrosoftGraphEvent withRecurrence(MicrosoftGraphPatternedRecurrence recurrence)
      Set the recurrence property: patternedRecurrence.
      Parameters:
      recurrence - the recurrence value to set.
      Returns:
      the MicrosoftGraphEvent object itself.
    • reminderMinutesBeforeStart

      public Integer reminderMinutesBeforeStart()
      Get the reminderMinutesBeforeStart property: The number of minutes before the event start time that the reminder alert occurs.
      Returns:
      the reminderMinutesBeforeStart value.
    • withReminderMinutesBeforeStart

      public MicrosoftGraphEvent withReminderMinutesBeforeStart(Integer reminderMinutesBeforeStart)
      Set the reminderMinutesBeforeStart property: The number of minutes before the event start time that the reminder alert occurs.
      Parameters:
      reminderMinutesBeforeStart - the reminderMinutesBeforeStart value to set.
      Returns:
      the MicrosoftGraphEvent object itself.
    • responseRequested

      public Boolean responseRequested()
      Get the responseRequested property: Default is true, which represents the organizer would like an invitee to send a response to the event.
      Returns:
      the responseRequested value.
    • withResponseRequested

      public MicrosoftGraphEvent withResponseRequested(Boolean responseRequested)
      Set the responseRequested property: Default is true, which represents the organizer would like an invitee to send a response to the event.
      Parameters:
      responseRequested - the responseRequested value to set.
      Returns:
      the MicrosoftGraphEvent object itself.
    • responseStatus

      public MicrosoftGraphResponseStatus responseStatus()
      Get the responseStatus property: responseStatus.
      Returns:
      the responseStatus value.
    • withResponseStatus

      public MicrosoftGraphEvent withResponseStatus(MicrosoftGraphResponseStatus responseStatus)
      Set the responseStatus property: responseStatus.
      Parameters:
      responseStatus - the responseStatus value to set.
      Returns:
      the MicrosoftGraphEvent object itself.
    • sensitivity

      public MicrosoftGraphSensitivity sensitivity()
      Get the sensitivity property: sensitivity.
      Returns:
      the sensitivity value.
    • withSensitivity

      public MicrosoftGraphEvent withSensitivity(MicrosoftGraphSensitivity sensitivity)
      Set the sensitivity property: sensitivity.
      Parameters:
      sensitivity - the sensitivity value to set.
      Returns:
      the MicrosoftGraphEvent object itself.
    • seriesMasterId

      public String seriesMasterId()
      Get the seriesMasterId property: The ID for the recurring series master item, if this event is part of a recurring series.
      Returns:
      the seriesMasterId value.
    • withSeriesMasterId

      public MicrosoftGraphEvent withSeriesMasterId(String seriesMasterId)
      Set the seriesMasterId property: The ID for the recurring series master item, if this event is part of a recurring series.
      Parameters:
      seriesMasterId - the seriesMasterId value to set.
      Returns:
      the MicrosoftGraphEvent object itself.
    • showAs

      Get the showAs property: freeBusyStatus.
      Returns:
      the showAs value.
    • withShowAs

      Set the showAs property: freeBusyStatus.
      Parameters:
      showAs - the showAs value to set.
      Returns:
      the MicrosoftGraphEvent object itself.
    • start

      Get the start property: dateTimeTimeZone.
      Returns:
      the start value.
    • withStart

      Set the start property: dateTimeTimeZone.
      Parameters:
      start - the start value to set.
      Returns:
      the MicrosoftGraphEvent object itself.
    • subject

      public String subject()
      Get the subject property: The text of the event's subject line.
      Returns:
      the subject value.
    • withSubject

      public MicrosoftGraphEvent withSubject(String subject)
      Set the subject property: The text of the event's subject line.
      Parameters:
      subject - the subject value to set.
      Returns:
      the MicrosoftGraphEvent object itself.
    • transactionId

      public String transactionId()
      Get the transactionId property: A custom identifier specified by a client app for the server to avoid redundant POST operations in case of client retries to create the same event. This is useful when low network connectivity causes the client to time out before receiving a response from the server for the client's prior create-event request. After you set transactionId when creating an event, you cannot change transactionId in a subsequent update. This property is only returned in a response payload if an app has set it. Optional.
      Returns:
      the transactionId value.
    • withTransactionId

      public MicrosoftGraphEvent withTransactionId(String transactionId)
      Set the transactionId property: A custom identifier specified by a client app for the server to avoid redundant POST operations in case of client retries to create the same event. This is useful when low network connectivity causes the client to time out before receiving a response from the server for the client's prior create-event request. After you set transactionId when creating an event, you cannot change transactionId in a subsequent update. This property is only returned in a response payload if an app has set it. Optional.
      Parameters:
      transactionId - the transactionId value to set.
      Returns:
      the MicrosoftGraphEvent object itself.
    • type

      public MicrosoftGraphEventType type()
      Get the type property: eventType.
      Returns:
      the type value.
    • withType

      Set the type property: eventType.
      Parameters:
      type - the type value to set.
      Returns:
      the MicrosoftGraphEvent object itself.
    • webLink

      public String webLink()
      Get the webLink property: The URL to open the event in Outlook on the web.Outlook on the web opens the event in the browser if you are signed in to your mailbox. Otherwise, Outlook on the web prompts you to sign in.This URL cannot be accessed from within an iFrame.
      Returns:
      the webLink value.
    • withWebLink

      public MicrosoftGraphEvent withWebLink(String webLink)
      Set the webLink property: The URL to open the event in Outlook on the web.Outlook on the web opens the event in the browser if you are signed in to your mailbox. Otherwise, Outlook on the web prompts you to sign in.This URL cannot be accessed from within an iFrame.
      Parameters:
      webLink - the webLink value to set.
      Returns:
      the MicrosoftGraphEvent object itself.
    • attachments

      public List<MicrosoftGraphAttachment> attachments()
      Get the attachments property: The collection of fileAttachment and itemAttachment attachments for the event. Navigation property. Read-only. Nullable.
      Returns:
      the attachments value.
    • withAttachments

      public MicrosoftGraphEvent withAttachments(List<MicrosoftGraphAttachment> attachments)
      Set the attachments property: The collection of fileAttachment and itemAttachment attachments for the event. Navigation property. Read-only. Nullable.
      Parameters:
      attachments - the attachments value to set.
      Returns:
      the MicrosoftGraphEvent object itself.
    • calendar

      public MicrosoftGraphCalendar calendar()
      Get the calendar property: calendar.
      Returns:
      the calendar value.
    • withCalendar

      public MicrosoftGraphEvent withCalendar(MicrosoftGraphCalendar calendar)
      Set the calendar property: calendar.
      Parameters:
      calendar - the calendar value to set.
      Returns:
      the MicrosoftGraphEvent object itself.
    • extensions

      public List<MicrosoftGraphExtension> extensions()
      Get the extensions property: The collection of open extensions defined for the event. Read-only. Nullable.
      Returns:
      the extensions value.
    • withExtensions

      public MicrosoftGraphEvent withExtensions(List<MicrosoftGraphExtension> extensions)
      Set the extensions property: The collection of open extensions defined for the event. Read-only. Nullable.
      Parameters:
      extensions - the extensions value to set.
      Returns:
      the MicrosoftGraphEvent object itself.
    • instances

      public List<MicrosoftGraphEvent> instances()
      Get the instances property: The instances of the event. Navigation property. Read-only. Nullable.
      Returns:
      the instances value.
    • withInstances

      public MicrosoftGraphEvent withInstances(List<MicrosoftGraphEvent> instances)
      Set the instances property: The instances of the event. Navigation property. Read-only. Nullable.
      Parameters:
      instances - the instances value to set.
      Returns:
      the MicrosoftGraphEvent object itself.
    • multiValueExtendedProperties

      public List<MicrosoftGraphMultiValueLegacyExtendedProperty> multiValueExtendedProperties()
      Get the multiValueExtendedProperties property: The collection of multi-value extended properties defined for the event. Read-only. Nullable.
      Returns:
      the multiValueExtendedProperties value.
    • withMultiValueExtendedProperties

      public MicrosoftGraphEvent withMultiValueExtendedProperties(List<MicrosoftGraphMultiValueLegacyExtendedProperty> multiValueExtendedProperties)
      Set the multiValueExtendedProperties property: The collection of multi-value extended properties defined for the event. Read-only. Nullable.
      Parameters:
      multiValueExtendedProperties - the multiValueExtendedProperties value to set.
      Returns:
      the MicrosoftGraphEvent object itself.
    • singleValueExtendedProperties

      public List<MicrosoftGraphSingleValueLegacyExtendedProperty> singleValueExtendedProperties()
      Get the singleValueExtendedProperties property: The collection of single-value extended properties defined for the event. Read-only. Nullable.
      Returns:
      the singleValueExtendedProperties value.
    • withSingleValueExtendedProperties

      public MicrosoftGraphEvent withSingleValueExtendedProperties(List<MicrosoftGraphSingleValueLegacyExtendedProperty> singleValueExtendedProperties)
      Set the singleValueExtendedProperties property: The collection of single-value extended properties defined for the event. Read-only. Nullable.
      Parameters:
      singleValueExtendedProperties - the singleValueExtendedProperties value to set.
      Returns:
      the MicrosoftGraphEvent object itself.
    • additionalProperties

      public Map<String,Object> additionalProperties()
      Get the additionalProperties property: event.
      Overrides:
      additionalProperties in class MicrosoftGraphOutlookItem
      Returns:
      the additionalProperties value.
    • withAdditionalProperties

      public MicrosoftGraphEvent withAdditionalProperties(Map<String,Object> additionalProperties)
      Set the additionalProperties property: event.
      Overrides:
      withAdditionalProperties in class MicrosoftGraphOutlookItem
      Parameters:
      additionalProperties - the additionalProperties value to set.
      Returns:
      the MicrosoftGraphEvent object itself.
    • withCategories

      public MicrosoftGraphEvent withCategories(List<String> categories)
      Set the categories property: The categories associated with the item.
      Overrides:
      withCategories in class MicrosoftGraphOutlookItem
      Parameters:
      categories - the categories value to set.
      Returns:
      the MicrosoftGraphOutlookItem object itself.
    • withChangeKey

      public MicrosoftGraphEvent withChangeKey(String changeKey)
      Set the changeKey property: Identifies the version of the item. Every time the item is changed, changeKey changes as well. This allows Exchange to apply changes to the correct version of the object. Read-only.
      Overrides:
      withChangeKey in class MicrosoftGraphOutlookItem
      Parameters:
      changeKey - the changeKey value to set.
      Returns:
      the MicrosoftGraphOutlookItem object itself.
    • withCreatedDateTime

      public MicrosoftGraphEvent withCreatedDateTime(OffsetDateTime createdDateTime)
      Set the createdDateTime property: The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 would look like this: '2014-01-01T00:00:00Z'.
      Overrides:
      withCreatedDateTime in class MicrosoftGraphOutlookItem
      Parameters:
      createdDateTime - the createdDateTime value to set.
      Returns:
      the MicrosoftGraphOutlookItem object itself.
    • withLastModifiedDateTime

      public MicrosoftGraphEvent withLastModifiedDateTime(OffsetDateTime lastModifiedDateTime)
      Set the lastModifiedDateTime property: The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 would look like this: '2014-01-01T00:00:00Z'.
      Overrides:
      withLastModifiedDateTime in class MicrosoftGraphOutlookItem
      Parameters:
      lastModifiedDateTime - the lastModifiedDateTime value to set.
      Returns:
      the MicrosoftGraphOutlookItem object itself.
    • withId

      public MicrosoftGraphEvent withId(String id)
      Set the id property: Read-only.
      Overrides:
      withId in class MicrosoftGraphOutlookItem
      Parameters:
      id - the id value to set.
      Returns:
      the MicrosoftGraphEntity object itself.
    • validate

      public void validate()
      Validates the instance.
      Overrides:
      validate in class MicrosoftGraphOutlookItem
      Throws:
      IllegalArgumentException - thrown if the instance is not valid.