viewpoint 0.0.5 → 0.1.0

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

@@ -0,0 +1,86 @@
+#############################################################################
+# Copyright © 2010 Dan Wanek <dan.wanek@gmail.com>
+#
+#
+# This file is part of Viewpoint.
+# 
+# Viewpoint is free software: you can redistribute it and/or
+# modify it under the terms of the GNU General Public License as published
+# by the Free Software Foundation, either version 3 of the License, or (at
+# your option) any later version.
+# 
+# Viewpoint is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General
+# Public License for more details.
+# 
+# You should have received a copy of the GNU General Public License along
+# with Viewpoint.  If not, see <http://www.gnu.org/licenses/>.
+#############################################################################
+require 'builders/ews_build_helpers.rb'
+module Viewpoint
+  module EWS
+    module SOAP
+
+      # This class includes all the build helpers and also contains some root
+      # level methods to help code reuse.  The CreateItem operation is an example
+      # of this because the different item types share a lot but have a few subtle
+      # differences.
+      class EwsBuilder
+        include EwsBuildHelpers
+
+        def initialize(node, opts, &block)
+          @node, @opts = node, opts
+          instance_eval(&block) if block_given?
+        end
+
+        # @see ExchangeWebService#subscribe
+        def pull_subscription_request!(folder_ids, event_types, timeout)
+          @node.add("#{NS_EWS_MESSAGES}:PullSubscriptionRequest") do |ps|
+            folder_ids!(ps, folder_ids, nil, "#{NS_EWS_TYPES}:FolderIds")
+            event_types!(ps, event_types)
+            ps.add("#{NS_EWS_TYPES}:Timeout", timeout)
+          end
+        end
+
+        # @param [String] type The type of items in the items array message/calendar
+        # @todo Fix max_changes_returned to be more flexible
+        def create_item!(folder_id, items, message_disposition, send_invites, type)
+          @node.set_attr('MessageDisposition', message_disposition) if message_disposition
+          @node.set_attr('SendMeetingInvitations', send_invites) if send_invites
+
+          saved_item_folder_id!(@node, folder_id) unless folder_id.nil?
+          items!(@node, items, type)
+        end
+
+        def add_delegate!(owner, delegate, permissions)
+          d_user = {
+            :user_id => {:primary_smtp_address => {:text => delegate}},
+            :delegate_permissions => permissions
+          }
+          
+          mailbox!(@node, {:email_address => {:text => owner}})
+          delegate_users!(@node, [d_user])
+        end
+
+        def remove_delegate!(owner, delegate)
+          mailbox!(@node, {:email_address => {:text => owner}})
+          @node.add("#{NS_EWS_MESSAGES}:UserIds") do |uids|
+            user_id!(uids, {:user_id => {:primary_smtp_address => {:text => delegate}}})
+          end
+        end
+
+        # This is forthcoming in Exchange 2010.  It will replace much of the Restriction
+        # based code.
+        # @param [Array] An array of query strings
+        # @see http://msdn.microsoft.com/en-us/library/ee693615.aspx
+        def query_strings!(query_strings)
+          query_strings.each do |qs|
+            @node.add("#{NS_EWS_MESSAGES}:QueryString", qs)
+          end
+        end
+
+      end # EwsBuilder
+    end # SOAP
+  end # EWS
+end # Viewpoint

data/lib/soap/handsoap/ews_service.rb

@@ -0,0 +1,646 @@
+#############################################################################
+# Copyright © 2010 Dan Wanek <dan.wanek@gmail.com>
+#
+#
+# This file is part of Viewpoint.
+# 
+# Viewpoint is free software: you can redistribute it and/or
+# modify it under the terms of the GNU General Public License as published
+# by the Free Software Foundation, either version 3 of the License, or (at
+# your option) any later version.
+# 
+# Viewpoint is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General
+# Public License for more details.
+# 
+# You should have received a copy of the GNU General Public License along
+# with Viewpoint.  If not, see <http://www.gnu.org/licenses/>.
+#############################################################################
+$: << File.dirname(__FILE__)
+require 'handsoap'
+require 'builder'
+require 'parser'
+
+
+Handsoap.http_driver = :http_client
+
+module Viewpoint
+  module EWS
+    module SOAP
+      class ExchangeWebService < Handsoap::Service
+
+        SOAP_ACTION_PREFIX = "http://schemas.microsoft.com/exchange/services/2006/messages"
+
+        @@raw_soap = false
+
+        def initialize()
+          if $DEBUG
+            @debug = File.new('ews_debug.out', 'w')
+            @debug.sync = true
+          end
+        end
+
+        def self.set_auth(user,pass)
+          @@user = user
+          @@pass = pass
+        end
+
+        # Turn off parsing and just return the soap response
+        def self.raw_soap!
+          @@raw_soap = true
+        end
+
+        # ********* Begin Hooks *********
+        def on_create_document(doc)
+          doc.alias NS_EWS_TYPES, 'http://schemas.microsoft.com/exchange/services/2006/types'
+          doc.alias NS_EWS_MESSAGES, 'http://schemas.microsoft.com/exchange/services/2006/messages'
+          header = doc.find('Header')
+          header.add("#{NS_EWS_TYPES}:RequestServerVersion") { |rsv| rsv.set_attr('Version','Exchange2007_SP1') }
+        end
+
+        # Adds knowledge of namespaces to the response object.  These have to be identical to the 
+        # URIs returned in the XML response.  For example, I had some issues with the 'soap'
+        # namespace because my original URI did not end in a '/'
+        # @example
+        #   Won't work: http://schemas.xmlsoap.org/soap/envelope
+        #   Works: http://schemas.xmlsoap.org/soap/envelope/
+        def on_response_document(doc)
+          doc.add_namespace NS_SOAP, 'http://schemas.xmlsoap.org/soap/envelope/'
+          doc.add_namespace NS_EWS_TYPES, 'http://schemas.microsoft.com/exchange/services/2006/types'
+          doc.add_namespace NS_EWS_MESSAGES, 'http://schemas.microsoft.com/exchange/services/2006/messages'
+        end
+
+        def on_after_create_http_request(req)
+          req.set_auth @@user, @@pass
+        end
+        # ********** End Hooks **********
+
+
+        # Resolve ambiguous e-mail addresses and display names
+        # @see http://msdn.microsoft.com/en-us/library/aa565329.aspx ResolveNames
+        # @see http://msdn.microsoft.com/en-us/library/aa581054.aspx UnresolvedEntry
+        #
+        # @param [String] name an unresolved entry
+        # @param [Boolean] full_contact_data whether or not to return full contact info
+        # @param [Hash] opts optional parameters to this method
+        # @option opts [String] :search_scope where to seach for this entry, one of
+        #   SOAP::Contacts, SOAP::ActiveDirectory, SOAP::ActiveDirectoryContacts (default),
+        #   SOAP::ContactsActiveDirectory
+        # @option opts [String, FolderId] :parent_folder_id either the name of a folder or
+        #   it's numerical ID.  @see http://msdn.microsoft.com/en-us/library/aa565998.aspx
+        def resolve_names(name, full_contact_data = true, opts = {})
+          action = "#{SOAP_ACTION_PREFIX}/ResolveNames"
+          resp = invoke("#{NS_EWS_MESSAGES}:ResolveNames", :soap_action => action) do |root|
+            build!(root) do
+              root.set_attr('ReturnFullContactData',full_contact_data)
+              root.add("#{NS_EWS_MESSAGES}:UnresolvedEntry",name)
+            end
+          end
+          parse!(resp)
+        end
+
+
+        # Exposes the full membership of distribution lists.
+        # @see http://msdn.microsoft.com/en-us/library/aa494152.aspx ExpandDL
+        #
+        # @param [String] dist_email The e-mail address associated with the Distribution List
+        # @todo Fully support all of the ExpandDL operations. Today it just supports
+        #   taking an e-mail address as an argument
+        def expand_dl(dist_email)
+          action = "#{SOAP_ACTION_PREFIX}/ExpandDL"
+          resp = invoke("#{NS_EWS_MESSAGES}:ExpandDL", :soap_action => action) do |root|
+            build!(root) do
+              mailbox!(root, {:email_address => {:text => dist_email}})
+            end
+          end
+          parse!(resp)
+        end
+
+        # Find subfolders of an identified folder
+        # @see http://msdn.microsoft.com/en-us/library/aa563918.aspx
+        #
+        # @param [Array] parent_folder_ids An Array of folder ids, either a
+        #   DistinguishedFolderId (must me a Symbol) or a FolderId (String)
+        # @param [String] traversal Shallow/Deep/SoftDeleted
+        # @param [Hash] folder_shape defines the FolderShape node
+        #   See: http://msdn.microsoft.com/en-us/library/aa494311.aspx
+        # @option folder_shape [String] :base_shape IdOnly/Default/AllProperties
+        # @option folder_shape :additional_properties
+        #   See: http://msdn.microsoft.com/en-us/library/aa563810.aspx
+        # @param [Hash] opts optional parameters to this method
+        def find_folder(parent_folder_ids = [:root], traversal = 'Shallow', folder_shape = {:base_shape => 'Default'}, opts = {})
+          action = "#{SOAP_ACTION_PREFIX}/FindFolder"
+          resp = invoke("#{NS_EWS_MESSAGES}:FindFolder", :soap_action => action) do |root|
+            build!(root) do
+              root.set_attr('Traversal', traversal)
+              folder_shape!(root, folder_shape)
+              parent_folder_ids!(root, parent_folder_ids)
+            end
+          end
+          parse!(resp)
+        end
+
+        # Identifies items that are located in a specified folder
+        # @see http://msdn.microsoft.com/en-us/library/aa566107.aspx
+        #
+        # @param [Array] parent_folder_ids An Array of folder ids, either a
+        #   DistinguishedFolderId (must me a Symbol) or a FolderId (String)
+        # @param [String] traversal Shallow/Deep/SoftDeleted
+        # @param [Hash] item_shape defines the FolderShape node
+        #   See: http://msdn.microsoft.com/en-us/library/aa494311.aspx
+        # @option item_shape [String] :base_shape IdOnly/Default/AllProperties
+        # @option item_shape :additional_properties
+        #   See: http://msdn.microsoft.com/en-us/library/aa563810.aspx
+        # @param [Hash] opts optional parameters to this method
+        # @option opts [Hash] :calendar_view Limit FindItem by a start and end date
+        #   {:calendar_view => {:max_entries_returned => 2, :start => <DateTime Obj>, :end => <DateTime Obj>}}
+        def find_item(parent_folder_ids, traversal = 'Shallow', item_shape = {:base_shape => 'Default'}, opts = {})
+          action = "#{SOAP_ACTION_PREFIX}/FindItem"
+          resp = invoke("#{NS_EWS_MESSAGES}:FindItem", :soap_action => action) do |root|
+            build!(root) do
+              root.set_attr('Traversal', traversal)
+              item_shape!(root, item_shape)
+              query_strings = opts.delete(:query_string)
+              restriction = opts.delete(:restriction)
+              if(opts.has_key?(:calendar_view))
+                cal_view = opts[:calendar_view]
+                cal_view.each_pair do |k,v|
+                  cal_view[k] = v.to_s
+                end
+              end
+              add_hierarchy!(root, opts, NS_EWS_MESSAGES)
+              #query_strings!(query_strings)
+              root.add("#{NS_EWS_MESSAGES}:Restriction") do |r|
+                add_hierarchy!(r, restriction)
+              end unless restriction.nil?
+              parent_folder_ids!(root, parent_folder_ids)
+            end
+          end
+          parse!(resp)
+        end
+
+        # Gets folders from the Exchange store
+        # @see http://msdn.microsoft.com/en-us/library/aa580274.aspx
+        #
+        # @param [Array] folder_ids An Array of folder ids, either a
+        #   DistinguishedFolderId (must me a Symbol) or a FolderId (String)
+        # @param [Hash] folder_shape defines the FolderShape node
+        #   See: http://msdn.microsoft.com/en-us/library/aa494311.aspx
+        # @option folder_shape [String] :base_shape IdOnly/Default/AllProperties
+        # @option folder_shape :additional_properties
+        #   See: http://msdn.microsoft.com/en-us/library/aa563810.aspx
+        # @param [String,nil] act_as User to act on behalf as.  This user must have been
+        #   given delegate access to this folder or else this operation will fail.
+        # @param [Hash] opts optional parameters to this method
+        def get_folder(folder_ids, folder_shape = {:base_shape => 'Default'}, act_as = nil)
+          action = "#{SOAP_ACTION_PREFIX}/GetFolder"
+          resp = invoke("#{NS_EWS_MESSAGES}:GetFolder", :soap_action => action) do |root|
+            build!(root) do
+              folder_shape!(root, folder_shape)
+              folder_ids!(root, folder_ids, act_as)
+            end
+          end
+          parse!(resp)
+        end
+
+        def convert_id
+          action = "#{SOAP_ACTION_PREFIX}/ConvertId"
+          resp = invoke("#{NS_EWS_MESSAGES}:ConvertId", :soap_action => action) do |convert_id|
+            build_convert_id!(convert_id)
+          end
+          parse_convert_id(resp)
+        end
+
+        # Creates folders, calendar folders, contacts folders, tasks folders, and search folders.
+        # @see http://msdn.microsoft.com/en-us/library/aa563574.aspx CreateFolder
+        #
+        # @param [String,Symbol] parent_folder_id either the name of a folder or it's
+        #   numerical ID.  See: http://msdn.microsoft.com/en-us/library/aa565998.aspx
+        # @param [Array,String] folder_name The display name for the new folder or folders
+        def create_folder(parent_folder_id, folder_name)
+          action = "#{SOAP_ACTION_PREFIX}/CreateFolder"
+          resp = invoke("#{NS_EWS_MESSAGES}:CreateFolder", :soap_action => action) do |root|
+            build!(root) do
+              root.add("#{NS_EWS_MESSAGES}:ParentFolderId") do |pfid|
+                folder_id!(pfid, parent_folder_id)
+              end
+              folder_name = (folder_name.is_a?(Array)) ? folder_name : [folder_name]
+              root.add("#{NS_EWS_MESSAGES}:Folders") do |fids|
+                folder_name.each do |f|
+                  add_hierarchy!(fids, {:folder => {:display_name => {:text => f}}})
+                end
+              end
+            end
+          end
+          parse!(resp)
+        end
+
+        # Deletes folders from a mailbox.
+        # @see http://msdn.microsoft.com/en-us/library/aa564767.aspx DeleteFolder
+        #
+        # @param [Array,String,Symbol] folder_id either the name of a folder or it's
+        #   numerical ID.  See: http://msdn.microsoft.com/en-us/library/aa565998.aspx
+        # @param [String,nil] delete_type Type of delete to do: HardDelete/SoftDelete/MoveToDeletedItems
+        def delete_folder(folder_id, delete_type = 'MoveToDeletedItems')
+          action = "#{SOAP_ACTION_PREFIX}/DeleteFolder"
+          resp = invoke("#{NS_EWS_MESSAGES}:DeleteFolder", :soap_action => action) do |root|
+            root.set_attr('DeleteType', delete_type)
+            build!(root) do
+              folder_id = (folder_id.is_a?(Array)) ? folder_id : [folder_id]
+              folder_ids!(root, folder_id)
+            end
+          end
+          parse!(resp)
+        end
+
+        def update_folder
+          action = "#{SOAP_ACTION_PREFIX}/UpdateFolder"
+          resp = invoke("#{NS_EWS_MESSAGES}:UpdateFolder", :soap_action => action) do |update_folder|
+            build_update_folder!(update_folder)
+          end
+          parse_update_folder(resp)
+        end
+
+        def move_folder
+          action = "#{SOAP_ACTION_PREFIX}/MoveFolder"
+          resp = invoke("#{NS_EWS_MESSAGES}:MoveFolder", :soap_action => action) do |move_folder|
+            build_move_folder!(move_folder)
+          end
+          parse_move_folder(resp)
+        end
+
+        def copy_folder
+          action = "#{SOAP_ACTION_PREFIX}/CopyFolder"
+          resp = invoke("#{NS_EWS_MESSAGES}:CopyFolder", :soap_action => action) do |copy_folder|
+            build_copy_folder!(copy_folder)
+          end
+          parse_copy_folder(resp)
+        end
+
+        # Used to subscribe client applications to either push or pull notifications.
+        # @see http://msdn.microsoft.com/en-us/library/aa566188.aspx Subscribe on MSDN
+        #
+        # @param [Array] folder_ids An Array of folder ids, either a
+        #   DistinguishedFolderId (must me a Symbol) or a FolderId (String)
+        # @param [Array] event_types An Array of EventTypes that we should track.
+        #   Available types are, CopiedEvent, CreatedEvent, DeletedEvent, ModifiedEvent,
+        #   MovedEvent, NewMailEvent, FreeBusyChangedEvent
+        # @param [Integer] timeout The number of minutes in which the subscription
+        #   will timeout after not receiving a get_events operation.
+        # @todo Decide how/if to handle the optional SubscribeToAllFolders attribute of
+        #   the PullSubscriptionRequest element.
+        def subscribe(folder_ids, event_types, timeout = 10)
+          action = "#{SOAP_ACTION_PREFIX}/Subscribe"
+          resp = invoke("#{NS_EWS_MESSAGES}:Subscribe", :soap_action => action) do |root|
+            build!(root) do
+              pull_subscription_request!(folder_ids, event_types, timeout)
+            end
+          end
+          parse!(resp)
+        end
+
+        # End a pull notification subscription.
+        # @see http://msdn.microsoft.com/en-us/library/aa564263.aspx
+        #
+        # @param [String] subscription_id The Id of the subscription
+        def unsubscribe(subscription_id)
+          action = "#{SOAP_ACTION_PREFIX}/Unsubscribe"
+          resp = invoke("#{NS_EWS_MESSAGES}:Unsubscribe", :soap_action => action) do |root|
+            build!(root) do
+              subscription_id!(root, subscription_id)
+            end
+          end
+          parse!(resp)
+        end
+
+        # Used by pull subscription clients to request notifications from the Client Access server
+        # @see http://msdn.microsoft.com/en-us/library/aa566199.aspx GetEvents on MSDN
+        #
+        # @param [String] subscription_id Subscription identifier
+        # @param [String] watermark Event bookmark in the events queue
+        def get_events(subscription_id, watermark)
+          action = "#{SOAP_ACTION_PREFIX}/GetEvents"
+          resp = invoke("#{NS_EWS_MESSAGES}:GetEvents", :soap_action => action) do |root|
+            build!(root) do
+              subscription_id!(root, subscription_id)
+              watermark!(root, watermark)
+            end
+          end
+          parse!(resp)
+        end
+
+        def sync_folder_hierarchy
+          action = "#{SOAP_ACTION_PREFIX}/SyncFolderHierarchy"
+          resp = invoke("#{NS_EWS_MESSAGES}:SyncFolderHierarchy", :soap_action => action) do |sync_folder_hierarchy|
+            build_sync_folder_hierarchy!(sync_folder_hierarchy)
+          end
+          parse_sync_folder_hierarchy(resp)
+        end
+
+        # Synchronizes items between the Exchange server and the client
+        # @see http://msdn.microsoft.com/en-us/library/aa563967.aspx
+        #
+        # @param [String, Symbol] folder_id either a DistinguishedFolderId
+        #   (must me a Symbol) or a FolderId (String)
+        # @param [String] sync_state Base-64 encoded string used to determine
+        #   where we are in the sync process.
+        # @param [Integer] max_changes The amount of items to sync per call
+        #   to SyncFolderItems
+        # @param [Hash] item_shape defines the ItemShape node
+        #   See: http://msdn.microsoft.com/en-us/library/aa565261.aspx
+        # @option item_shape [String] :base_shape IdOnly/Default/AllProperties
+        # @option item_shape :additional_properties
+        #   See: http://msdn.microsoft.com/en-us/library/aa565261.aspx
+        # @param [Hash] opts optional parameters to this method
+        def sync_folder_items(folder_id, sync_state = nil, max_changes = 256, item_shape = {:base_shape => 'Default'}, opts = {})
+          action = "#{SOAP_ACTION_PREFIX}/SyncFolderItems"
+          resp = invoke("#{NS_EWS_MESSAGES}:SyncFolderItems", :soap_action => action) do |root|
+            build!(root) do
+              item_shape!(root, item_shape)
+              root.add("#{NS_EWS_MESSAGES}:SyncFolderId") do |sfid|
+                folder_id!(sfid, folder_id)
+              end
+              sync_state!(root, sync_state) unless sync_state.nil?
+              root.add("#{NS_EWS_MESSAGES}:MaxChangesReturned", max_changes)
+            end
+          end
+          parse!(resp)
+        end
+
+        # Gets items from the Exchange store
+        # @see http://msdn.microsoft.com/en-us/library/aa565934.aspx
+        #
+        # @param [Array] item_ids An Array of item ids
+        # @param [Hash] item_shape defines the ItemShape node
+        #   See: http://msdn.microsoft.com/en-us/library/aa565261.aspx
+        # @option item_shape [String] :base_shape ('Default') IdOnly/Default/AllProperties
+        # @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'})
+          action = "#{SOAP_ACTION_PREFIX}/GetItem"
+          resp = invoke("#{NS_EWS_MESSAGES}:GetItem", :soap_action => action) do |root|
+            build!(root) do
+              item_shape!(root, item_shape)
+              item_ids!(root, item_ids)
+            end
+          end
+          parse!(resp)
+        end
+
+        # Operation is used to create e-mail messages
+        # This is actually a CreateItem operation but they differ for different types
+        # of Exchange objects so it is named appropriately here.
+        # @see http://msdn.microsoft.com/en-us/library/aa566468.aspx
+        #
+        # @param [String, Symbol] folder_id The folder to save this message in. Either a
+        #   DistinguishedFolderId (must me a Symbol) or a FolderId (String)
+        # @param [Hash, Array] items An array of item Hashes or a single item Hash. Hash
+        #   This Hash will eventually be passed to add_hierarchy! in the builder so it is in that format.
+        #   Values should be based on values found here: http://msdn.microsoft.com/en-us/library/aa494306.aspx
+        # @param [String] message_disposition "SaveOnly/SendOnly/SendAndSaveCopy"
+        #   See: http://msdn.microsoft.com/en-us/library/aa565209.aspx
+        def create_message_item(folder_id, items, message_disposition = 'SaveOnly')
+          action = "#{SOAP_ACTION_PREFIX}/CreateItem"
+          resp = invoke("#{NS_EWS_MESSAGES}:CreateItem", :soap_action => action) do |node|
+            build!(node) do
+              create_item!(folder_id, items, message_disposition, send_invites=false, 'message')
+            end
+          end
+          parse!(resp)
+        end
+
+        # Operation is used to create calendar items
+        # @see http://msdn.microsoft.com/en-us/library/aa564690.aspx
+        #
+        # @param [String, Symbol] folder_id The folder to create this item in. Either a
+        #   DistinguishedFolderId (must me a Symbol) or a FolderId (String)
+        # @param [Hash, Array] items An array of item Hashes or a single item Hash. Hash
+        #   This Hash will eventually be passed to add_hierarchy! in the builder so it is in that format.
+        #   Values should be based on values found here: http://msdn.microsoft.com/en-us/library/aa564765.aspx
+        # @param [String] send_invites "SendToNone/SendOnlyToAll/SendToAllAndSaveCopy"
+        def create_calendar_item(folder_id, items, send_invites = 'SendToAllAndSaveCopy')
+          action = "#{SOAP_ACTION_PREFIX}/CreateItem"
+          resp = invoke("#{NS_EWS_MESSAGES}:CreateItem", :soap_action => action) do |node|
+            build!(node) do
+              create_item!(folder_id, items, message_disposition=false, send_invites, 'calendar')
+            end
+          end
+          parse!(resp)
+        end
+        
+        # Operation is used to create task items
+        # This is actually a CreateItem operation but they differ for different types
+        # of Exchange objects so it is named appropriately here.
+        # @see http://msdn.microsoft.com/en-us/library/aa563439.aspx
+        #
+        # @param [String, Symbol] folder_id The folder to save this task in. Either a
+        #   DistinguishedFolderId (must me a Symbol) or a FolderId (String)
+        # @param [Hash, Array] items An array of item Hashes or a single item Hash. Hash
+        #   values should be based on values found here: http://msdn.microsoft.com/en-us/library/aa494306.aspx
+        #   This Hash will eventually be passed to add_hierarchy! in the builder so it is in that format.
+        # @param [String] message_disposition "SaveOnly/SendOnly/SendAndSaveCopy"
+        #   See: http://msdn.microsoft.com/en-us/library/aa565209.aspx
+        def create_task_item(folder_id, items, message_disposition = 'SaveOnly')
+          action = "#{SOAP_ACTION_PREFIX}/CreateItem"
+          resp = invoke("#{NS_EWS_MESSAGES}:CreateItem", :soap_action => action) do |node|
+            build!(node) do
+              create_item!(folder_id, items, message_disposition, send_invites=false, 'task')
+            end
+          end
+          parse!(resp)
+        end
+
+        # Delete an item from a mailbox in the Exchange store
+        # @see http://msdn.microsoft.com/en-us/library/aa562961.aspx
+        # @param [Array] item_ids An Array of item ids
+        # @param [String] delete_type Type of deletion: "HardDelete/SoftDelete/MoveToDeletedItems"
+        # @param [String, nil] send_meeting_cancellations "SendToNone/SendOnlyToAll/SendToAllAndSaveCopy"
+        #   This is only applicable to CalendarItems and should be nil otherwise, which is the default
+        # @param [String, nil] affected_task_occurrences "AllOccurrences/SpecifiedOccurrenceOnly"
+        #   This is really only related to tasks and can be nil otherwise, which is the default.
+        def delete_item(item_ids, delete_type, send_meeting_cancellations = nil, affected_task_occurrences = nil)
+          action = "#{SOAP_ACTION_PREFIX}/DeleteItem"
+          resp = invoke("#{NS_EWS_MESSAGES}:DeleteItem", :soap_action => action) do |root|
+            build!(root) do
+              root.set_attr('DeleteType', delete_type)
+              root.set_attr('SendMeetingCancellations', send_meeting_cancellations) unless send_meeting_cancellations.nil?
+              root.set_attr('AffectedTaskOccurrences', affected_task_occurrences) unless affected_task_occurrences.nil?
+              item_ids!(root, item_ids)
+            end
+          end
+          parse!(resp)
+        end
+
+        def update_item
+          action = "#{SOAP_ACTION_PREFIX}/UpdateItem"
+          resp = invoke("#{NS_EWS_MESSAGES}:UpdateItem", :soap_action => action) do |update_item|
+            build_update_item!(update_item)
+          end
+          parse_update_item(resp)
+        end
+
+        def send_item
+          action = "#{SOAP_ACTION_PREFIX}/SendItem"
+          resp = invoke("#{NS_EWS_MESSAGES}:SendItem", :soap_action => action) do |send_item|
+            build_send_item!(send_item)
+          end
+          parse_send_item(resp)
+        end
+
+        def move_item
+          action = "#{SOAP_ACTION_PREFIX}/MoveItem"
+          resp = invoke("#{NS_EWS_MESSAGES}:MoveItem", :soap_action => action) do |move_item|
+            build_move_item!(move_item)
+          end
+          parse_move_item(resp)
+        end
+
+        def copy_item
+          action = "#{SOAP_ACTION_PREFIX}/CopyItem"
+          resp = invoke("#{NS_EWS_MESSAGES}:CopyItem", :soap_action => action) do |copy_item|
+            build_copy_item!(copy_item)
+          end
+          parse_copy_item(resp)
+        end
+
+        def create_attachment
+          action = "#{SOAP_ACTION_PREFIX}/CreateAttachment"
+          resp = invoke("#{NS_EWS_MESSAGES}:CreateAttachment", :soap_action => action) do |create_attachment|
+            build_create_attachment!(create_attachment)
+          end
+          parse_create_attachment(resp)
+        end
+
+        def delete_attachment
+          action = "#{SOAP_ACTION_PREFIX}/DeleteAttachment"
+          resp = invoke("#{NS_EWS_MESSAGES}:DeleteAttachment", :soap_action => action) do |delete_attachment|
+            build_delete_attachment!(delete_attachment)
+          end
+          parse_delete_attachment(resp)
+        end
+
+        def get_attachment
+          action = "#{SOAP_ACTION_PREFIX}/GetAttachment"
+          resp = invoke("#{NS_EWS_MESSAGES}:GetAttachment", :soap_action => action) do |get_attachment|
+            build_get_attachment!(get_attachment)
+          end
+          parse_get_attachment(resp)
+        end
+
+        def create_managed_folder
+          action = "#{SOAP_ACTION_PREFIX}/CreateManagedFolder"
+          resp = invoke("#{NS_EWS_MESSAGES}:CreateManagedFolder", :soap_action => action) do |create_managed_folder|
+            build_create_managed_folder!(create_managed_folder)
+          end
+          parse_create_managed_folder(resp)
+        end
+
+        # Retrieves the delegate settings for a specific mailbox.
+        # @see http://msdn.microsoft.com/en-us/library/bb799735.aspx
+        #
+        # @param [String] owner The user that is delegating permissions
+        def get_delegate(owner)
+          action = "#{SOAP_ACTION_PREFIX}/GetDelegate"
+          resp = invoke("#{NS_EWS_MESSAGES}:GetDelegate", :soap_action => action) do |root|
+            root.set_attr('IncludePermissions', 'true')
+            build!(root) do
+              mailbox!(root, {:email_address => {:text => owner}})
+            end
+          end
+          parse!(resp)
+        end
+
+        # Adds one or more delegates to a principal's mailbox and sets specific access permissions.
+        # @see http://msdn.microsoft.com/en-us/library/bb856527.aspx
+        #
+        # @param [String] owner The user that is delegating permissions
+        # @param [String] delegate The user that is being given delegate permission
+        # @param [Hash] permissions A hash of permissions that will be delegated.
+        #   This Hash will eventually be passed to add_hierarchy! in the builder so it is in that format.
+        def add_delegate(owner, delegate, permissions)
+          action = "#{SOAP_ACTION_PREFIX}/AddDelegate"
+          resp = invoke("#{NS_EWS_MESSAGES}:AddDelegate", :soap_action => action) do |root|
+            build!(root) do
+              add_delegate!(owner, delegate, permissions)
+            end
+          end
+          parse!(resp)
+        end
+
+        # Removes one or more delegates from a user's mailbox.
+        # @see http://msdn.microsoft.com/en-us/library/bb856564.aspx
+        #
+        # @param [String] owner The user that is delegating permissions
+        # @param [String] delegate The user that is being given delegate permission
+        def remove_delegate(owner, delegate)
+          action = "#{SOAP_ACTION_PREFIX}/RemoveDelegate"
+          resp = invoke("#{NS_EWS_MESSAGES}:RemoveDelegate", :soap_action => action) do |root|
+            build!(root) do
+              remove_delegate!(owner, delegate)
+            end
+          end
+          parse!(resp)
+        end
+        
+        # Updates delegate permissions on a principal's mailbox
+        # @see http://msdn.microsoft.com/en-us/library/bb856529.aspx
+        #
+        # @param [String] owner The user that is delegating permissions
+        # @param [String] delegate The user that is being given delegate permission
+        # @param [Hash] permissions A hash of permissions that will be delegated.
+        #   This Hash will eventually be passed to add_hierarchy! in the builder so it is in that format.
+        def update_delegate(owner, delegate, permissions)
+          action = "#{SOAP_ACTION_PREFIX}/UpdateDelegate"
+          resp = invoke("#{NS_EWS_MESSAGES}:UpdateDelegate", :soap_action => action) do |root|
+            build!(root) do
+              add_delegate!(owner, delegate, permissions)
+            end
+          end
+          parse!(resp)
+        end
+
+        def get_user_availability
+          action = "#{SOAP_ACTION_PREFIX}/GetUserAvailability"
+          resp = invoke("#{NS_EWS_MESSAGES}:GetUserAvailability", :soap_action => action) do |get_user_availability|
+            build_get_user_availability!(get_user_availability)
+          end
+          parse_get_user_availability(resp)
+        end
+
+        def get_user_oof_settings
+          action = "#{SOAP_ACTION_PREFIX}/GetUserOofSettings"
+          resp = invoke("#{NS_EWS_MESSAGES}:GetUserOofSettings", :soap_action => action) do |get_user_oof_settings|
+            build_get_user_oof_settings!(get_user_oof_settings)
+          end
+          parse_get_user_oof_settings(resp)
+        end
+
+        def set_user_oof_settings
+          action = "#{SOAP_ACTION_PREFIX}/SetUserOofSettings"
+          resp = invoke("#{NS_EWS_MESSAGES}:SetUserOofSettings", :soap_action => action) do |set_user_oof_settings|
+            build_set_user_oof_settings!(set_user_oof_settings)
+          end
+          parse_set_user_oof_settings(resp)
+        end
+
+
+
+        # Private Methods (Builders and Parsers)
+        private
+
+
+        def build!(node, opts = {}, &block)
+          EwsBuilder.new(node, opts, &block)
+        end
+
+        def parse!(response, opts = {})
+          return response if @@raw_soap
+          EwsParser.new(response).parse(opts)
+        end
+
+      end # class ExchangeWebService
+    end # module SOAP
+  end # EWS
+end # Viewpoint