# KOrganizer workshop: Exchange Plugin

## Overview

The &korganizer; Exchange plugin allows you to access your calendar on an &Microsoft; Exchange® server from &korganizer;. You can import the appointments in a certain date range into your &korganizer; calendar, you can export appointments (one at a time) from your &korganizer; calendar to the Exchange server® and you can delete appointments (also one at a time) from the Exchange server®. The plugin uses the WebDAV protocol to access the Exchange server®.

## Requirements

- &korganizer; version 3.1 beta2 or later

- &Microsoft; Exchange Server 2000®

- On the Exchange Server®, Outlook Web Access needs to be enabled, since this also enables the WebDAV protocol

## Enabling the Exchange Plugin

The Exchange Plugin is disabled by default, so you need to enable the plugin by accessing Settings Configure Plugins from &korganizer;. You should see this dialog appear:

Enabling the Exchange Plugin

In this dialog, enable the &Microsoft; Exchange 2000 plugin for &korganizer; and click OK. This should enable a new Exchange menu in &korganizer;, as in the following screenshot:

Exchange menu

## Configuration

After the plugin is enabled, you should configure it. Choose Configure... from the Exchange menu. You should see this dialog appear:

Configuration

In this dialog, you need to fill in:

- the address of your Exchange server®, ⪚ `mail.mycompany.com`

- your account, or Exchange Mailbox, ⪚ `joe`. Do not put in your domain here!

- your password. If you fill in your password here, it is stored in encrypted format in `~/.kde/share/config/korganizerrc`

## Downloading Appointments

When you have configured the plugin, you can download events from your account on the Exchange server® into &korganizer;. Choose Download... from the Exchange menu. Now the following dialog will pop up:

Downloading Appointments

In this dialog you need to fill in the date range you want to download from the server. It defaults to the date range currently shown in &korganizer;'s main window. When you click OK, a progress dialog pops up:

Progress Dialog

The progress shown in this dialog does not correspond to the number of appointments downloaded, but to the total number of accesses to the Exchange server.

When download is finished, the downloaded appointments will show up in the &korganizer; main window.

## Uploading Appointments

You can upload appointments one at a time. First select an appointment in &korganizer; by clicking on it. Then choose Upload Event from the Exchange menu. A warning message pops up, which is only important if you overwrite an existing appointment on the Exchange server® with an edited version of the same appointment. If you click OK, your appointment will be uploaded to the Exchange server®.

## Deleting Appointments

You can delete appointments also one at a time. First select an appointment in &korganizer; by clicking on it. Then choose Delete Event from the Exchange menu. This also shows a warning message: `Deleting a single appointment from a list of recurrent appointments will delete all recurrences of the appointments`. If you are OK with this, the appointment is deleted from the server and from the &korganizer; calendar.

## Debugging

If you find problems with the Exchange Plugin, please report them to the kde-pim mailing list or to the &kde; bug repository at bugs.kde.org.

Please include a full debug log from ~/.xsession-errors or from the console from which you started X.

If you have compiled &korganizer; from source, please recompile will full debug enabled:

    ~$ cd src/kdepim
    ~/src/kdepim$ ./configure --enable-debug=full
    ~/src/kdepim$ cd libkpimexchange
    ~/src/kdepim/libkpimexchange$ make clean
    ~/src/kdepim/libkpimexchange$ make install
    ~/src/kdepim/libkpimexchange$ cd ../korganizer/plugins/exchange
    ~/src/kdepim/korganizer/plugins/exchange$ make clean
    ~/src/kdepim/korganizer/plugins/exchange$ make install

You should see lines like

    korganizer: Registering Exchange Plugin...
    korganizer: Creating Exchange Plugin...
    korganizer: Creating ExchangeClient...

in the log file.

Your help in improving the Exchange plugin is greatly appreciated.

## Credits and license

Contributors:

Original author

- Jan-Pascal van Best janpascal@vanbest.org

Additionals texts

- Klaus Stärk staerk@kde.org

Conversion to DocBook

- Eric Bischoff e.bischoff@noos.fr

&underFDL;