1 This is excorporate.info, produced by makeinfo version 6.0 from
4 Copyright (C) 2016 Free Software Foundation, Inc.
6 Permission is granted to copy, distribute and/or modify this
7 document under the terms of the GNU Free Documentation License,
8 Version 1.2 or any later version published by the Free Software
9 Foundation; with no Invariant Sections, with the Front-Cover, or
10 Back-Cover Texts. A copy of the license is included in the section
11 entitled "GNU Free Documentation License" in the Emacs manual.
13 This document is part of a collection distributed under the GNU
14 Free Documentation License. If you want to distribute this
15 document separately from the collection, you can do so by adding a
16 copy of the license to the document, as described in section 6 of
19 All Emacs Lisp code contained in this document may be used,
20 distributed, and modified without restriction.
21 INFO-DIR-SECTION Emacs
23 * Excorporate: (excorporate). Exchange Web Services integration for Emacs.
27 File: excorporate.info, Node: Top, Next: Installation, Up: (dir)
32 Excorporate provides Exchange Web Services (EWS) support for Emacs.
34 If the Exchange server you access is configured to provide EWS
35 support, then there's a 76% chance that Excorporate will enable you to
36 retrieve your calendar entries from the comfort of Emacs.
38 The 24% failure rate is because accessing - in particular,
39 authenticating against - an Exchange server can be challenging.
41 Known to fail are Kerberos/GSSAPI authentication and accessing the
42 server through a proxy
43 (<https://debbugs.gnu.org/cgi/bugreport.cgi?bug=10>).
45 Patches are welcome to enable more of these access scenarios.
49 * Installation:: Getting and installing 'excorporate'.
50 * Configuration:: Configuring 'excorporate'.
51 * Usage:: Using 'excorporate'.
52 * Troubleshooting:: Debugging why a connection failed
55 File: excorporate.info, Node: Installation, Next: Configuration, Prev: Top, Up: Top
60 Excorporate works on Emacs versions >= 24.1.
62 Install 'excorporate' from the GNU ELPA repository:
64 'M-x package-install RET excorporate'
67 File: excorporate.info, Node: Configuration, Next: Usage, Prev: Installation, Up: Top
72 Ideally you won't need to configure Excorporate at all. On friendly
73 Exchange setups, Excorporate can discover the EWS URL automatically.
79 which will prompt you for the Exchange account email address. Follow
80 the prompts and if all goes well, you'll see a message in the minibuffer
81 or in *Messages* saying that the connection is ready.
83 If autodiscovery runs out of URLs to try, then customize
84 'excorporate-configuration':
86 'M-x customize-variable RET excorporate-configuration'
88 From the value menu select "Skip autodiscovery". This allows you to
89 enter the Exchange account email address and the EWS URL directly. The
90 EWS URL is of the form 'https://mail.gnu.org/ews/exchange.asmx'.
92 After saving the configuration, try 'M-x excorporate' again.
94 If that doesn't work, then you're probably out of luck, or you'll
95 have to start a troubleshooting deep dive (*note Troubleshooting::).
98 File: excorporate.info, Node: Usage, Next: Troubleshooting, Prev: Configuration, Up: Top
103 Excorporate binds 'e' in '*Calendar*' buffers. Open the calendar with:
107 move the cursor to the date you want to see meetings for, and press 'e'.
108 This will show the meetings in a temporary read-only Org Mode buffer
109 named '*Excorporate*'.
112 File: excorporate.info, Node: Troubleshooting, Prev: Usage, Up: Top
117 First, you'll want to double-check that the Exchange server you're
118 trying to access provides EWS support. If it doesn't, Excorporate can't
119 do anything for you. Before asking your Exchange administrator, check
120 intranet wikis and so forth; other users of non-standard clients may
121 have already found the EWS URL.
123 The buffer '*fsm-debug*' shows 'excorporate' state transitions and
124 should provide details of where things went wrong.
126 Also check '*Messages*' for anything obvious.
128 If you suspect something wrong with accessing the EWS URL, try
129 setting 'url-debug' to t and retry 'M-x excorporate', then check the
130 '*URL-DEBUG*' buffer for output.
132 If you suspect NTLM authentication is failing, as a long shot, you
133 might try setting 'ntlm-compatibility-level' to 0 and retrying 'M-x
136 Excorporate's dependencies implement the tricky elements of
137 asynchronous Exchange access: a state machine ('fsm'), TLS negotiation
138 ('gnutls'), NTLM authentication ('ntlm' and 'url-http-ntlm') and SOAP
139 communication ('soap-client').
145 Node: Installation
\7f2077
146 Node: Configuration
\7f2340
148 Node: Troubleshooting
\7f3771