<chapter id="exchange-plugin-ws">

<chapterinfo>
<authorgroup>

<author
><firstname
>Jan-Pascal</firstname
> <surname
>van Best</surname
> <affiliation
><address
><email
>janpascal@vanbest.org</email
></address
></affiliation>
<contrib
>Ursprünglicher Autor</contrib>
</author>

<author
><firstname
>Klaus</firstname
> <surname
>St&auml;rk</surname
> <affiliation
><address
><email
>staerk@kde.org</email
></address
></affiliation>
<contrib
>Zusätzliche Texte</contrib>
</author>

<othercredit role="reviewer"
><firstname
>Eric</firstname
> <surname
>Bischoff</surname
> <affiliation
><address
><email
>e.bischoff@noos.fr</email
></address
></affiliation>
<contrib
>Bearbeitung</contrib>
</othercredit>

<othercredit role="translator"
><firstname
>Frank</firstname
><surname
>Schütte</surname
><affiliation
><address
><email
>F.Schuette@t-online.de</email
></address
></affiliation
><contrib
>Deutsche Übersetzung</contrib
></othercredit
> 

</authorgroup>

<abstract>
<para
>Diese Version von &korganizer; Workshop <quote
>Exchange-Plugin</quote
> wurde am 3. November 2002 veröffentlicht. Informationen über Änderungen befinden sich in der Datei <filename
>ChangeLog</filename
>.</para>
</abstract>

<keywordset>
<keyword
>kdepim</keyword>
<keyword
>KOrganizer</keyword>
<keyword
>KOrganizer Workshop</keyword>
<keyword
>Exchange</keyword>
<keyword
>Outlook</keyword>
</keywordset>
<date
>2002-11-02</date
> <releaseinfo
>3.1</releaseinfo
> </chapterinfo>

<title
>KOrganizer Workshop: Exchange-Plugin</title>

<sect1 id="exchange-plugin-overview">
<title
>Übersicht</title>

<para
>Das &korganizer; Exchange-Plugin erlaubt den Zugriff auf Kalender von einem &Microsoft; Exchange&reg;-Server von &korganizer; aus. Man kann alle Termine in einer bestimmten Zeitspanne in den &korganizer;-Kalender importieren, einzelne Termine von &korganizer; zum Exchange-Server&reg; exportieren und man kann Termine (ebenfalls einzeln) vom Exchange-Server&reg; löschen. Das Plugin verwendet zum Zugriff auf den Exchange-Server&reg; das WebDAV-Protokoll. </para>

</sect1>

<sect1 id="exchange-plugin-requirements">
<title
>Voraussetzungen</title>

<itemizedlist>
<listitem
><para
>&korganizer; in der Version 3.1 Beta2 oder später</para
></listitem>
<listitem
><para
>&Microsoft; Exchange-Server 2000&reg;</para
></listitem>
<listitem
><para
>Auf dem Exchange-Server&reg; muss der Outlook-WebAccess aktiviert sein, weil dadurch das WebDAV-Protokoll aktiviert wird.</para
></listitem>
</itemizedlist>

</sect1>

<sect1 id="exchange-plugin-enabling">
<title
>Das Exchange-Plugin aktivieren</title>

<para
>Standardmäßig ist das Exchange-Plugin abgeschaltet, daher muss es zunächst in &korganizer; unter <menuchoice
><guimenu
>Einstellungen</guimenu
> <guimenuitem
>Plugins einrichten</guimenuitem
></menuchoice
> aktiviert werden. Es erscheint folgender Dialog: </para>

<mediaobject>
<imageobject
><imagedata fileref="ep_enable.png" format="PNG"/></imageobject>
<textobject
><para
>Das Exchange-Plugin aktivieren</para
></textobject>
</mediaobject>

<para
>In diesem Dialog muss man <guilabel
>&Microsoft; Excahnge 2000-Plugin für &korganizer;</guilabel
> aktivieren und auf <guibutton
>OK</guibutton
> klicken. Damit sollte ein neues Menü <guimenu
>Exchange</guimenu
> in &korganizer; erscheinen. </para>

<mediaobject>
<imageobject
><imagedata fileref="ep_menu.png" format="PNG"/></imageobject>
<textobject
><para
>Menü Exchange</para
></textobject>
</mediaobject>

</sect1>

<sect1 id="exchange-plugin-configuration">
<title
>Einrichtung</title>

<para
>Nach der Aktivierung muss das Plugin eingerichtet werden. Dazu wählt man <guimenuitem
>Einrichten...</guimenuitem
> aus dem Menü <guimenu
>Exchange</guimenu
>. Es erscheint folgender Dialog: </para>

<mediaobject>
<imageobject
><imagedata fileref="ep_config.png" format="PNG"/></imageobject>
<textobject
><para
>Einrichtung</para
></textobject>
</mediaobject>

<para
>Folgendes muss hier ausgefüllt werden: <itemizedlist>
<listitem
><para
>Die Adresse des Exchange-Servers&reg;, als z.B. <userinput
>mail.mycompany.com</userinput
>.</para
></listitem>
<listitem
><para
>Das eigene Konto (bzw. die Exchange-Mailbox), also z.B. <userinput
>joe</userinput
>. Hier darf kein Domänenname angehängt werden.</para
></listitem>
<listitem
><para
>Das eigene Passwort. Falls man das Passwort hier einträgt, wird es verschlüsselt in <filename
>~/.kde/share/config/korganizerrc</filename
> gespeichert.</para
></listitem>
</itemizedlist>
</para>

</sect1>

<sect1 id="exchange-plugin-downloading">
<title
>Termine herunterladen</title>

<para
>Nach der Einrichtung des Plugins kann man Termine des eigenen Kontos auf dem Exchange-Server&reg; in &korganizer; importieren. Dazu wählt man <guimenuitem
>Herunterladen...</guimenuitem
> aus dem Menü <guimenu
>Exchange</guimenu
>. Es erscheint folgender Dialog: </para>

<mediaobject>
<imageobject
><imagedata fileref="ep_download.png" format="PNG"/></imageobject>
<textobject
><para
>Termine herunterladen</para
></textobject>
</mediaobject>

<para
>Hier muss man eine Zeitspanne angeben. Standardmäßig wird die Zeitspanne gewählt, die aktuell im Hauptfenster von &korganizer; angezeigt wird. Nach Klicken auf <guibutton
>OK</guibutton
> erscheint eine Fortschrittsanzeige: </para>

<mediaobject>
<imageobject
><imagedata fileref="ep_progress.png" format="PNG"/></imageobject>
<textobject
><para
>Fortschrittsanzeige</para
></textobject>
</mediaobject>

<para
>Der angezeigte Fortschritt bezieht sich nicht auf die Anzahl der heruntergeladenen Termine, sondern auf die Anzahl der Zugriffe auf den Exchange-Server. </para>

<para
>Nach Beendigung des Herunterladens erscheinen die Termine im Hauptfenster von &korganizer;. </para>

</sect1>

<sect1 id="exchange-plugin-uploading">
<title
>Termine Hochladen</title>

<para
>Man kann Termine einzeln hochladen. Dazu wählt man zunächst den gewünschten Termin durch klicken in &korganizer; aus. Danach wählt man <guimenuitem
>Termin hochladen</guimenuitem
> aus dem Menü <guimenu
>Exchange</guimenu
>. Es erscheint eine Warnung, die aber nur dann zu beachten ist, wenn man einen existierenden Termin auf dem Exchange-Server&reg; mit einer bearbeiteten Version dieses Termins überschreiben will. Klickt man auf <guibutton
>OK</guibutton
>, so wird der Termin auf den Exchange-Server&reg; hochgeladen. </para>

</sect1>

<sect1 id="exchange-plugin-deleting">
<title
>Termine entfernen</title>

<para
>Termine können einzeln vom Server gelöscht werden. Dazu wählt man einen Termin in &korganizer;. Dann wählt man im Menü <guimenu
>Exchange</guimenu
> den Eintrag <guimenuitem
>Termin löschen</guimenuitem
>. Wiederum wird eine Warnung angezeigt: <computeroutput
>Das Löschen eines einzelnen Termins aus einer Liste wiederkehrender Termine löscht alle Wiederholungen dieses Termins</computeroutput
>. Falls man auf <guibutton
>OK</guibutton
> klickt, wird der Termin vom Server und aus dem Kalender von  &korganizer; entfernt. </para>

</sect1>

<sect1 id="exchange-plugin-debugging">
<title
>Fehlersuche</title>

<para
>Bitte melden Sie Probleme und Fehler im Exchange-Plugin an die <ulink url="mailto:kde-pim@mail.kde.org"
>kde-pim Mailingliste</ulink
> oder Internetseite für Fehler in &kde; unter <ulink url="http://bugs.kde.org"
>http://bugs.kde.org</ulink
>. </para>

<para
>Die Fehlernachricht sollte die gesamte Ausgabe von ~/.xsession-errors oder der Konsole enthalten, von der X gestartet worden ist. </para>

<para
>Falls Sie &korganizer; selbst kompiliert haben, kompilieren Sie bitte neu mit aktivierten Debug-Informationen. <literallayout
>~$ 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
</literallayout>
</para>

<para
>In der Protokolldatei tauchen Zeilen wie <literallayout>
korganizer: Registering Exchange Plugin...
korganizer: Creating Exchange Plugin...
korganizer: Creating ExchangeClient...
</literallayout
> auf. </para>

<para
>Jede Hilfe bei der Vervollkommnung des Exchange-Plugins ist willkommen. </para>

</sect1>

<sect1 id="exchange-plugin-credits">
<title
>Mitwirkende und Lizenz</title>

<para
>Mitwirkende:</para>

<variablelist>
<varlistentry>
<term
>Ursprünglicher Autor</term>
<listitem
><para
>Jan-Pascal van Best <email
>janpascal@vanbest.org</email
></para
></listitem>
</varlistentry>

<varlistentry>
<term
>Zusätzliche Texte</term>
<listitem
><para
>Klaus Stärk <email
>staerk@kde.org</email
></para
></listitem>
</varlistentry>

<varlistentry>
<term
>Konvertierung in das Docbook-Format</term>
<listitem
><para
>Eric Bischoff <email
>e.bischoff@noos.fr</email
></para
></listitem>
</varlistentry>
</variablelist>

<para
>Deutsche Übersetzung Frank Schütte <email
>F.Schuette@t-online.de</email
></para
> 
&underFDL; </sect1>

</chapter>
