viewpoint 0.0.5 → 0.1.0

data/lib/viewpoint/calendar_item.rb

@@ -1,118 +0,0 @@
-#############################################################################
-# Copyright © 2009 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/>.
-#############################################################################
-$:.unshift(File.dirname(__FILE__))
-require 'rubygems'
-require 'icalendar'
-require 'item'
-
-class Viewpoint::CalendarItem < Viewpoint::Item
-	include Viewpoint
-
-  attr_reader :subject, :organizer, :location, :start, :end, :cal_item_type
-
-	# Initialize an Exchange Web Services item
-	def initialize(ews_item, parent_folder)
-    raise InvalidEWSItemError if ews_item.nil?
-
-		@subject = ews_item.subject # String
-		@location = ews_item.location if ews_item.location
-		@cal_item_type = ews_item.calendarItemType
-		@organizer = ews_item.organizer.mailbox.name if ews_item.organizer and ews_item.organizer.mailbox # String
-		@start = ews_item.start if ews_item.start # DateTime
-		@end = ews_item.v_end if ews_item.v_end # DateTime
-		@busy_status = ews_item.legacyFreeBusyStatus if ews_item.legacyFreeBusyStatus # String
-		@date_time_recieved = ews_item.dateTimeReceived if ews_item.dateTimeReceived # DateTime
-
-		# This is where the event object gets loaded if it
-		# is requested.  Think of it like IMAP downloading the
-		# body when the message is viewed.
-		@message = nil
-
-		super(ews_item, parent_folder)
-	end
-
-
-  def body
-		get_calitem if @message == nil
-    @message.body
-  end
-
-  def sender
-    @organizer
-  end
-
-
-	# Convert item to iCal format: http://www.ietf.org/rfc/rfc2445.txt
-	# Returns Icalendar::Event object
-	def to_ical_event
-		get_calitem if @message == nil
-		iev = Icalendar::Event.new
-		iev.uid = @message.uID
-		unless(@message.organizer == nil)
-			iev.organizer = "CN=\"#{@message.organizer.mailbox.name}\"" if @message.organizer.mailbox.name
-			iev.organizer += ":MAILTO:#{@message.organizer.mailbox.emailAddress}" if @message.organizer.mailbox.emailAddress
-		end
-		# TODO: Handle EWS Timezones better.  TZ_HASH in viewpoint.rb is the start of this
-		require 'time'
-		#tzoffset = @message.timeZone.sub(/^\(GMT([^\)]+)\).*$/,'\1')
-		dtstart = Time.at(@message.start.strftime('%s').to_i)
-		dtend   = Time.at(@message.v_end.strftime('%s').to_i)
-		dtstamp = Time.at(@message.dateTimeStamp.strftime('%s').to_i)
-		last_modified = Time.at(@message.lastModifiedTime.strftime('%s').to_i)
-		timestr = "%Y%m%dT%H%M%S"
-		iev.dtstart = dtstart.strftime(timestr)
-		iev.dtend   = dtend.strftime(timestr)
-		iev.tzid    = dtstart.strftime('%Z')
-		iev.dtstamp = dtstamp.strftime(timestr)
-		iev.last_modified = last_modified.strftime(timestr)
-		iev.location = @message.location if @message.location
-		iev.klass = @message.sensitivity if @message.sensitivity
-		iev.summary = @message.subject if @message.subject
-		iev.description = @message.body if @message.body
-		iev.transp = @message.legacyFreeBusyStatus if @message.legacyFreeBusyStatus
-		iev.duration = @message.duration if @message.duration
-		iev.sequence = @message.appointmentSequenceNumber if @message.appointmentSequenceNumber
-		iev.status = @message.myResponseType if @message.myResponseType
-		#iev.attach @message.attachments if @message.hasAttachments
-		@message.requiredAttendees.each do |pers|
-			output =  "ROLE=REQ-PARTICIPANT;CN=\"#{pers.mailbox.name}\"" if pers.mailbox.respond_to?(:name)
-			output += ":MAILTO:#{pers.mailbox.emailAddress}" if pers.mailbox.respond_to?(:emailAddress)
-			iev.attendees << output if output
-		end if @message.requiredAttendees
-		@message.optionalAttendees.each do |pers|
-			output =  "ROLE=OPT-PARTICIPANT;CN=\"#{pers.mailbox.name}\"" if pers.mailbox.respond_to?(:name)
-			output += ":MAILTO:#{pers.mailbox.emailAddress}" if pers.mailbox.respond_to?(:emailAddress)
-			iev.attendees << output if output
-		end if @message.optionalAttendees
-
-		#iev.categories = @message.categories if @message.categories
-		#iev.resources  = @message.resources if @message.resources
-		return iev
-	end
-
-
-	# These methods are marked 'private' because they return EWS Types and I am trying to 
-	# hide those because they are not elegant and a bit too tedious for the public interface.
-	private
-
-	def get_calitem
-		@message = @parent_folder.get_item(@item_id)
-	end
-end

data/lib/viewpoint/exchange_headers.rb

@@ -1,49 +0,0 @@
-#############################################################################
-# Copyright © 2009 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 'rubygems'
-gem 'soap4r'
-require 'soap/header/simplehandler'
-
-
-# Some functionality of EWS depends on setting the "RequestServerVersion"
-# element with a specified "Version" attribute.  That is all this class
-# is doing.
-# It is used during the initial connection process by setting the
-# headerhandler in the serivce binding.
-# *<tt>@exchange.headerhandler << ExchangeHeaders.new</tt>
-class Viewpoint::ExchangeHeaders < SOAP::Header::SimpleHandler
-	NAMESPACE = 'http://schemas.microsoft.com/exchange/services/2006/types'
-
-	def initialize
-		@qname = XSD::QName.new(NAMESPACE,"RequestServerVersion")
-		super(@qname)
-	end
-
-	def on_simple_outbound
-		{
-		"xmlattr_Version" => "Exchange2007_SP1"
-		}
-	end
-
-	def on_outbound
-    	h = on_simple_outbound
-    	h ? SOAP::SOAPElement.from_obj(h, nil) : nil
-  	end
-end

data/lib/viewpoint/exchwebserv.rb

@@ -1,236 +0,0 @@
-#############################################################################
-# Copyright © 2009 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/>.
-#############################################################################
-$:.unshift(File.dirname(__FILE__))
-require 'rubygems'
-require 'singleton'
-require 'wsdl/exchangeServiceBinding'
-# --- Custom libs ---
-require 'exchange_headers'
-# --- Folder Types ---
-require 'folder'
-require 'calendar'
-require 'mail'
-
-# This class will act as the controller for a client connection to the
-# Exchange web service.
-class Viewpoint::ExchWebServ
-	include Viewpoint
-	include Singleton
-
-	attr_reader :ews, :user, :authenticated, :email
-
-	def initialize
-		@authenticated = false
-		@user = nil
-		@pass = nil
-		@email = nil
-		@ews_endpoint  = nil
-
-		# Connection to Exchange web services.
-		# You can get fetch this from an accessor later.
-		@ews  = nil
-
-		# Stores folders returned from 'find_folders'
-		@folders = {}
-
-		# Do initial authentication
-		#do_auth
-	end
-
-
-	# Finds all folders and returns a hash of FolderTypes
-	def find_folders
-		ff = FindFolderType.new()
-		ff.xmlattr_Traversal = FolderQueryTraversalType::Deep
-		ff.folderShape = FolderResponseShapeType.new( DefaultShapeNamesType::AllProperties )
-		fid = NonEmptyArrayOfBaseFolderIdsType.new()
-		fidt = DistinguishedFolderIdType.new
-		fidt.xmlattr_Id = DistinguishedFolderIdNameType::Root
-		fid.distinguishedFolderId = fidt
-		ff.parentFolderIds = fid
-
-		# FindFolderResponseType
-		resp = @ews.findFolder(ff)
-
-		# ArrayOfResponseMessagesType
-		msgs = resp.responseMessages
-
-		# Array of FindFolderResponseMessageType
-		msgs.findFolderResponseMessage.each do |elem|
-			# Mail Folders
-			mail_folders = {}
-			elem.rootFolder.folders.folder.each do |folder|
-				if( folder.folderClass != nil)
-					mail_folders[folder.displayName] = MailFolder.new(folder)
-				end
-			end
-			@folders['MailFolder'] = mail_folders
-
-			# CalendarFolderType
-			cal_folders = {}
-			elem.rootFolder.folders.calendarFolder.each do |folder|
-				cal_folders[folder.displayName] = CalendarFolder.new(folder)
-			end
-			@folders['CalendarFolder'] = cal_folders
-
-			#elem.rootFolder.folders.contactsFolder.each do |folder|
-			#end
-			#elem.rootFolder.folders.searchFolder.each do |folder|
-			#end
-			#elem.rootFolder.folders.tasksFolder.each do |folder|
-			#end
-		end
-		return @folders
-	end
-
-	# Return folder
-	# The default is to return a folder that is a subclass of Folder from the
-	# SqliteDB, but if fetch_from_ews is set to true it will go out and return
-	# the FolderType object from EWS.
-	# Parameters:
-	# 	folder_ids: NonEmptyArrayOfBaseFolderIdsType or String if fetch_from_ews is not set
-	# 	fetch_from_ews: boolean
-	# 	folder_shape: DefaultShapeNamesType
-	def get_folder(folder_ids, fetch_from_ews = false, folder_shape = DefaultShapeNamesType::AllProperties)
-		unless fetch_from_ews
-			return @folders['MailFolder'][folder_ids] ||
-				@folders['CalendarFolder'][folder_ids]
-		end
-
-		folder_shape = FolderResponseShapeType.new( folder_shape )
-		get_folder = GetFolderType.new(folder_shape, folder_ids)
-		
-		resp = @ews.getFolder(get_folder).responseMessages.getFolderResponseMessage[0].folders.folder[0]
-	end
-
-	# Parameters:
-	# 	display_name: String
-	# 	fetch_from_ews: boolean
-	# 	folder_shape: DefaultShapeNamesType
-	def get_folder_by_name(display_name, fetch_from_ews = true, folder_shape = DefaultShapeNamesType::AllProperties)
-		#folder_ids = NonEmptyArrayOfBaseFolderIdsType.new()
-		dist_name = DistinguishedFolderIdType.new
-		dist_name.xmlattr_Id = DistinguishedFolderIdNameType.new(display_name.downcase)
-		#folder_ids.distinguishedFolderId = dist_name
-		folder_ids = NonEmptyArrayOfBaseFolderIdsType.new(nil, [dist_name])
-
-		get_folder(folder_ids, true, folder_shape)
-	end
-
-	# Parameters:
-	# 	folder_id: String
-	# 	change_key: String
-	# 	folder_shape: DefaultShapeNamesType
-	def get_folder_by_id(folder_id, change_key = nil, fetch_from_ews = true, folder_shape = DefaultShapeNamesType::AllProperties)
-		folder_ids = NonEmptyArrayOfBaseFolderIdsType.new()
-		folder_id_t = FolderIdType.new
-		folder_id_t.xmlattr_Id = folder_id
-		folder_id_t.xmlattr_ChangeKey = change_key unless change_key == nil
-		folder_ids.folderId = folder_id
-		folder_ids = NonEmptyArrayOfBaseFolderIdsType.new([folder_id_t], nil)
-
-		get_folder(folder_ids, true, folder_shape)
-	end
-
-	def get_mail_folders
-		return @folders['MailFolder']
-	end
-
-	def get_calendar_folders
-		return @folders['CalendarFolder']
-	end
-
-	def authenticate(user = nil, pass = nil, endpoint = nil)
-		unless @authenticated
-			@user = user
-			@pass = pass
-			@ews_endpoint = endpoint
-			do_auth unless @authenticated
-		end
-		@authenticated
-	end
-
-
-	# Resolve a Contact name.
-	# More info: http://msdn.microsoft.com/en-us/library/aa563518.aspx
-	def resolve_name(unresolved_entry, full_contact_data = false)
-		rn_t = ResolveNamesType.new(nil,unresolved_entry)
-		rn_t.xmlattr_ReturnFullContactData = full_contact_data
-		ews.resolveNames(rn_t).responseMessages.resolveNamesResponseMessage.first
-	end
-
-	private
-	def do_auth
-		retry_count = 0
-		begin
-			if( File.exists?("#{ENV['HOME']}/.viewpointrc") )
-				props = SOAP::Property.load(File.new("#{ENV['HOME']}/.viewpointrc"))
-				@user = props['exchange.ews.user'] if @user == nil
-				@pass = props['exchange.ews.pass'] if @pass == nil
-				@ews_endpoint = props['exchange.ews.endpoint'] if @ews_endpoint == nil
-			elsif( File.exists?("#{File.dirname(__FILE__)}/soap/viewpoint.conf") )
-				props = SOAP::Property.load(File.new("#{File.dirname(__FILE__)}/soap/viewpoint.conf"))
-				@user = props['exchange.ews.user'] if @user == nil
-				@pass = props['exchange.ews.pass'] if @pass == nil
-				@ews_endpoint = props['exchange.ews.endpoint'] if @ews_endpoint == nil
-			elsif(@ews_endpoint == nil && @user == nil && @pass == nil)
-				require 'highline/import'
-				@ews_endpoint  = ask("Exchange EWS Endpoint:  ") { |q| q.echo = true }
-				@user = ask("User:  ") { |q| q.echo = true }
-				@pass = ask("Pass:  ") { |q| q.echo = "*"}
-			else
-				# Nothing to do
-			end
-
-			@ews = ExchangeServiceBinding.new(@ews_endpoint)
-			@ews.options["protocol.http.auth.ntlm"] = [@ews_endpoint.sub(/\/[^\/]+$/,'/'),@user,@pass]
-			@ews.headerhandler << ExchangeHeaders.new
-
-			# Log SOAP request and response for debugging.  Run ruby with the '-d' option.
-			if($DEBUG) then
-				@ews.wiredump_file_base = "viewpoint-soaplog"
-			end
-
-			# Do a ResolveNames operation to make sure that authentication works.
-			# If you don't do an operation, you won't find out that bad credentials
-			# were entered until later.  The ResolveNames operation is completely
-			# arbitrary and could be any EWS call.
-			# http://msdn.microsoft.com/en-us/library/bb409286.aspx
-			resp = resolve_name(@user + '@')
-			# Set email while we're at it
-			@email = resp.resolutionSet.resolution.first.mailbox.emailAddress
-
-		rescue SOAP::HTTPStreamError
-			puts "Bad Login!  Try Again."
-			if( retry_count < 2)
-				retry_count += 1
-				retry
-			else
-				puts "-----------------------------------------------------------"
-				puts "Could not log into Exchange Web Services.  Make sure your information is correct"
-				puts "End Point: #{@ews_endpoint}"
-				puts "User: #{@user}"
-				puts "-----------------------------------------------------------"
-				return
-			end
-		end
-		@authenticated = true
-	end
-end

data/lib/viewpoint/folder.rb

@@ -1,358 +0,0 @@
-#############################################################################
-# Copyright © 2009 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 'rubygems'
-
-# This class is inherited by all folder subtypes such as Mail, Calendar,
-# Tasks and Search.  It will serve as the brain for all of the methods that
-# each of these folder types have in common.
-class Viewpoint::Folder
-	include Viewpoint
-
-	attr_accessor :folder_id, :parent_id, :display_name
-	def initialize(folder)
-		@folder_id = folder.folderId.xmlattr_Id
-		@parent_id = folder.parentFolderId.xmlattr_Id unless folder.parentFolderId == nil
-		@display_name = folder.displayName
-		@sync_state = nil
-		@subscription_id = nil
-		@watermark = nil
-	end
-
-	# Subscribe to folder and save the subscription_id into the database.  Subsequent calls
-	# to check_subscription will use that id.
-	# Returns true if the operation is successful, false otherwise
-	def subscribe
-		# Refresh the subscription if already subscribed
-		if( subscribed? )
-			unsubscribe
-		end
-		subscribe = SubscribeType.new
-		pull = PullSubscriptionRequestType.new
-
-		# Set-up folder Id
-		f_id_t = FolderIdType.new
-		f_id_t.xmlattr_Id = @folder_id
-		f_ids = NonEmptyArrayOfBaseFolderIdsType.new([f_id_t],nil)
-		pull.folderIds = f_ids
-
-		# Set-up event types
-		event_types = NonEmptyArrayOfNotificationEventTypesType.new
-		event_types.push(NotificationEventTypeType::CopiedEvent)
-		event_types.push(NotificationEventTypeType::CreatedEvent)
-		event_types.push(NotificationEventTypeType::DeletedEvent)
-		event_types.push(NotificationEventTypeType::ModifiedEvent)
-		event_types.push(NotificationEventTypeType::MovedEvent)
-		event_types.push(NotificationEventTypeType::NewMailEvent)
-		pull.eventTypes = event_types
-
-		pull.timeout = 10
-
-		subscribe.pullSubscriptionRequest = pull
-		
-		resp = ExchWebServ.instance.ews.subscribe(subscribe).responseMessages.subscribeResponseMessage.first
-		@subscription_id = resp.subscriptionId
-		@watermark = resp.watermark
-
-		return (resp.responseCode == "NoError")? true: false
-	end
-
-	def subscribed?
-			( @subscription_id.nil? or @watermark.nil? )? false : true
-	end
-
-
-	# unsubscribe from folder
-	# Returns true if unsubscription succeeds, false otherwise
-	def unsubscribe
-		begin
-			if( @subscription_id == nil ) then
-				return true
-			end
-
-			unsub_t = UnsubscribeType.new(@subscription_id)
-			resp = ExchWebServ.instance.ews.unsubscribe(unsub_t).responseMessages.unsubscribeResponseMessage.first
-
-			return (resp.responseCode == "NoError")? true: false
-		end
-	end
-
-
-	# Fetch events with the subscription_id.  If one does not exists or is expired,
-	# call subscribe.
-  # Returns a hash with the event type as the key and an Array of Hashes that
-  # represent each event's data
-  # An :error key is set if there is a problem
-	def check_subscription
-		begin
-			if( @subscription_id == nil or @watermark == nil) then
-				self.subscribe
-			end
-			ge = GetEventsType.new(@subscription_id, @watermark)
-
-			resp = ExchWebServ.instance.ews.getEvents(ge).responseMessages.getEventsResponseMessage
-
-			#TODO:  Add more event processing
-			
-
-			notifications = resp.first.notification
-
-      notif_hash = {}
-			# Process Notifications
-			if( notifications.copiedEvent != nil)
-        notif_hash[:copiedEvent] = []
-				notifications.copiedEvent.each do |note|
-					@watermark = note.watermark
-          item = {}
-          item.store(:old_item_id,note.oldItemId.xmlattr_Id) if note.itemId
-          item.store(:old_folder_id,note.oldParentFolderId.xmlattr_Id) if note.oldParentFolderId
-          item.store(:item_id,note.itemId.xmlattr_Id) if note.itemId
-          item.store(:folder_id,note.parentFolderId.xmlattr_Id) if note.parentFolderId
-          notif_hash[:copiedEvent] << item
-				end
-			end
-
-			if( notifications.createdEvent != nil)
-        notif_hash[:createdEvent] = []
-				notifications.createdEvent.each do |note|
-					@watermark = note.watermark
-          item = {}
-          item.store(:item_id,note.itemId.xmlattr_Id) if note.itemId
-          item.store(:folder_id,note.parentFolderId.xmlattr_Id) if note.parentFolderId
-          notif_hash[:createdEvent] << item
-				end
-			end
-
-			if( notifications.deletedEvent != nil)
-        notif_hash[:deletedEvent] = []
-				notifications.deletedEvent.each do |note|
-					@watermark = note.watermark
-          item = {}
-          item.store(:item_id,note.itemId.xmlattr_Id) if note.itemId
-          item.store(:folder_id,note.parentFolderId.xmlattr_Id) if note.parentFolderId
-          notif_hash[:deletedEvent] << item
-				end
-			end
-
-			if( notifications.modifiedEvent != nil)
-        notif_hash[:modifiedEvent] = []
-				notifications.modifiedEvent.each do |note|
-					@watermark = note.watermark
-          item = {}
-          item.store(:item_id,note.itemId.xmlattr_Id) if note.itemId
-          item.store(:folder_id,note.folderId.xmlattr_Id) if note.folderId
-          item.store(:parent_folder_id,note.parentFolderId.xmlattr_Id) if note.parentFolderId
-          item.store(:unreadCount,note.unreadCount)
-          notif_hash[:modifiedEvent] << item
-				end
-			end
-
-			if( notifications.movedEvent != nil)
-        notif_hash[:movedEvent] = []
-				notifications.movedEvent.each do |note|
-					@watermark = note.watermark
-          item = {}
-          item.store(:old_item_id,note.oldItemId.xmlattr_Id) if note.oldItemId
-          item.store(:old_folder_id,note.oldParentFolderId.xmlattr_Id) if note.oldParentFolderId
-          item.store(:item_id,note.itemId.xmlattr_Id) if note.itemId
-          item.store(:folder_id,note.parentFolderId.xmlattr_Id) if note.parentFolderId
-          notif_hash[:movedEvent] << item
-				end
-			end
-
-			if( notifications.newMailEvent!= nil)
-        notif_hash[:newMailEvent] = []
-				notifications.newMailEvent.each do |note|
-					@watermark = note.watermark
-          item = {}
-          item.store(:item_id,note.itemId.xmlattr_Id) if note.itemId
-          item.store(:folder_id,note.parentFolderId.xmlattr_Id) if note.parentFolderId
-          notif_hash[:newMailEvent] << item
-				end
-			end
-
-			if( notifications.statusEvent != nil)
-				notifications.statusEvent.each do |note|
-					@watermark = note.watermark
-				end
-			end
-
-    rescue NoMethodError
-      # This ocurrs if something bad happened to the subscription.
-      # This is handled by resubscribing to the subscription and returning
-      # an error key.
-      self.subscribe
-      return {:error => "Something bad happened to your subscription.  You have been re-subscribed" }
-		end
-
-		#return resp
-    notif_hash[:resp] = resp
-		return notif_hash
-	end
-
-
-	# This is a proxy for the SyncFolderItems operation detailed here: http://msdn.microsoft.com/en-us/library/aa563967.aspx
-	# It returns a SyncFolderItemsResponseType object
-	def sync_folder(max_items = 256)
-		begin
-			# ItemResponseShapeType
-			itemshapeT = ItemResponseShapeType.new(DefaultShapeNamesType::IdOnly, false)
- 
-			# TargetFolderIdType
-			tfolderidT = TargetFolderIdType.new
-			folderidT = FolderIdType.new
-			folderidT.xmlattr_Id = self.folder_id
-			tfolderidT.folderId = folderidT
-
-			# SyncFolderItemsType
-			syncitemsT = SyncFolderItemsType.new(itemshapeT,tfolderidT,self.sync_state,nil,max_items)
-
-			# Call Sync => returns SyncFolderItemsResponseType
-			resp = ExchWebServ.instance.ews.syncFolderItems(syncitemsT).responseMessages.syncFolderItemsResponseMessage[0]
-			@sync_state = resp.syncState
-			return resp
-		rescue
-			puts "** Something happened during synchronizing folder => #{self.display_name}"
-			raise
-		end
-	end
-
-
-	# Wrapper around EWS's FindItem method:  http://msdn.microsoft.com/en-us/library/aa566107.aspx
-	# The specifics of this method should be set up in the child classes and then this method should
-	# be called with a parameter of FindItemType:  http://msdn.microsoft.com/en-us/library/aa566370.aspx
-	# This allows for a central place of error handling.  See Calendar::get_events for an example
-	# of how this works.
-	def find_items(find_item_t)
-		# FindItemResponseMessageType: http://msdn.microsoft.com/en-us/library/aa566424.aspx
-		resp = ExchWebServ.instance.ews.findItem(find_item_t).responseMessages.findItemResponseMessage[0]
-
-		#TODO: Error handling
-		if resp.xmlattr_ResponseClass == "Success"
-			return resp
-		else
-			return nil
-		end
-	end
-
-
-	# Fetch item by item_id
-	# Params: item_id: ItemIdType
-	#         item_type: String (message, calendarItem)
-	#         all_props: boolean; default is to get just the Default props
-	# Returns:  a Item type of some sort ( depends on 'item_type' parameter )
-	def get_item(item_id, item_type = nil, all_props = false)
-		get_item = GetItemType.new
-
-		if all_props
-			shape_name = DefaultShapeNamesType::AllProperties
-		else
-			shape_name = DefaultShapeNamesType::Default
-		end
-
-		item_shape = ItemResponseShapeType.new( shape_name, false, BodyTypeResponseType::Text )
-
-		#additional_props = NonEmptyArrayOfPathsToElementType.new
-		#prop_a = PathToUnindexedFieldType.new
-		#prop_b = PathToUnindexedFieldType.new
-		#prop_c = PathToUnindexedFieldType.new
-		#prop_d = PathToUnindexedFieldType.new
-		#prop_a.xmlattr_FieldURI = UnindexedFieldURIType::CalendarMeetingTimeZone
-		#prop_b.xmlattr_FieldURI = UnindexedFieldURIType.new("calendar:EndTimeZone")
-		#prop_c.xmlattr_FieldURI = UnindexedFieldURIType::ItemInternetMessageHeaders
-		#prop_d.xmlattr_FieldURI = UnindexedFieldURIType::MessageFrom
-		#additional_props.upath << prop_a
-		#additional_props.upath << prop_b
-		#additional_props.upath << prop_c
-		#additional_props << prop_d
-		#item_shape.additionalProperties = additional_props
-
-
-		
-		item_id_t = ItemIdType.new
-		item_id_t.xmlattr_Id = item_id
-		item_ids = NonEmptyArrayOfBaseItemIdsType.new([item_id_t])
-
-		get_item.itemShape = item_shape
-		get_item.itemIds= item_ids
-
-		# ItemInfoResponseMessageType: http://msdn.microsoft.com/en-us/library/aa565417.aspx
-		resp = ExchWebServ.instance.ews.getItem(get_item).responseMessages.getItemResponseMessage[0]
-
-		#TODO: Error handling
-		if resp.xmlattr_ResponseClass == "Success"
-			item = resp.items.send(item_type)
-			if( item.length > 1 )
-				puts "ERROR:  Item Id should only resolve to a single item!"
-			end
-			return item[0]
-		else
-			return nil
-		end
-	end
-
-
-	# More info: http://msdn.microsoft.com/en-us/library/aa565781.aspx
-	def move_item(item_id, new_folder)
-		return false unless new_folder.kind_of?(Viewpoint::Folder)
-
-		folder_id_t = FolderIdType.new
-		folder_id_t.xmlattr_Id =  new_folder.folder_id
-		target_folder_t = TargetFolderIdType.new(folder_id_t)
-
-		item_ids = NonEmptyArrayOfBaseItemIdsType.new
-		item_t = ItemIdType.new
-		item_t.xmlattr_Id = item_id
-		item_ids.itemId << item_t
-
-		move_t = MoveItemType.new(target_folder_t, item_ids)
-		resp = ExchWebServ.instance.ews.moveItem(move_t).responseMessages.moveItemResponseMessage.first
-		#TODO: Error handling
-		if resp.xmlattr_ResponseClass == "Success"
-			return true
-		else
-			return false
-		end
-	end
-
-	# Delete item by item_id
-	# More info: http://msdn.microsoft.com/en-us/library/aa580484.aspx
-	def delete_item(item_id, delete_type=DisposalType::HardDelete)
-		item_ids = NonEmptyArrayOfBaseItemIdsType.new
-		item = ItemIdType.new
-		item.xmlattr_Id = item_id
-		item_ids.itemId << item
-
-		delete = DeleteItemType.new(item_ids)
-		delete.xmlattr_DeleteType = delete_type
-		resp = ExchWebServ.instance.ews.deleteItem(delete).responseMessages.deleteItemResponseMessage.first
-
-		#TODO: Error handling
-		if resp.xmlattr_ResponseClass == "Success"
-			return true
-		else
-			return false
-		end
-	end
-
-	# Move item to Deleted Items folder instead of deleting it
-	def recycle_item(item_id)
-		delete_item(item_id, DisposalType::MoveToDeletedItems)
-	end
-end