<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>tdepim</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>~/.trinity/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.trinitydesktop.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/tdepim
~/src/tdepim$ ./configure --enable-debug=full
~/src/tdepim$ cd libkpimexchange
~/src/tdepim/libkpimexchange$ make clean
~/src/tdepim/libkpimexchange$ make install
~/src/tdepim/libkpimexchange$ cd ../korganizer/plugins/exchange
~/src/tdepim/korganizer/plugins/exchange$ make clean
~/src/tdepim/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>