<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
>Autor original</contrib>
</author>

<author
><firstname
>Klaus</firstname
> <surname
>St&auml;rk</surname
> <affiliation
><address
><email
>staerk@kde.org</email
></address
></affiliation>
<contrib
>Textos adicionais</contrib>
</author>

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

<othercredit role="translator"
><firstname
>José</firstname
><surname
>Pires</surname
><affiliation
><address
><email
>jncp@netcabo.pt</email
></address
></affiliation
><contrib
>Tradução</contrib
></othercredit
> 

</authorgroup>

<abstract>
<para
>Esta versão da sessão para o &korganizer; do <quote
>'Plugin' do Exchange</quote
> foi lançada a 3 de Novembro de 2002. Veja o <filename
>ChangeLog</filename
> para mais detalhes.</para>
<para
>Lembre-se por favor que as descrições e as imagens referem-se à versão 3.1 do &korganizer;.</para>
</abstract>

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

<title
>Curso KOrganizer: 'Plugin' Exchange</title>

<sect1 id="exchange-plugin-overview">
<title
>Introdução</title>

<para
>O 'plugin' do Exchange para o &korganizer; permite-lhe aceder ao seu calendário num servidor do &Microsoft; Exchange&reg; a partir do &korganizer;. Você poderá importar os compromissos num dado intervalo de datas para o calendário do seu &korganizer;, poderá exportar os compromissos (um de cada vez) a partir do seu calendário do &korganizer; para o servidor de Exchange&reg; e poderá remover compromissos (também um de cada vez) do servidor de Exchange&reg;. O 'plugin' usa o protocolo WebDAV para aceder ao servidor de Exchange&reg;. </para>

</sect1>

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

<itemizedlist>
<listitem
><para
>&korganizer; versão 3.1 beta2 ou posterior</para
></listitem>
<listitem
><para
>&Microsoft; Exchange Server 2000&reg;</para
></listitem>
<listitem
><para
>No servidor de Exchange&reg;, é necessário estar instalado o Acesso Web do Outlook e activo, dado que isto também activa o protocolo WebDAV</para
></listitem>
</itemizedlist>

</sect1>

<sect1 id="exchange-plugin-enabling">
<title
>Activar o 'Plugin' Exchange</title>

<para
>O 'Plugin' do Exchange está desactivado por omissão, como tal você terá de activar o 'plugin', acedendo à opção <menuchoice
><guimenu
>Configuração</guimenu
> <guimenuitem
>Configurar os 'Plugins'</guimenuitem
></menuchoice
> do &korganizer;. Você irá ver esta janela a aparecer: </para>

<mediaobject>
<imageobject
><imagedata fileref="ep_enable.png" format="PNG"/></imageobject>
<textobject
><para
>Activar o 'Plugin' do Exchange</para
></textobject>
</mediaobject>

<para
>Nesta janela, active o <guilabel
>'Plugin' do &Microsoft; Exchange 2000 para o &korganizer;</guilabel
> e carregue em <guibutton
>OK</guibutton
>. Isto deverá activar um novo menu <guimenu
>Exchange</guimenu
> no &korganizer;, como aparece na janela seguinte: </para>

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

</sect1>

<sect1 id="exchange-plugin-configuration">
<title
>Configuração</title>

<para
>Depois de o 'plugin' ficar activo, você devê-lo-á configurar. Escolha a opção <guimenuitem
>Configurar...</guimenuitem
> no menu <guimenu
>Exchange</guimenu
>. Você deverá ver esta janela a aparecer: </para>

<mediaobject>
<imageobject
><imagedata fileref="ep_config.png" format="PNG"/></imageobject>
<textobject
><para
>Configuração</para
></textobject>
</mediaobject>

<para
>Nesta janela, você precisa de preencher: <itemizedlist>
<listitem
><para
>o endereço do seu servidor de Exchange&reg;, &eg; <userinput
>mail.empresa.com</userinput
></para
></listitem>
<listitem
><para
>a sua conta ou caixa de correio do Exchange, &eg; <userinput
>ze</userinput
>. Não ponha aqui o seu domínio!</para
></listitem>
<listitem
><para
>a sua senha. Se você preencher aqui a sua senha, ela fica guardada num formato cifrado em <filename
>~/.kde/share/config/korganizerrc</filename
></para
></listitem>
</itemizedlist>
</para>

</sect1>

<sect1 id="exchange-plugin-downloading">
<title
>Obter os Compromissos</title>

<para
>Quando você tiver configurado o 'plugin', você poderá obter os eventos da sua conta no servidor de Exchange&reg; para o &korganizer;. Escolha <guimenuitem
>Obter...</guimenuitem
> no menu <guimenu
>Exchange</guimenu
>. Deste modo, irá aparecer a seguinte janela: </para>

<mediaobject>
<imageobject
><imagedata fileref="ep_download.png" format="PNG"/></imageobject>
<textobject
><para
>Obter os Compromissos</para
></textobject>
</mediaobject>

<para
>Nesta janela, você terá de preencher o intervalo de datas que deseja obter do servidor. Por omissão, é usado o intervalo de datas visível de momento na janela principal do &korganizer;. Quando carregar em <guibutton
>OK</guibutton
>, irá ver uma janela de evolução a aparecer: </para>

<mediaobject>
<imageobject
><imagedata fileref="ep_progress.png" format="PNG"/></imageobject>
<textobject
><para
>Janela de Evolução</para
></textobject>
</mediaobject>

<para
>A evolução mostrada nesta janela não corresponde ao número de compromissos transferidos, mas ao número total de acessos ao servidor de Exchange. </para>

<para
>Quando a transferência terminar, os compromissos obtidos irão aparecer na janela principal do &korganizer;. </para>

</sect1>

<sect1 id="exchange-plugin-uploading">
<title
>Enviar Compromissos</title>

<para
>Você poderá enviar os compromissos, um de cada vez. Primeiro, seleccione um compromisso no &korganizer;, carregando nele. Depois escolha a opção <guimenuitem
>Enviar o Evento</guimenuitem
> no menu <guimenu
>Exchange</guimenu
>. Irá aparecer uma mensagem de aviso, a qual só será importante se você sobrepor um compromisso existente no servidor de Exchange&reg; com uma versão editada do mesmo compromisso. Se você carregar em <guibutton
>OK</guibutton
>, o seu compromisso será enviado para o servidor de Exchange&reg;. </para>

</sect1>

<sect1 id="exchange-plugin-deleting">
<title
>Apagar Compromissos</title>

<para
>Você poderá remover os compromissos da mesma forma, ou seja, um a um. Primeiro seleccione o evento propriamente dito no &korganizer;, carregando com o &LMB; em cima dele. Depois, escolha a opção <guimenuitem
>Remover o Evento</guimenuitem
> do menu <guimenu
>Exchange</guimenu
>. Isto mostra também uma mensagem de aviso: <computeroutput
>A remoção de um único compromisso de uma lista de compromissos recorrentes irá remover todas as recorrências dos compromissos</computeroutput
>. Se estiver tudo bem para si, o compromisso é removido do servidor e do calendário do &korganizer;. </para>

</sect1>

<sect1 id="exchange-plugin-debugging">
<title
>Depuração</title>

<para
>Se tiver alguns problemas com o 'Plugin' do Exchange, por favor comunique-os na  <ulink url="mailto:kde-pim@mail.kde.org"
>lista de correio 'kde-pim'</ulink
> ou no repositório de erros do &kde; em <email
>bugs.kde.org</email
>. </para>

<para
>Por favor inclua um registo de depuração completo a partir do ~/.xsession-errors ou a partir da consola onde você iniciou o X. </para>

<para
>Se tiver compilado o &korganizer; a partir do código, por favor recompile-o com o suporte completo de depuração: <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
>Você deverá ver algumas linhas do tipo <literallayout>
korganizer: Registering Exchange Plugin...
korganizer: Creating Exchange Plugin...
korganizer: Creating ExchangeClient...
</literallayout
> no ficheiro de registo. </para>

<para
>A sua ajuda a melhorar o 'plugin' do Exchange é bastante apreciada. </para>

</sect1>

<sect1 id="exchange-plugin-credits">
<title
>Créditos e licença</title>

<para
>Contribuições:</para>

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

<varlistentry>
<term
>Textos adicionais</term>
<listitem
><para
>Klaus St&auml;rk <email
>staerk@kde.org</email
></para
></listitem>
</varlistentry>

<varlistentry>
<term
>Conversão para DocBook</term>
<listitem
><para
>Eric Bischoff <email
>e.bischoff@noos.fr</email
></para
></listitem>
</varlistentry>
</variablelist>

<para
>Tradução de José Nuno Pires <email
>jncp@netcabo.pt</email
></para
> 
&underFDL; </sect1>

</chapter>
