book

Inside Microsoft® Exchange Server 2007 Web Services

by David Sterling, Michael Mainer, Ben Spain, Mark Taylor, Huw Upshall

November 2007

Intermediate to advanced

928 pages

26h 9m

English

Microsoft Press

Read now

Unlock full access

From David
What Does This Book Cover?Part I: The BasicsPart II: Things in Your MailboxPart III: SearchingPart IV: Keeping You in the LoopPart V: Advanced Topics

Questions and Comments
What Is Exchange Web Services?What Does It Cover?What Features Are Missing?Which APIs Is It Meant to Replace?How Do You Talk to Exchange Web Services?
Generating the Proxy in Visual Studio 2005STEP 1: Create a New Class Library ProjectSTEP 2: Add a Web Reference to Your ProjectSTEP 3: Compile the LibraryGenerating Proxies by Using wsdl.exeCreating a Class Library
Messages.xsdTypes.xsdSchema, Meet ProxyChoice Elements*Specified FlagsOnly Default ConstructorsName Mangling on enum ValuesArray Length Restrictions LostSome Simple Type Restrictions LostCertain Reference Type Elements Are No Longer Required
Accessing Your Own Mailbox
Folder IdsDistinguished Folder IdsFear the DisplayNameNormal Folder IdsItem IdsAttachment IdsId Caching
Primary SMTP Addresses
Client Cultures versus Server Cultures
An Item by Any Other Name
Unindexed Property PathsIndexed Property PathsExtended Property PathsProperty TagProperty Set with NameProperty Set with Dispatch IdentifierException Property Paths
Base ShapesIdOnlyDefaultAllPropertiesItem ShapesBaseShapeIncludeMimeContentBodyTypeAdditionalPropertiesFolder ShapesUseful Proxy Class Extensions
Mailbox Structure
BaseFolderTypeFolderClass PropertyDisplayName PropertyCalendarFolderTypeFolderTypeContactsFolderTypeSearchFolderTypeTasksFolderType
GetFolderDealing with Response MessagesCreateFolderWhat Does Your New Folder Look Like?Creating Strongly Typed FoldersMoveFolderMoveFolder and Delegate AccessCopyFolderFindFolderTraversalParentFolderIdsDeleteFolderDeleteType AttributeHardDeleteSoftDeleteMoveToDeletedItemsUpdateFolderSetFolderFieldTypeDeleteFolderFieldTypeAppendToFolderFieldTypeApplication Operations for Properties
Creating Managed Folder Instances in Exchange Web ServicesFinding the Managed Folder RootUpdating Managed Folder InformationDeleting Managed Folders
What Is an Item?Determining the Type of an Item
GetItemCreateItemMessageDisposition AttributeSendMeetingInvitations AttributeSavedItemFolderId ElementItems ElementCopyItemToFolderId ElementItemIds ElementMoveItemDeleteItemItemIds ElementDeleteType AttributeSendMeetingCancellations AttributeAffectedTaskOccurrences AttributeFindItemTraversal AttributeItemShape ElementPaging ElementsGrouping ElementsRestriction ElementSortOrder ElementParentFolderIds ElementDealing with the FindItem ResponseSendItemUpdateItemConflictResolution AttributeSavedItemFolderId ElementItemChanges ElementSetItemFieldTypeDeleteItemFieldTypeAppendItemFieldTypeWhat If You Specify the Wrong Type?ItemType PropertiesItemType Properties and ShapesMimeContent PropertyRetrieving MIME ContentCreating an Item from MIMEBody PropertyAttachments PropertyCategories PropertyInternetMessageHeaders PropertyResponseObjects PropertyCulture Property
What Is a Contact?Store ContactsDirectory Contacts
FileAs and FileAsMappingSubject and DisplayNameCompleteNameEmailAddressesThe contacts:EmailAddresses Property PathDeleting E-Mail AddressesPhysicalAddresses and PostalAddressIndexPhysical Address Property PathsPhoneNumbersPhone Number Property PathsImAddressesDictionary Property Paths and the Proxy ClassesChildren and CompaniesContactSource
UnresolvedEntry ElementResolving Directory ContactsResolving Store ContactsDealing with the ResponseReturnFullContactData Attribute
Expanding Store (Private) Distribution ListsExpanding Directory (Public) Distribution ListsA Proxy Class Example
What Exactly Is a Message?
Recipient AddressesThe EmailAddressTypeThe Name elementThe EmailAddress and RoutingType elements
Recipient Collection PropertiesUpdating the Recipient Collection PropertiesRetrieving the Recipient Collection PropertiesIsRead PropertyCreating and Suppressing Read ReceiptsIsDeliverReceiptRequested PropertyReplyTo PropertyFrom and Sender Properties
The SendItem Web MethodItemIds ElementSavedItemFolderId and SaveItemToFolderResending MessagesSending to a Store Distribution List
ReferenceItemId PropertyBody and NewBodyContent PropertiesThe Missing Properties on Response ObjectsResponse Object Applicability
Making the Complex Understandable
Introducing RecurrencesIntroducing MeetingsIntroducing Free/Busy StatusCalendarItemType PropertiesThe Start and End PropertiesThe Location PropertyThe CalendarItemType PropertyThe ResponseObjects PropertyThe LegacyFreeBusyStatus PropertyThe Duration PropertyThe IsCancelled PropertyThe IsRecurring PropertyThe IsAllDayEvent PropertyThe TimeZone PropertyThe MeetingTimeZone Property
The AdjacentMeetingCount and ConflictingMeetingCount PropertiesThe AdjacentMeetings and ConflictingMeetings Properties
Understanding Offsets in Date/Time StringsExchange Web Services Rules Governing Date/Time String ConversionWorking with DateTime Structures in the Proxy Classes
Getting a System.TimeSpan Object from a Duration PropertyWorking with TimeSpan Structures and the BaseOffset Property
Understanding the TotalCount Property on Calendar FoldersIntroducing the CalendarViewType TypeUsing a Calendar View with the Proxy ClassesCalendarViews and Custom AppointmentTypes
Understanding RecurrencesMastering the Occurrence RelationshipGetting the Recurring Master of a Series from an Occurrence IdUnderstanding How Occurrences and Exceptions Are IndexedFinding an Occurrence or Exception by IndexSpecial References to Items in a Recurring SeriesFirstOccurrence PropertyLastOccurrence PropertyModifiedOccurrences PropertyDeletedOccurrences PropertyExample of the Recurring Series Special Reference Properties
Setting the Properties of the RecurrenceType Type in ProxyUnderstanding Recurrence PatternsFixed Interval Recurrence Pattern TypesAbsolute Yearly Recurrence PatternRelative Yearly Recurrence PatternVariable Interval Recurrence Pattern TypesAbsolute Monthly Recurrence PatternRelative Monthly Recurrence PatternWeekly Recurrence PatternDaily Recurrence PatternSummarizing the Use of the Interval PropertyUnderstanding Recurrence RangesNotes on Recurrence Ranges
Notes on Using Change Keys in a Recurring Series
Understanding the MeetingTimeZone ElementTimeZoneName Attribute of the TimeZoneType TypeStandard and Daylight PropertiesOffset Element of TimeChangeType TypeTime Element of the TimeChangeTypeTimeZoneName Attribute of TimeChangeType TypeTime Change Patterns in the MeetingTimeZone ElementUsing the MeetingTimeZone to Set a Time Zone with Time Changes on a Calendar ItemUpdating MeetingTimeZoneUnderstanding xs:time XML Serialization IssuesOvercoming xs:time XML Serialization Issues with IXmlSerializableUsing the MeetingTimeZone Property to Set a Time Zone with Time Changes on a Calendar Item via the ProxyNotes on Getting Time Zone Definitions from the Windows Registry
Creating a Meeting and Inviting AttendeesCreating a Meeting Using the CreateItem Web MethodCreating a Meeting Using the UpdateItem Web MethodUnderstanding Attendees and Attendee CollectionsModifying an Attendee CollectionRemoving Attendees from a MeetingForwarding Meetings and Meeting RequestsMeeting Forward Notification MessagesRecognizing a Meeting Request as ‘Sent On Behalf Of’
Understanding Meeting MessagesAssociatedCalendarItemId PropertyIsDelegated PropertyIsOutOfDate PropertyHasBeenProcessed PropertyResponseType PropertyUnderstanding Meeting RequestsProperties of a Meeting RequestMeetingRequestType PropertyIntendedFreeBusyStatus PropertyLegacyFreeBusyStatus PropertyMeetingRequestWasSent PropertyMyResponseType PropertyThe RequiredAttendees and OptionalAttendees PropertiesViewing a Meeting Request via the Proxy Classes
Understanding the Meeting Registration Response Object TypesReferenceItemId PropertyAccepting a Meeting RequestDeclining a Meeting RequestTentatively Accepting a Meeting RequestResponding to Meetings Using a MeetingMessage Id versus Using a CalendarItem IdIncluding Message Content in a Meeting ResponseResponding to a Meeting Request via the Proxy Classes
Understanding Meeting Response MessagesTracking Meeting Responses
Removing a Meeting from the Organizer’s Calendar Using the DeleteItem Web MethodUsing CancelCalendarItem to Cancel a MeetingUnderstanding Meeting Cancellation MessagesRemoving a Cancelled Meeting with the RemoveItem Response Object
Changing a Response to One Occurrence of a Recurring MeetingUpdating the Attendee List for One Occurrence of a Recurring Meeting
Basic Task Operations
Task Delegation and Exchange Web ServicesAssignedTime PropertyDelegationState PropertyDelegator PropertyIsAssignmentEditable PropertyIsComplete and PercentComplete PropertiesIsTeamTask PropertyOwner PropertyStatus and StatusDescription Properties
Creating a Recurring TaskWhat Is a Regenerating Recurrence Pattern?Regenerating Recurrence Pattern TypesTask Properties and RestrictionsOverdue Regenerating TasksModifying Recurrence PatternsHow Are Recurring Task Instances Related?
What Are Attachments?Attachments, Property Paths, and Item Shapes
Retrieving Attachment ContentAttachmentShape ElementAttachmentIds ElementCreating File AttachmentsAttachment IdsDeleting File AttachmentsHidden/Inline AttachmentsUpdating AttachmentsFinding Attachments
Reintroducing the AttachmentShapeCreating an Item AttachmentDeleting Item Attachments
A Little BackgroundProperty TypePropTag RangesIdentifying Extended Properties
Property TypeProperty TagsCustom Properties by NameCustom Properties by IdExtended Property Metadata and DataProperties with Multiple Values
Specifying Extended Properties in ShapesUpdating Extended PropertiesOverriding Exchange Web Services Business Logic
Restrictions
TwoOperandExpressionTypeNotType Search ExpressionAnd and Or FiltersExists FilterContains FilterContainmentMode AttributeContainmentComparison AttributeExcludes Filter
Recipient SubfiltersAttachment Subfilters
PagingIndexed PagingForward NavigationIndexed Paging Using The ProxyBackward NavigationFractional PagingPaging and Stale Data
GroupBy ElementOrder AttributeAggregationDistinguishedGroupBy ElementGrouped Results and TotalItemsInViewDealing with the ResultsMore on the Group IdentifierGrouping by a Property that Doesn’t Exist for an ItemAcceptable Group by PropertiesGrouping by Attachments
SearchParametersType
Partial Support for MAPI RestrictionsSubfilters Not Supported for Office Outlook Search Folders
What Is Synchonization?
FolderShape ElementSyncState ElementNotable OmissionsSyncFolderHierarchy ResponsesIncludesLastFolderInRange ElementChanges ElementCreate Change EntriesUpdate Change EntriesDelete Change EntriesThe "Other" DeleteMoving and Copying FoldersDealing with the Response
ItemShape ElementSyncFolderId ElementSyncState ElementIgnore ElementMaxChangesReturned ElementSyncFolderItems ResponsesChanges ElementCreate and Update Change EntriesDelete Change EntriesSyncFolderItems Responses and the Proxy ClassesSyncing Items Outside of the IPM Subtree
What Is a Notification?
WeightFolders versus ItemsServer versus Client Held StateInformation RichnessControl Over Information ReceivedOther Mailboxes
Creating a Pull Notification SubscriptionThe FolderIds ElementThe Timeout ElementSubscriptionId and Watermark Response ElementsUsing the Proxy ClassesRe-Creating a SubscriptionRetrieving and Interpreting EventsSubscriptionId and PreviousWatermark Elements in ResponseMoreEvents Element in ResponseWatermark Element in ResponseItemId or FolderId in ResponseTimestamp Element in ResponseParentFolderId Element in ResponseStatusEventCreatedEvent, DeletedEvent, and NewMailEventCopiedEvent and MovedEventModifiedEventUsing the Proxy ClassesUnsubscribing
Creating a Push Notification SubscriptionStatusFrequency Element in RequestURL Element in RequestPush Subscription LifetimeUsing the Proxy ClassesPush Notification Requests and ResponsesMoreEvents Element in SendNotificationResponding to SendNotificationThe Art of Listening: The Push Subscription ClientWhat Happens When Things Go Wrong?
SOAP and Batch Processing
ResponseClass AttributeMessageText ElementResponseCode ElementDescriptiveLinkKey ElementMessageXml Element
The Non-Batched, Exception ApproachThe Batched Approach
The Two Hop ProblemThe Exchange Two Hop SolutionThe Principle of Least PrivilegeMore Account Control
The Service AccountThe Act As AccountThe Mailbox Account
Exchange ImpersonationPrincipalNameSIDPrimarySmtpAddressUsing the Proxy ClassesThe ms-Exch-EPI-Impersonation RightThe ms-Exch-EPI-May-Impersonate RightGranting the ms-Exch-EPI-May-Impersonate Right on the User ObjectGranting ms-Exch-EPI-May-Impersonate to the Mailbox DatabaseResolving Rights DiscrepanciesExchange Impersonation and Cross-Forest ContactsLooking at the Security DescriptorToken SerializationWhy Two Formats for S2S Authentication?PerformanceConfigurationWider-Scoped PrivilegesToken Serialization in the SchemaUserSid ElementGroupsSids ElementRestrictedGroupSids ElementPrimarySmtpAddress ElementCreating the SerializedSecurityContextToken Serialization RightOh, How I Trust Thee!
Talking to Autodiscover
The Outlook ProviderEMailAddress ElementLegacyDN ElementAcceptableResponseSchema ElementThe Outlook Provider Autodiscover ResponseThe User ElementThe Account ElementThe EXCH ProtocolThe EXPR ProtocolThe WEB ProtocolOutlook Provider RedirectionsThe MobileSync ProviderMobileSync Provider for Autodiscover ResponseThe Culture ElementThe User ElementThe Action Element
What Is User Availability?
GetUserAvailabilityResponseTypeIntroducing the FreeBusyResponseArray and FreeBusyViewIntroducting the SuggestionsResponseChecking for Success in a GetUserAvailabilityResponse via the Proxy Classes
TimeZone ElementBias Element of the SerializableTimeZoneStandardTime and DaylightTime PropertiesBias Element of SerializableTimeZoneTimeTime Element of SerializableTimeZoneTimeThe DayOrder, Month, and DayOfWeek Elements of SerializableTimeZoneTimeComparison of RelativeYearlyRecurrencePatternType and SerializableTimeZoneTimeMailboxDataArray ElementEmail Element of MailboxDataAttendeeTypeExcludeConflicts
FreeBusyViewOptions in an Availability RequestFreeBusyViewOptions ElementsTimeWindowMergedFreeBusyIntervalInMinutesRequestedViewFreeBusyView in an Availability ResponseFreeBusyViewTypeMergedFreeBusyCalendarEventArray and CalendarEventsCalendarEventDetailsWorkingHoursTimeZone Element of WorkingHoursWorkingPeriodArray and WorkingPeriodDayOfWeek Element on of WorkingPeriodStartTimeInMinutes and EndTimeInMinutesUnderstanding Time Zone Issues with CalendarEventsOvercomming Incorrect CalendarEvent Time Values with IXmlSerializableGetting Free/Busy Information from the Proxy ClassesGetting Free/Busy Information from a Distribution List
SuggestionsViewOptions in an Availability RequestSuggestionsViewOptions ElementsGoodThresholdMaximumResultsByDayMaximumNonWorkHourResultsByDayMeetingDurationInMinutesMinimumSuggestionQualityDetailedSuggestionsWindowCurrentMeetingTimeGlobalObjectIdSuggestionsResponse in an Availability ResponseSuggestionDayResultDate Element of SuggestionDayResultDayQuality ElementSuggestionArraySuggestionsMeetingTime Element of SuggestionIsWorkTimeSuggestionQualityAttendee Conflict DataUnknownAttendeeConflictDataIndividualAttendeeConflictDataTooBigGroupAttendeeConflictDataGroupAttendeeConflictDataUnderstanding Time Zone Issues with SuggestionsOvercoming Incorrect Suggestion MeetingTime Values with IXmlSerializableGetting Suggestion Information with the Proxy Classes
Introducing the SetUserOofSettings Web MethodMailbox Element in SetUserOofSettingsRequestUserOofSettings Element in SetUserOofSettingsRequestOofState Element in UserOofSettingsExternalAudience Element in UserOofSettingsDuration Element in UserOofSettingsInternalReply and ExternalReply Elements in UserOofSettingsUnderstanding the SetUserOofSettingsResponseSetting User OOF Settings via the Proxy Classes
Understanding the GetUserOofSettingsResponseOofState Element in OofSettingsExternalAudience Element in OofSettingsDuration Element in OofSettingsInternalReply and ExternalReply Elements in OofSettingsAllowExternalOof in GetUserOofSettingsResponseGetting User OOF Settings via the Proxy Classes
David Sterling

Content preview from Inside Microsoft® Exchange Server 2007 Web Services

Understanding Calendar Items

Soon we are going to take an in depth look at all of the properties on calendar items, but before we get to that, we want to introduce three concepts that are important to understand when working with calendar items. Those concepts are

Recurrences
Meetings
Free/Busy Status

Introducing Recurrences

A sequence of calendar items that follow a distinct pattern and are delimited by a range is called a recurring series. A recurring series is created by setting the Recurrence property on a new or existing calendar item with a recurrence pattern and recurrence range. The calendar item that then holds the information in its Recurrence property is called the recurring master.

When a recurring series is created, calendar items known ...