viewpoint 0.1.12 → 0.1.13

data/lib/exceptions/exceptions.rb

@@ -37,6 +37,9 @@ module Viewpoint
     class EwsNotImplemented < StandardError
     end
 
+    # Raised when an method is called in the wrong way
+    class EwsBadArgumentError < StandardError; end
+
   end # EWS
 end # Viewpoint
  

data/lib/model/calendar_item.rb

@@ -53,6 +53,26 @@ module Viewpoint
           raise EwsError, "Could not create CalendarItem. #{resp.code}: #{resp.message}"
         end
       end
+      
+      # Format attendees (usually called from #add_attendees!
+      # @param [Array,String,Hash,MailboxUser] attendees
+      # @param [Symbol] type the type of the attendees :required_attendees/:optional_attendees/:resources
+      def self.format_attendees(attendees, type=:required_attendees)
+        case attendees.class.to_s
+        when 'String'
+          return {type => [{:attendee => {:mailbox => {:email_address => {:text => attendees}}}}]}
+        when /Attendee|MailboxUser/
+          return {type => [{:attendee => {:mailbox => [{:name => {:text => attendees.name}}, {:email_address => {:text => attendees.email_address}}]}}]}
+        when 'Hash'
+          return {type => [{:attendee => {:mailbox => [{:name => {:text => attendees[:name]}}, {:email_address => {:text => attendees[:email_address]}}]}}]}
+        when 'Array'
+          as = {type => []}
+          attendees.each do |a|
+            as.merge!(format_attendees(a, type)) {|k,v1,v2| v1 + v2}
+          end
+          return as
+        end
+      end
 
       # Create a new CalendarItem.
       # @param [DateTime] v_start The date and time when the CalendarItem begins
@@ -60,9 +80,9 @@ module Viewpoint
       # @param [String] subject The subject of this Item
       # @param [String,optional] body The body of this object
       # @param [String,optional] location The location where this calendar item will ocurr
-      # @param [Array<String>,optional] required_attendees An Array of e-mail addresses of required attendees
-      # @param [Array<String>,optional] optional_attendees An Array of e-mail addresses of optional attendees
-      # @param [Array<String>,optional] resources An Array of e-mail addresses of resources
+      # @param [Array<String,MailboxUser,Attendee>,optional] required_attendees An Array of e-mail addresses of required attendees
+      # @param [Array<String,MailboxUser,Attendee>,optional] optional_attendees An Array of e-mail addresses of optional attendees
+      # @param [Array<String,MailboxUser,Attendee>,optional] resources An Array of e-mail addresses of resources
       def self.create_item(v_start, v_end, subject, body = nil, location = nil, required_attendees=[], optional_attendees=[], resources=[])
         item = {}
         item[:start] = {:text => v_start.to_s}
@@ -70,19 +90,12 @@ module Viewpoint
         item[:subject] = {:text => subject}
         item[:body] = {:text => body, :body_type => 'Text'} unless body.nil?
         item[:location] = {:text => location} unless location.nil?
-        required_attendees.each do |a|
-          item[:required_attendees] = [] unless item[:required_attendees].is_a?(Array)
-          item[:required_attendees] << {:attendee => {:mailbox => {:email_address => {:text => a}}}}
-        end
-        optional_attendees.each do |a|
-          item[:optional_attendees] = [] unless item[:optional_attendees].is_a?(Array)
-          item[:optional_attendees] << {:attendee => {:mailbox => {:email_address => {:text => a}}}}
-        end
+        item.merge!(self.format_attendees(required_attendees)) unless required_attendees.empty?
+        item.merge!(self.format_attendees(optional_attendees, :optional_attendees)) unless optional_attendees.empty?
         resources.each do |a|
           item[:resources] = [] unless item[:resources].is_a?(Array)
           item[:resources] << {:attendee => {:mailbox => {:email_address => {:text => a}}}}
         end
-        puts item
         self.create_item_from_hash(item)
       end
 
@@ -91,6 +104,95 @@ module Viewpoint
         super(ews_item)
       end
       
+      # Add attendees to this CalendarItem. This does not commit the changes so you will have to use #save! to
+      #   commit them back. If you want to commit them at once look at the #add_attendees! method.
+      # @param [Array] required Required attendees to add to this object
+      #   Array values of attendees may be simple email strings, MailboxUser items or Hashes in the form
+      #   {:email_address => 'email@test', :name => 'My Name'}.
+      # @param [Array] optional Optional attendees to add to this object
+      #   see the notes for the 'required' parameter.
+      # @example
+      #   ['user1@example.org', 'user2@example.org']
+      #   or
+      #   [{:name => 'User1', :email_address => 'user1@example.org'}, {:name => 'User2', :email_address => 'user2@example.org'}]
+      #   or
+      #   ['user1@example.org', 'user2@example.org'], ['user3@example.org', 'user4@example.org']
+      #   or
+      #   [{:name => 'User1', :email_address => 'user1@example.org'}, {:name => 'User2', :email_address => 'user2@example.org'}],
+      #     [{:name => 'User3', :email_address => 'user3@example.org'}, {:name => 'User4', :email_address => 'user4@example.org'}]
+      # @return [Boolean] true on success, false otherwise
+      # @todo add ability to add resources
+      def add_attendees(required, optional = [], resources = [])
+        update = {}
+        update.merge!(self.class.format_attendees(required)) unless required.empty? || required.nil?
+        update.merge!(self.class.format_attendees(optional, :optional_attendees)) unless optional.empty? || optional.nil?
+
+        return false if update.empty?
+
+        @required_attendees, @optional_attendees = nil, nil
+        changes = update_attribs(update, :append)
+        @updates.merge!({:preformatted => changes}) {|k,v1,v2| v1 + v2}
+        true
+      end
+
+      # This is the same as the #add_attendees method, but it actually commits the change back to Exchange
+      # @see #add_attendees
+      def add_attendees!(required, optional = [], resources = [])
+        add_attendees(required, optional, resources)
+        save!
+      end
+
+      # Remove the attendees from the attendee list. This does not commit the changes so you will have to use
+      #   #save! to commit them back. If you want to commit them at once look at the #remove_attendees! method.
+      # @param [Array] attendees the attendees to remove from this CalendarItem
+      #   [Viewpoint::EWS::Attendee<user1>, Viewpoint::EWS::Attendee<user2>] or
+      #   ['user1@example.org', 'user2@example.org']
+      # @return [Boolean] false if the object is not updated, true otherwise
+      def remove_attendees(attendees)
+        return false if attendees.empty?
+
+        emails = attendees.is_a?(Array) ? attendees : attendees.values
+        emails = emails.collect do |v|
+          case v.class.to_s
+          when 'String'
+            v
+          when /MailboxUser|Attendee/
+            v.email_address
+          when 'Hash'
+            v[:email_address]
+          end
+        end
+
+        update = {}
+        [:required_attendees, :optional_attendees].each do |type|
+          ivar = self.send(type.to_s)
+          next if ivar.nil?
+
+          required_a = ivar.select {|v| !emails.include?(v.email_address) }
+          formatted_a = self.class.format_attendees(required_a, type)
+          if formatted_a[type].empty?
+            update[:preformatted] ||= []
+            update[:preformatted] << {:delete_item_field => [{:field_uRI => {:field_uRI=>FIELD_URIS[type][:text]}}]}
+            self.instance_eval "undef #{type}"
+          else
+            update.merge!(formatted_a)
+          end
+        end
+
+        return false if update.empty?
+
+        @required_attendees, @optional_attendees = nil, nil
+        @updates.merge!(update) {|k,v1,v2| v1 + v2}
+        true
+      end
+
+      # This is the same as the #remove_attendees method, but it actually commits the change back to Exchange
+      # @see #remove_attendees
+      def remove_attendees!(attendees)
+        remove_attendees(attendees)
+        save!
+      end
+
       # Call UpdateItem for this item with the passed updates
       # @param [Hash] updates a well-formed update hash
       # @example {:set_item_field=>{:field_u_r_i=>{:field_u_r_i=>"message:IsRead"}, :message=>{:is_read=>{:text=>"true"}}}}

data/lib/model/item.rb

@@ -102,7 +102,7 @@ module Viewpoint
 
       # Call UpdateItem for this item with the passed updates
       # @param [Hash] updates a well-formed update hash
-      # @example {:set_item_field=>{:field_u_r_i=>{:field_u_r_i=>"message:IsRead"}, :message=>{:is_read=>{:text=>"true"}}}}
+      # @example {:set_item_field=>{:field_uRI=>{:field_uRI=>"message:IsRead"}, :message=>{:is_read=>{:text=>"true"}}}}
       def update!(updates)
         conn = Viewpoint::EWS::EWS.instance
         resp = conn.ews.update_item([{:id => @item_id, :change_key => @change_key}], {:updates => updates})
@@ -117,32 +117,52 @@ module Viewpoint
 
       end
 
-      # This takes a hash of attributes with new values and builds the appropriate udpate hash
+      # This takes a hash of attributes with new values and builds the appropriate udpate hash.
+      #   It does not commit the changes to Exchange, call #update! with the returned values from
+      #   this method or look at #update_attribs! for a version of this method that autocommits the
+      #   changes back.
+      #
+      # You can also specify a preformatted Array of data like so:
+      #   {:preformatted => [misc data]}
+      #   This will simply be passed to the update! method
       # @param [Hash] updates a hash that is formed like so :item_attr => newvalue
+      # @param [Symbol] update_type :append, :replace, :delete
       # @example  {:sensitivity => {:text => 'Normal'}, :display_name => {:text => 'Test User'}}
-      def update_attribs!(updates)
+      def update_attribs(updates, update_type = :replace)
+        utype_map = {:append => :append_to_item_field, :replace => :set_item_field, :delete => :delete_item_field}
         changes = []
         type = self.class.name.split(/::/).last.ruby_case.to_sym
 
         updates.each_pair do |k,v|
+          if(k == :preformatted)
+            changes += v
+            next
+          end
           raise EwsError, "Field (#{FIELD_URIS[k][:text]}) not writable by update." unless FIELD_URIS[k][:writable]
-          changes << {:set_item_field=>[{:field_u_r_i => {:field_u_r_i=>FIELD_URIS[k][:text]}}, {type=>{k => v}}]}
+          changes << {utype_map[update_type]=>[{:field_uRI => {:field_uRI=>FIELD_URIS[k][:text]}}, {type=>{k => v}}]}
         end
 
+        changes
+      end
+
+      # This is the same as #update_attribs, but it will commit the changes back to Exchange.
+      # @see #update_attribs
+      def update_attribs!(updates, update_type = :replace)
+        changes = update_attribs(updates, update_type)
         update!(changes)
       end
 
       # Mark this Item as read
       def mark_read!
         field = :is_read
-        update!({:set_item_field=>{:field_u_r_i=>{:field_u_r_i=>FIELD_URIS[field][:text]}, :message=>{field=>{:text=>"true"}}}})
+        update!({:set_item_field=>{:field_uRI=>{:field_uRI=>FIELD_URIS[field][:text]}, :message=>{field=>{:text=>"true"}}}})
         @is_read = true
       end
 
       # Mark this Item as unread
       def mark_unread!
         field = :is_read
-        update!({:set_item_field=>{:field_u_r_i=>{:field_u_r_i=>FIELD_URIS[field][:text]}, :message=>{field=>{:text=>"false"}}}})
+        update!({:set_item_field=>{:field_uRI=>{:field_uRI=>FIELD_URIS[field][:text]}, :message=>{field=>{:text=>"false"}}}})
         @is_read = false
         true
       end

data/lib/model/model.rb

@@ -230,7 +230,7 @@ module Viewpoint
             @ews_methods << attendee_type
             self.instance_eval <<-EOF
             def #{attendee_type}
-              return @#{attendee_type} if defined?(@#{attendee_type})
+              return @#{attendee_type} if(defined?(@#{attendee_type}) && !@#{attendee_type}.nil?)
               if( (@ews_item[:#{attendee_type}][:attendee]).is_a?(Hash) )
                 @#{attendee_type} = [Attendee.new(@ews_item[:#{attendee_type}][:attendee])]
               elsif( (@ews_item[:#{attendee_type}][:attendee]).is_a?(Array) )

metadata

@@ -5,8 +5,8 @@ version: !ruby/object:Gem::Version
   segments: 
   - 0
   - 1
-  - 12
-  version: 0.1.12
+  - 13
+  version: 0.1.13
 platform: ruby
 authors: 
 - Dan Wanek
@@ -14,7 +14,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2010-12-29 00:00:00 -06:00
+date: 2010-12-31 00:00:00 -06:00
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency 
@@ -114,8 +114,6 @@ files:
 - COPYING.txt
 - TODO
 - lib/exceptions/exceptions.rb
-- lib/field_hash2.txt
-- lib/field_hash.txt
 - lib/soap/soap_provider.rb
 - lib/soap/handsoap/builder.rb
 - lib/soap/handsoap/ews_service.rb

data/lib/field_hash.txt

@@ -1,197 +0,0 @@
-FolderId => 'older:FolderId'
-ParentFolderId => 'folder:ParentFolderId'
-DisplayName => 'folder:DisplayName'
-UnreadCount => 'folder:UnreadCount'
-TotalCount => 'folder:TotalCount'
-ChildFolderCount => 'folder:ChildFolderCount'
-FolderClass => 'folder:FolderClass'
-SearchParameters => 'folder:SearchParameters'
-ManagedFolderInformation => 'folder:ManagedFolderInformation'
-PermissionSet => 'folder:PermissionSet'
-EffectiveRights => 'folder:EffectiveRights'
-SharingEffectiveRights => 'folder:SharingEffectiveRights'
-ItemId => 'item:ItemId'
-ParentFolderId => 'item:ParentFolderId'
-ItemClass => 'item:ItemClass'
-MimeContent => 'item:MimeContent'
-Attachments => 'item:Attachments'
-Subject => 'item:Subject'
-DateTimeReceived => 'item:DateTimeReceived'
-Size => 'item:Size'
-Categories => 'item:Categories'
-HasAttachments => 'item:HasAttachments'
-Importance => 'item:Importance'
-InReplyTo => 'item:InReplyTo'
-InternetMessageHeaders => 'item:InternetMessageHeaders'
-IsAssociated => 'item:IsAssociated'
-IsDraft => 'item:IsDraft'
-IsFromMe => 'item:IsFromMe'
-IsResend => 'item:IsResend'
-IsSubmitted => 'item:IsSubmitted'
-IsUnmodified => 'item:IsUnmodified'
-DateTimeSent => 'item:DateTimeSent'
-DateTimeCreated => 'item:DateTimeCreated'
-Body => 'item:Body'
-ResponseObjects => 'item:ResponseObjects'
-Sensitivity => 'item:Sensitivity'
-ReminderDueBy => 'item:ReminderDueBy'
-ReminderIsSet => 'item:ReminderIsSet'
-ReminderMinutesBeforeStart => 'item:ReminderMinutesBeforeStart'
-DisplayTo => 'item:DisplayTo'
-DisplayCc => 'item:DisplayCc'
-Culture => 'item:Culture'
-EffectiveRights => 'item:EffectiveRights'
-LastModifiedName => 'item:LastModifiedName'
-LastModifiedTime => 'item:LastModifiedTime'
-ConversationId => 'item:ConversationId'
-UniqueBody => 'item:UniqueBody'
-WebClientReadFormQueryString => 'item:WebClientReadFormQueryString'
-WebClientEditFormQueryString => 'item:WebClientEditFormQueryString'
-ConversationIndex => 'message:ConversationIndex'
-ConversationTopic => 'message:ConversationTopic'
-InternetMessageId => 'message:InternetMessageId'
-IsRead => 'message:IsRead'
-IsResponseRequested => 'message:IsResponseRequested'
-IsReadReceiptRequested => 'message:IsReadReceiptRequested'
-IsDeliveryReceiptRequested => 'message:IsDeliveryReceiptRequested'
-References => 'message:References'
-ReplyTo => 'message:ReplyTo'
-From => 'message:From'
-Sender => 'message:Sender'
-ToRecipients => 'message:ToRecipients'
-CcRecipients => 'message:CcRecipients'
-BccRecipients => 'message:BccRecipients'
-AssociatedCalendarItemId => 'meeting:AssociatedCalendarItemId'
-IsDelegated => 'meeting:IsDelegated'
-IsOutOfDate => 'meeting:IsOutOfDate'
-HasBeenProcessed => 'meeting:HasBeenProcessed'
-ResponseType => 'meeting:ResponseType'
-MeetingRequestType => 'meetingRequest:MeetingRequestType'
-IntendedFreeBusyStatus => 'meetingRequest:IntendedFreeBusyStatus'
-Start => 'calendar:Start'
-End => 'calendar:End'
-OriginalStart => 'calendar:OriginalStart'
-IsAllDayEvent => 'calendar:IsAllDayEvent'
-LegacyFreeBusyStatus => 'calendar:LegacyFreeBusyStatus'
-Location => 'calendar:Location'
-When => 'calendar:When'
-IsMeeting => 'calendar:IsMeeting'
-IsCancelled => 'calendar:IsCancelled'
-IsRecurring => 'calendar:IsRecurring'
-MeetingRequestWasSent => 'calendar:MeetingRequestWasSent'
-IsResponseRequested => 'calendar:IsResponseRequested'
-CalendarItemType => 'calendar:CalendarItemType'
-MyResponseType => 'calendar:MyResponseType'
-Organizer => 'calendar:Organizer'
-RequiredAttendees => 'calendar:RequiredAttendees'
-OptionalAttendees => 'calendar:OptionalAttendees'
-Resources => 'calendar:Resources'
-ConflictingMeetingCount => 'calendar:ConflictingMeetingCount'
-AdjacentMeetingCount => 'calendar:AdjacentMeetingCount'
-ConflictingMeetings => 'calendar:ConflictingMeetings'
-AdjacentMeetings => 'calendar:AdjacentMeetings'
-Duration => 'calendar:Duration'
-TimeZone => 'calendar:TimeZone'
-AppointmentReplyTime => 'calendar:AppointmentReplyTime'
-AppointmentSequenceNumber => 'calendar:AppointmentSequenceNumber'
-AppointmentState => 'calendar:AppointmentState'
-Recurrence => 'calendar:Recurrence'
-FirstOccurrence => 'calendar:FirstOccurrence'
-LastOccurrence => 'calendar:LastOccurrence'
-ModifiedOccurrences => 'calendar:ModifiedOccurrences'
-DeletedOccurrences => 'calendar:DeletedOccurrences'
-MeetingTimeZone => 'calendar:MeetingTimeZone'
-ConferenceType => 'calendar:ConferenceType'
-AllowNewTimeProposal => 'calendar:AllowNewTimeProposal'
-IsOnlineMeeting => 'calendar:IsOnlineMeeting'
-MeetingWorkspaceUrl => 'calendar:MeetingWorkspaceUrl'
-NetShowUrl => 'calendar:NetShowUrl'
-UID => 'calendar:UID'
-RecurrenceId => 'calendar:RecurrenceId'
-DateTimeStamp => 'calendar:DateTimeStamp'
-StartTimeZone => 'calendar:StartTimeZone'
-EndTimeZone => 'calendar:EndTimeZone'
-ActualWork => 'task:ActualWork'
-AssignedTime => 'task:AssignedTime'
-BillingInformation => 'task:BillingInformation'
-ChangeCount => 'task:ChangeCount'
-Companies => 'task:Companies'
-CompleteDate => 'task:CompleteDate'
-Contacts => 'task:Contacts'
-DelegationState => 'task:DelegationState'
-Delegator => 'task:Delegator'
-DueDate => 'task:DueDate'
-IsAssignmentEditable => 'task:IsAssignmentEditable'
-IsComplete => 'task:IsComplete'
-IsRecurring => 'task:IsRecurring'
-IsTeamTask => 'task:IsTeamTask'
-Mileage => 'task:Mileage'
-Owner => 'task:Owner'
-PercentComplete => 'task:PercentComplete'
-Recurrence => 'task:Recurrence'
-StartDate => 'task:StartDate'
-Status => 'task:Status'
-StatusDescription => 'task:StatusDescription'
-TotalWork => 'task:TotalWork'
-AssistantName => 'contacts:AssistantName'
-Birthday => 'contacts:Birthday'
-BusinessHomePage => 'contacts:BusinessHomePage'
-Children => 'contacts:Children'
-Companies => 'contacts:Companies'
-CompanyName => 'contacts:CompanyName'
-CompleteName => 'contacts:CompleteName'
-ContactSource => 'contacts:ContactSource'
-Culture => 'contacts:Culture'
-Department => 'contacts:Department'
-DisplayName => 'contacts:DisplayName'
-EmailAddresses => 'contacts:EmailAddresses'
-FileAs => 'contacts:FileAs'
-FileAsMapping => 'contacts:FileAsMapping'
-Generation => 'contacts:Generation'
-GivenName => 'contacts:GivenName'
-HasPicture => 'contacts:HasPicture'
-ImAddresses => 'contacts:ImAddresses'
-Initials => 'contacts:Initials'
-JobTitle => 'contacts:JobTitle'
-Manager => 'contacts:Manager'
-MiddleName => 'contacts:MiddleName'
-Mileage => 'contacts:Mileage'
-Nickname => 'contacts:Nickname'
-OfficeLocation => 'contacts:OfficeLocation'
-PhoneNumbers => 'contacts:PhoneNumbers'
-PhysicalAddresses => 'contacts:PhysicalAddresses'
-PostalAddressIndex => 'contacts:PostalAddressIndex'
-Profession => 'contacts:Profession'
-SpouseName => 'contacts:SpouseName'
-Surname => 'contacts:Surname'
-WeddingAnniversary => 'contacts:WeddingAnniversary'
-Members => 'distributionlist:Members'
-PostedTime => 'postitem:PostedTime'
-ConversationId => 'conversation:ConversationId'
-ConversationTopic => 'conversation:ConversationTopic'
-UniqueRecipients => 'conversation:UniqueRecipients'
-GlobalUniqueRecipients => 'conversation:GlobalUniqueRecipients'
-UniqueUnreadSenders => 'conversation:UniqueUnreadSenders'
-GlobalUniqueUnreadSenders => 'conversation:GlobalUniqueUnreadSenders'
-UniqueSenders => 'conversation:UniqueSenders'
-GlobalUniqueSenders => 'conversation:GlobalUniqueSenders'
-LastDeliveryTime => 'conversation:LastDeliveryTime'
-GlobalLastDeliveryTime => 'conversation:GlobalLastDeliveryTime'
-Categories => 'conversation:Categories'
-GlobalCategories => 'conversation:GlobalCategories'
-FlagStatus => 'conversation:FlagStatus'
-GlobalFlagStatus => 'conversation:GlobalFlagStatus'
-HasAttachments => 'conversation:HasAttachments'
-GlobalHasAttachments => 'conversation:GlobalHasAttachments'
-MessageCount => 'conversation:MessageCount'
-GlobalMessageCount => 'conversation:GlobalMessageCount'
-UnreadCount => 'conversation:UnreadCount'
-GlobalUnreadCount => 'conversation:GlobalUnreadCount'
-Size => 'conversation:Size'
-GlobalSize => 'conversation:GlobalSize'
-ItemClasses => 'conversation:ItemClasses'
-GlobalItemClasses => 'conversation:GlobalItemClasses'
-Importance => 'conversation:Importance'
-GlobalImportance => 'conversation:GlobalImportance'
-ItemIds => 'conversation:ItemIds'
-GlobalItemIds => 'conversation:GlobalItemIds'

data/lib/field_hash2.txt

@@ -1 +0,0 @@
-:folder_id  =>  'older:FolderId', :parent_folder_id  =>  'folder:ParentFolderId', :display_name  =>  'folder:DisplayName', :unread_count  =>  'folder:UnreadCount', :total_count  =>  'folder:TotalCount', :child_folder_count  =>  'folder:ChildFolderCount', :folder_class  =>  'folder:FolderClass', :search_parameters  =>  'folder:SearchParameters', :managed_folder_information  =>  'folder:ManagedFolderInformation', :permission_set  =>  'folder:PermissionSet', :effective_rights  =>  'folder:EffectiveRights', :sharing_effective_rights  =>  'folder:SharingEffectiveRights', :item_id  =>  'item:ItemId', :parent_folder_id  =>  'item:ParentFolderId', :item_class  =>  'item:ItemClass', :mime_content  =>  'item:MimeContent', :attachments  =>  'item:Attachments', :subject  =>  'item:Subject', :date_time_received  =>  'item:DateTimeReceived', :size  =>  'item:Size', :categories  =>  'item:Categories', :has_attachments  =>  'item:HasAttachments', :importance  =>  'item:Importance', :in_reply_to  =>  'item:InReplyTo', :internet_message_headers  =>  'item:InternetMessageHeaders', :is_associated  =>  'item:IsAssociated', :is_draft  =>  'item:IsDraft', :is_from_me  =>  'item:IsFromMe', :is_resend  =>  'item:IsResend', :is_submitted  =>  'item:IsSubmitted', :is_unmodified  =>  'item:IsUnmodified', :date_time_sent  =>  'item:DateTimeSent', :date_time_created  =>  'item:DateTimeCreated', :body  =>  'item:Body', :response_objects  =>  'item:ResponseObjects', :sensitivity  =>  'item:Sensitivity', :reminder_due_by  =>  'item:ReminderDueBy', :reminder_is_set  =>  'item:ReminderIsSet', :reminder_minutes_before_start  =>  'item:ReminderMinutesBeforeStart', :display_to  =>  'item:DisplayTo', :display_cc  =>  'item:DisplayCc', :culture  =>  'item:Culture', :effective_rights  =>  'item:EffectiveRights', :last_modified_name  =>  'item:LastModifiedName', :last_modified_time  =>  'item:LastModifiedTime', :conversation_id  =>  'item:ConversationId', :unique_body  =>  'item:UniqueBody', :web_client_read_form_query_string  =>  'item:WebClientReadFormQueryString', :web_client_edit_form_query_string  =>  'item:WebClientEditFormQueryString', :conversation_index  =>  'message:ConversationIndex', :conversation_topic  =>  'message:ConversationTopic', :internet_message_id  =>  'message:InternetMessageId', :is_read  =>  'message:IsRead', :is_response_requested  =>  'message:IsResponseRequested', :is_read_receipt_requested  =>  'message:IsReadReceiptRequested', :is_delivery_receipt_requested  =>  'message:IsDeliveryReceiptRequested', :references  =>  'message:References', :reply_to  =>  'message:ReplyTo', :from  =>  'message:From', :sender  =>  'message:Sender', :to_recipients  =>  'message:ToRecipients', :cc_recipients  =>  'message:CcRecipients', :bcc_recipients  =>  'message:BccRecipients', :associated_calendar_item_id  =>  'meeting:AssociatedCalendarItemId', :is_delegated  =>  'meeting:IsDelegated', :is_out_of_date  =>  'meeting:IsOutOfDate', :has_been_processed  =>  'meeting:HasBeenProcessed', :response_type  =>  'meeting:ResponseType', :meeting_request_type  =>  'meetingRequest:MeetingRequestType', :intended_free_busy_status  =>  'meetingRequest:IntendedFreeBusyStatus', :start  =>  'calendar:Start', :end  =>  'calendar:End', :original_start  =>  'calendar:OriginalStart', :is_all_day_event  =>  'calendar:IsAllDayEvent', :legacy_free_busy_status  =>  'calendar:LegacyFreeBusyStatus', :location  =>  'calendar:Location', :when  =>  'calendar:When', :is_meeting  =>  'calendar:IsMeeting', :is_cancelled  =>  'calendar:IsCancelled', :is_recurring  =>  'calendar:IsRecurring', :meeting_request_was_sent  =>  'calendar:MeetingRequestWasSent', :is_response_requested  =>  'calendar:IsResponseRequested', :calendar_item_type  =>  'calendar:CalendarItemType', :my_response_type  =>  'calendar:MyResponseType', :organizer  =>  'calendar:Organizer', :required_attendees  =>  'calendar:RequiredAttendees', :optional_attendees  =>  'calendar:OptionalAttendees', :resources  =>  'calendar:Resources', :conflicting_meeting_count  =>  'calendar:ConflictingMeetingCount', :adjacent_meeting_count  =>  'calendar:AdjacentMeetingCount', :conflicting_meetings  =>  'calendar:ConflictingMeetings', :adjacent_meetings  =>  'calendar:AdjacentMeetings', :duration  =>  'calendar:Duration', :time_zone  =>  'calendar:TimeZone', :appointment_reply_time  =>  'calendar:AppointmentReplyTime', :appointment_sequence_number  =>  'calendar:AppointmentSequenceNumber', :appointment_state  =>  'calendar:AppointmentState', :recurrence  =>  'calendar:Recurrence', :first_occurrence  =>  'calendar:FirstOccurrence', :last_occurrence  =>  'calendar:LastOccurrence', :modified_occurrences  =>  'calendar:ModifiedOccurrences', :deleted_occurrences  =>  'calendar:DeletedOccurrences', :meeting_time_zone  =>  'calendar:MeetingTimeZone', :conference_type  =>  'calendar:ConferenceType', :allow_new_time_proposal  =>  'calendar:AllowNewTimeProposal', :is_online_meeting  =>  'calendar:IsOnlineMeeting', :meeting_workspace_url  =>  'calendar:MeetingWorkspaceUrl', :net_show_url  =>  'calendar:NetShowUrl', :u_i_d  =>  'calendar:UID', :recurrence_id  =>  'calendar:RecurrenceId', :date_time_stamp  =>  'calendar:DateTimeStamp', :start_time_zone  =>  'calendar:StartTimeZone', :end_time_zone  =>  'calendar:EndTimeZone', :actual_work  =>  'task:ActualWork', :assigned_time  =>  'task:AssignedTime', :billing_information  =>  'task:BillingInformation', :change_count  =>  'task:ChangeCount', :companies  =>  'task:Companies', :complete_date  =>  'task:CompleteDate', :contacts  =>  'task:Contacts', :delegation_state  =>  'task:DelegationState', :delegator  =>  'task:Delegator', :due_date  =>  'task:DueDate', :is_assignment_editable  =>  'task:IsAssignmentEditable', :is_complete  =>  'task:IsComplete', :is_recurring  =>  'task:IsRecurring', :is_team_task  =>  'task:IsTeamTask', :mileage  =>  'task:Mileage', :owner  =>  'task:Owner', :percent_complete  =>  'task:PercentComplete', :recurrence  =>  'task:Recurrence', :start_date  =>  'task:StartDate', :status  =>  'task:Status', :status_description  =>  'task:StatusDescription', :total_work  =>  'task:TotalWork', :assistant_name  =>  'contacts:AssistantName', :birthday  =>  'contacts:Birthday', :business_home_page  =>  'contacts:BusinessHomePage', :children  =>  'contacts:Children', :companies  =>  'contacts:Companies', :company_name  =>  'contacts:CompanyName', :complete_name  =>  'contacts:CompleteName', :contact_source  =>  'contacts:ContactSource', :culture  =>  'contacts:Culture', :department  =>  'contacts:Department', :display_name  =>  'contacts:DisplayName', :email_addresses  =>  'contacts:EmailAddresses', :file_as  =>  'contacts:FileAs', :file_as_mapping  =>  'contacts:FileAsMapping', :generation  =>  'contacts:Generation', :given_name  =>  'contacts:GivenName', :has_picture  =>  'contacts:HasPicture', :im_addresses  =>  'contacts:ImAddresses', :initials  =>  'contacts:Initials', :job_title  =>  'contacts:JobTitle', :manager  =>  'contacts:Manager', :middle_name  =>  'contacts:MiddleName', :mileage  =>  'contacts:Mileage', :nickname  =>  'contacts:Nickname', :office_location  =>  'contacts:OfficeLocation', :phone_numbers  =>  'contacts:PhoneNumbers', :physical_addresses  =>  'contacts:PhysicalAddresses', :postal_address_index  =>  'contacts:PostalAddressIndex', :profession  =>  'contacts:Profession', :spouse_name  =>  'contacts:SpouseName', :surname  =>  'contacts:Surname', :wedding_anniversary  =>  'contacts:WeddingAnniversary', :members  =>  'distributionlist:Members', :posted_time  =>  'postitem:PostedTime', :conversation_id  =>  'conversation:ConversationId', :conversation_topic  =>  'conversation:ConversationTopic', :unique_recipients  =>  'conversation:UniqueRecipients', :global_unique_recipients  =>  'conversation:GlobalUniqueRecipients', :unique_unread_senders  =>  'conversation:UniqueUnreadSenders', :global_unique_unread_senders  =>  'conversation:GlobalUniqueUnreadSenders', :unique_senders  =>  'conversation:UniqueSenders', :global_unique_senders  =>  'conversation:GlobalUniqueSenders', :last_delivery_time  =>  'conversation:LastDeliveryTime', :global_last_delivery_time  =>  'conversation:GlobalLastDeliveryTime', :categories  =>  'conversation:Categories', :global_categories  =>  'conversation:GlobalCategories', :flag_status  =>  'conversation:FlagStatus', :global_flag_status  =>  'conversation:GlobalFlagStatus', :has_attachments  =>  'conversation:HasAttachments', :global_has_attachments  =>  'conversation:GlobalHasAttachments', :message_count  =>  'conversation:MessageCount', :global_message_count  =>  'conversation:GlobalMessageCount', :unread_count  =>  'conversation:UnreadCount', :global_unread_count  =>  'conversation:GlobalUnreadCount', :size  =>  'conversation:Size', :global_size  =>  'conversation:GlobalSize', :item_classes  =>  'conversation:ItemClasses', :global_item_classes  =>  'conversation:GlobalItemClasses', :importance  =>  'conversation:Importance', :global_importance  =>  'conversation:GlobalImportance', :item_ids  =>  'conversation:ItemIds', :global_item_ids  =>  'conversation:GlobalItemIds'