viewpoint 0.1.6 → 0.1.7

data/Changelog.txt

@@ -1,3 +1,57 @@
+commit 002a3562533991ff27270c6d44e2c055b63fc9d8
+Author: Dan Wanek <dan.wanek@gmail.com>
+Date:   Sun Nov 14 20:17:47 2010 -0600
+
+    changed Message.send back to returning true on success
+
+commit b756a46c4f9fc7ec54b0f954fd23b9ffa20e47a2
+Author: Dan Wanek <dan.wanek@gmail.com>
+Date:   Sun Nov 14 10:53:21 2010 -0600
+
+    Added BPOS work-around GenericFolder#sync_items_sync!
+    Added a way to clear out synchornization GenericFolder#clear_sync_state!
+    Added additional tests for new methods
+
+commit bfa1569fbeb9b7af81f0ebe84408dc376891e416
+Author: Dan Wanek <dan.wanek@gmail.com>
+Date:   Wed Nov 10 11:13:59 2010 -0600
+
+    Added ability to mark/unmark an Item read Item#mark_read!, Item#mark_unread!
+
+commit 40299edf5013e05427900bccea9d64db41b17942
+Author: Dan Wanek <dan.wanek@gmail.com>
+Date:   Wed Nov 10 10:09:15 2010 -0600
+
+    Added properties to ItemShape for get_item so that you can request
+    :body_type of Text only.
+    Added EWS init methods to meeting request
+
+commit 3c73c2556f6c4cdd33601eed90ab8815201e476d
+Author: Dan Wanek <dan.wanek@gmail.com>
+Date:   Fri Nov 5 14:13:55 2010 -0500
+
+    version up for hash insertion bugs
+
+commit ecac0e11754a436248688aca17c33bb1b2c4aaed
+Author: Dan Wanek <dan.wanek@gmail.com>
+Date:   Fri Nov 5 13:47:57 2010 -0500
+
+    version 0.1.5b
+
+commit d9bc83a83c83d832eb30b6e3f309c80e4e36350a
+Author: Dan Wanek <dan.wanek@gmail.com>
+Date:   Fri Nov 5 13:44:20 2010 -0500
+
+    Fixed issue with GenericFolder#items_since and #items_between for
+    versions of Ruby less than 1.8.7.  It had to do with insertion order
+    of Hashes.
+
+commit bf5426fec4862020b5186caf15d77550f00649ab
+Author: Dan Wanek <dan.wanek@gmail.com>
+Date:   Fri Nov 5 12:05:28 2010 -0500
+
+    version 0.1.5
+
 commit 62dbad34702f88505a846a6e9da730ab4c69ae2c
 Author: Dan Wanek <dan.wanek@gmail.com>
 Date:   Fri Nov 5 11:47:50 2010 -0500

data/VERSION

@@ -1 +1 @@
-0.1.6
+0.1.7

data/lib/model/generic_folder.rb

@@ -104,8 +104,8 @@ module Viewpoint
         end
       end
 
-      attr_accessor :folder_id, :change_key, :parent_id
-      attr_reader :subscription_id, :watermark, :sync_state
+      attr_accessor :folder_id, :change_key, :parent_id, :sync_state
+      attr_reader :subscription_id, :watermark
       alias :id :folder_id
 
       def initialize(ews_item)
@@ -313,6 +313,30 @@ module Viewpoint
         items
       end
 
+      # This is basically a work-around for Microsoft's BPOS hosted Exchange, which does not support
+      # subscriptions at the time of this writing.  This is the best way I could think of to get
+      # items from a specific period of time and track changes.
+      # !! Before using this method I would suggest trying a GenericFolder#items_since then using
+      # a subscription to track changes.
+      # This method should be followed by subsequent calls to GenericFolder#sync_items! to fetch
+      # 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)
+        clear_sync_state!
+
+        begin
+          items = sync_items!
+        end until items.empty?
+
+        items_since(datetime)
+      end
+
+      # Clears out the @sync_state so you can freshly synchronize this folder if needed
+      def clear_sync_state!
+        @sync_state = nil
+      end
+
       # Create a subfolder of this folder
       #
       # @param [String] name The name of the new folder

data/lib/model/item.rb

@@ -67,14 +67,51 @@ module Viewpoint
         @shallow = shallow
         @item_id = ews_item[:item_id][:id]
         @change_key = ews_item[:item_id][:change_key]
+        @text_only = false
 
         init_methods
       end
 
+
+      # See if this item is set to return only text in its body.
+      # @return [Boolean] if true the body will return only text, otherwise it may be HTML or text.
+      def text_only?
+        @text_only
+      end
+
+      # Set whether or not the body should be text-only or not
+      # @param [Boolean] txt if true the body will return only text, otherwise it may be HTML or text.
+      def text_only=(txt)
+        @text_only = ( txt == true ? true : false)
+      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"}}}}}
+      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}")
+      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"}}}}})
+        @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"}}}}})
+        @is_read = false
+        true
+      end
+
       def deepen!
         return true unless @shallow
         conn = Viewpoint::EWS::EWS.instance
-        resp = conn.ews.get_item([@item_id], {:base_shape => 'AllProperties'})
+        shape = {:base_shape => 'AllProperties', :body_type => (@text_only ? 'Text' : 'Best')}
+        resp = conn.ews.get_item([@item_id], shape) 
         resp = resp.items.shift
         @ews_item = resp[resp.keys.first]
         @shallow = false
@@ -198,7 +235,7 @@ module Viewpoint
           deepen!
           send(m, *args, &block)
         else
-          warn "!!! No such method: #{m}"
+          warn "!!! No such method: #{m}" if $DEBUG
           nil
         end
       end

data/lib/model/meeting_request.rb

@@ -21,6 +21,21 @@
 module Viewpoint
   module EWS
     class MeetingRequest < Item
+
+
+      private
+
+      def init_methods
+        super()
+        define_str_var :conversation_index, :conversation_topic, :internet_message_id, :references
+        define_mbox_users :to_recipients, :cc_recipients, :bcc_recipients, :reply_to, :required_attendees, :optional_attendees
+        define_mbox_user :from, :sender, :received_by, :received_representing, :organizer
+        define_bool_var :is_read, :is_read_receipt_requested, :is_response_requested, :is_delivery_receipt_requested, :is_draft, :is_from_me
+        define_bool_var :is_all_day_event, :is_cancelled, :is_delegated, :is_meeting, :is_out_of_date, :is_recurring, :is_resend
+        define_bool_var :is_submitted, :is_unmodified, :allow_new_time_proposal
+        define_int_var :adjacent_meeting_count, :appointment_sequence_number, :appointment_state, :conflicting_meeting_count
+        define_datetime_var :start, :end
+      end
     end # MeetingRequest
   end # EWS
 end # Viewpoint

data/lib/model/message.rb

@@ -59,7 +59,6 @@ module Viewpoint
         if !draft
           resp = conn.ews.send_item([msg_id])
           (resp.status == 'Success') || (raise EwsError, "Could not send message. #{resp.code}: #{resp.message}")
-          self.get_item(msg_id)
         else
           self.new({:item_id => msg_id})
         end

data/lib/soap/handsoap/builders/ews_build_helpers.rb

@@ -64,6 +64,16 @@ module Viewpoint
           end
         end
 
+        # Create the ItemChanges Element
+        def item_changes!(node, item_ids, changes)
+          node.add("#{NS_EWS_MESSAGES}:ItemChanges") do |chgs|
+            chgs.add("#{NS_EWS_TYPES}:ItemChange") do |chg|
+              item_id!(chg, item_ids.first)
+              add_hierarchy!(chg, changes)
+            end
+          end
+        end
+
         # Create the ItemIds Element
         # @param [Element] node The node we are adding Mailbox elements to.
         # @param [Array] item_ids The item ids to add in.
@@ -142,6 +152,10 @@ module Viewpoint
         def item_shape!(node, item_shape)
           node.add("#{NS_EWS_MESSAGES}:ItemShape") do |is|
             is.add("#{NS_EWS_TYPES}:BaseShape", item_shape[:base_shape])
+            is.add("#{NS_EWS_TYPES}:IncludeMimeContent", item_shape[:include_mime_content]) if item_shape.has_key?(:include_mime_content)
+            is.add("#{NS_EWS_TYPES}:BodyType", item_shape[:body_type]) if item_shape.has_key?(:body_type)
+            is.add("#{NS_EWS_TYPES}:FilterHtmlContent", item_shape[:filter_html_content]) if item_shape.has_key?(:filter_html_content)
+            is.add("#{NS_EWS_TYPES}:ConvertHtmlCodePageToUTF8", item_shape[:convert_html_code_page_to_utf8]) if item_shape.has_key?(:convert_html_code_page_to_utf8)
           end
           
           unless( item_shape[:additional_props].nil? )

data/lib/soap/handsoap/ews_service.rb

@@ -408,8 +408,9 @@ module Viewpoint
         # @option item_shape :additional_properties
         #   See: http://msdn.microsoft.com/en-us/library/aa563810.aspx
         # @param [Hash] opts optional parameters to this method
-        def get_item(item_ids, item_shape = {:base_shape => 'Default'})
+        def get_item(item_ids, item_shape = {})
           action = "#{SOAP_ACTION_PREFIX}/GetItem"
+          item_shape[:base_shape] = 'Default' unless item_shape.has_key?(:base_shape)
           resp = invoke("#{NS_EWS_MESSAGES}:GetItem", action) do |root|
             build!(root) do
               item_shape!(root, item_shape)
@@ -523,14 +524,19 @@ module Viewpoint
           parse!(resp)
         end
 
-        def update_item
+        # Used to modify the properties of an existing item in the Exchange store
+        # @see http://msdn.microsoft.com/en-us/library/aa581084.aspx
+        # @param [Array] item_ids An Array of item ids
+        def update_item(item_ids, changes)
           action = "#{SOAP_ACTION_PREFIX}/UpdateItem"
           resp = invoke("#{NS_EWS_MESSAGES}:UpdateItem", action) do |root|
             build!(root) do
+              root.set_attr('MessageDisposition', 'SaveOnly')
+              root.set_attr('ConflictResolution', 'AutoResolve')
+              item_changes!(root, item_ids, changes)
             end
           end
-          resp
-          #parse_update_item(resp)
+          parse!(resp)
         end
 
         # Used to send e-mail messages that are located in the Exchange store.

data/test/spec/folder_synchronization.spec

@@ -16,13 +16,21 @@ describe "Folder Synchronization" do
     @inbox = Viewpoint::EWS::GenericFolder.get_folder :inbox
   end
 
-  describe "Example Folder Synchronization for the Inbox" do
+  describe "An unsynchronized Inbox Folder" do
+    after(:all) do
+      @inbox.clear_sync_state!
+    end
 
     it 'should start synchronization of the Inbox Folder' do
       @inbox.sync_items!(2)
       @inbox.sync_state.should_not be_nil
     end
 
+    it 'should synchronized to a given DateTime' do
+      @inbox.sync_items_since!((Date.today - 1).to_datetime)
+      @inbox.sync_state.should_not be_nil
+    end
+
   end
 
 end

metadata

@@ -5,8 +5,8 @@ version: !ruby/object:Gem::Version
   segments: 
   - 0
   - 1
-  - 6
-  version: 0.1.6
+  - 7
+  version: 0.1.7
 platform: ruby
 authors: 
 - Dan Wanek
@@ -14,7 +14,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2010-11-05 00:00:00 -05:00
+date: 2010-11-14 00:00:00 -06:00
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency