# Fusion du courrier

&kword; dispose de la capacité d'utiliser des données provenant d'une base de données externe (ou d'une base de données interne) pour personnaliser vos documents à l'intention de vos amis/clients/membres.

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 :

- La création d'une base de données externe.

- Les problèmes de sécurité concernant les bases de données.

- 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.

- Accéder au réseau ou à Internet

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

Si vous voulez utiliser la base de données interne à &kword;, cliquez ici.

## Utilisation d'une base de données externe (SQL) pour créer des documents.

&kword; a la capacité d'utiliser plusieurs des bases de données open source les plus réputées comme source de données des documents personnalisés.

Votre machine doit disposer du module approprié compilé dans votre copie de Qt pour pouvoir accéder à une base de données externe utilisant SQL.

Pour obtenir plus d'informations, consultez la section installation de ce document.

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.

Vous devez connaître les informations suivantes pour pouvoir utiliser la base de données :

- Nom de la base de données

- Nom de machine/adresse IP de l'ordinateur sur lequel la base de données est située

- Numéro du port de l'ordinateur spécifié offrant l'accès SQL

- Un nom d'utilisateur valable pour la base de données

- Un mot de passe valable pour le nom d'utilisateur

Si vous possédez toutes ces informations, vous êtes prêt à continuer

L'utilisation d'une base de données externe pour créer des documents personnalisés est un processus en trois étapes :

1. Connectez-vous à la base de données et sélectionnez votre requête.

2. Insérez les champs de fusion pour indiquer à &kword; où insérer les informations de la base de données

3. Imprimez les documents personnalisés.

### Situez la base de données et effectuez des requêtes sur les enregistrements.

Pour commencer, sélectionnez Outils Configurer la fusion du courrier... à partir de la barre de menu. Une boîte de dialogue apparaîtra.

Cliquez sur En ouvrir une existante.... Une autre petite boîte de dialogue apparaîtra.

Il n'existe actuellement qu'une seule option dans la boîte de dialogue (Source QT-SQL). Cliquez sur OK. Une nouvelle boîte de dialogue apparaîtra.

Saisissez l'URL ou l'adresse IP de l'ordinateur qui contient la base de données dans le champ texte étiqueté Nom d'hôte : .

Sélectionnez le pilote adéquat à partir de la liste déroulante étiquetée Pilote.

Écrivez le nom de la base de données qui vous a été fourni dans le champ texte étiqueté Nom de base de données : et un nom d'utilisateur dans le champ texte étiqueté Nom d'utilisateur : .

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 étiqueté Port : .

Si vous comptez utiliser cette base de données à d'autres occasions, vous pouvez cliquer sur le bouton étiqueté Conserver les réglages. &kword; vous demandera un nom descriptif.

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.

Quand toutes les informations sont correctes, cliquez sur OK. &kword; vous demandera votre mot passe pour cette base de données. Mettez le mot de passe dans le champ texte et cliquez sur OK.

Cette boîte de dialogue apparaîtra de nouveau.

Cliquez sur Modifier l'actuelle.... Une autre boîte de dialogue apparaîtra.

Cette boîte de dialogue est conçue pour vous aider à entrer 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.

La section d'informations sur la base de données est étiquetée Information et se compose de deux boîtes combo. La boîte combo de gauche (Tables disponibles) 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 boîte combo de droite.

La ligne de requête est une boîte de texte située près du bas de la boîte de dialogue étiquetée Requête. Entrez simplement votre requête SQL dans la boîte de texte et cliquez sur Exécuter. &kword; exécutera la requête sur la base de données et retournera la requête spécifiée dans la boîte Résultat de la requête. Vous pouvez modifier ou éditer votre requête sur la ligne de requête et chaque fois que vous cliquerez sur Exécuter, le nouveau résultat de la requête apparaîtra.

&kword; ne limite pas vos chaînes de requête. Il peut s'agir de requêtes simples et directes :

`select * from eMail`

ou de requêtes complexes multitables :

`select eMail.FirstName, eMail.LastName, eMail.address, data.Birthday, data.EyeColour from eMail, data where data.FirstName=eMail.FirstName and data.LastName=eMail.LastName`

Le fait de cliquer sur Configuration vous permettra de vous connecter à une base de données différente.

Lorsque vous avez effectué la requête adéquate dans le champ texte Requête, cliquez sur OK pour sélectionner cette requête.

Cela vous renverra à la boîte de dialogue principale de fusion de courrier.

Cliquez sur Fermer.

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 ici pour continuer.

## Utilisation d'une représentation interne des données tabulaires pour créer des documents

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é d'entrer les données directement dans &kword; 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.

L'utilisation de la représentation interne de données pour créer des documents personnalisés est un processus en trois étapes :

1. Entrez les données dans &kword;

2. Insérez les champs de fusion pour indiquer à &kword; où insérer les informations de la base de données

3. Imprimez les documents personnalisés.

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.

### Entrer les données

Pour commencer, sélectionnez Outils Configurer la fusion du courrier... à partir de la barre de menu. Une boîte de dialogue apparaîtra.

Cliquez sur En créer une nouvelle.... Une autre petite boîte de dialogue apparaîtra.

Il n'y a actuellement qu'une option dans cette boîte de dialogue, Stockage interne. Cliquez sur OK. Une nouvelle boîte de dialogue apparaîtra.

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.

#### Définition de la structure de votre table de données

Nous avons besoin, en premier, d'ajouter une ou plusieurs entrées (champs de fusion). Ceci s'obtient en cliquant le bouton (Ajouter une entrée) (troisième bouton à partir de la droite sur la barre d'outils). Une petite boîte de dialogue apparaîtra. Tapez un nom descriptif de votre entrée dans le boîte de dialogue (Nom, Adresse, Solde dû, etc.).

C'est le nom de l'entrée et non les données qui sont contenues dans l'entrée.

Cliquez sur OK et l'entrée est ajoutée à la carte.

Répétez ce processus jusqu'à ce que toutes les données nécessaires soient visibles dans cette première carte.

Si vous voulez supprimer une entrée, cliquez simplement sur le nom de l'entrée avec le &BGS; et sélectionnez (Supprimer l'entrée).

Assurez-vous bien d'avoir sélectionné le nom d'entrée correct. Une fois que vous aurez dit à &kword; de supprimer l'entrée, celle-ci, ainsi que toutes les données qui y sont contenues seront supprimées immédiatement. Vous n'aurez pas la possibilité d'arrêter ou d'inverser le processus une fois qu'il est entamé.

#### Entrer les données dans la table

Maintenant que la structure de vos données est définie, vous pouvez saisir vos données dans vos entrées.

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.

bouton | Action
--- | ---
| Se déplacer directement au premier enregistrement
| Reculer d'un enregistrement
| Avancer d'un enregistrement
| Aller au dernier enregistrement de l'ensemble de données

Pour entrer les données, placez simplement le curseur dans le champ texte à droite du nom de l'entrée et tapez les données. (&kword; utilise Pas de valeur comme valeur par défaut pour toutes les entrées dans les enregistrements nouvellement créés).

Pour ajouter un nouvel enregistrement, cliquez sur le bouton .

Pour supprimer un enregistrement, cliquez sur le bouton .

Soyez prudent losrque vous supprimez des enregistrements. Une fois supprimés, les enregistrements ne peuvent pas être récupérés.

Continuez d'entrer toutes les données jusqu'à ce que votre ensemble de données soit complet.

Lorsque votre ensemble de données est complet, cliquez sur OK pour enregistrer les changements apportés à celui-ci. Ceci fera apparaître la boîte de dialogue de fusion principale.

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

### Insérer des champs de fusion dans un document

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.

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.

#### Insérer un champ de fusion

Pour insérer un champ de fusion, placez le curseur à l'emplacement désiré dans le document. Sélectionnez Insertion VariableFusionner le courrier à partir de la barre de menu. Un liste d'entrées disponibles apparaîtra. Sélectionnez l'entrée désirée et cliquez sur OK.

Le champ de fusion est inséré à l'emplacement du curseur. Le champ de fusion est entre parenthèses.

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.

#### Supprimer un champ de fusion

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

### Prévisualiser et imprimer le document fusionné

Lorsque vous avez inséré tous les champs de fusion souhaités, vous êtes prêt à prévisualiser et imprimer les documents personnalisés.

#### Prévisualiser votre document avant impression

Pour prévisualiser votre document, sélectionnez Outils Configurer la fusion du courrier à partir de la barre de menu. Une boîte de dialogue apparaîtra.

Sélectionnez Afficher l'aperçu.... Vous pourrez voir la sortie finale de vos documents personnalisés avant impression.

#### Imprimer vos documents personnalisés.

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 sur Imprimer un document.