/Viewpoint

A Ruby client access library for Microsoft Exchange Web Services (EWS)

Primary LanguageRubyGNU General Public License v3.0GPL-3.0

--------------------------------------------------------------------------
                   Viewpoint for Exchange Web Services
--------------------------------------------------------------------------
This program attempts to create a client access library for Exchange Web
Services (EWS) in Ruby.
--------------------------------------------------------------------------
TO USE:
require 'rubygems'
require 'viewpoint'
# See REQUIRED GEMS below

REQUIRED GEMS:

# Current SOAP4R ( http://dev.ctor.org/soap4r )
gem install -r soap4r
# NTLM isn't an automatic dependency so you may need this if you are having issues.
gem install -r rubyntlm


# iCalendar
gem install -r icalendar

CONFIGURATION:
Configure your user/pass and EWS endpoint in lib/soap/viewpoint.conf
or $HOME/.viewpointrc.  If the file $HOME/.viewpointrc exists it takes
presidence.  See the sample in lib/soap/viewpoint.conf for how this
file should be configured.


Running Examples:
To run the FuseFS example you need the 'fusefs' gem


******************** EXAMPLES *********************
# I will be posting examples to my blog:
#	http://distributed-frostbite.blogspot.com/
# In the following examples the following are used:
# "item" is a type of Viewpoint::Item
# "folder" is a type of Viewpoint::Folder
# "new_folder" is a type of Viewpoint::Folder

# === Convert your Exchange Calendar to a Icalendar::Calendar object ===
require 'rubygems'
require 'viewpoint'
vp = Viewpoint::ExchWebServ.instance
vp.authenticate
vp.find_folders
cal = vp.get_folder("Calendar")
ical = cal.to_ical
puts ical.to_ical

# === Get a listing of todays messages ===
# See test/test_client.rb

# === Moving an item ===
item.move_to!(new_folder)

# === Deleting an item ===
item.delete!
item.recycle!   # Move to "Deleted Items"


--------------------------------------------------------------------------
DISCLAIMER:  I am by no means a Ruby or EWS expert.  There may be better
means of doing what I am attempting to do.  If you see something that
could be done better or would like to help out in the development of this
code please feel free to clone the 'git' repository:
git clone git://github.com/zenchild/Viewpoint-for-MS-Exchange.git
or add an issue on GitHub:
http://github.com/zenchild/Viewpoint/issues
--------------------------------------------------------------------------