Typen Mail Merge - bewerking

Het belangrijkste idee van Mail Merge is om automatisch een document of meerdere documenten te maken op basis van uw sjabloon en gegevens die uit uw gegevensbron zijn opgehaald. Met Aspose.Words kunt u twee verschillende soorten Mail Merge bewerkingen uitvoeren: eenvoudig Mail Merge en Mail Merge met regio ' s.

Het meest voorkomende voorbeeld van het gebruik van simple Mail Merge is wanneer u een document voor verschillende clients wilt verzenden door hun namen aan het begin van het document op te nemen. Hiervoor moet u samenvoegvelden zoals First Name en Last Name in uw sjabloon maken en deze vervolgens invullen met gegevens uit uw gegevensbron. Terwijl het meest voorkomende voorbeeld van het gebruik van Mail Merge Met regio ' s is wanneer u een document wilt verzenden dat specifieke bestellingen bevat met de lijst van alle items binnen elke bestelling. Om dit te doen, moet u merge – regio ' s maken binnen uw template-eigen regio voor elke bestelling, om deze te vullen met alle vereiste gegevens voor de items.

Het belangrijkste verschil tussen beide samenvoegbewerkingen is dat eenvoudig Mail Merge (zonder regio ’s) het hele document per gegevensbronrecord herhaalt, terwijl Mail Merge met regio' s alleen aangewezen regio ' s per record herhaalt. U kunt een eenvoudige Mail Merge - bewerking zien als een specifiek geval van samenvoegen met regio ' s waarbij het enige gebied het hele document is.

De MailMerge klasse vertegenwoordigt een Mail Merge functionaliteit. Met zijn eigenschappen kunt u het vereiste gedrag aanpassen voordat u een Mail Merge - bewerking uitvoert.

Eenvoudige Mail Merge Bewerking

Een eenvoudige Mail Merge wordt gebruikt om de Mail Merge velden in uw sjabloon te vullen met de vereiste gegevens uit uw gegevensbron (weergave van één tabel). Dus het is vergelijkbaar met de klassieke Mail Merge in Microsoft Word.

U kunt een of meer samenvoegvelden toevoegen aan uw sjabloon en vervolgens de eenvoudige bewerking Mail Merge uitvoeren. Het wordt aanbevolen om het te gebruiken als uw sjabloon geen samenvoeggebieden bevat.

De belangrijkste beperking van het gebruik van dit type is dat de volledige documentinhoud voor elke record in de gegevensbron wordt herhaald.

Een eenvoudige Mail Merge - bewerking {#how-to-execute-a-simple-mail-merge-operation}uitvoeren

Zodra uw sjabloon klaar is, kunt u beginnen met het uitvoeren van de eenvoudige Mail Merge - bewerking. Met Aspose.Words kunt u een eenvoudige Mail Merge - bewerking uitvoeren met verschillende Execute methods die verschillende gegevensobjecten als gegevensbron accepteren.

Het volgende codevoorbeeld laat zien hoe u een eenvoudige Mail Merge - bewerking uitvoert met behulp van een van de Execute - methode:

U kunt het verschil tussen het document opmerken voordat u simple mail mergeuitvoert:

En na het uitvoeren van simple mail merge:

Hoe meerdere samengevoegde documenten te maken

In Aspose.Words vult de standaard Mail Merge - bewerking slechts één document met inhoud uit uw gegevensbron. U moet de bewerking Mail Merge dus meerdere keren uitvoeren om meerdere samengevoegde documenten als uitvoer te maken.

Het volgende codevoorbeeld laat zien hoe u meerdere samengevoegde documenten kunt genereren tijdens een bewerking van Mail Merge:

U kunt het voorbeeldbestand van dit voorbeeld downloaden van Aspose.Words GitHub.

Mail Merge Met regio ' s

U kunt verschillende regio ' s in uw sjabloon maken om speciale gebieden te hebben die u eenvoudig met uw gegevens kunt vullen. Gebruik Mail Merge Met regio ’s als u tabellen, rijen met herhalende gegevens wilt invoegen om uw documenten dynamisch te laten groeien door deze regio' s in uw sjabloon op te geven.

U kunt geneste (kind) regio ’s maken en regio' s samenvoegen. Het belangrijkste voordeel van het gebruik van dit type is om delen in een document dynamisch te vergroten. Zie meer details in het volgende artikel “geneste Mail Merge Met regio ’s”.

Informatie over een Mail Merge Regio kan worden verkregen met behulp van de MailMergeRegionInfo Klasse.

Mail Merge uitvoeren met regio ' s

Een Mail Merge regio is een specifiek deel in een document dat een begin-en eindpunt heeft. Beide punten worden weergegeven als Mail Merge velden met specifieke namen “TableStart:XXX” en “TableEnd:XXX”. Alle inhoud die is opgenomen in een Mail Merge - regio wordt automatisch herhaald voor elke record in de gegevensbron.

Met Aspose.Words kunt u Mail Merge uitvoeren met regio ' s met verschillende Execute methods die verschillende gegevensobjecten als gegevensbron accepteren.

Als eerste stap moeten we de DataSet maken om deze later als invoerparameter door te geven aan de ExecuteWithRegions methode:

Het volgende codevoorbeeld laat zien hoe Mail Merge met regio ' s uitgevoerd moet worden met behulp van de ExecuteWithRegions(DataSet) methode:

U kunt het verschil tussen het document opmerken voordat u Mail Merge uitvoert met regio ' s:

En na het uitvoeren van Mail Merge Met regio ' s:

Beperkingen van Mail Merge Met regio ' s

Er zijn enkele belangrijke punten waar u rekening mee moet houden bij het uitvoeren van een Mail Merge Met regio ' s:

• Het beginpunt TableStart:Orders en het eindpunt TableEnd:Orders moeten beide in dezelfde rij of cel staan. Als u bijvoorbeeld een samenvoeggebied start in een cel van een tabel, moet u het samenvoeggebied beëindigen in dezelfde rij als de eerste cel.
• De naam van het veld samenvoegen moet overeenkomen met de naam van de kolom in uw DataTable. Tenzij u toegewezen velden hebt opgegeven, zal de Mail Merge Met regio ' s niet succesvol zijn voor een samenvoegveld met een andere naam dan de naam van de kolom.

Als een van deze regels wordt overtreden, krijg je onverwachte resultaten of kan er een uitzondering worden gegooid.

Als u geen Mail Merge - regio ' s gebruikt, is deze vergelijkbaar met Microsoft Word mail merge en wordt de hele documentinhoud herhaald voor elke record in de gegevensbron.