Imbriqué Mail Merge avec des régions
Dans certains scénarios, vous devrez peut-être utiliser des Mail Merge imbriqués avec des régions. La fusion imbriquée est une fonctionnalité qui vous permet de fusionner des données hiérarchiques de votre source de données dans votre modèle de fusion pour remplir facilement votre document. Fondamentalement, les données hiérarchiques sont représentées comme un ensemble d’éléments de données, et les relations hiérarchiques décrivent comment les éléments de données sont liés les uns aux autres (un élément de données est le parent d’un autre).
Aspose.Words vous permet d’effectuer une opération Mail Merge avec des régions imbriquées. Vous pouvez utiliser cette fonctionnalité si vous disposez d’une source de données organisée en structure arborescente et que vous souhaitez exécuter une opération Mail Merge pour remplir un modèle avec des données hiérarchiques.
Qu’est-ce qu’un Mail Mergeimbriqué
La région Mail Merge est appelée imbriquée si vous avez au moins deux régions Mail Merge dont l’une est à l’intérieur de l’autre sous une forme hiérarchique. Notez que chaque région contient les données d’une table.
L’exemple le plus courant d’un Mail Merge imbriqué est un ordre qui contient plusieurs éléments dans lequel vous devez lier plusieurs tables de données et présenter les informations dans un modèle.
L’image ci-dessous montre deux régions imbriquées où la région Order Mail Merge est le parent de la région Item Mail Merge.
Comment traiter Mail Merge avec des régions imbriquées
Les données à fusionner dans un modèle peuvent provenir de diverses sources, principalement des bases de données relationnelles ou des documents XML. Dans notre exemple, nous allons utiliser un fichier XML pour stocker nos données et les charger directement dans le DataSet.
Aspose.Words vous permet de traiter Mail Merge avec des régions imbriquées en utilisant les relations de données spécifiées dans DataSet. Lorsque l’objet DataSet charge XML, il utilise le schéma fourni ou le déduit de la structure du XML lui-même pour y parvenir. À partir de cette structure, il crée des relations entre les tables si nécessaire.
L’image ci-dessous montre comment les données de la table Order transmises aux régions de fusion imbriquées seront liées à la table Item, ainsi que la sortie générée lors de l’opération de fusion.
Comme vous pouvez le voir dans le document de sortie, chaque commande de la table Order est insérée dans le modèle de fusion avec tous les éléments associés de la commande de la table Item. La prochaine commande sera insérée avec leurs articles jusqu’à ce que toutes les commandes et tous les articles soient répertoriés. L’ordre d’imbrication Mail Merge des régions dans le modèle doit correspondre aux relations de données entre les tables de la source de données.
L’exemple de code suivant montre comment générer une facture à l’aide de Mail Merge imbriqués avec des régions:
Comment configurer des Relations de Données dans Mail Merge imbriquées avec des Régions
Vous devez configurer toutes les relations de données dans la structure parent-enfant pour exécuter correctement les régions Mail Merge imbriquées. Ignorer cette étape importante peut entraîner l’échec de l’exécution des régions Mail Merge imbriquées.
Lors de la récupération de données pour un Mail Merge imbriqué à partir d’un fichier XML à l’aide de la méthode ReadXml, des relations sont automatiquement créées en fonction de la structure du document XML. Cependant, vous devez vous assurer que des relations correctes ont été créées.
Si Mail Merge ne fonctionne pas comme prévu, vous devrez peut-être restructurer votre fichier XML ou créer explicitement des relations entre les objets DataTable dans le DataSet.
Un DataSet qui a des tables de données associées utilisera l’objet DataRelation pour représenter la relation parent-enfant entre les tables.
L’exemple de code suivant montre comment établir un DataRelation entre la table d’un client et la table d’une commande à l’aide d’un objet DataRelation:
dataSet.getRelations().add(new DataRelation("OrderToItem", orderTable.getColumns().get("Order_Id"), itemTable.getColumns().get("Order_Id"), false));