viewpoint 1.2.0 → 2.0.0

data/lib/ews/soap/exchange_notification.rb

@@ -1,146 +1,141 @@
-=begin
-  This file is part of Viewpoint; the Ruby library for Microsoft Exchange Web Services.
+# frozen_string_literal: true
 
-  Copyright © 2011 Dan Wanek <dan.wanek@gmail.com>
+#   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.
 
-  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
+module Viewpoint
+  module EWS
+    module SOAP
+      # Exchange Notification operations as listed in the EWS Documentation.
+      # @see http://msdn.microsoft.com/en-us/library/bb409286.aspx
+      module ExchangeNotification
+        include Viewpoint::EWS::SOAP
 
-    http://www.apache.org/licenses/LICENSE-2.0
+        # Used to subscribe client applications to either push, pull or stream notifications.
+        # @see http://msdn.microsoft.com/en-us/library/aa566188(v=EXCHG.140).aspx
+        # @param [Array<Hash>] subscriptions An array of Hash objects that describe each
+        #   subscription.
+        #   Ex: [ {:pull_subscription_request => {
+        #         :subscribe_to_all_folders => false,
+        #         :folder_ids => [ {:id => 'id', :change_key => 'ck'} ],
+        #         :event_types=> %w{CopiedEvent CreatedEvent},
+        #         :watermark  => 'watermark id',
+        #         :timeout    => intval
+        #       }},
+        #       {:push_subscription_request => {
+        #         :subscribe_to_all_folders => true,
+        #         :event_types=> %w{CopiedEvent CreatedEvent},
+        #         :status_frequency => 15,
+        #         :uRL => 'http://my.endpoint.for.updates/',
+        #       }},
+        #       {:streaming_subscription_request => {
+        #         :subscribe_to_all_folders => false,
+        #         :folder_ids => [ {:id => 'id', :change_key => 'ck'} ],
+        #         :event_types=> %w{NewMailEvent DeletedEvent},
+        #       }},
+        #       ]
+        def subscribe(subscriptions)
+          req = build_soap! { |type, builder|
+            unless type == :header
+              builder.nbuild.Subscribe {
+                builder.nbuild.parent.default_namespace = @default_ns
+                subscriptions.each do |sub|
+                  subtype = sub.keys.first
+                  raise EwsBadArgumentError, "Bad subscription type. #{subtype}" unless builder.respond_to?(subtype)
 
-  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
-
-  # Exchange Notification operations as listed in the EWS Documentation.
-  # @see http://msdn.microsoft.com/en-us/library/bb409286.aspx
-  module ExchangeNotification
-    include Viewpoint::EWS::SOAP
-
-    # Used to subscribe client applications to either push, pull or stream notifications.
-    # @see http://msdn.microsoft.com/en-us/library/aa566188(v=EXCHG.140).aspx
-    # @param [Array<Hash>] subscriptions An array of Hash objects that describe each
-    #   subscription.
-    #   Ex: [ {:pull_subscription_request => {
-    #         :subscribe_to_all_folders => false,
-    #         :folder_ids => [ {:id => 'id', :change_key => 'ck'} ],
-    #         :event_types=> %w{CopiedEvent CreatedEvent},
-    #         :watermark  => 'watermark id',
-    #         :timeout    => intval
-    #       }},
-    #       {:push_subscription_request => {
-    #         :subscribe_to_all_folders => true,
-    #         :event_types=> %w{CopiedEvent CreatedEvent},
-    #         :status_frequency => 15,
-    #         :uRL => 'http://my.endpoint.for.updates/',
-    #       }},
-    #       {:streaming_subscription_request => {
-    #         :subscribe_to_all_folders => false,
-    #         :folder_ids => [ {:id => 'id', :change_key => 'ck'} ],
-    #         :event_types=> %w{NewMailEvent DeletedEvent},
-    #       }},
-    #       ]
-    def subscribe(subscriptions)
-      req = build_soap! do |type, builder|
-        if(type == :header)
-        else
-          builder.nbuild.Subscribe {
-            builder.nbuild.parent.default_namespace = @default_ns
-            subscriptions.each do |sub|
-              subtype = sub.keys.first
-              if(builder.respond_to?(subtype))
-                builder.send subtype, sub[subtype]
-              else
-                raise EwsBadArgumentError, "Bad subscription type. #{subtype}"
-              end
+                  builder.send subtype, sub[subtype]
+                end
+              }
             end
           }
+          do_soap_request(req, response_class: EwsResponse)
         end
-      end
-      do_soap_request(req, response_class: EwsResponse)
-    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)
-      req = build_soap! do |type, builder|
-        if(type == :header)
-        else
-          builder.nbuild.Unsubscribe {
-            builder.nbuild.parent.default_namespace = @default_ns
-            builder.subscription_id!(subscription_id)
+        # 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)
+          req = build_soap! { |type, builder|
+            unless type == :header
+              builder.nbuild.Unsubscribe {
+                builder.nbuild.parent.default_namespace = @default_ns
+                builder.subscription_id!(subscription_id)
+              }
+            end
           }
+          do_soap_request(req, response_class: EwsResponse)
         end
-      end
-      do_soap_request(req, response_class: EwsResponse)
-    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)
-      req = build_soap! do |type, builder|
-        if(type == :header)
-        else
-          builder.nbuild.GetEvents {
-            builder.nbuild.parent.default_namespace = @default_ns
-            builder.subscription_id!(subscription_id)
-            builder.watermark!(watermark, NS_EWS_MESSAGES)
+        # 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)
+          req = build_soap! { |type, builder|
+            unless type == :header
+              builder.nbuild.GetEvents {
+                builder.nbuild.parent.default_namespace = @default_ns
+                builder.subscription_id!(subscription_id)
+                builder.watermark!(watermark, NS_EWS_MESSAGES)
+              }
+            end
           }
+          do_soap_request(req, response_class: EwsResponse)
         end
-      end
-      do_soap_request(req, response_class: EwsResponse)
-    end
-
 
-    # ------- convenience methods ------- #
+        # ------- convenience methods ------- #
 
-    # Create a pull subscription to a single folder
-    # @param folder [Hash] a hash with the folder :id and :change_key
-    # @param evtypes [Array] the events you would like to subscribe to.
-    # @param timeout [Fixnum] http://msdn.microsoft.com/en-us/library/aa565201.aspx
-    # @param watermark [String] http://msdn.microsoft.com/en-us/library/aa565886.aspx
-    def pull_subscribe_folder(folder, evtypes, timeout = nil, watermark = nil)
-      timeout ||= 240 # 4 hour default timeout
-      psr = {
-        :subscribe_to_all_folders => false,
-        :folder_ids => [ {:id => folder[:id], :change_key => folder[:change_key]} ],
-        :event_types=> evtypes,
-        :timeout    => timeout
-      }
-      psr[:watermark] = watermark if watermark
-      subscribe([{pull_subscription_request: psr}])
-    end
+        # Create a pull subscription to a single folder
+        # @param folder [Hash] a hash with the folder :id and :change_key
+        # @param evtypes [Array] the events you would like to subscribe to.
+        # @param timeout [Fixnum] http://msdn.microsoft.com/en-us/library/aa565201.aspx
+        # @param watermark [String] http://msdn.microsoft.com/en-us/library/aa565886.aspx
+        def pull_subscribe_folder(folder, evtypes, timeout = nil, watermark = nil)
+          timeout ||= 240 # 4 hour default timeout
+          psr = {
+            subscribe_to_all_folders: false,
+            folder_ids: [{ id: folder[:id], change_key: folder[:change_key] }],
+            event_types: evtypes,
+            timeout: timeout
+          }
+          psr[:watermark] = watermark if watermark
+          subscribe([{ pull_subscription_request: psr }])
+        end
 
-    # Create a push subscription to a single folder
-    # @param folder [Hash] a hash with the folder :id and :change_key
-    # @param evtypes [Array] the events you would like to subscribe to.
-    # @param url [String,URI] http://msdn.microsoft.com/en-us/library/aa566309.aspx
-    # @param watermark [String] http://msdn.microsoft.com/en-us/library/aa565886.aspx
-    # @param status_frequency [Fixnum] http://msdn.microsoft.com/en-us/library/aa564048.aspx
-    def push_subscribe_folder(folder, evtypes, url, status_frequency = nil, watermark = nil)
-      status_frequency ||= 30
-      psr = {
-        :subscribe_to_all_folders => false,
-        :folder_ids => [ {:id => folder[:id], :change_key => folder[:change_key]} ],
-        :event_types=> evtypes,
-        :status_frequency => status_frequency,
-        :uRL => url.to_s
-      }
-      psr[:watermark] = watermark if watermark
-      subscribe([{push_subscription_request: psr}])
+        # Create a push subscription to a single folder
+        # @param folder [Hash] a hash with the folder :id and :change_key
+        # @param evtypes [Array] the events you would like to subscribe to.
+        # @param url [String,URI] http://msdn.microsoft.com/en-us/library/aa566309.aspx
+        # @param watermark [String] http://msdn.microsoft.com/en-us/library/aa565886.aspx
+        # @param status_frequency [Fixnum] http://msdn.microsoft.com/en-us/library/aa564048.aspx
+        def push_subscribe_folder(folder, evtypes, url, status_frequency = nil, watermark = nil)
+          status_frequency ||= 30
+          psr = {
+            subscribe_to_all_folders: false,
+            folder_ids: [{ id: folder[:id], change_key: folder[:change_key] }],
+            event_types: evtypes,
+            status_frequency: status_frequency,
+            uRL: url.to_s
+          }
+          psr[:watermark] = watermark if watermark
+          subscribe([{ push_subscription_request: psr }])
+        end
+      end
     end
-
-
-  end #ExchangeNotification
+  end
 end

data/lib/ews/soap/exchange_synchronization.rb

@@ -1,93 +1,93 @@
-=begin
-  This file is part of Viewpoint; the Ruby library for Microsoft Exchange Web Services.
+# frozen_string_literal: true
 
-  Copyright © 2011 Dan Wanek <dan.wanek@gmail.com>
+#   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.
 
-  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
+module Viewpoint
+  module EWS
+    module SOAP
+      # Exchange Synchronization operations as listed in the EWS Documentation.
+      # @see http://msdn.microsoft.com/en-us/library/bb409286.aspx
+      module ExchangeSynchronization
+        include Viewpoint::EWS::SOAP
 
-    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
-
-  # Exchange Synchronization operations as listed in the EWS Documentation.
-  # @see http://msdn.microsoft.com/en-us/library/bb409286.aspx
-  module ExchangeSynchronization
-    include Viewpoint::EWS::SOAP
-
-    # Defines a request to synchronize a folder hierarchy on a client
-    # @see http://msdn.microsoft.com/en-us/library/aa580990.aspx
-    # @param [Hash] opts
-    # @option opts [Hash] :folder_shape The folder shape properties
-    #   Ex: {:base_shape => 'Default', :additional_properties => 'bla bla bla'}
-    # @option opts [Hash] :sync_folder_id An optional Hash that represents a FolderId or
-    #   DistinguishedFolderId.
-    #   Ex: {:id => :inbox}
-    # @option opts [Hash] :sync_state The Base64 sync state id. If this is the
-    #   first time syncing this does not need to be passed.
-    def sync_folder_hierarchy(opts)
-      opts = opts.clone
-      req = build_soap! do |type, builder|
-        if(type == :header)
-        else
-          builder.nbuild.SyncFolderHierarchy {
-            builder.nbuild.parent.default_namespace = @default_ns
-            builder.folder_shape!(opts[:folder_shape])
-            builder.sync_folder_id!(opts[:sync_folder_id]) if opts[:sync_folder_id]
-            builder.sync_state!(opts[:sync_state]) if opts[:sync_state]
+        # Defines a request to synchronize a folder hierarchy on a client
+        # @see http://msdn.microsoft.com/en-us/library/aa580990.aspx
+        # @param [Hash] opts
+        # @option opts [Hash] :folder_shape The folder shape properties
+        #   Ex: {:base_shape => 'Default', :additional_properties => 'bla bla bla'}
+        # @option opts [Hash] :sync_folder_id An optional Hash that represents a FolderId or
+        #   DistinguishedFolderId.
+        #   Ex: {:id => :inbox}
+        # @option opts [Hash] :sync_state The Base64 sync state id. If this is the
+        #   first time syncing this does not need to be passed.
+        def sync_folder_hierarchy(opts)
+          opts = opts.clone
+          req = build_soap! { |type, builder|
+            unless type == :header
+              builder.nbuild.SyncFolderHierarchy {
+                builder.nbuild.parent.default_namespace = @default_ns
+                builder.folder_shape!(opts[:folder_shape])
+                builder.sync_folder_id!(opts[:sync_folder_id]) if opts[:sync_folder_id]
+                builder.sync_state!(opts[:sync_state]) if opts[:sync_state]
+              }
+            end
           }
+          do_soap_request(req, response_class: EwsResponse)
         end
-      end
-      do_soap_request(req, response_class: EwsResponse)
-    end
 
-    # Synchronizes items between the Exchange server and the client
-    # @see http://msdn.microsoft.com/en-us/library/aa563967(v=EXCHG.140).aspx
-    # @param [Hash] opts
-    # @option opts [Hash] :item_shape The item shape properties
-    #   Ex: {:base_shape => 'Default', :additional_properties => 'bla bla bla'}
-    # @option opts [Hash] :sync_folder_id A Hash that represents a FolderId or
-    #   DistinguishedFolderId. [ Ex: {:id => :inbox} ] OPTIONAL
-    # @option opts [String] :sync_state The Base64 sync state id. If this is the
-    #   first time syncing this does not need to be passed. OPTIONAL on first call
-    # @option opts [Array <String>] :ignore An Array of ItemIds for items to ignore
-    #   during the sync process. Ex: [{:id => 'id1', :change_key => 'ck'}, {:id => 'id2'}]
-    #   OPTIONAL
-    # @option opts [Integer] :max_changes_returned ('required') The amount of items to sync per call.
-    # @option opts [String] :sync_scope specifies whether just items or items and folder associated
-    #   information are returned. OPTIONAL
-    #   options: 'NormalItems' or 'NormalAndAssociatedItems'
-    # @example
-    #   { :item_shape => {:base_shape => 'Default'},
-    #     :sync_folder_id => {:id => :inbox},
-    #     :sync_state => myBase64id,
-    #     :max_changes_returned => 256 }
-    def sync_folder_items(opts)
-      opts = opts.clone
-      req = build_soap! do |type, builder|
-        if(type == :header)
-        else
-          builder.nbuild.SyncFolderItems {
-            builder.nbuild.parent.default_namespace = @default_ns
-            builder.item_shape!(opts[:item_shape])
-            builder.sync_folder_id!(opts[:sync_folder_id]) if opts[:sync_folder_id]
-            builder.sync_state!(opts[:sync_state]) if opts[:sync_state]
-            builder.ignore!(opts[:ignore]) if opts[:ignore]
-            builder.max_changes_returned!(opts[:max_changes_returned])
-            builder.sync_scope!(opts[:sync_scope]) if opts[:sync_scope]
+        # Synchronizes items between the Exchange server and the client
+        # @see http://msdn.microsoft.com/en-us/library/aa563967(v=EXCHG.140).aspx
+        # @param [Hash] opts
+        # @option opts [Hash] :item_shape The item shape properties
+        #   Ex: {:base_shape => 'Default', :additional_properties => 'bla bla bla'}
+        # @option opts [Hash] :sync_folder_id A Hash that represents a FolderId or
+        #   DistinguishedFolderId. [ Ex: {:id => :inbox} ] OPTIONAL
+        # @option opts [String] :sync_state The Base64 sync state id. If this is the
+        #   first time syncing this does not need to be passed. OPTIONAL on first call
+        # @option opts [Array <String>] :ignore An Array of ItemIds for items to ignore
+        #   during the sync process. Ex: [{:id => 'id1', :change_key => 'ck'}, {:id => 'id2'}]
+        #   OPTIONAL
+        # @option opts [Integer] :max_changes_returned ('required') The amount of items to sync per call.
+        # @option opts [String] :sync_scope specifies whether just items or items and folder associated
+        #   information are returned. OPTIONAL
+        #   options: 'NormalItems' or 'NormalAndAssociatedItems'
+        # @example
+        #   { :item_shape => {:base_shape => 'Default'},
+        #     :sync_folder_id => {:id => :inbox},
+        #     :sync_state => myBase64id,
+        #     :max_changes_returned => 256 }
+        def sync_folder_items(opts)
+          opts = opts.clone
+          req = build_soap! { |type, builder|
+            unless type == :header
+              builder.nbuild.SyncFolderItems {
+                builder.nbuild.parent.default_namespace = @default_ns
+                builder.item_shape!(opts[:item_shape])
+                builder.sync_folder_id!(opts[:sync_folder_id]) if opts[:sync_folder_id]
+                builder.sync_state!(opts[:sync_state]) if opts[:sync_state]
+                builder.ignore!(opts[:ignore]) if opts[:ignore]
+                builder.max_changes_returned!(opts[:max_changes_returned])
+                builder.sync_scope!(opts[:sync_scope]) if opts[:sync_scope]
+              }
+            end
           }
+          do_soap_request(req, response_class: EwsResponse)
         end
       end
-      do_soap_request(req, response_class: EwsResponse)
     end
-
-  end #ExchangeSynchronization
+  end
 end

data/lib/ews/soap/exchange_time_zones.rb

@@ -1,56 +1,53 @@
-module Viewpoint::EWS::SOAP
+# frozen_string_literal: true
 
-  module ExchangeTimeZones
-    include Viewpoint::EWS::SOAP
+module Viewpoint
+  module EWS
+    module SOAP
+      # Known Exchange time zone definitions.
+      module ExchangeTimeZones
+        include Viewpoint::EWS::SOAP
 
-    # Request list of server known time zones
-    # @param full [Boolean] Request full time zone definition? Returns only name and id if false.
-    # @param ids [Array] Returns only the specified time zones instead of all if present
-    # @return [Array] Array of Objects responding to #id() and #name()
-    # @example Retrieving server time zones
-    #   ews_client = Viewpoint::EWSClient.new # ...
-    #   zones = ews_client.ews.get_time_zones
-    # @todo Implement TimeZoneDefinition with sub elements Periods, TransitionsGroups and Transitions
-    def get_time_zones(full = false, ids = nil)
-      req = build_soap! do |type, builder|
-        unless type == :header
-          builder.get_server_time_zones!(full: full, ids: ids)
-        end
-      end
-      result = do_soap_request req, response_class: EwsSoapResponse
+        # Request list of server known time zones
+        # @param full [Boolean] Request full time zone definition? Returns only name and id if false.
+        # @param ids [Array] Returns only the specified time zones instead of all if present
+        # @return [Array] Array of Objects responding to #id() and #name()
+        # @example Retrieving server time zones
+        #   ews_client = Viewpoint::EWSClient.new # ...
+        #   zones = ews_client.ews.get_time_zones
+        # @todo Implement TimeZoneDefinition with sub elements Periods, TransitionsGroups and Transitions
+        def get_time_zones(full = false, ids = nil) # rubocop:disable Style/OptionalBooleanParameter -- public API
+          req = build_soap! { |type, builder|
+            builder.get_server_time_zones!(full: full, ids: ids) unless type == :header
+          }
+          result = do_soap_request req, response_class: EwsSoapResponse
 
-      if result.success?
-        zones = []
-        result.response_messages.each do |message|
-          elements = message[:get_server_time_zones_response_message][:elems][:time_zone_definitions][:elems]
-          elements.each do |definition|
-            data = {
+          raise EwsError, 'Could not get time zones' unless result.success?
+
+          zones = []
+          result.response_messages.each do |message|
+            elements = message[:get_server_time_zones_response_message][:elems][:time_zone_definitions][:elems]
+            elements.each do |definition|
+              data = {
                 id: definition[:time_zone_definition][:attribs][:id],
                 name: definition[:time_zone_definition][:attribs][:name]
-            }
-            zones << OpenStruct.new(data)
+              }
+              zones << OpenStruct.new(data)
+            end
           end
+          zones
         end
-        zones
-      else
-        raise EwsError, "Could not get time zones"
-      end
-    end
 
-    # Sets the time zone context header
-    # @param id [String] Identifier of a Microsoft well known time zone
-    # @example Set time zone context for connection
-    #   ews_client = Viewpoint::EWSClient.new # ...
-    #   ews_client.set_time_zone 'AUS Central Standard Time'
-    #   # subsequent request will send the TimeZoneContext header
-    # @see EWSClient#set_time_zone
-    def set_time_zone_context(id)
-      if id
-        @time_zone_context = {id: id}
-      else
-        @time_zone_context = nil
+        # Sets the time zone context header
+        # @param id [String] Identifier of a Microsoft well known time zone
+        # @example Set time zone context for connection
+        #   ews_client = Viewpoint::EWSClient.new # ...
+        #   ews_client.set_time_zone 'AUS Central Standard Time'
+        #   # subsequent request will send the TimeZoneContext header
+        # @see EWSClient#set_time_zone
+        def set_time_zone_context(id) # rubocop:disable Naming/AccessorMethodName -- public API name
+          @time_zone_context = ({ id: id } if id)
+        end
       end
     end
-
   end
 end

data/lib/ews/soap/exchange_user_configuration.rb

@@ -1,33 +1,36 @@
-module Viewpoint::EWS::SOAP
+# frozen_string_literal: true
 
-  # Exchange User Configuration operations as listed in the EWS Documentation.
-  # @see http://msdn.microsoft.com/en-us/library/bb409286.aspx
-  module ExchangeUserConfiguration
-    include Viewpoint::EWS::SOAP
+module Viewpoint
+  module EWS
+    module SOAP
+      # Exchange User Configuration operations as listed in the EWS Documentation.
+      # @see http://msdn.microsoft.com/en-us/library/bb409286.aspx
+      module ExchangeUserConfiguration
+        include Viewpoint::EWS::SOAP
 
-    # The GetUserConfiguration operation gets a user configuration object from
-    # a folder.
-    # @see http://msdn.microsoft.com/en-us/library/aa563465.aspx
-    # @param [Hash] opts
-    # @option opts [Hash] :user_config_name 
-    # @option opts [String] :user_config_props
-    def get_user_configuration(opts)
-      opts = opts.clone
-      [:user_config_name, :user_config_props].each do |k|
-        validate_param(opts, k, true)
-      end
-      req = build_soap! do |type, builder|
-        if(type == :header)
-        else
-        builder.nbuild.GetUserConfiguration {|x|
-          x.parent.default_namespace = @default_ns
-          builder.user_configuration_name!(opts[:user_config_name])
-          builder.user_configuration_properties!(opts[:user_config_props])
-        }
+        # The GetUserConfiguration operation gets a user configuration object from
+        # a folder.
+        # @see http://msdn.microsoft.com/en-us/library/aa563465.aspx
+        # @param [Hash] opts
+        # @option opts [Hash] :user_config_name
+        # @option opts [String] :user_config_props
+        def get_user_configuration(opts)
+          opts = opts.clone
+          %i[user_config_name user_config_props].each do |k|
+            validate_param(opts, k, true)
+          end
+          req = build_soap! { |type, builder|
+            unless type == :header
+              builder.nbuild.GetUserConfiguration { |x|
+                x.parent.default_namespace = @default_ns
+                builder.user_configuration_name!(opts[:user_config_name])
+                builder.user_configuration_properties!(opts[:user_config_props])
+              }
+            end
+          }
+          do_soap_request(req, response_class: EwsSoapAvailabilityResponse)
         end
       end
-      do_soap_request(req, response_class: EwsSoapAvailabilityResponse)
     end
-
-  end #ExchangeUserConfiguration
+  end
 end