<sect1 id="mail-merge">
<sect1info>
<authorgroup>
<author
><firstname
>Mike</firstname
> <surname
>McBride</surname
> </author>
<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>
</sect1info>
<title
>Mala Direta</title>
<indexterm
><primary
>mala direta</primary
><secondary
>introdução</secondary
></indexterm>

<para
>O &kword; tem a habilidade de usar dados de um banco de dados externo (ou um banco de dados interno) para <emphasis
>personalizar</emphasis
> seus documentos para membros/clientes/amigos individuais.</para>
<para
>Esta seção do manual abrangerá todos os aspectos da criação, mesclagem e impressão de documentos que são específicas do &kword;. Este manual não abrangerá:</para>
<itemizedlist>
<listitem
><para
>Criação de um banco de dados externo.</para
></listitem>
<listitem
><para
>Conceitos de segurança sobre banco de dados.</para
></listitem>
<listitem
><para
>Instruções detalhadas em SQL. É assumido que você tem algum conhecimento sobre SQL se você está usando um banco de dados SQL para sua fonte de dados.</para
></listitem>
<listitem
><para
>Acessar a rede ou Internet.</para
></listitem>
</itemizedlist>

<para
>Para respostas a essas perguntas, outra documentação está disponível na Internet que é específica do programa que você escolher.</para>

<para
>Se você deseja usar o banco de dados interno do &kword;, clique <link linkend="mail-merge-internal"
>aqui</link
>.</para>

<sect2 id="mail-merge-sql">
<title
>Using an outside database (SQL) to create documents</title>
<indexterm
><primary
>mala direta</primary
><secondary
>using outside database</secondary
></indexterm>

<para
>O &kword; tem a habilidade de usar diversos dos mais populares bancos de dados de fonte aberta como uma fonte para os dados de documentos personalizados.</para>
<note
><para
>Para acessar um banco de dados externo usando SQL, sua máquina necessita ter o módulo apropriado de banco de dados compilado em sua cópia do QT.</para>
<para
>Para mais informações veja a <link linkend="installation"
>seção de instalação desta documentação</link
>.</para
></note>
<para
>Os bancos de dados podem estar localizados na mesma máquina do &kword;, ou em qualquer computador que seja acessível através de sua rede de computadores ou a Internet.</para>
<para
>Para usar o banco de dados, você deve saber as seguintes informações:</para>
<itemizedlist>
<listitem
><para
>Nome do banco de dados</para
></listitem>
<listitem
><para
>Nome da máquina/endereço IP do computador que o banco de dados está localizado</para
></listitem>
<listitem
><para
>O endereço da porta no computador especificado que fornece acesso SQL</para
></listitem>
<listitem
><para
>Um nome válido de usuário para o banco de dados</para
></listitem>
<listitem
><para
>Uma senha válida para o nome de usuário</para
></listitem>
</itemizedlist>

<para
>Se você possui todas esstas informações à mão, você está pronto para proceder.</para>
<para
>Usar um banco de dados externo para criar documentos personalizado é um processo de três passos:</para>
<orderedlist>
<listitem
><para
><link linkend="mail-merge-sql-data"
>Conectar ao banco de dados e selecionar sua consulta.</link
></para
></listitem>
<listitem
><para
><link linkend="mail-merge-fields"
>Inserir os campos mesclados</link
> para dizer ao &kword; onde inserir as informações do banco de dados</para
></listitem>
<listitem
><para
><link linkend="mail-merge-print"
>Imprimir</link
> o documento personalizado.</para
></listitem>
</orderedlist>

<sect3 id="mail-merge-sql-data">
<title
>Localizar o banco de dados e consultar os registros.</title>
<para
>Para iniciar, selecione <menuchoice
> <guimenu
>Ferramentas</guimenu
><guimenuitem
>Configurar Mala Direta...</guimenuitem
></menuchoice
> na barra de menu. Uma caixa de diálogo aparecerá.</para>

<screenshot>
<mediaobject>
<imageobject>
<imagedata fileref="mmerge1.png" format="PNG"/></imageobject>
</mediaobject>
</screenshot>

<para
>Clique em <guibutton
>Abrir Existente...</guibutton
>. Outra pequena caixa de diálogo aparecerá.</para>
<para
>There is currently only one option in this dialog box (<guilabel
>QT-SQL source</guilabel
>). Click on <guibutton
>OK</guibutton
>. A new dialog box will appear.<anchor id="mail-merge-login"/></para>

<screenshot>
<mediaobject>
<imageobject>
<imagedata fileref="mmergesql1.png" format="PNG"/></imageobject>
</mediaobject>
</screenshot>

<para
>Insira a &URL; ou endereço IP do computador onde se encontra o banco de dados na caixa de texto rotulada <guilabel
>Nome da máquina:</guilabel
>.</para>
<para
>Select the correct driver from the combo box labeled <guilabel
>Driver:</guilabel
>. </para>
<para
>Insira o nome do banco de dados que deseja acessar na caixa de texto rotulada <guilabel
>Nome do banco de dados:</guilabel
> e um nome de usuário na caixa de texto rotulada <guilabel
>Nome de usuário:</guilabel
>.</para>
<para
>Se o banco de dados é acessado por uma porta diferente da padrão insira o número da porta na caixa de texto rotulada <guilabel
>Porta:</guilabel
>.</para>
<tip
><para
>Se você irá usar este banco de dados outras vezes, você pode clicar no botão rotulado <guibutton
>Manter configurações</guibutton
>. O &kword; lhe pedirá por um nome descritivo.</para>
<para
>Quando você quiser restaurar estas configurações em sessões futuras, simplesmente selecione o nome descritivo na caixa combinada na parte superior esquerda da caixa de diálogo.</para>
</tip>
<para
>Quando todas as informações estiverem corretas, clique <guibutton
>OK</guibutton
>. O &kword; lhe pedirá por uma senha para o banco de dados. Insira a senha na caixa de texto, e clique <guibutton
>OK</guibutton
>.</para>
<para
>This dialog box will re-appear.</para>

<screenshot>
<mediaobject>
<imageobject>
<imagedata fileref="mmerge1.png" format="PNG"/></imageobject>
</mediaobject>
</screenshot>

<para
>Clique em <guibutton
>Editar Atual...</guibutton
>. Outro diálogo aparecerá.</para>

<screenshot>
<mediaobject>
<imageobject>
<imagedata fileref="mmergesql2.png" format="PNG"/></imageobject>
</mediaobject>
</screenshot>

<para
>Este diálogo fi desenhado para auxiliá-lo a inserir e testar sua consulta ao banco de dados. O diálogo é dividido em três seções: Informações do banco de dados, Informações da consulta e Linha de consulta.</para>
<para
>A seção de informações do banco de dados é rotulada <guilabel
>Informações</guilabel
> e consiste de duas caixas combinadas. A caixa da esquerda (<guilabel
>Tabelas disponíveis</guilabel
>) lhe fornece uma lista de todas as tabelas disponíveis no banco de dados atual. Selecione a tabela desejada na lista clicando no nome da tabela com o &LMB;. Uma lista de todos os campos disponíveis na tabela aparecerá na caixa combinada à direita.</para>
<para
>A linha de consulta é uma caixa de texto localizada próxima à base do diálogo rotulada <guilabel
>Consulta</guilabel
>. Simplesmente digite sua consulta SQL nesta caixa de texto e clique <guibutton
>Executar</guibutton
>. O &kword; consultará o banco de dados e retornará a consulta especificada num formato tabular na caixa <guilabel
>Resultado da consulta</guilabel
>. Você pode alterar, ou editar sua consulta na linha de consulta e cada vez que você clicar <guibutton
>Executar</guibutton
>, o resultado da nova consulta aparecerá.</para>
<note
><para
>O &kword; não possui um limite para sua string de consulta. Elas podem ser simples e diretas:</para>
<para
><userinput
>select * from eMail</userinput
></para>
<para
>Ou consultas complexas com múltiplas tabelas:</para>
<para
><userinput
>select eMail.FirstName, eMail.LastName, eMail.address, data.Birthday, data.EyeColour from eMail, data where data.FirstName=eMail.FirstName and data.LastName=eMail.LastName </userinput
></para>
</note>
<para
>Clicar em <guibutton
>Configurar</guibutton
>. lhe permitirá <link linkend="mail-merge-login"
>logar em um banco de dados diferente</link
>.</para>
<para
>Quando você tiver a consulta correta na caixa de texto <guilabel
>Consulta</guilabel
>, clique <guibutton
>OK</guibutton
> para selecionar a consulta. </para>
<para
>Isto lhe retornará a caixa de diálogo principal da mala direta.</para>

<screenshot>
<mediaobject>
<imageobject>
<imagedata fileref="mmerge1.png" format="PNG"/></imageobject>
</mediaobject>
</screenshot>

<para
>Clique <guibutton
>Fechar</guibutton
>.</para>

<para
>Agora que você selecionou sua consulta de dados, é hora de inserir os campos mesclados no documento. Clique <link linkend="mail-merge-fields"
>aqui para continuar</link
>.</para>
</sect3>
</sect2>

<sect2 id="mail-merge-internal">
<title
>Usar uma representação interna dos dados tabulares para criar documentos</title>
<indexterm
><primary
>mala direta</primary
><secondary
>usar tabelas de dados do &kword;</secondary
></indexterm>

<para
>Para pequenos conjuntos de dados, ou quando você não possui atualmente um banco de dados contendo os dados mesclados, o &kword; lhe oferece a habilidade de inserir os dados <emphasis
>diretamente no &kword;</emphasis
> numa forma tabular. Esta estrutura interna de dados pode ser usada para criar documentos com estes dados inseridos em posições pré-definidas.</para>
<para
>Usar uma representação interna de dados para criar documentos personalizados é um processo de três passos:</para>
<orderedlist>
<listitem
><para
><link linkend="mail-merge-internal-data"
>Inserir os dados</link
> no &kword;</para
></listitem>
<listitem
><para
><link linkend="mail-merge-fields"
>Inserir os campos mesclados</link
> para dizer ao &kword; onde inserir as informações do banco de dados</para
></listitem>
<listitem
><para
><link linkend="mail-merge-print"
>Imprimir</link
> o documento personalizado.</para
></listitem>
</orderedlist>
<para
>Após os dados serem criados uma vez, você pode retornar e mudar os dados como necessário, e produzir outro conjunto de documentos personalizados a partir destes dados.</para>

<sect3 id="mail-merge-internal-data">
<title
>Inserir os dados</title>
<para
>Para iniciar, selecione <menuchoice
> <guimenu
>Ferramentas</guimenu
><guimenuitem
>Configurar Mala Direta...</guimenuitem
></menuchoice
> na barra de menu. Uma caixa de diálogo aparecerá.</para>

<screenshot>
<mediaobject>
<imageobject>
<imagedata fileref="mmerge1.png" format="PNG"/></imageobject>
</mediaobject>
</screenshot>

<para
>Clique em <guibutton
>Criar Novo...</guibutton
>. Outro pequeno diálogo aparecerá.</para>
<para
>Existe atualmente somente uma opção nesta caixa de diálogo <guilabel
>Armazenamento interno</guilabel
>. Clique em <guibutton
>OK</guibutton
>. Uma nova caixa de diálogo aparecerá.</para>

<screenshot>
<mediaobject>
<imageobject>
<imagedata fileref="mmerge2.png" format="PNG"/></imageobject>
</mediaobject>
</screenshot>

<para
>Este é um cartão de registro para criação de seu arquivo de dados tabelares. Ao longo do topo está uma barra de ferramentas e a parte principal do diálogo é o espaço para manter seus pares de entrada/dados.</para>
<sect4 id="mail-merge-internal-data-entry"
><title
>Definir a estrutura de sua tabela</title>
<para
>Primeiro, nós precisamos adicionar uma ou mais entradas (campos mesclados). Isto é conseguido clicando o botão <inlinemediaobject
><imageobject
><imagedata fileref="addentry.png" format="PNG" align="center"/></imageobject
></inlinemediaobject
> (<guilabel
>Adicionar entrada</guilabel
>) (terceiro botão a partir da direita na barra de ferramentas). Uma pequena caixa de diálogo aparecerá. Digite um nome descritivo de sua entrada na caixa de diálogo (Nome, Endereço, Juros Devidos, etc...). </para>
<note
><para
>Isto é para o nome da entrada, não o dado que estará contido na entrada.</para
></note>
<para
>Clique <guibutton
>OK</guibutton
>, e a entrada será adicionada ao cartão.</para>
<para
>Repita este processo até todas as entradas necessárias estiverem visíveis neste primeiro cartão.</para>
<para
>Se você desejar excluir uma entrada, simplesmente clique uma vez no nome da entrada com o &LMB; e selecione <inlinemediaobject
><imageobject
> <imagedata fileref="delentry.png" format="PNG" align="center"/></imageobject
></inlinemediaobject
> (<guilabel
>Remover entrada</guilabel
>).  </para>
<warning
><para
>Tenha <emphasis
>muita</emphasis
> certeza de que você selecionou o nome correto da entrada. Uma vez que você diga ao &kword; para excluir a entrada, a entrada <emphasis
>e todos os dados desta entrada serão excluídos imediatamente</emphasis
>. Você não terá opção de parar ou reverter o processo uma vez iniciado.</para
></warning>

</sect4>
<sect4 id="mail-merge-internal-data-value"
><title
>Inserir os dados na tabela</title>
<para
>Agora que a estrutura de seus dados está definida, você pode inserir os dados em suas entradas.</para>
<para
>No topo da caixa de diálogo, existem 4 botões rodeados por uma caixa com contador. A caixa com contador lhe fornece o número do registro atual. Todos os registros são numerados na ordem que eles são adicionados inciando com o número 1. Você pode usar a caixa com contador para ir diretamente para o registro desejado ou você pode usar as setas para graficamente mover-se através da lista de registros.</para>

<informaltable>
<tgroup cols="2">
<thead>
<row
><entry
>botão</entry
><entry
>Ação</entry
></row>
</thead
><tbody>
<row
><entry
><inlinemediaobject
><imageobject
><imagedata fileref="beginning.png" format="PNG"/></imageobject
></inlinemediaobject
></entry
><entry
>Mover diretamente para o registro um</entry
></row>
<row
><entry
><inlinemediaobject
><imageobject
><imagedata fileref="back.png" format="PNG"/></imageobject
></inlinemediaobject
></entry
><entry
>Mover para trás um registro</entry
></row>
<row
><entry
><inlinemediaobject
><imageobject
><imagedata fileref="forward.png" format="PNG"/></imageobject
></inlinemediaobject
></entry
><entry
>Mover para frente um registro</entry
></row>
<row
><entry
><inlinemediaobject
><imageobject
><imagedata fileref="end.png" format="PNG"/></imageobject
></inlinemediaobject
></entry
><entry
>Mover para o último registro do conjunto de dados</entry
></row>
</tbody>
</tgroup>
</informaltable>

<para
>Para inserir os dados, simplesmente posicione o cursor na caixa de texto à direita do nome da entrada, e digite os dados. (O &kword; usa <quote
>Nenhum Valor</quote
> como valor padrão para todas as entradas nos registros novos criados.)</para>
<para
>Para adicionar um registro, clique no botão <inlinemediaobject
><imageobject
> <imagedata fileref="addrecord.png" format="PNG" align="center"/></imageobject
></inlinemediaobject
>.</para>
<para
>Para excluir um registro, clique no botão <inlinemediaobject
><imageobject
> <imagedata fileref="delrecord.png" format="PNG" align="center"/></imageobject
></inlinemediaobject
>.</para>
<warning
><para
>Tenha cuidado ao excluir registros. Uma vez excluídos, o registro não pode ser recuperado.</para
></warning>
<para
>Continue a inserir todos os dados até o seu conjunto de dados estiver completo.</para
>  
<para
>Após seu conjunto de dados estiver completo, clique <guibutton
>OK</guibutton
> para salvar as mudanças para seu conjunto de dados. Isto lhe trará o diálogo principal da mala direta:</para>

<screenshot>
<mediaobject>
<imageobject>
<imagedata fileref="mmerge1.png" format="PNG"/></imageobject>
</mediaobject>
</screenshot>

<para
>Clique <guibutton
>Fechar</guibutton
>. Agora é hora de inserir os campos mesclados no documento.</para>

</sect4>

</sect3>

<sect3 id="mail-merge-fields">
<title
>Inserir os campos mesclados no documento</title>
<para
>Agora qque o &kword; sabe as entradas disponíveis em sua fonte de dados, você pode inserir os campos mesclados em seu documento.</para>
<para
>Um campo mesclado é um reservador de espaço dentro do documento. Este reservador de espaço será substituído em cada documento personalizado com o valor da entrada para cada registro individual.</para>

<sect4 id="mail-merge-field-insert">
<title
>Inserir um campo mesclado</title>
<indexterm
><primary
>mala direta</primary
><secondary
>inserindo campos mesclados</secondary
></indexterm>

<para
>Para inserir um campo mesclado, posicione o cursor no local desejado no documento. Selecione <menuchoice
> <guimenu
>Inserir</guimenu
><guimenuitem
>Variável</guimenuitem
> <guimenuitem
>Mala Direta...</guimenuitem
></menuchoice
> na barra de menu. Uma lista de todas as entradas disponíveis aparecerá. Selecione a entrada desejada, e clique <guibutton
>OK</guibutton
>.</para>
<para
>O campo mesclado é inserido na posição atual do cursor. O campo mesclado é envolvido por colchetes.</para>
<para
>Você pode posicionar o cursor numa nova localização no documento e inserir outro reservador de espaço. Quando você tiver terminado de inserir reservadores de espaço, você pode proceder a impressão de seu documento.</para>
</sect4>

<sect4 id="mail-merge-field-delete">
<title
>Excluir um campo mesclado</title>
<indexterm
><primary
>mala direta</primary
><secondary
>excluindo um campo mesclado</secondary
></indexterm>

<para
>Para excluir um campo mesclado, simplesmente posicione o cursor no fim do campo mesclado, e pressione a tecla &Backspace;. Todo o campo mesclado será excluído.</para>

</sect4>
</sect3>

<sect3 id="mail-merge-print">
<title
>Pré-visualizando e imprimindo um documento mesclado</title>
<indexterm
><primary
>mala direta</primary
><secondary
>mesclando dados e texto</secondary
></indexterm>

<para
>Uma vez que você tenha inserido todos os campos mesclados que você deseja, você está pronto para pré-visualizar e imprimir os documentos personalizados.</para>
<sect4 id="mail-merge-print-preview">
<title
>Pré-visualizar seus documentos antes de imprimir</title>
<para
>Para pré-visualizar seu documento selecione <menuchoice
><guimenu
>Ferramentas</guimenu
><guimenuitem
>Configurar Mala Direta...</guimenuitem
></menuchoice
> na barra de menu. Uma caixa de diálogo aparecerá.</para>

<screenshot>
<mediaobject>
<imageobject>
<imagedata fileref="mmerge1.png" format="PNG"/></imageobject>
</mediaobject>
</screenshot>

<para
>Select <guilabel
>Print Preview</guilabel
>. You will be able to see the final output of your personalized documents prior to printing.</para>
</sect4>
<sect4 id="mail-merge-print-printing">
<title
>Imprimir seus documentos personalizados.</title>
<para
>Você imprime seus documentos personalizados usando os mesmos métodos que você usa para imprimir documentos tradicionais. Para mais informações sobre impressão veja a seção <link linkend="printing"
>Imprimir um Documento</link
>.</para>
</sect4>
</sect3>
</sect2>
</sect1>
