Types d'opération Mail Merge
L’idée principale de Mail Merge est de créer automatiquement un document ou plusieurs documents en fonction de votre modèle et des données extraites de votre source de données. Aspose.Words vous permet d’effectuer deux types différents d’opérations Mail Merge: simples Mail Merge et Mail Merge avec des régions.
L’exemple le plus courant d’utilisation de simple Mail Merge est lorsque vous souhaitez envoyer un document à différents clients en incluant leurs noms au début du document. Pour ce faire, vous devez créer des champs de fusion tels que First Name et Last Name dans votre modèle, puis les remplir avec des données de votre source de données. Alors que l’exemple le plus courant d’utilisation de Mail Merge avec des régions est lorsque vous souhaitez envoyer un document qui inclut des commandes spécifiques avec la liste de tous les éléments de chaque commande. Pour ce faire, vous devrez créer des régions de fusion dans votre propre région de modèle pour chaque commande, afin de la remplir avec toutes les données requises pour les articles.
La principale différence entre les deux opérations de fusion est que la simple Mail Merge (sans régions) répète l’intégralité du document pour chaque enregistrement de source de données, tandis que Mail Merge avec des régions répète uniquement les régions désignées par enregistrement. Vous pouvez considérer une simple opération Mail Merge comme un cas particulier de fusion avec des régions où la seule région est le document entier.
Opération simple Mail Merge
Un simple Mail Merge est utilisé pour remplir les champs Mail Merge à l’intérieur de votre modèle avec les données requises de votre source de données (représentation de table unique). C’est donc similaire au classique Mail Merge dans Microsoft Word.
Vous pouvez ajouter un ou plusieurs champs de fusion dans votre modèle, puis exécuter l’opération simple Mail Merge. Il est recommandé de l’utiliser si votre modèle ne contient aucune région de fusion.
La principale limitation de l’utilisation de ce type est que l’ensemble du contenu du document sera répété pour chaque enregistrement de la source de données.
Comment exécuter une opération simple Mail Merge
Une fois que votre modèle est prêt, vous pouvez commencer à effectuer l’opération simple Mail Merge. Aspose.Words vous permet d’exécuter une opération Mail Merge simple en utilisant différents Execute methods qui acceptent divers objets de données comme source de données.
L’exemple de code suivant montre comment exécuter une opération Mail Merge simple en utilisant l’une des méthodes Execute:
Vous pouvez remarquer la différence entre le document avant d’exécuter simple mail merge:
Et après avoir exécuté le simple mail merge:
Comment Créer Plusieurs Documents Fusionnés
Dans Aspose.Words, l’opération standard Mail Merge ne remplit qu’un seul document avec le contenu de votre source de données. Ainsi, vous devrez exécuter l’opération Mail Merge plusieurs fois pour créer plusieurs documents fusionnés en sortie.
L’exemple de code suivant montre comment générer plusieurs documents fusionnés lors d’une opération Mail Merge:
Mail Merge avec les régions
Vous pouvez créer différentes régions dans votre modèle pour avoir des zones spéciales que vous pouvez simplement remplir avec vos données. Utilisez le Mail Merge avec des régions si vous souhaitez insérer des tableaux, des lignes avec des données répétitives pour faire croître dynamiquement vos documents en spécifiant ces régions dans votre modèle.
Vous pouvez créer des régions imbriquées (enfants) ainsi que fusionner des régions. Le principal avantage de l’utilisation de ce type est d’augmenter dynamiquement les parties à l’intérieur d’un document. Voir plus de détails dans le prochain article “Imbriqué Mail Merge avec des régions”.
Comment exécuter Mail Merge avec des régions
Une région Mail Merge est une partie spécifique d’un document qui a un point de départ et un point final. Les deux points sont représentés par des champs Mail Merge portant des noms spécifiques “TableStart:XXX” et “TableEnd:XXX”. Tout le contenu inclus dans une région Mail Merge sera automatiquement répété pour chaque enregistrement de la source de données.
Aspose.Words vous permet d’exécuter Mail Merge avec des régions utilisant différentes Execute methods qui acceptent divers objets de données comme source de données.
Dans un premier temps, nous devons créer le DataSet pour le transmettre plus tard en tant que paramètre d’entrée à la méthode ExecuteWithRegions:
L’exemple de code suivant montre comment exécuter Mail Merge avec des régions à l’aide de la méthode ExecuteWithRegions(DataSet):
Vous pouvez remarquer la différence entre le document avant d’exécuter Mail Merge avec des régions:
Et après avoir exécuté Mail Merge avec des régions:
Limitations de Mail Merge avec les régions
Il y a quelques points importants que vous devez prendre en compte lorsque vous effectuez un Mail Merge avec des régions:
- Le point de départ TableStart:Orders et le point final TableEnd:Orders doivent tous deux se trouver dans la même ligne ou cellule. Par exemple, si vous démarrez une région de fusion dans une cellule d’un tableau, vous devez terminer la région de fusion sur la même ligne que la première cellule.
- Le nom du champ de fusion doit correspondre au nom de la colonne dans votre DataTable. Sauf si vous avez spécifié des champs mappés, le Mail Merge avec des régions ne réussira pas pour tout champ de fusion qui a un nom différent de celui de la colonne.
Si l’une de ces règles est enfreinte, vous obtiendrez des résultats inattendus ou une exception peut être levée.