viewpoint 0.1.27 → 1.0.0.beta.1

data/lib/ews/message_accessors.rb

@@ -0,0 +1,86 @@
+=begin
+  This file is part of Viewpoint; the Ruby library for Microsoft Exchange Web Services.
+
+  Copyright © 2011 Dan Wanek <dan.wanek@gmail.com>
+
+  Licensed under the Apache License, Version 2.0 (the "License");
+  you may not use this file except in compliance with the License.
+  You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+  Unless required by applicable law or agreed to in writing, software
+  distributed under the License is distributed on an "AS IS" BASIS,
+  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+  See the License for the specific language governing permissions and
+  limitations under the License.
+=end
+module Viewpoint::EWS::MessageAccessors
+  include Viewpoint::EWS
+
+  # Send an E-mail message
+  #
+  # @param [Hash] opts A Hash with message params
+  # @option opts [String] :subject The message subject
+  # @option opts [String] :body The message body
+  # @option opts [Array] :to_recipients An array of e-mail addresses to send to
+  # @option opts [Array] :cc_recipients An array of e-mail addresses to send to
+  # @option opts [Array] :bcc_recipients An array of e-mail addresses to send to
+  # @option opts [Boolean] :draft if true it will save to the draft folder
+  #   without sending the message.
+  # @option opts [String,Symbol,Hash] saved_item_folder_id Either a
+  #   FolderId(String) or a DistinguishedFolderId(Symbol). You can also pass a
+  #   Hash in the form: {id: <fold_id>, change_key: <change_key>}
+  # @option opts [Array<File>] :file_attachments an Array of File objects
+  # @return [Message,Boolean] Returns true if the message is sent, false if
+  #   nothing is returned from EWS or if draft is true it will return the
+  #   Message object. Finally, if something goes wrong, it raises an error
+  #   with a message stating why the e-mail could not be sent.
+  # @todo Finish ItemAttachments
+  def send_message(opts = {}, &block)
+    msg = Template::Message.new opts.clone
+    yield msg if block_given?
+    if msg.has_attachments?
+      draft = msg.draft
+      msg.draft = true
+      resp = parse_create_item(ews.create_item(msg.to_ews))
+      msg.file_attachments.each do |f|
+        next unless f.kind_of?(File)
+        resp.add_file_attachment(f)
+      end
+      if draft
+        resp.submit_attachments!
+        resp
+      else
+        resp.submit!
+      end
+    else
+      resp = ews.create_item(msg.to_ews)
+      resp.response_messages ?  parse_create_item(resp) : false
+    end
+  end
+
+  # See #send_message for options
+  def draft_message(opts = {}, &block)
+    send_message opts.merge(draft: true), &block
+  end
+
+
+  private
+
+
+  def parse_create_item(resp)
+    rm = resp.response_messages[0]
+    if(rm.status == 'Success')
+      rm.items.empty? ? true : parse_message(rm.items.first)
+    else
+      raise EwsError, "Could not send message. #{rm.code}: #{rm.message_text}"
+    end
+  end
+
+  def parse_message(msg)
+    mtype = msg.keys.first
+    message = class_by_name(mtype).new(ews, msg[mtype])
+  end
+
+end # Viewpoint::EWS::MessageAccessors

data/lib/ews/push_subscription_accessors.rb

@@ -0,0 +1,33 @@
+=begin
+  This file is part of Viewpoint; the Ruby library for Microsoft Exchange Web Services.
+
+  Copyright © 2011 Dan Wanek <dan.wanek@gmail.com>
+
+  Licensed under the Apache License, Version 2.0 (the "License");
+  you may not use this file except in compliance with the License.
+  You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+  Unless required by applicable law or agreed to in writing, software
+  distributed under the License is distributed on an "AS IS" BASIS,
+  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+  See the License for the specific language governing permissions and
+  limitations under the License.
+=end
+
+module Viewpoint::EWS::PushSubscriptionAccessors
+  include Viewpoint::EWS
+
+  def parse_send_notification(msg)
+    parser = Viewpoint::EWS::SOAP::EwsParser.new(msg)
+    resp = parser.parse response_class: Viewpoint::EWS::SOAP::EwsResponse
+    rmsg = resp.response_messages[0]
+    if rmsg.success?
+      rmsg
+    else
+      raise EwsSubscriptionError, "#{rmsg.code}: #{rmsg.message_text}"
+    end
+  end
+
+end # Viewpoint::EWS::PushSubscriptionAccessors

data/lib/ews/soap.rb

@@ -0,0 +1,63 @@
+=begin
+  This file is part of Viewpoint; the Ruby library for Microsoft Exchange Web Services.
+
+  Copyright © 2011 Dan Wanek <dan.wanek@gmail.com>
+
+  Licensed under the Apache License, Version 2.0 (the "License");
+  you may not use this file except in compliance with the License.
+  You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+  Unless required by applicable law or agreed to in writing, software
+  distributed under the License is distributed on an "AS IS" BASIS,
+  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+  See the License for the specific language governing permissions and
+  limitations under the License.
+=end
+
+# This module defines some constants and other niceties to make available to
+# the underlying SOAP classes and modules that do the actual work.
+module Viewpoint
+  module EWS
+    module SOAP
+
+      # CONSTANTS
+
+      NS_SOAP         = 'soap'.freeze
+      NS_EWS_TYPES    = 't'.freeze
+      NS_EWS_MESSAGES = 'm'.freeze
+      NAMESPACES = {
+        "xmlns:#{NS_SOAP}"         => 'http://schemas.xmlsoap.org/soap/envelope/',
+        "xmlns:#{NS_EWS_TYPES}"    => 'http://schemas.microsoft.com/exchange/services/2006/types',
+        "xmlns:#{NS_EWS_MESSAGES}" => 'http://schemas.microsoft.com/exchange/services/2006/messages',
+      }.freeze
+
+      # used in ResolveNames to determine where names are resolved
+      ActiveDirectory         = 'ActiveDirectory'
+      ActiveDirectoryContacts = 'ActiveDirectoryContacts'
+      Contacts                = 'Contacts'
+      ContactsActiveDirectory = 'ContactsActiveDirectory'
+
+      # Target specific Exchange Server versions
+      # @see http://msdn.microsoft.com/en-us/library/bb891876(v=exchg.140).aspx
+      VERSION_2007      = 'Exchange2007'
+      VERSION_2007_SP1  = 'Exchange2007_SP1'
+      VERSION_2010      = 'Exchange2010'
+      VERSION_2010_SP1  = 'Exchange2010_SP1'
+      VERSION_2010_SP2  = 'Exchange2010_SP2'
+      VERSION_2013      = 'Exchange2013'
+      VERSION_NONE      = 'none'
+
+      HARD_DELETE = 'HardDelete'
+      SOFT_DELETE = 'SoftDelete'
+      MOVE_TO_DELETED_ITEMS = 'MoveToDeletedItems'
+
+      def initialize
+        @log = Logging.logger[self.class.name.to_s.to_sym]
+        @default_ns = NAMESPACES["xmlns:#{NS_EWS_MESSAGES}"]
+      end
+
+    end # SOAP
+  end # EWS
+end # Viewpoint

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

@@ -0,0 +1,1011 @@
+=begin
+  This file is part of Viewpoint; the Ruby library for Microsoft Exchange Web Services.
+
+  Copyright © 2011 Dan Wanek <dan.wanek@gmail.com>
+
+  Licensed under the Apache License, Version 2.0 (the "License");
+  you may not use this file except in compliance with the License.
+  You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+  Unless required by applicable law or agreed to in writing, software
+  distributed under the License is distributed on an "AS IS" BASIS,
+  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+  See the License for the specific language governing permissions and
+  limitations under the License.
+=end
+module Viewpoint::EWS::SOAP
+
+  # This class includes the element builders. The idea is that each element should
+  # know how to build themselves so each parent element can delegate creation of
+  # subelements to a method of the same name with a '!' after it.
+  class EwsBuilder
+
+    attr_reader :nbuild
+    def initialize
+      @nbuild = Nokogiri::XML::Builder.new
+    end
+
+    # Build the SOAP envelope and yield this object so subelements can be built. Once
+    # you have the EwsBuilder object you can use the nbuild object like shown in the
+    # example for the Header section. The nbuild object is the underlying
+    # Nokogiri::XML::Builder object.
+    # @param [Hash] opts
+    # @option opts [String] :server_version The version string that should get
+    #   set in the Header. See ExchangeWebService#initialize
+    # @example
+    #   xb = EwsBuilder.new
+    #   xb.build! do |part, b|
+    #     if(part == :header)
+    #       b.nbuild.MyVar('blablabla')
+    #     else
+    #       b.folder_shape!({:base_shape => 'Default'})
+    #     end
+    #   end
+    def build!(opts = {}, &block)
+      @nbuild.Envelope(NAMESPACES) do |node|
+        node.parent.namespace = parent_namespace(node)
+        node.Header {
+          set_version_header! opts[:server_version]
+          yield(:header, self) if block_given?
+        }
+        node.Body {
+          yield(:body, self) if block_given?
+        }
+      end
+      @nbuild.doc
+    end
+
+    # Build XML from a passed in Hash or Array in a specified format.
+    # @param [Array,Hash] elems The elements to add to the Builder. They must
+    #   be specified like so:
+    #   {:top =>
+    #     { :xmlns => 'http://stonesthrow/soap',
+    #       :sub_elements => [
+    #         {:elem1 => {:text => 'inside'}},
+    #         {:elem2 => {:text => 'inside2'}}
+    #       ],
+    #       :id => '3232', :tx_dd => 23, :asdf => 'turkey'
+    #     }
+    #   }
+    #   or
+    #   [ {:first => {:text => 'hello'}},
+    #     {:second => {:text => 'world'}}
+    #   ]
+    #
+    #   NOTE: there are specialized keys for text (:text), child elements
+    #   (:sub_elements) and namespaces (:xmlns).
+    def build_xml!(elems)
+      case elems.class.name
+      when 'Hash'
+        keys = elems.keys
+        vals = elems.values
+        if(keys.length > 1 && !vals.is_a?(Hash))
+          raise "invalid input: #{elems}"
+        end
+        vals = vals.first.clone
+        se = vals.delete(:sub_elements)
+        txt = vals.delete(:text)
+
+        @nbuild.send(keys.first.to_s.camel_case, txt, vals) {|x|
+          build_xml!(se) if se
+        }
+      when 'Array'
+        elems.each do |e|
+          build_xml!(e)
+        end
+      else
+        raise "Unsupported type: #{elems.class.name}"
+      end
+    end
+
+    # Build the FolderShape element
+    # @see http://msdn.microsoft.com/en-us/library/aa494311.aspx
+    # @param [Hash] folder_shape The folder shape structure to build from
+    # @todo need fully support all options
+    def folder_shape!(folder_shape)
+      @nbuild.FolderShape {
+        @nbuild.parent.default_namespace = @default_ns
+        base_shape!(folder_shape[:base_shape])
+        if(folder_shape[:additional_properties])
+          additional_properties!(folder_shape[:additional_properties])
+        end
+      }
+    end
+
+    # Build the ItemShape element
+    # @see http://msdn.microsoft.com/en-us/library/aa565261.aspx
+    # @param [Hash] item_shape The item shape structure to build from
+    # @todo need fully support all options
+    def item_shape!(item_shape)
+      @nbuild[NS_EWS_MESSAGES].ItemShape {
+        @nbuild.parent.default_namespace = @default_ns
+        base_shape!(item_shape[:base_shape])
+        body_type!(item_shape[:body_type]) if item_shape[:body_type]
+        if(item_shape[:additional_properties])
+          additional_properties!(item_shape[:additional_properties])
+        end
+      }
+    end
+
+    # Build the BaseShape element
+    # @see http://msdn.microsoft.com/en-us/library/aa580545.aspx
+    def base_shape!(base_shape)
+      @nbuild[NS_EWS_TYPES].BaseShape(base_shape.to_s.camel_case)
+    end
+
+    def body_type!(body_type)
+      body_type = body_type.to_s
+      if body_type =~ /html/i
+        body_type = body_type.upcase
+      else
+        body_type = body_type.downcase.capitalize
+      end
+      nbuild[NS_EWS_TYPES].BodyType(body_type)
+    end
+
+    # Build the ParentFolderIds element
+    # @see http://msdn.microsoft.com/en-us/library/aa565998.aspx
+    def parent_folder_ids!(pfids)
+      @nbuild[NS_EWS_MESSAGES].ParentFolderIds {
+        pfids.each do |pfid|
+          dispatch_folder_id!(pfid)
+        end
+      }
+    end
+
+    # Build the ParentFolderId element
+    # @see http://msdn.microsoft.com/en-us/library/aa563268.aspx
+    def parent_folder_id!(pfid)
+      @nbuild.ParentFolderId {
+        dispatch_folder_id!(pfid)
+      }
+    end
+
+    # Build the FolderIds element
+    # @see http://msdn.microsoft.com/en-us/library/aa580509.aspx
+    def folder_ids!(fids, act_as=nil)
+      ns = @nbuild.parent.name.match(/subscription/i) ? NS_EWS_TYPES : NS_EWS_MESSAGES
+      @nbuild[ns].FolderIds {
+        fids.each do |fid|
+          fid[:act_as] = act_as if act_as != nil
+          dispatch_folder_id!(fid)
+        end
+      }
+    end
+
+    # Build the SyncFolderId element
+    # @see http://msdn.microsoft.com/en-us/library/aa580296.aspx
+    def sync_folder_id!(fid)
+      @nbuild.SyncFolderId {
+        dispatch_folder_id!(fid)
+      }
+    end
+
+    # Build the DistinguishedFolderId element
+    # @see http://msdn.microsoft.com/en-us/library/aa580808.aspx
+    # @todo add support for the Mailbox child object
+    def distinguished_folder_id!(dfid, change_key = nil, act_as = nil)
+      attribs = {'Id' => dfid.to_s}
+      attribs['ChangeKey'] = change_key if change_key
+      @nbuild[NS_EWS_TYPES].DistinguishedFolderId(attribs) {
+        if ! act_as.nil?
+          mailbox!({:email_address => act_as})
+        end
+      }
+    end
+
+    # Build the FolderId element
+    # @see http://msdn.microsoft.com/en-us/library/aa579461.aspx
+    def folder_id!(fid, change_key = nil)
+      attribs = {'Id' => fid}
+      attribs['ChangeKey'] = change_key if change_key
+      @nbuild[NS_EWS_TYPES].FolderId(attribs)
+    end
+
+    # @see http://msdn.microsoft.com/en-us/library/aa563525(v=EXCHG.140).aspx
+    def item_ids!(item_ids)
+      @nbuild.ItemIds {
+        item_ids.each do |iid|
+          dispatch_item_id!(iid)
+        end
+      }
+    end
+
+    def parent_item_id!(id)
+      nbuild.ParentItemId {|x|
+        x.parent['Id'] = id[:id]
+        x.parent['ChangeKey'] = id[:change_key] if id[:change_key]
+      }
+    end
+
+    # @see http://msdn.microsoft.com/en-us/library/aa580234(v=EXCHG.140).aspx
+    def item_id!(id)
+      nbuild[NS_EWS_TYPES].ItemId {|x|
+        x.parent['Id'] = id[:id]
+        x.parent['ChangeKey'] = id[:change_key] if id[:change_key]
+      }
+    end
+
+    # @see http://msdn.microsoft.com/en-us/library/aa580744(v=EXCHG.140).aspx
+    def occurrence_item_id!(id)
+      @nbuild[NS_EWS_TYPES].OccurrenceItemId {|x|
+        x.parent['RecurringMasterId'] = id[:recurring_master_id]
+        x.parent['ChangeKey'] = id[:change_key] if id[:change_key]
+        x.parent['InstanceIndex'] = id[:instance_index]
+      }
+    end
+
+    # @see http://msdn.microsoft.com/en-us/library/aa581019(v=EXCHG.140).aspx
+    def recurring_master_item_id!(id)
+      @nbuild[NS_EWS_TYPES].RecurringMasterItemId {|x|
+        x.parent['OccurrenceId'] = id[:occurrence_id]
+        x.parent['ChangeKey'] = id[:change_key] if id[:change_key]
+      }
+    end
+
+    # @see http://msdn.microsoft.com/en-us/library/aa565020(v=EXCHG.140).aspx
+    def to_folder_id!(to_fid)
+      @nbuild[NS_EWS_MESSAGES].ToFolderId {
+        dispatch_folder_id!(to_fid)
+      }
+    end
+
+    # @see http://msdn.microsoft.com/en-us/library/aa564009.aspx
+    def folders!(folders)
+      @nbuild.Folders {|x|
+        folders.each do |fold|
+          fold.each_pair do |ftype, vars| # convenience, should only be one pair
+            ftype = "#{ftype}!".to_sym
+            if self.respond_to? ftype
+              self.send ftype, vars
+            else
+              raise Viewpoint::EWS::EwsNotImplemented,
+                "#{ftype} not implemented as a builder."
+            end
+          end
+        end
+      }
+    end
+
+    def folder!(folder, type = :Folder)
+      nbuild[NS_EWS_TYPES].send(type) {|x|
+        folder.each_pair do |e,v|
+          ftype = "#{e}!".to_sym
+          if e == :folder_id
+            dispatch_folder_id!(v)
+          elsif self.respond_to?(ftype)
+            self.send ftype, v
+          else
+            raise Viewpoint::EWS::EwsNotImplemented,
+              "#{ftype} not implemented as a builder."
+          end
+        end
+      }
+    end
+
+    def calendar_folder!(folder)
+      folder! folder, :CalendarFolder
+    end
+
+    def contacts_folder!(folder)
+      folder! folder, :ContactsFolder
+    end
+
+    def search_folder!(folder)
+      folder! folder, :SearchFolder
+    end
+
+    def tasks_folder!(folder)
+      folder! folder, :TasksFolder
+    end
+
+    def display_name!(name)
+      nbuild[NS_EWS_TYPES].DisplayName(name)
+    end
+
+    # Build the AdditionalProperties element
+    # @see http://msdn.microsoft.com/en-us/library/aa563810.aspx
+    def additional_properties!(addprops)
+      @nbuild[NS_EWS_TYPES].AdditionalProperties {
+        addprops.each_pair {|k,v|
+          dispatch_field_uri!({k => v})
+        }
+      }
+    end
+
+    # Build the Mailbox element.
+    # This element is commonly used for delegation. Typically passing an
+    #   email_address is sufficient
+    # @see http://msdn.microsoft.com/en-us/library/aa565036.aspx
+    # @param [Hash] mailbox A well-formated hash
+    def mailbox!(mbox)
+      nbuild[NS_EWS_TYPES].Mailbox {
+        name!(mbox[:name]) if mbox[:name]
+        email_address!(mbox[:email_address]) if mbox[:email_address]
+        address!(mbox[:address]) if mbox[:address] # for Availability query
+        routing_type!(mbox[:routing_type]) if mbox[:routing_type]
+        mailbox_type!(mbox[:mailbox_type]) if mbox[:mailbox_type]
+        item_id!(mbox[:item_id]) if mbox[:item_id]
+      }
+    end
+
+    def name!(name)
+      nbuild[NS_EWS_TYPES].Name(name)
+    end
+
+    def email_address!(email)
+      nbuild[NS_EWS_TYPES].EmailAddress(email)
+    end
+
+    def address!(email)
+      nbuild[NS_EWS_TYPES].Address(email)
+    end
+
+    # This is stupid. The only valid value is "SMTP"
+    def routing_type!(type)
+      nbuild[NS_EWS_TYPES].RoutingType(type)
+    end
+
+    def mailbox_type!(type)Standard
+      nbuild[NS_EWS_TYPES].MailboxType(type)
+    end
+
+    def user_oof_settings!(opts)
+      nbuild[NS_EWS_TYPES].UserOofSettings {
+        nbuild.OofState(opts[:oof_state].to_s.camel_case)
+        nbuild.ExternalAudience(opts[:external_audience].to_s.camel_case) if opts[:external_audience]
+        duration!(opts[:duration]) if opts[:duration]
+        nbuild.InternalReply {
+          nbuild.Message(opts[:internal_reply])
+        } if opts[:external_reply]
+        nbuild.ExternalReply {
+          nbuild.Message(opts[:external_reply])
+        } if opts[:external_reply]
+      }
+    end
+
+    def duration!(opts)
+      nbuild.Duration {
+        nbuild.StartTime(opts[:start_time].new_offset(0).strftime('%FT%H:%M:%SZ'))
+        nbuild.EndTime(opts[:end_time].new_offset(0).strftime('%FT%H:%M:%SZ'))
+      }
+    end
+
+    def mailbox_data!(md)
+      nbuild[NS_EWS_TYPES].MailboxData {
+        nbuild.Email {
+          mbox = md[:email]
+          name!(mbox[:name]) if mbox[:name]
+          address!(mbox[:address]) if mbox[:address] # for Availability query
+          routing_type!(mbox[:routing_type]) if mbox[:routing_type]
+        }
+        nbuild.AttendeeType 'Required'
+      }
+    end
+
+    def free_busy_view_options!(opts)
+      nbuild[NS_EWS_TYPES].FreeBusyViewOptions {
+        nbuild.TimeWindow {
+          nbuild.StartTime(opts[:time_window][:start_time])
+          nbuild.EndTime(opts[:time_window][:end_time])
+        }
+        nbuild.RequestedView(opts[:requested_view][:requested_free_busy_view].to_s.camel_case)
+      }
+    end
+
+    def suggestions_view_options!(opts)
+    end
+
+    def time_zone!(zone)
+      nbuild[NS_EWS_TYPES].TimeZone {
+        nbuild.Bias(480)
+        nbuild.StandardTime {
+          nbuild.Bias(0)
+          nbuild.Time("02:00:00")
+          nbuild.DayOrder(5)
+          nbuild.Month(10)
+          nbuild.DayOfWeek('Sunday')
+        }
+        nbuild.DaylightTime {
+          nbuild.Bias(-60)
+          nbuild.Time("02:00:00")
+          nbuild.DayOrder(1)
+          nbuild.Month(4)
+          nbuild.DayOfWeek('Sunday')
+        }
+      }
+    end
+
+    # Build the Restriction element
+    # @see http://msdn.microsoft.com/en-us/library/aa563791.aspx
+    # @param [Hash] restriction a well-formatted Hash that can be fed to #build_xml!
+    def restriction!(restriction)
+      @nbuild[NS_EWS_MESSAGES].Restriction {
+        restriction.each_pair do |k,v|
+          self.send normalize_type(k), v
+        end
+      }
+    end
+
+    def and_r(expr)
+      and_or('And', expr)
+    end
+
+    def or_r(expr)
+      and_or('Or', expr)
+    end
+
+    def and_or(type, expr)
+      @nbuild[NS_EWS_TYPES].send(type) {
+        expr.each do |e|
+          type = e.keys.first
+          self.send normalize_type(type), e[type]
+        end
+      }
+    end
+
+    def not_r(expr)
+      @nbuild[NS_EWS_TYPES].Not {
+        type = expr.keys.first
+        self.send(type, expr[type])
+      }
+    end
+
+    def contains(expr)
+      @nbuild[NS_EWS_TYPES].Contains(
+        'ContainmentMode' => expr.delete(:containment_mode),
+        'ContainmentComparison' => expr.delete(:containment_comparison)) {
+        c = expr.delete(:constant) # remove constant 1st for ordering
+        type = expr.keys.first
+        self.send(type, expr[type])
+        constant(c)
+      }
+    end
+
+    def excludes(expr)
+      @nbuild[NS_EWS_TYPES].Excludes {
+        b = expr.delete(:bitmask) # remove bitmask 1st for ordering
+        type = expr.keys.first
+        self.send(type, expr[type])
+        bitmask(b)
+      }
+    end
+
+    def exists(expr)
+      @nbuild[NS_EWS_TYPES].Exists {
+        type = expr.keys.first
+        self.send(type, expr[type])
+      }
+    end
+
+    def bitmask(expr)
+      @nbuild[NS_EWS_TYPES].Bitmask('Value' => expr[:value])
+    end
+
+    def is_equal_to(expr)
+      restriction_compare('IsEqualTo',expr)
+    end
+
+    def is_greater_than(expr)
+      restriction_compare('IsGreaterThan',expr)
+    end
+
+    def is_greater_than_or_equal_to(expr)
+      restriction_compare('IsGreaterThanOrEqualTo',expr)
+    end
+
+    def is_less_than(expr)
+      restriction_compare('IsLessThan',expr)
+    end
+
+    def is_less_than_or_equal_to(expr)
+      restriction_compare('IsLessThanOrEqualTo',expr)
+    end
+
+    def is_not_equal_to(expr)
+      restriction_compare('IsNotEqualTo',expr)
+    end
+
+    def restriction_compare(type,expr)
+      nbuild[NS_EWS_TYPES].send(type) {
+        expr.each do |e|
+          e.each_pair do |k,v|
+            self.send(k, v)
+          end
+        end
+      }
+    end
+
+    def field_uRI(expr)
+      nbuild[NS_EWS_TYPES].FieldURI('FieldURI' => expr[:field_uRI])
+    end
+
+    def indexed_field_uRI(expr)
+      nbuild[NS_EWS_TYPES].IndexedFieldURI(
+        'FieldURI'    => expr[:field_uRI],
+        'FieldIndex'  => expr[:field_index]
+      )
+    end
+
+    def extended_field_uRI(expr)
+      nbuild[NS_EWS_TYPES].ExtendedFieldURI {
+        nbuild.parent['DistinguishedPropertySetId'] = expr[:distinguished_property_set_id] if expr[:distinguished_property_set_id]
+        nbuild.parent['PropertySetId'] = expr[:property_set_id] if expr[:property_set_id]
+        nbuild.parent['PropertyTag'] = expr[:property_tag] if expr[:property_tag]
+        nbuild.parent['PropertyName'] = expr[:property_name] if expr[:property_name]
+        nbuild.parent['PropertyId'] = expr[:property_id] if expr[:property_id]
+        nbuild.parent['PropertyType'] = expr[:property_type] if expr[:property_type]
+      }
+    end
+
+    def field_uRI_or_constant(expr)
+      nbuild[NS_EWS_TYPES].FieldURIOrConstant {
+        type = expr.keys.first
+        self.send(type, expr[type])
+      }
+    end
+
+    def constant(expr)
+      nbuild[NS_EWS_TYPES].Constant('Value' => expr[:value])
+    end
+
+    # Build the CalendarView element
+    def calendar_view!(cal_view)
+      attribs = {}
+      cal_view.each_pair {|k,v| attribs[k.to_s.camel_case] = v.to_s}
+      @nbuild[NS_EWS_MESSAGES].CalendarView(attribs)
+    end
+
+    # Build the ContactsView element
+    def contacts_view!(con_view)
+      attribs = {}
+      con_view.each_pair {|k,v| attribs[k.to_s.camel_case] = v.to_s}
+      @nbuild[NS_EWS_MESSAGES].ContactsView(attribs)
+    end
+
+    # @see http://msdn.microsoft.com/en-us/library/aa579678(v=EXCHG.140).aspx
+    def event_types!(evtypes)
+      @nbuild[NS_EWS_TYPES].EventTypes {
+        evtypes.each do |et|
+          @nbuild[NS_EWS_TYPES].EventType(et.to_s.camel_case)
+        end
+      }
+    end
+
+    # @see http://msdn.microsoft.com/en-us/library/aa565886(v=EXCHG.140).aspx
+    def watermark!(wmark, ns = NS_EWS_TYPES)
+      @nbuild[ns].Watermark(wmark)
+    end
+
+    # @see http://msdn.microsoft.com/en-us/library/aa565201(v=EXCHG.140).aspx
+    def timeout!(tout)
+      @nbuild[NS_EWS_TYPES].Timeout(tout)
+    end
+
+    # @see http://msdn.microsoft.com/en-us/library/aa564048(v=EXCHG.140).aspx
+    def status_frequency!(freq)
+      @nbuild[NS_EWS_TYPES].StatusFrequency(freq)
+    end
+
+    # @see http://msdn.microsoft.com/en-us/library/aa566309(v=EXCHG.140).aspx
+    def uRL!(url)
+      @nbuild[NS_EWS_TYPES].URL(url)
+    end
+
+    # @see http://msdn.microsoft.com/en-us/library/aa563790(v=EXCHG.140).aspx
+    def subscription_id!(subid)
+      @nbuild.SubscriptionId(subid)
+    end
+
+    # @see http://msdn.microsoft.com/en-us/library/aa563455(v=EXCHG.140).aspx
+    def pull_subscription_request(subopts)
+      subscribe_all = subopts[:subscribe_to_all_folders] ? 'true' : 'false'
+      @nbuild.PullSubscriptionRequest('SubscribeToAllFolders' => subscribe_all) {
+        folder_ids!(subopts[:folder_ids]) if subopts[:folder_ids]
+        event_types!(subopts[:event_types]) if subopts[:event_types]
+        watermark!(subopts[:watermark]) if subopts[:watermark]
+        timeout!(subopts[:timeout]) if subopts[:timeout]
+      }
+    end
+
+    # @see http://msdn.microsoft.com/en-us/library/aa563599(v=EXCHG.140).aspx
+    def push_subscription_request(subopts)
+      subscribe_all = subopts[:subscribe_to_all_folders] ? 'true' : 'false'
+      @nbuild.PushSubscriptionRequest('SubscribeToAllFolders' => subscribe_all) {
+        folder_ids!(subopts[:folder_ids]) if subopts[:folder_ids]
+        event_types!(subopts[:event_types]) if subopts[:event_types]
+        watermark!(subopts[:watermark]) if subopts[:watermark]
+        status_frequency!(subopts[:status_frequency]) if subopts[:status_frequency]
+        uRL!(subopts[:uRL]) if subopts[:uRL]
+      }
+    end
+
+    # @see http://msdn.microsoft.com/en-us/library/ff406182(v=EXCHG.140).aspx
+    def streaming_subscription_request(subopts)
+      subscribe_all = subopts[:subscribe_to_all_folders] ? 'true' : 'false'
+      @nbuild.StreamingSubscriptionRequest('SubscribeToAllFolders' => subscribe_all) {
+        folder_ids!(subopts[:folder_ids]) if subopts[:folder_ids]
+        event_types!(subopts[:event_types]) if subopts[:event_types]
+      }
+    end
+
+    # @see http://msdn.microsoft.com/en-us/library/aa565970(v=EXCHG.140).aspx
+    def sync_state!(syncstate)
+      @nbuild.SyncState(syncstate)
+    end
+
+    # @see http://msdn.microsoft.com/en-us/library/aa563785(v=EXCHG.140).aspx
+    def ignore!(item_ids)
+      @nbuild.Ignore {
+        item_ids.each do |iid|
+          item_id!(iid)
+        end
+      }
+    end
+
+    # @see http://msdn.microsoft.com/en-us/library/aa566325(v=EXCHG.140).aspx
+    def max_changes_returned!(cnum)
+      @nbuild[NS_EWS_MESSAGES].MaxChangesReturned(cnum)
+    end
+
+    # @see http://msdn.microsoft.com/en-us/library/dd899531(v=EXCHG.140).aspx
+    def sync_scope!(scope)
+      @nbuild.SyncScope(scope)
+    end
+
+    # @see http://msdn.microsoft.com/en-us/library/aa580758(v=EXCHG.140).aspx
+    def saved_item_folder_id!(fid)
+      @nbuild.SavedItemFolderId {
+        dispatch_folder_id!(fid)
+      }
+    end
+
+    # @see http://msdn.microsoft.com/en-us/library/aa565652(v=exchg.140).aspx
+    def item!(item)
+      nbuild.Item {
+        item.each_pair {|k,v|
+          self.send("#{k}!", v)
+        }
+      }
+    end
+
+    def message!(item)
+      nbuild[NS_EWS_TYPES].Message {
+        item.each_pair {|k,v|
+          self.send("#{k}!", v)
+        }
+      }
+    end
+
+    def calendar_item!(item)
+      nbuild[NS_EWS_TYPES].CalendarItem {
+        item.each_pair {|k,v|
+          self.send("#{k}!", v)
+        }
+      }
+    end
+
+    def forward_item!(item)
+      nbuild[NS_EWS_TYPES].ForwardItem {
+        item.each_pair {|k,v|
+          self.send("#{k}!", v)
+        }
+      }
+    end
+
+    def reply_to_item!(item)
+      nbuild[NS_EWS_TYPES].ReplyToItem {
+        item.each_pair {|k,v|
+          self.send("#{k}!", v)
+        }
+      }
+    end
+
+    def reply_all_to_item!(item)
+      nbuild[NS_EWS_TYPES].ReplyAllToItem {
+        item.each_pair {|k,v|
+          self.send("#{k}!", v)
+        }
+      }
+    end
+
+    def reference_item_id!(id)
+      nbuild[NS_EWS_TYPES].ReferenceItemId {|x|
+        x.parent['Id'] = id[:id]
+        x.parent['ChangeKey'] = id[:change_key] if id[:change_key]
+      }
+    end
+
+    def subject!(sub)
+      nbuild[NS_EWS_TYPES].Subject(sub)
+    end
+
+    def body!(b)
+      nbuild[NS_EWS_TYPES].Body(b[:text]) {|x|
+        x.parent['BodyType'] = b[:body_type] if b[:body_type]
+      }
+    end
+
+    def new_body_content!(b)
+      nbuild[NS_EWS_TYPES].NewBodyContent(b[:text]) {|x|
+        x.parent['BodyType'] = b[:body_type] if b[:body_type]
+      }
+    end
+
+    # @see http://msdn.microsoft.com/en-us/library/aa563719(v=exchg.140).aspx
+    # @param [Array] r An array of Mailbox type hashes to send to #mailbox!
+    def to_recipients!(r)
+      nbuild[NS_EWS_TYPES].ToRecipients {
+        r.each {|mbox| mailbox!(mbox[:mailbox]) }
+      }
+    end
+
+    def cc_recipients!(r)
+      nbuild[NS_EWS_TYPES].CcRecipients {
+        r.each {|mbox| mailbox!(mbox[:mailbox]) }
+      }
+    end
+
+    def bcc_recipients!(r)
+      nbuild[NS_EWS_TYPES].BccRecipients {
+        r.each {|mbox| mailbox!(mbox[:mailbox]) }
+      }
+    end
+
+    def required_attendees!(attendees)
+      nbuild[NS_EWS_TYPES].RequiredAttendees {
+        attendees.each {|a| attendee!(a[:attendee])}
+      }
+    end
+
+    def optional_attendees!(attendees)
+      nbuild[NS_EWS_TYPES].OptionalAttendees {
+        attendees.each {|a| attendee!(a[:attendee])}
+      }
+    end
+
+    def resources!(attendees)
+      nbuild[NS_EWS_TYPES].Resources {
+        attendees.each {|a| attendee!(a[:attendee])}
+      }
+    end
+
+    def attendee!(a)
+      nbuild[NS_EWS_TYPES].Attendee {
+        mailbox!(a[:mailbox])
+        #@todo support ResponseType, LastResponseTime: http://msdn.microsoft.com/en-us/library/aa580339.aspx
+      }
+    end
+
+    def start!(st)
+      nbuild[NS_EWS_TYPES].Start(st[:text])
+    end
+
+    def end!(et)
+      nbuild[NS_EWS_TYPES].End(et[:text])
+    end
+
+    # @see http://msdn.microsoft.com/en-us/library/aa565428(v=exchg.140).aspx
+    def item_changes!(changes)
+      nbuild.ItemChanges {
+        changes.each do |chg|
+          item_change!(chg)
+        end
+      }
+    end
+
+    # @see http://msdn.microsoft.com/en-us/library/aa581081(v=exchg.140).aspx
+    def item_change!(change)
+      @nbuild[NS_EWS_TYPES].ItemChange {
+        updates = change.delete(:updates) # Remove updates so dispatch_item_id works correctly
+        dispatch_item_id!(change)
+        updates!(updates)
+      }
+    end
+
+    # @see http://msdn.microsoft.com/en-us/library/aa581074(v=exchg.140).aspx
+    def updates!(updates)
+      @nbuild[NS_EWS_TYPES].Updates {
+        updates.each do |update|
+          dispatch_update_type!(update)
+        end
+      }
+    end
+
+    # @see http://msdn.microsoft.com/en-us/library/aa581317(v=exchg.140).aspx
+    def append_to_item_field!(upd)
+      uri = upd.select {|k,v| k =~ /_uri/i}
+      raise EwsBadArgumentError, "Bad argument given for AppendToItemField." if uri.keys.length != 1
+      upd.delete(uri.keys.first)
+      @nbuild.AppendToItemField {
+        dispatch_field_uri!(uri)
+        dispatch_field_item!(upd)
+      }
+    end
+
+    # @see http://msdn.microsoft.com/en-us/library/aa581487(v=exchg.140).aspx
+    def set_item_field!(upd)
+      uri = upd.select {|k,v| k =~ /_uri/i}
+      raise EwsBadArgumentError, "Bad argument given for SetItemField." if uri.keys.length != 1
+      upd.delete(uri.keys.first)
+      @nbuild.SetItemField {
+        dispatch_field_uri!(uri)
+        dispatch_field_item!(upd)
+      }
+    end
+
+    # @see http://msdn.microsoft.com/en-us/library/aa580330(v=exchg.140).aspx
+    def delete_item_field!(upd)
+      uri = upd.select {|k,v| k =~ /_uri/i}
+      raise EwsBadArgumentError, "Bad argument given for SetItemField." if uri.keys.length != 1
+      @nbuild.DeleteItemField {
+        dispatch_field_uri!(uri)
+      }
+    end
+
+    # @see http://msdn.microsoft.com/en-us/library/ff709497(v=exchg.140).aspx
+    def return_new_item_ids!(retval)
+      @nbuild.ReturnNewItemIds(retval)
+    end
+
+    def file_attachment!(fa)
+      @nbuild[NS_EWS_TYPES].FileAttachment {
+        @nbuild.Name(fa.name)
+        @nbuild.Content(fa.content)
+      }
+    end
+
+    def item_attachment!(ia)
+      @nbuild[NS_EWS_TYPES].ItemAttachment {
+        @nbuild.Name(ia.name)
+        @nbuild.Item {
+          item_id!(ia.item)
+        }
+      }
+    end
+
+    # Build the AttachmentIds element
+    # @see http://msdn.microsoft.com/en-us/library/aa580686.aspx
+    def attachment_ids!(aids)
+      @nbuild.AttachmentIds {
+        @nbuild.parent.default_namespace = @default_ns
+        aids.each do |aid|
+          attachment_id!(aid)
+        end
+      }
+    end
+
+    # Build the AttachmentId element
+    # @see http://msdn.microsoft.com/en-us/library/aa580764.aspx
+    def attachment_id!(aid)
+      attribs = {'Id' => aid}
+      @nbuild[NS_EWS_TYPES].AttachmentId(attribs)
+    end
+
+    def user_configuration_name!(cfg_name)
+      attribs = {'Name' => cfg_name.delete(:name)}
+      @nbuild[NS_EWS_MESSAGES].UserConfigurationName(attribs) {
+        fid = cfg_name.keys.first
+        self.send "#{fid}!", cfg_name[fid][:id], cfg_name[fid][:change_key]
+      }
+    end
+
+    def user_configuration_properties!(cfg_prop)
+      @nbuild[NS_EWS_MESSAGES].UserConfigurationProperties(cfg_prop)
+    end
+
+    # ---------------------- Helpers -------------------- #
+
+    # A helper method to dispatch to a FolderId or DistinguishedFolderId correctly
+    # @param [Hash] fid A folder_id
+    #   Ex: {:id => myid, :change_key => ck}
+    def dispatch_folder_id!(fid)
+      if(fid[:id].is_a?(String))
+        folder_id!(fid[:id], fid[:change_key])
+      elsif(fid[:id].is_a?(Symbol))
+        distinguished_folder_id!(fid[:id], fid[:change_key], fid[:act_as])
+      else
+        raise EwsBadArgumentError, "Bad argument given for a FolderId. #{fid[:id].class}"
+      end
+    end
+
+    # A helper method to dispatch to an ItemId, OccurrenceItemId, or a RecurringMasterItemId
+    # @param [Hash] iid The item id of some type
+    def dispatch_item_id!(iid)
+      type = iid.keys.first
+      item = iid[type]
+      case type
+      when :item_id
+        item_id!(item)
+      when :occurrence_item_id
+        occurrence_item_id!(
+          item[:recurring_master_id], item[:change_key], item[:instance_index])
+      when :recurring_master_item_id
+        recurring_master_item_id!(item[:occurrence_id], item[:change_key])
+      else
+        raise EwsBadArgumentError, "Bad ItemId type. #{type}"
+      end
+    end
+
+    # A helper method to dispatch to a AppendToItemField, SetItemField, or
+    #   DeleteItemField
+    # @param [Hash] update An update of some type
+    def dispatch_update_type!(update)
+      type = update.keys.first
+      upd  = update[type]
+      case type
+      when :append_to_item_field
+        append_to_item_field!(upd)
+      when :set_item_field
+        set_item_field!(upd)
+      when :delete_item_field
+        delete_item_field!(upd)
+      else
+        raise EwsBadArgumentError, "Bad Update type. #{type}"
+      end
+    end
+
+    # A helper to dispatch to a FieldURI, IndexedFieldURI, or an ExtendedFieldURI
+    # @todo Implement ExtendedFieldURI
+    def dispatch_field_uri!(uri)
+      type = uri.keys.first
+      vals = uri[type].is_a?(Array) ? uri[type] : [uri[type]]
+      case type
+      when :field_uRI, :field_uri
+        vals.each do |val|
+          nbuild.FieldURI('FieldURI' => val[:field_uRI])
+        end
+      when :indexed_field_uRI, :indexed_field_uri
+        vals.each do |val|
+          nbuild.IndexedFieldURI('FieldURI' => val[:field_uRI], 'FieldIndex' => val[:field_index])
+        end
+      when :extended_field_uRI, :extended_field_uri
+        vals.each do |val|
+          nbuild.ExtendedFieldURI {
+            nbuild.parent['DistinguishedPropertySetId'] = val[:distinguished_property_set_id] if val[:distinguished_property_set_id]
+            nbuild.parent['PropertySetId'] = val[:property_set_id] if val[:property_set_id]
+            nbuild.parent['PropertyTag'] = val[:property_tag] if val[:property_tag]
+            nbuild.parent['PropertyName'] = val[:property_name] if val[:property_name]
+            nbuild.parent['PropertyId'] = val[:property_id] if val[:property_id]
+            nbuild.parent['PropertyType'] = val[:property_type] if val[:property_type]
+          }
+        end
+      else
+        raise EwsBadArgumentError, "Bad URI type. #{type}"
+      end
+
+    end
+
+    def dispatch_field_item!(item)
+      build_xml!(item)
+    end
+
+
+private
+
+    def parent_namespace(node)
+      node.parent.namespace_definitions.find {|ns| ns.prefix == NS_SOAP}
+    end
+
+    def set_version_header!(version)
+      if version && !(version == 'none')
+        nbuild[NS_EWS_TYPES].RequestServerVersion {|x|
+          x.parent['Version'] = version
+        }
+      end
+    end
+
+    # some methods need special naming so they use the '_r' suffix like 'and'
+    def normalize_type(type)
+      case type
+      when :and, :or, :not
+        "#{type}_r".to_sym
+      else
+        type
+      end
+    end
+
+  end # EwsBuilder
+end # Viewpoint::EWS::SOAP