Skip to content
Newer
Older
100644 70 lines (53 sloc) 1.61 KB
0bf1fca @ebeigarts Initial commit
authored Oct 7, 2010
1 Exchanger
2 =========
3
4 Ruby library for accessing Microsoft Exchange using Exchange Web Services.
5 This library tries to make creating and updating items as easy as possible.
6 It will keep track of changed properties and will update only them.
7
8 Supported operations
9 ====================
10
0c7d0ee @ebeigarts Added DeleteItem operation
authored Mar 15, 2011
11 * FindItem, GetItem, CreateItem, UpdateItem, DeleteItem
0bf1fca @ebeigarts Initial commit
authored Oct 7, 2010
12 * FindFolder, GetFolder
71a17b7 @ebeigarts Updated README.md
authored Jan 5, 2011
13 * ResolveNames, ExpandDL
54334f8 @ebeigarts Adding GetUserAvailability to README
authored May 29, 2012
14 * GetUserAvailability
0bf1fca @ebeigarts Initial commit
authored Oct 7, 2010
15
16 Installing
17 ==========
18
1f4b51e @ebeigarts Improved documentation
authored Aug 9, 2011
19 ```bash
20 gem install exchanger
21 ```
0bf1fca @ebeigarts Initial commit
authored Oct 7, 2010
22
23 Configuration
24 =============
25
1f4b51e @ebeigarts Improved documentation
authored Aug 9, 2011
26 ```ruby
27 Exchanger.configure do |config|
28 config.endpoint = "https://domain.com/EWS/Exchanger.asmx"
29 config.username = "username"
30 config.password = "password"
31 end
32 ```
0bf1fca @ebeigarts Initial commit
authored Oct 7, 2010
33
34 or configure from YAML
35
1f4b51e @ebeigarts Improved documentation
authored Aug 9, 2011
36 ```ruby
37 Exchanger::Config.instance.from_hash(YAML.load_file("#{Rails.root}/config/exchanger.yml")[Rails.env])
38 ```
0bf1fca @ebeigarts Initial commit
authored Oct 7, 2010
39
40 Examples
41 ========
42
43 Creating and updating contacts
44 ------------------------------
45
1f4b51e @ebeigarts Improved documentation
authored Aug 9, 2011
46 ```ruby
47 folder = Exchanger::Folder.find(:contacts)
48 contact = folder.new_contact
49 contact.given_name = "Edgars"
50 contact.surname = "Beigarts"
51 contact.email_addresses = [ Exchanger::EmailAddress.new(:key => "EmailAddress1", :text => "me@example.com") ]
52 contact.phone_numbers = [ Exchanger::PhoneNumber.new(:key => "MobilePhone", :text => "+371 80000000") ]
53 contact.save # CreateItem operation
54 contact.company_name = "Example Inc."
55 contact.save # UpdateItem operation
56 contact.destroy # DeleteItem operation
57 ```
0bf1fca @ebeigarts Initial commit
authored Oct 7, 2010
58
71a17b7 @ebeigarts Updated README.md
authored Jan 5, 2011
59 Searching in Global Address Book
60 --------------------------------
61
1f4b51e @ebeigarts Improved documentation
authored Aug 9, 2011
62 ```ruby
63 mailboxes = Exchanger::Mailbox.search("John")
64 ```
71a17b7 @ebeigarts Updated README.md
authored Jan 5, 2011
65
0bf1fca @ebeigarts Initial commit
authored Oct 7, 2010
66 Alternatives
67 ============
68
c0e0f43 @ebeigarts Edited README.md via GitHub
authored Oct 13, 2011
69 * [Exchange Clients in Ruby Toolbox](https://www.ruby-toolbox.com/categories/Exchange_Clients)
Something went wrong with that request. Please try again.