<sect1 id="mail-merge"
><title
>Fusion du courrier</title>
<indexterm
><primary
>fusion du courrier</primary
><secondary
>introduction</secondary
></indexterm>

<para
>&kword; peut utiliser des données provenant d'une base de données externe (ou d'une base de données interne) pour <emphasis
>personnaliser</emphasis
> vos documents à l'intention de vos amis / clients / membres.</para>
<para
>Cette section du manuel couvrira tous les aspects de la création, de la fusion et de l'impression de documents spécifiques à &kword;. Ce manuel ne couvrira pas :</para>
<itemizedlist>
<listitem
><para
>La création d'une base de données externe.</para
></listitem>
<listitem
><para
>Les problèmes de sécurité concernant les bases de données.</para
></listitem>
<listitem
><para
>Les instructions détaillées concernant SQL. Il est acquis que vous disposez d'une certaine connaissance de SQL si vous utilisez une base de données SQL comme source de données.</para
></listitem>
<listitem
><para
>Accéder au réseau ou à Internet</para
></listitem>
</itemizedlist>

<para
>D'autres documentations spécifiques au logiciel que vous avez choisi et répondant à ces questions sont disponibles sur Internet.</para>

<para
>Si vous voulez utiliser la base de données interne à &kword;, cliquez <link linkend="mail-merge-internal"
>ici</link
>.</para>

<sect2 id="mail-merge-sql">
<title
>Utilisation d'une base de données externe (SQL) pour créer des documents.</title>
<indexterm
><primary
>fusion du courrier</primary
><secondary
>utilisation d'une base de données externe</secondary
></indexterm>

<para
>&kword; peut utiliser plusieurs des bases de données open source les plus réputées comme source de données des documents personnalisés.</para>
<note
><para
>Votre machine doit disposer d'une version de Qt compilé avec le module de base de données approprié pour pouvoir accéder à une base de données externe utilisant SQL.</para>
<para
>Pour obtenir plus d'informations, consultez la section <link linkend="installation"
>installation de ce document</link
>.</para
></note>
<para
>La base de données peut se situer sur la même machine que &kword; ou sur tout ordinateur accessible par votre réseau ou par Internet.</para>
<para
>Vous devez connaître les informations suivantes pour pouvoir utiliser la base de données :</para>
<itemizedlist>
<listitem
><para
>Le nom de la base de données</para
></listitem>
<listitem
><para
>Le nom de la machine ou l'adresse IP de l'ordinateur sur lequel la base de données est située</para
></listitem>
<listitem
><para
>Le numéro du port de l'ordinateur spécifié offrant l'accès SQL</para
></listitem>
<listitem
><para
>Un nom d'utilisateur valable pour la base de données</para
></listitem>
<listitem
><para
>Un mot de passe valable pour le nom d'utilisateur</para
></listitem>
</itemizedlist>

<para
>Si vous possédez toutes ces informations, vous êtes prêt à continuer.</para>
<para
>L'utilisation d'une base de données externe pour créer des documents personnalisés est un processus en trois étapes : </para>
<orderedlist>
<listitem
><para
><link linkend="mail-merge-sql-data"
>Connectez-vous à la base de données et sélectionnez votre requête.</link
></para
></listitem>
<listitem
><para
><link linkend="mail-merge-fields"
>Insérez les champs de fusion</link
> pour indiquer à &kword; où insérer les informations de la base de données</para
></listitem>
<listitem
><para
><link linkend="mail-merge-print"
>Imprimez</link
> les documents personnalisés.</para
></listitem>
</orderedlist>

<sect3 id="mail-merge-sql-data">
<title
>Situez la base de données et effectuez des requêtes sur les enregistrements.</title>
<para
>Pour commencer, sélectionnez <menuchoice
><guimenu
>Outils</guimenu
><guimenuitem
>Configurer la fusion du courrier...</guimenuitem
></menuchoice
> à partir de la barre de menus. Une boîte de dialogue apparaîtra.</para>

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

<para
>Cliquez sur <guibutton
>En ouvrir une existante...</guibutton
>. Une autre petite boîte de dialogue apparaîtra.</para>
<para
>Il n'existe actuellement qu'une seule option dans la boîte de dialogue (<guilabel
>Source QT-SQL</guilabel
>). Cliquez sur <guibutton
>OK</guibutton
>. Une nouvelle boîte de dialogue apparaîtra.<anchor id="mail-merge-login"/></para>

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

<para
>Saisissez l'URL ou l'adresse IP de l'ordinateur qui contient la base de données dans le champ texte intitulé <guilabel
>Nom d'hôte : </guilabel
>.</para>
<para
>Sélectionnez le pilote adéquat à partir de la liste déroulante intitulée <guilabel
>Pilote</guilabel
>. </para>
<para
>Saisissez le nom de la base de données qui vous a été fourni dans le champ texte intitulé <guilabel
>Nom de base de données : </guilabel
>et un nom d'utilisateur dans le champ texte intitulé <guilabel
>Nom d'utilisateur : </guilabel
>.</para>
<para
>Si l'accès à la base de données se fait par un autre port que celui par défaut, saisissez le numéro de port dans le champ texte intitulé <guilabel
>Port : </guilabel
>.</para>
<tip
><para
>Si vous comptez utiliser cette base de données à d'autres occasions, vous pouvez cliquer sur le bouton intitulé <guibutton
>Conserver les réglages</guibutton
>. &kword; vous demandera un nom descriptif.</para>
<para
>Quand vous voudrez restaurer ces paramètres lors de sessions futures, sélectionnez simplement le nom descriptif dans la liste déroulante en haut et à gauche de la boîte de dialogue.</para>
</tip>
<para
>Quand toutes les informations sont correctes, cliquez sur <guibutton
>OK</guibutton
>. &kword; vous demandera votre mot de passe pour cette base de données. Mettez le mot de passe dans le champ texte et cliquez sur <guibutton
>OK</guibutton
>.</para>
<para
>Cette boîte de dialogue apparaîtra de nouveau.</para>

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

<para
>Cliquez sur <guibutton
>Modifier l'actuelle...</guibutton
>. Une autre boîte de dialogue apparaîtra.</para>

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

<para
>Cette boîte de dialogue est conçue pour vous aider à saisir et à tester votre requête de base de données. Elle est divisée en trois sections : informations sur la base de données, informations sur la requête et ligne de requête.</para>
<para
>La section d'informations sur la base de données est intitulée <guilabel
>Informations</guilabel
> et se compose de deux listes combinées. La liste combinée de gauche (<guilabel
>Tables disponibles</guilabel
>) vous donne une liste de toutes les tables dans la base de données actuelle. Sélectionnez la table souhaitée en cliquant sur celle-ci avec le &BGS;. Une liste de tous les champs disponibles dans cette table apparaîtra dans la liste combinée de droite.</para>
<para
>La ligne de requête est une zone de texte située près du bas de la boîte de dialogue intitulée <guilabel
>Requête</guilabel
>. Saisissez simplement votre requête SQL dans la zone de texte et cliquez sur <guibutton
>Exécuter</guibutton
>. &kword; exécutera la requête sur la base de données et retournera la requête spécifiée dans le champ <guilabel
>Résultat de la requête</guilabel
>. Vous pouvez modifier ou éditer votre requête sur la ligne de requête et à chaque fois que vous cliquerez sur <guibutton
>Exécuter</guibutton
>, le nouveau résultat de la requête apparaîtra.</para>
<note
><para
>&kword; ne limite pas vos chaînes de requête. Il peut s'agir de requêtes simples et directes : </para>
<para
><userinput
>select * from eMail</userinput
></para>
<para
>ou de requêtes complexes multitables : </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>
<para
></para>
<para
></para
></note>
<para
>Le fait de cliquer sur <guibutton
>Configuration</guibutton
> vous permettra de vous <link linkend="mail-merge-login"
>connecter à une base de données différente</link
>.</para>
<para
>Lorsque vous avez effectué la requête adéquate dans le champ texte <guilabel
>Requête</guilabel
>, cliquez sur <guibutton
>OK</guibutton
> pour sélectionner cette requête. </para>
<para
>Cela vous renverra à la boîte de dialogue principale de fusion de courrier.</para>

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

<para
>Cliquez sur <guibutton
>Fermer</guibutton
>.</para>

<para
>Maintenant que vous avez sélectionné votre requête de données, il est temps d'insérer les champs de fusion dans le document. Cliquez <link linkend="mail-merge-fields"
>ici pour continuer</link
>.</para>
</sect3>
</sect2>

<sect2 id="mail-merge-internal">
<title
>Utilisation d'une représentation interne des données tabulaires pour créer des documents</title>
<indexterm
><primary
>fusion du courrier</primary
><secondary
>utilisation des tables de données de &kword;</secondary
></indexterm>

<para
>Pour de petits ensembles de données ou lorsque vous ne disposez pas de base de données contenant les données à fusionner, &kword; offre la possibilité de saisir les données <emphasis
>directement dans &kword;</emphasis
> sous forme de tableau. Cette structure interne de données peut être utilisée pour créer des documents avec des données insérées à des emplacements prédéfinis.</para>
<para
>L'utilisation de la représentation interne de données pour créer des documents personnalisés est un processus en trois étapes : </para>
<orderedlist>
<listitem
><para
><link linkend="mail-merge-internal-data"
>Saisir les données</link
> dans &kword;</para
></listitem>
<listitem
><para
><link linkend="mail-merge-fields"
>Insérez les champs de fusion</link
> pour indiquer à &kword; où insérer les informations de la base de données</para
></listitem>
<listitem
><para
><link linkend="mail-merge-print"
>Imprimez</link
> les documents personnalisés.</para
></listitem>
</orderedlist>
<para
>Une fois que les données ont été créées, vous pouvez y retourner et les changer selon les besoins et produire un autre ensemble de documents personnalisés à partir de ces données.</para>

<sect3 id="mail-merge-internal-data">
<title
>Saisir les données</title>
<para
>Pour commencer, sélectionnez <menuchoice
><guimenu
>Outils</guimenu
><guimenuitem
>Configurer la fusion du courrier...</guimenuitem
></menuchoice
> à partir de la barre de menus. Une boîte de dialogue apparaîtra.</para>

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

<para
>Cliquez sur <guibutton
>En créer une nouvelle...</guibutton
>. Une autre petite boîte de dialogue apparaîtra.</para>
<para
>Il n'y a actuellement qu'une option dans cette boîte de dialogue, <guilabel
>Stockage interne</guilabel
>. Cliquez sur <guibutton
>OK</guibutton
>. Une nouvelle boîte de dialogue apparaîtra.</para>

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

<para
>C'est une carte d'enregistrement pour créer votre fichier de données tabulaire. Au sommet se trouve une barre d'outils et la partie principale de la boîte de dialogue est l'espace pour contenir vos paires d'entrées / données.</para>
<sect4 id="mail-merge-internal-data-entry"
><title
>Définition de la structure de votre table de données</title>
<para
>Nous avons besoin, en premier lieu, d'ajouter une ou plusieurs entrées (champs de fusion). Ceci s'obtient en cliquant sur le bouton <inlinemediaobject
><imageobject
> <imagedata fileref="addentry.png" format="PNG" align="center"/> </imageobject
></inlinemediaobject
> (<guilabel
>Ajouter une entrée</guilabel
>) (troisième bouton à partir de la droite sur la barre d'outils). Une petite boîte de dialogue apparaîtra. Saisissez un nom descriptif de votre entrée dans le boîte de dialogue (Nom, Adresse, Solde dû, &etc;). </para>
<note
><para
>C'est le nom de l'entrée et non les données qui sont contenues dans l'entrée.</para
></note>
<para
>Cliquez sur <guibutton
>OK</guibutton
> et l'entrée est ajoutée à la carte.</para>
<para
>Répétez ce processus jusqu'à ce que toutes les données nécessaires soient visibles dans cette première carte.</para>
<para
>Si vous voulez supprimer une entrée, cliquez simplement sur le nom de l'entrée avec le &BGS; et sélectionnez <inlinemediaobject
><imageobject
> <imagedata fileref="delentry.png" format="PNG" align="center"/> </imageobject
></inlinemediaobject
> (<guilabel
>Supprimer l'entrée</guilabel
>). </para>
<warning
><para
>Assurez-vous <emphasis
>bien</emphasis
> d'avoir sélectionné le nom d'entrée correct. Une fois que vous aurez indiqué à &kword; de supprimer l'entrée, celle-ci, <emphasis
>ainsi que toutes les données qui y sont contenues seront supprimées immédiatement</emphasis
>. Vous n'aurez pas la possibilité d'arrêter ou d'inverser le processus une fois qu'il est entamé.</para
></warning>
<para
></para>
</sect4>
<sect4 id="mail-merge-internal-data-value"
><title
>Saisir les données dans la table</title>
<para
>Maintenant que la structure de vos données est définie, vous pouvez saisir vos données dans vos entrées.</para>
<para
>En haut de la boîte de dialogue, se trouvent 4 boutons entourant un compteur. Le compteur donne le numéro actuel de l'enregistrement. Tous les enregistrements sont numérotés dans l'ordre où ils ont été ajoutés en commençant par le chiffre 1. Vous pouvez utiliser le compteur pour aller directement à l'enregistrement souhaité ou vous pouvez utiliser les flèches pour vous déplacer dans la liste des enregistrements.</para>

<informaltable>
<tgroup cols="2">
<thead>
<row
><entry
>bouton</entry
><entry
>Action</entry
></row>
</thead
><tbody>
<row
><entry
><inlinemediaobject
><imageobject
><imagedata fileref="beginning.png" format="PNG"/></imageobject
></inlinemediaobject
></entry
><entry
>Se déplace directement sur le premier enregistrement</entry
></row>
<row
><entry
><inlinemediaobject
><imageobject
><imagedata fileref="back.png" format="PNG"/></imageobject
></inlinemediaobject
></entry
><entry
>Recule d'un enregistrement</entry
></row>
<row
><entry
><inlinemediaobject
><imageobject
><imagedata fileref="forward.png" format="PNG"/></imageobject
></inlinemediaobject
></entry
><entry
>Avance d'un enregistrement</entry
></row>
<row
><entry
><inlinemediaobject
><imageobject
><imagedata fileref="end.png" format="PNG"/></imageobject
></inlinemediaobject
></entry
><entry
>Se déplace sur le dernier enregistrement de l'ensemble de données</entry
></row>
</tbody>
</tgroup>
</informaltable>

<para
>Pour saisir les données, placez simplement le curseur dans le champ texte à droite du nom de l'entrée et saisissez les données. (&kword; utilise <quote
>Pas de valeur</quote
> comme valeur par défaut pour toutes les entrées dans les enregistrements nouvellement créés).</para>
<para
>Pour ajouter un nouvel enregistrement, cliquez sur le bouton <inlinemediaobject
><imageobject
><imagedata fileref="addrecord.png" format="PNG" align="center"/></imageobject
></inlinemediaobject
>.</para>
<para
>Pour supprimer un enregistrement, cliquez sur le bouton <inlinemediaobject
><imageobject
><imagedata fileref="delrecord.png" format="PNG" align="center"/></imageobject
></inlinemediaobject
>.</para>
<warning
><para
>Soyez prudent lorsque vous supprimez des enregistrements. Une fois supprimés, les enregistrements ne peuvent pas être récupérés.</para
></warning>
<para
>Continuez de saisir toutes les données jusqu'à ce que votre ensemble de données soit complet.</para
>  
<para
>Lorsque votre ensemble de données est complet, cliquez sur <guibutton
>OK</guibutton
> pour enregistrer les changements apportés à celui-ci. Cela fera apparaître la boîte de dialogue de fusion principale :</para>

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

<para
>Cliquez sur <guibutton
>Fermer</guibutton
>. Il est maintenant temps d'insérer les champs de fusion dans le document.</para>

</sect4>

</sect3>

<sect3 id="mail-merge-fields">
<title
>Insérer des champs de fusion dans un document</title>
<para
>Maintenant que &kword; connaît les entrées disponibles dans votre source de données, vous pouvez insérer les champs de fusion dans votre document.</para>
<para
>Un champ de fusion est un mot-clé dans le document. Ce mot-clé sera remplacé dans chaque document personnalisé par la valeur de l'entrée pour cet enregistrement particulier.</para>

<sect4 id="mail-merge-field-insert">
<title
>Insérer un champ de fusion</title>
<indexterm
><primary
>fusion du courrier</primary
><secondary
>insérer les champs de fusion</secondary
></indexterm>

<para
>Pour insérer un champ de fusion, placez le curseur à l'emplacement désiré dans le document. Sélectionnez <menuchoice
><guimenu
>Insertion</guimenu
><guimenuitem
>Variable</guimenuitem
><guimenuitem
>Fusionner le courrier</guimenuitem
></menuchoice
> à partir de la barre de menus. Une liste d'entrées disponibles apparaîtra. Sélectionnez l'entrée désirée et cliquez sur <guibutton
>OK</guibutton
>.</para>
<para
>Le champ de fusion est inséré à l'emplacement du curseur. Le champ de fusion est entre parenthèses.</para>
<para
>Vous pouvez placer le curseur à une autre endroit dans le document et insérer un autre mot clé. Lorsque vous avez fini l'insertion des mots-clés, vous pouvez procéder à l'impression de votre document.</para>
</sect4>

<sect4 id="mail-merge-field-delete">
<title
>Supprimer un champ de fusion</title>
<indexterm
><primary
>fusion du courrier</primary
><secondary
>suppression d'un champ de fusion</secondary
></indexterm>

<para
>Pour supprimer un champ de fusion, placez simplement le curseur à la fin de celui-ci et appuyez sur la touche &Correction;. Tout le champ de fusion sera supprimé.</para>
<para
></para>
</sect4>
</sect3>

<sect3 id="mail-merge-print">
<title
>Prévisualiser et imprimer le document fusionné</title>
<indexterm
><primary
>fusion du courrier</primary
><secondary
>fusion des données et du texte</secondary
></indexterm>

<para
>Lorsque vous avez inséré tous les champs de fusion souhaités, vous êtes prêt à prévisualiser et imprimer les documents personnalisés.</para>
<sect4 id="mail-merge-print-preview">
<title
>Prévisualiser votre document avant impression</title>
<para
>Pour prévisualiser votre document, sélectionnez <menuchoice
><guimenu
>Outils</guimenu
><guimenuitem
>Configurer la fusion du courrier</guimenuitem
></menuchoice
> à partir de la barre de menus. Une boîte de dialogue apparaîtra.</para>

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

<para
>Sélectionnez <guilabel
>Afficher l'aperçu...</guilabel
>. Vous pourrez voir la sortie finale de vos documents personnalisés avant impression.</para>
</sect4>
<sect4 id="mail-merge-print-printing">
<title
>Imprimer vos documents personnalisés.</title>
<para
>Vous imprimez les documents personnalisés en utilisant la même méthode que celle utilisée pour imprimer les documents traditionnels. Pour obtenir plus d'informations concernant l'impression, consultez la section <link linkend="printing"
>Imprimer un document</link
>.</para>
</sect4>
</sect3>
</sect2>
</sect1>
