Sections

When merging multiple records using the TX Text Control's &#9584; TX Text Control .NET Server &#9584; DocumentServer Namespace &#9584; MailMerge Class &#9584; MergeJsonData Method Merges data given as a JSON string into a document template. " data-tippy-interactive="true" data-tippy-placement="bottom" data-tooltip-width="wide"

>Merge Json Data method, the append parameter determines whether the output is a single document with each record in a new section or multiple separate documents.

Templates that contain only a first page header can be tricky in scenarios where the append parameter is set to true to append all records to a resulting document. If set to false, individual documents are created and the first page header is only visible on page 1.

The Problem

But when appended, the first page header is rendered for all sections, and if the header contains merge fields, they are populated with data from the first record. So basically, after the merge, you have all the records merged into separate sections, but the header and footer contain the merge field data from the first record.

Let's take a look at the following template:

You can see a first page header with a merge field and the main body containing a merge block. This is the JSON data that will be used to merge the content into the template.

[ { "invoice": "INV-001", "date": "2023-10-01", "items": [ { "name": "Widget A", "description": "A longer description of Widget A.", "quantity": 2, "unit_price": 10.00 }, { "name": "Widget B", "description": "A longer description of Widget B.", "quantity": 1, "unit_price": 20.00 } ] }, { "invoice": "INV-002", "date": "2023-10-02", "items": [ { "name": "Widget C", "description": "A longer description of Widget C.", "quantity": 5, "unit_price": 5.00 }, { "name": "Widget D", "description": "A longer description of Widget D.", "quantity": 3, "unit_price": 15.00 } ] } ] The following code shows how to merge the JSON data into the template using the MergeJsonData method.

using System.IO; using TXTextControl; using TXTextControl.DocumentServer;

// Create and initialize a ServerTextControl instance using var tx = new ServerTextControl();

// Create a new, empty document tx.Create();

// Load the template in the internal Unicode format tx.Load("template.tx", StreamType.InternalUnicodeFormat);

// Set up the MailMerge engine and assign the TextComponent var mailMerge = new MailMerge { TextComponent = tx };

// Read JSON data from a file var jsonData = File.ReadAllText("data.json");

// Merge JSON data into the loaded template // `append: true` means merge all records into one document, each in a new section mailMerge.MergeJsonData(jsonData, append: true);

// Save the merged result as a PDF file tx.Save("result.pdf", StreamType.AdobePDF); After the merge, the resulting document looks like this:

The Solution

As you can see, the header of the second attached document contains the merge data from the first record. This is not what we want. A new section is added for each record, and a unique first page header should be added for all pages in each section. But we know that a new section is added for all records, so we can use a header and footer setting to implement this requirement.

For the first page header, we use the &#9584; TX Text Control .NET Server &#9584; TXTextControl Namespace &#9584; HeaderFooter Class &#9584; ConnectedToPrevious Property Gets or sets a value specifying whether the header or footer is connected with the header or footer of the previous section. " data-tippy-interactive="true" data-tippy-placement="bottom" data-tooltip-width="wide"

>Connected To Previous property and set it to false for the first page header. This means that the first page header is not connected to the header of the previous section.

Now the first page header is not linked to the previous section, and the merge field is populated with the data from the current record. Below is the resulting document after the merge:

As you can see, the first page header is now populated with the data from the current record.

Conclusion

In this article, we learned how to use the &#9584; TX Text Control .NET Server &#9584; DocumentServer Namespace &#9584; MailMerge Class &#9584; MergeJsonData Method Merges data given as a JSON string into a document template. " data-tippy-interactive="true" data-tippy-placement="bottom" data-tooltip-width="wide"

>Merge Json Data method to merge multiple records into a single document with a first page header. We also learned how to set the ConnectedToPrevious property to false for the first page header to ensure that it is not connected to the previous section.

By using this approach, we can ensure that the first page header is populated with the data from the current record and not the first record.

TX Text Control .NET Server

DS Server

Server & Web

Windows Forms

WPF

ActiveX

Core Technologies

Blog

Core Technologies

Blog

Authors

Latest Posts

Support Resources

Documentation

Support

Getting Started

Other Resources

About Us

Industry events

Company

Contact

Newsletter

Legal

Sign in

Create account

Text Control Account

Sections

Post tagged with Sections in 2025

Server & Web

Windows Forms

WPF

ActiveX

Core Technologies

​

Latest Posts

​

Support

Getting Started

​

Other Resources

Company

Contact

Newsletter

Legal

Text Control Account

​

​

Sections

Post tagged with Sections in 2025 ​

April 2025

Post tagged with Sections in 2025