viewpoint 0.1.9 → 0.1.10

data/lib/field_hash.txt

@@ -0,0 +1,197 @@
+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

@@ -0,0 +1 @@
+: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'

data/lib/model/calendar_folder.rb

@@ -43,27 +43,25 @@ module Viewpoint
         #   <SharingEffectiveRights/>
       end
 
-      # Find Items
-      # @see GenericFolder#find_items
-      def find_items(start_date = nil, end_date = nil)
-        opts ||= {}
-        if(!start_date.nil? && !end_date.nil?)
-          opts = {:calendar_view => {:max_entries_returned => 256, :start_date => start_date, :end_date => end_date}}
-        end
-        super(opts)
-      end
-      alias :items_between :find_items
-      
       # Fetch only items from today (since midnight)
-      def todays_items
+      def todays_items(opts = {})
         #This is a bit convoluted for pre-1.9.x ruby versions that don't support to_datetime
-        find_items(DateTime.parse(Date.today.to_s), DateTime.parse((Date.today + 1).to_s))
+        items_between(DateTime.parse(Date.today.to_s), DateTime.parse((Date.today + 1).to_s), opts)
       end
 
       # Fetch items since a give DateTime
       # @param [DateTime] start_date_time the time to fetch Items since.
-      def items_since(start_date_time)
-        find_items(start_date_time, DateTime.now)
+      def items_since(start_date_time, opts = {})
+        items_between(start_date_time, DateTime.now, opts)
+      end
+
+      # Find Calendar Items between two dates
+      # @param [DateTime] start_date the date to start the search from
+      # @param [DateTime] end_date the date to end the search at
+      # @param [Hash] opts misc opts like restrictions, etc
+      def items_between(start_date, end_date, opts = {})
+        opts[:calendar_view] = {:max_entries_returned => 256, :start_date => start_date, :end_date => end_date}
+        find_items(opts)
       end
 
     end # CalendarFolder

data/lib/model/contact.rb

@@ -87,6 +87,89 @@ module Viewpoint
 
       def init_methods
         super()
+
+        define_str_var :file_as, :file_as_mapping, :display_name, :job_title, :given_name, :surname
+        define_attr_str_var :complete_name, :first_name, :middle_name, :last_name, :initials, :full_name
+        define_inet_addresses :email_addresses, :im_addresses
+        define_phone_numbers :phone_numbers
+        define_physical_addresses :physical_addresses
+      end
+      
+      # Define email_addresses or im_addresses for a Contact
+      def define_inet_addresses(*inet_addresses)
+        inet_addresses.each do |itype|
+          eval "@#{itype} ||= {}"
+          return unless self.instance_variable_get("@#{itype}").empty?
+          if(@ews_item.has_key?(itype))
+            @ews_methods << itype
+            if(@ews_item[itype][:entry].is_a?(Array))
+              @ews_item[itype][:entry].each do |entry|
+                next if entry.keys.length == 1
+                eval "@#{itype}[entry[:key].ruby_case.to_sym] = (entry.has_key?(:text) ? entry[:text] : '')"
+              end
+            else
+              entry = @ews_item[itype][:entry]
+              next if entry.keys.length == 1
+              eval "@#{itype}[entry[:key].ruby_case.to_sym] = (entry.has_key?(:text) ? entry[:text] : '')"
+            end
+            self.instance_eval <<-EOF
+          def #{itype}
+            self.instance_variable_get "@#{itype}"
+          end
+          EOF
+          else
+            @ews_methods_undef << itype
+          end
+        end
+      end
+      
+      def define_phone_numbers(phone_numbers)
+        @phone_numbers ||= {}
+        return unless @phone_numbers.empty?
+        if(@ews_item.has_key?(phone_numbers))
+          if(@ews_item[phone_numbers][:entry].is_a?(Array))
+            @ews_item[phone_numbers][:entry].each do |entry|
+              next if entry.keys.length == 1
+              @phone_numbers[entry[:key].ruby_case.to_sym] = (entry.has_key?(:text) ? entry[:text] : "")
+            end
+          else # it is a Hash then
+            entry = @ews_item[phone_numbers][:entry]
+            return if entry.keys.length == 1
+            @phone_numbers[entry[:key].ruby_case.to_sym] = (entry.has_key?(:text) ? entry[:text] : "")
+          end
+          self.instance_eval <<-EOF
+          def #{phone_numbers}
+            @phone_numbers
+          end
+          EOF
+          @ews_methods << phone_numbers
+        else
+          @ews_methods_undef << itype
+        end
+      end
+
+      # Define physical_addresses for a Contact
+      def define_physical_addresses(physical_addresses)
+        @physical_addresses ||= {}
+        return unless @physical_addresses.empty?
+        if(@ews_item.has_key?(physical_addresses))
+          @ews_methods << physical_addresses
+          @ews_item[physical_addresses][:entry].each do |entry|
+            next if entry.keys.length == 1
+            key = entry.delete(:key)
+            @physical_addresses[key.ruby_case.to_sym] = {}
+            entry.each_pair do |ekey,ev|
+              @physical_addresses[key.ruby_case.to_sym][ekey] = ev[:text]
+            end
+          end
+          self.instance_eval <<-EOF
+          def #{physical_addresses}
+            @physical_addresses
+          end
+          EOF
+        else
+          @ews_methods_undef << itype
+        end
       end
 
     end # Contact

data/lib/model/generic_folder.rb

@@ -215,7 +215,7 @@ module Viewpoint
 
       # Find Items
       def find_items(opts = {})
-        item_shape = {:base_shape => 'Default'}
+        item_shape = opts.has_key?(:item_shape) ? opts.delete(:item_shape) : {:base_shape => 'Default'}
         item_shape[:additional_properties] = {:field_uRI => ['item:ParentFolderId']}
         resp = (Viewpoint::EWS::EWS.instance).ews.find_item([@folder_id], 'Shallow', item_shape, opts)
         if(resp.status == 'Success')
@@ -232,27 +232,27 @@ module Viewpoint
       end
 
       # Fetch only items from today (since midnight)
-      def todays_items
+      def todays_items(opts = {})
         #opts = {:query_string => ["Received:today"]}
         #This is a bit convoluted for pre-1.9.x ruby versions that don't support to_datetime
-        items_since(DateTime.parse(Date.today.to_s))
+        items_since(DateTime.parse(Date.today.to_s), opts)
       end
 
       # Fetch items since a give DateTime
       # @param [DateTime] date_time the time to fetch Items since.
-      def items_since(date_time)
+      def items_since(date_time, opts = {})
         restr = {:restriction =>
           {:is_greater_than_or_equal_to => 
             [{:field_uRI => {:field_uRI=>'item:DateTimeReceived'}},
             {:field_uRI_or_constant =>{:constant => {:value=>date_time}}}]
           }}
-        find_items(restr)
+        find_items(opts.merge(restr))
       end
 
       # Fetch items between a given time period
       # @param [DateTime] start_date the time to start fetching Items from
       # @param [DateTime] end_date the time to stop fetching Items from
-      def items_between(start_date, end_date)
+      def items_between(start_date, end_date, opts={})
         restr = {:restriction =>  {:and => [
           {:is_greater_than_or_equal_to => 
             [{:field_uRI => {:field_uRI=>'item:DateTimeReceived'}},
@@ -261,7 +261,7 @@ module Viewpoint
             [{:field_uRI => {:field_uRI=>'item:DateTimeReceived'}},
             {:field_uRI_or_constant=>{:constant => {:value =>end_date}}}]}
         ]}}
-        find_items(restr)
+        find_items(opts.merge(restr))
       end
 
       # Search on the item subject
@@ -323,8 +323,9 @@ module Viewpoint
       #   an array of ItemIds are returned wich is a Hash in the form:
       #   {:id=>"item id", :change_key=>"change key"}
       #   See: http://msdn.microsoft.com/en-us/library/aa565609.aspx
-      def sync_items!(sync_amount = 256, sync_all = false)
-        resp = (Viewpoint::EWS::EWS.instance).ews.sync_folder_items(@folder_id, @sync_state, sync_amount)
+      def sync_items!(sync_amount = 256, sync_all = false, opts = {})
+        item_shape = opts.has_key?(:item_shape) ? opts.delete(:item_shape) : {:base_shape => 'Default'}
+        resp = (Viewpoint::EWS::EWS.instance).ews.sync_folder_items(@folder_id, @sync_state, sync_amount, item_shape)
         parms = resp.items.shift
         @sync_state = parms[:sync_state]
         @synced = parms[:includes_last_item_in_range]
@@ -351,14 +352,14 @@ module Viewpoint
       # additional items.  Calling this method again will clear the sync_state and synchronize
       # everything again.
       # @return [Array<Item>] returns an array of Items
-      def sync_items_since!(datetime)
+      def sync_items_since!(datetime, opts={})
         clear_sync_state!
 
         begin
           items = sync_items!
         end until items.empty?
 
-        items_since(datetime)
+        items_since(datetime, opts)
       end
 
       # Clears out the @sync_state so you can freshly synchronize this folder if needed

data/lib/model/item.rb

@@ -26,6 +26,7 @@ module Viewpoint
   module EWS
     class Item
       include Model
+      include ItemFieldUriMap
 
       # This is a class method that fetches an existing Item from the
       #  Exchange Store.
@@ -69,6 +70,7 @@ module Viewpoint
         @item_id = ews_item[:item_id][:id]
         @change_key = ews_item[:item_id][:change_key]
         @text_only = false
+        @updates = {}
 
         init_methods
       end
@@ -86,24 +88,60 @@ module Viewpoint
         @text_only = ( txt == true ? true : false)
       end
 
+      # Save any pending updates that were manipulated via setter methods.
+      def save!
+        return true if @updates.empty?
+        if update_attribs!(@updates)
+          @updates = {}
+          true
+        else
+          false
+        end
+      end
+
       # Call UpdateItem for this item with the passed updates
       # @param [Hash] updates a well-formed update hash
-      # @example {:updates=>{:set_item_field=>{:field_u_r_i=>{:field_u_r_i=>"message:IsRead"}, :message=>{:is_read=>{:text=>"true"}}}}}
+      # @example {:set_item_field=>{:field_u_r_i=>{:field_u_r_i=>"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)
-        (resp.status == 'Success') || (raise EwsError, "Trouble updating Item. #{resp.code}: #{resp.message}")
+        resp = conn.ews.update_item([{:id => @item_id, :change_key => @change_key}], {:updates => updates})
+        if resp.status == 'Success'
+          @item_id = resp.items.first[resp.items.first.keys.first][:item_id][:id]
+          @change_key = resp.items.first[resp.items.first.keys.first][:item_id][:change_key]
+          @shallow = true
+          deepen!
+        else
+          raise EwsError, "Trouble updating Item. #{resp.code}: #{resp.message}"
+        end
+
+      end
+
+      # This takes a hash of attributes with new values and builds the appropriate udpate hash
+      # @param [Hash] updates a hash that is formed like so :item_attr => newvalue
+      # @example  {:sensitivity => {:text => 'Normal'}, :display_name => {:text => 'Test User'}}
+      def update_attribs!(updates)
+        changes = []
+        type = self.class.name.split(/::/).last.ruby_case.to_sym
+
+        updates.each_pair do |k,v|
+          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}}}
+        end
+
+        update!(changes)
       end
 
       # Mark this Item as read
       def mark_read!
-        update!({:updates=>{:set_item_field=>{:field_u_r_i=>{:field_u_r_i=>"message:IsRead"}, :message=>{:is_read=>{:text=>"true"}}}}})
+        field = :is_read
+        update!({:set_item_field=>{:field_u_r_i=>{:field_u_r_i=>FIELD_URIS[field][:text]}, :message=>{field=>{:text=>"true"}}}})
         @is_read = true
       end
 
       # Mark this Item as unread
       def mark_unread!
-        update!({:updates=>{:set_item_field=>{:field_u_r_i=>{:field_u_r_i=>"message:IsRead"}, :message=>{:is_read=>{:text=>"false"}}}}})
+        field = :is_read
+        update!({:set_item_field=>{:field_u_r_i=>{:field_u_r_i=>FIELD_URIS[field][:text]}, :message=>{field=>{:text=>"false"}}}})
         @is_read = false
         true
       end
@@ -209,6 +247,7 @@ module Viewpoint
       end
 
 
+
       private
 
       # @todo Handle: