stxt-viewpoint 1.0.0.beta.3

data/lib/ews/message_accessors.rb

@@ -0,0 +1,93 @@
+=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 [Array] :extended_properties An array of extended properties
+  #   [{extended_field_uri: {epros}, value: <val>}] or values: [<val>, <val>]
+  # @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 or Tempfile objects
+  # @option opts [Array<File>] :inline_attachments an Array of Inline File or Tempfile 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) or f.kind_of?(Tempfile)
+        resp.add_file_attachment(f)
+      end
+      msg.inline_attachments.each do |f|
+        next unless f.kind_of?(File) or f.kind_of?(Tempfile)
+        resp.add_inline_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/room_accessors.rb

@@ -0,0 +1,48 @@
+=begin
+  This file is part of Viewpoint; the Ruby library for Microsoft Exchange Web Services.
+
+  Copyright © 2013 Camille Baldock <viewpoint@camillebaldock.co.uk>
+
+  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::RoomAccessors
+  include Viewpoint::EWS
+
+  # Gets the rooms that are available within the specified room distribution list
+  # @see http://msdn.microsoft.com/en-us/library/dd899415.aspx
+  # @param [String] roomDistributionList
+  def get_rooms(roomDistributionList)
+    resp = ews.get_rooms(roomDistributionList)
+    get_rooms_parser(resp)
+  end
+
+  def room_name( room )
+    room[:room][:elems][:id][:elems][0][:name][:text]
+  end
+
+  def room_email( room )
+    room[:room][:elems][:id][:elems][1][:email_address][:text]
+  end
+
+  private
+
+  def get_rooms_parser(resp)
+    if resp.success?
+      resp
+    else
+      raise EwsError, "GetRooms produced an error: #{resp.code}: #{resp.message}"
+    end
+  end
+
+end # Viewpoint::EWS::RoomAccessors

data/lib/ews/roomlist_accessors.rb

@@ -0,0 +1,47 @@
+=begin
+  This file is part of Viewpoint; the Ruby library for Microsoft Exchange Web Services.
+
+  Copyright © 2013 Camille Baldock <viewpoint@camillebaldock.co.uk>
+
+  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::RoomlistAccessors
+  include Viewpoint::EWS
+
+  # Gets the room lists that are available within the Exchange organization.
+  # @see http://msdn.microsoft.com/en-us/library/dd899416.aspx
+  def get_room_lists
+    resp = ews.get_room_lists
+    get_room_lists_parser(resp)
+  end
+
+  def roomlist_name( roomlist )
+    roomlist[:address][:elems][:name][:text]
+  end
+
+  def roomlist_email( roomlist )
+    roomlist[:address][:elems][:email_address][:text]
+  end
+
+  private
+
+  def get_room_lists_parser(resp)
+    if resp.success?
+      resp
+    else
+      raise EwsError, "GetRoomLists produced an error: #{resp.code}: #{resp.message}"
+    end
+  end
+
+end # Viewpoint::EWS::RoomlistAccessors