<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
>Marcus</firstname
><surname
>Gama</surname
><affiliation
><address
><email
>marcus_gama@uol.com.br</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 em 3 de Novembro de 2002. Veja o <filename
>ChangeLog</filename
> para mais detalhes.</para>
<para
>Por favor observe que as descrições e capturas de tela referem-se a 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
>02-11-2002</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 acessar ao seu calendário num servidor do &Microsoft; Exchange&reg; a partir do &korganizer;. Você poderá importar os compromissos num determinado 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 acessar 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 ativado o Acesso Web do Outlook, uma vez que isto também ativa o protocolo WebDAV</para
></listitem>
</itemizedlist>

</sect1>

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

<para
>O Plugin do Exchange está desativado por padrão, assim você terá que ativar o plugin, acessando a opção <menuchoice
><guimenu
>Configurações</guimenu
> <guimenuitem
>Configurar os Plugins</guimenuitem
></menuchoice
> do &korganizer;. Você deverá ver este diálogo aparecer: </para>

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

<para
>Neste diálogo, ative o <guilabel
>Plugin do &Microsoft; Exchange 2000 para o &korganizer;</guilabel
> e clique em <guibutton
>OK</guibutton
>. Isto deverá ativar um novo menu <guimenu
>Exchange</guimenu
> no &korganizer;, como aparece na seguinte captura de tela: </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 do plugin ficar ativo, você deverá configuré-lo. Escolha a opção <guimenuitem
>Configurar...</guimenuitem
> no menu <guimenu
>Exchange</guimenu
>. Você deverá ver este diálogo aparecer: </para>

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

<para
>Neste diálogo, você precisa 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 coloque aqui o seu domínio!</para
></listitem>
<listitem
><para
>a sua senha. Se você preencher aqui a sua senha, ela fica guardada num formato criptografado em <filename
>~/.kde/share/config/korganizerrc</filename
></para
></listitem>
</itemizedlist>
</para>

</sect1>

<sect1 id="exchange-plugin-downloading">
<title
>Obtendo 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 o seguinte diálogo: </para>

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

<para
>Neste diálogo, você terá que preencher o intervalo de datas que deseja obter do servidor. Por padrão, é usado o intervalo de datas visível atualmente na janela principal do &korganizer;. Quando clicar em <guibutton
>OK</guibutton
>, irá ver um diálogo de progresso aparecer: </para>

<mediaobject>
<imageobject
><imagedata fileref="ep_progress.png" format="PNG"/></imageobject>
<textobject
><para
>Diálogo de Progresso</para
></textobject>
</mediaobject>

<para
>O progresso mostrado neste diálogo 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
>Enviando Compromissos</title>

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

</sect1>

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

<para
>Você poderá remover os compromissos da mesma forma, ou seja, um a um. Primeiro selecione o evento propriamente dito no &korganizer;, clicando 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 você, o compromisso é removido do servidor e do calendário do &korganizer;. </para>

</sect1>

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

<para
>Se você encontrar algum problema 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 do console 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 arquivo de registo. </para>

<para
>A sua ajuda para 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 Marcus Gama<email
>marcus_gama@uol.com.br</email
></para
> 
&underFDL; </sect1>

</chapter>