Merge pull request #399 from telerik/new-kb-populate-table-data-mail-merge-25e9bf702b9e43a2b3ed3479b55d5a20

Added new kb article populate-table-data-mail-merge

Author: dessyordanova

knowledge-base/images/populate-table-data-mail-merge-original.png

@@ -0,0 +1,112 @@
+---
+title: Populate a Table with Data using Nested Mail Merge Functionality
+description: Learn how to populate a table with data using the Nested Mail Merge functionality.
+type: how-to
+page_title: Populate a Table with Data using Nested Mail Merge Functionality
+slug: populate-table-data-mail-merge
+tags: mail, merge, mailmerge, word, table, data, nested
+res_type: kb
+---
+
+# Environment
+
+| Version | Product | Author | 
+| --- | --- | ---- | 
+| 2024.1.124 | RadWordsProcessing |[Desislava Yordanova](https://www.telerik.com/blogs/author/desislava-yordanova)| 
+
+# Description
+
+Learn how to generate a Word (.DOCX) document that contains a [Table]({%slug radwordsprocessing-model-table%}) with a header row and an item row merge field. Then, passing a collection of records automatically creates and populates the data rows. 
+
+# Solution
+
+To achieve the desired result, you can use the [Nested Mail Merge]({%slug radwordsprocessing-editing-mail-merge%}) functionality that [RadWordsProcessing]({%slug radwordsprocessing-overview%}) offers and populate the data rows automatically.
+
+Here's a sample code snippet that demonstrates how to achieve this:
+
+```csharp
+internal class Program
+{
+    static void Main(string[] args)
+    {
+        List<Player> players = GetPlayers();
+        List<PlayersHolder> playersHolders = new List<PlayersHolder>() { new PlayersHolder(players) };
+        RadFlowDocument document = new RadFlowDocument();
+        RadFlowDocumentEditor editor = new RadFlowDocumentEditor(document);
+
+        Table table = editor.InsertTable(2, 2);
+        
+        table.Rows[0].Cells[0].Blocks.AddParagraph().Inlines.AddRun("First Name");
+        table.Rows[0].Cells[1].Blocks.AddParagraph().Inlines.AddRun("Last Name");
+        TableRow row = table.Rows[1];
+        var firstNameParagraph = table.Rows[1].Cells[0].Blocks.AddParagraph();
+        editor.MoveToParagraphStart(firstNameParagraph);
+        editor.InsertField("MERGEFIELD TableStart:Players", "");
+        editor.InsertField("MERGEFIELD FirstName", "");
+
+        var lastNameParagraph = table.Rows[1].Cells[1].Blocks.AddParagraph();
+        editor.MoveToParagraphStart(lastNameParagraph);
+        editor.InsertField("MERGEFIELD LastName", "");
+        editor.InsertField("MERGEFIELD TableEnd:Players", "");
+
+        table.PreferredWidth = new TableWidthUnit(TableWidthUnitType.Percent, 100);
+        Border border = new Border(1, BorderStyle.Single, new ThemableColor(Colors.Black));
+        table.Borders = new TableBorders(border);
+
+        editor.MoveToTableEnd(table);
+
+        editor.InsertParagraph();
+        RadFlowDocument mergedDocument = document.MailMerge(playersHolders);
+        string resultFileNameDocx = "merged.docx";
+        File.Delete(resultFileNameDocx);
+        DocxFormatProvider provider = new DocxFormatProvider();
+        using (var output = File.OpenWrite(resultFileNameDocx))
+        {
+            provider.Export(mergedDocument, output);
+        }
+        Process.Start(resultFileNameDocx);
+    }   
+    
+    public static List<Player> GetPlayers()
+    {
+        var Players = new List<Player>();
+
+        Players.Add(new Player() { FirstName = "John", LastName = "Baker" });
+        Players.Add(new Player() { FirstName = "Sam ", LastName = "Wayne" });
+        Players.Add(new Player() { FirstName = "Patrick", LastName = "Gibbs" });
+        Players.Add(new Player() { FirstName = "Oscar", LastName = "Stevens" });
+        Players.Add(new Player() { FirstName = "Larry", LastName = "Vodden" });
+
+        return Players;
+    }
+}
+
+public class PlayersHolder
+{
+    public PlayersHolder(List<Player> players)
+    {
+        Players = players;
+    }
+
+    public List<Player> Players { get; set; }
+}
+
+public class Player {
+    public string FirstName { get; set; }
+    public string LastName { get; set; }
+}
+```
+
+This code snippet will produce the desired result, merging the data into the table in the Word document.
+
+![Populate Table Data](images/populate-table-data-mail-merge.png) 
+
+
+If you skip the MailMerge step, the following template will be produced:
+
+![Populate Table Data](images/populate-table-data-mail-merge-original.png) 
+
+## See Also
+
+* [Nested Mail Merge]({%slug radwordsprocessing-editing-mail-merge%})
+* [Table]({%slug radwordsprocessing-model-table%})

knowledge-base/images/populate-table-data-mail-merge.png

@@ -215,3 +215,4 @@ If you want to separate the items into several rows you need to close the group
  * [RadFlowDocument]({%slug radwordsprocessing-model-radflowdocument%})
  * [Hiding MailMerge Line in Output Word Document If Blank]({%slug hide-mailmerge-line-output-word-document-if-blank%})
  * [Inserting Images using Mail Merge]({%slug inserting-images-using-mail-merge-radwordsprocessing%})
+ * [Populate a Table with Data using Nested Mail Merge Functionality]({%slug populate-table-data-mail-merge%})