Merge branch 'master' into new-kb-inserting-special-symbols-pdf-radpdfprocessing-edb732d7e0be4da39da3676e06ecdab3

Author: dessyordanova

knowledge-base/exporting-xlsx-to-pdf-formatting-issues.md

@@ -0,0 +1,105 @@
+---
+title: How to Eliminate Formatting Issues when Exporting XLSX to PDF Format
+description: This article provides a solution to formatting difficulties when exporting an XLSX file to PDF using the RadSpreadProcessing library.
+type: troubleshooting
+page_title: How to Eliminate Formatting Issues when Exporting XLSX to PDF Format
+slug: exporting-xlsx-to-pdf-formatting-issues
+tags: excel, pdf, font, width, column, standard
+res_type: kb
+---
+
+##Environment
+| Version | Product | Author | 
+| --- | --- | ---- | 
+| .NET Standard | RadSpreadProcessing |[Desislava Yordanova](https://www.telerik.com/blogs/author/desislava-yordanova)| 
+
+## Description
+This article demonstrates how to deal with formatting difficulties when exporting an XLSX file to PDF using the RadSpreadProcessing library in .NET Standard. 
+
+The most common scenario is:
+1. [Export an XLSX file to PDF]({%slug radspreadprocessing-formats-and-conversion-pdf-pdfformatprovider%}) using the RadSpreadProcessing library.
+2. Observe the resulting PDF file with truncated columns or different font.
+
+![Export Differences](images/exporting-xlsx-to-pdf-formatting-issues01.png)   
+
+## Solution
+The limitations of .NET Standard may cause differences in the font and text size (text measuring) when converting to PDF format.
+
+1\. To address the issue with the size discrepancy, set a [SpreadFixedTextMeasurer]({%slug radspreadprocessing-cross-platform-text-measure%}}) to handle the problem with the size:
+
+```csharp
+        SpreadTextMeasurerBase fixedTextMeasurer = new SpreadFixedTextMeasurer();
+        SpreadExtensibilityManager.TextMeasurer = fixedTextMeasurer;
+```
+
+2\. Implement a [FontsProvider]({%slug pdfprocessing-implement-fontsprovider%}) to handle differences in fonts. 
+
+```csharp
+        FontsProviderBase fontsProvider = new FontsProvider();
+        FixedExtensibilityManager.FontsProvider = fontsProvider;
+```
+
+This class provides a mechanism to read the fonts used in the document:
+
+```csharp
+    public class FontsProvider : Telerik.Windows.Documents.Extensibility.FontsProviderBase
+    {
+        public override byte[] GetFontData(Telerik.Windows.Documents.Core.Fonts.FontProperties fontProperties)
+        {
+            string fontFileName = fontProperties.FontFamilyName + ".ttf";
+            string fontFolder = Environment.GetFolderPath(Environment.SpecialFolder.Fonts);
+
+            //The fonts can differ depending on the file 
+            if (fontProperties.FontFamilyName == "Trebuchet MS")
+            {
+                if (fontProperties.FontStyle == FontStyles.Italic && fontProperties.FontWeight == FontWeights.Bold)
+                {
+                    fontFileName = $"trebucbi.ttf";
+                }
+                else if (fontProperties.FontStyle == FontStyles.Italic)
+                {
+                    fontFileName = $"trebucit.ttf";
+                }
+                else if (fontProperties.FontWeight == FontWeights.Normal)
+                {
+                    fontFileName = "trebuc.ttf";
+                }
+                else if (fontProperties.FontWeight == FontWeights.Bold)
+                {
+                    fontFileName = $"trebucbd.ttf";
+                }
+            }        
+            
+
+            //...add more fonts if needed... 
+
+            DirectoryInfo directory = new DirectoryInfo(fontFolder);
+            FileInfo[] fontFiles = directory.GetFiles();
+
+            var fontFile = fontFiles.FirstOrDefault(f => f.Name.Equals(fontFileName, StringComparison.InvariantCultureIgnoreCase));
+            if (fontFile != null)
+            {
+                var targetPath = fontFile.FullName;
+                using (FileStream fileStream = File.OpenRead(targetPath))
+                {
+                    using (MemoryStream memoryStream = new MemoryStream())
+                    {
+                        fileStream.CopyTo(memoryStream);
+                        return memoryStream.ToArray();
+                    }
+                }
+            }
+
+            return null;
+        }
+    }
+```
+Now, the font in the exported PDF document is the correct one and the text is not clipped.
+
+![Hande Export Differences](images/exporting-xlsx-to-pdf-formatting-issues02.png)    
+
+## See Also
+- [Cross-Platform Support]({%slug radspreadprocessing-cross-platform%})
+- [Text Measuring]({%slug radspreadprocessing-cross-platform-text-measure%})
+- [Fonts in PdfProcessing]({%slug radpdfprocessing-cross-platform-fonts%})
+- [How to implement FontsProvider]({%slug pdfprocessing-implement-fontsprovider%})

knowledge-base/images/exporting-xlsx-to-pdf-formatting-issues01.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/exporting-xlsx-to-pdf-formatting-issues02.png

@@ -25,4 +25,5 @@ You can find a detailed **FixedExtensibilityManager** and **FontsProvider** desc
  * [Standard Fonts]({%slug radpdfprocessing-concepts-fonts%})
  * [Cross-Platform Support]({%slug radpdfprocessing-cross-platform%})
  * [Inserting Special Symbols in PDF using RadPdfProcessing]({%slug inserting-special-symbols-pdf-radpdfprocessing%})
- * [How to Eliminate Formatting Issues when Exporting XLSX to PDF Format]({%slug exporting-xlsx-to-pdf-formatting-issues%})
+ * [How to Eliminate Formatting Issues when Exporting XLSX to PDF Format]({%slug exporting-xlsx-to-pdf-formatting-issues%})
+

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

@@ -109,7 +109,7 @@ You can assign any **SpreadTextMeasurerBase** implementation to the **SpreadExte
 
 
 ## See Also
-
+ * [How to Eliminate Formatting Issues when Exporting XLSX to PDF Format]({%slug exporting-xlsx-to-pdf-formatting-issues%})
  * [Cross-Platform Support]({%slug radspreadprocessing-cross-platform%})
  * [Using XlsxFormatProvider]({%slug radspreadprocessing-formats-and-conversion-xlsx-xlsxformatprovider%})
  * [Using PdfFormatProvider]({%slug radspreadprocessing-formats-and-conversion-pdf-pdfformatprovider%})

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

@@ -69,6 +69,6 @@ The result from the export method is a document that can be opened in any applic
 >tip __RadFixedDocument__ is the base class of the __RadPdfProcessing__ library. Additional information on the library and its functionality can be found [here]({%slug radpdfprocessing-overview%}).
 
 ## See Also
-
-* [Import/Load and Export/Save RadSpreadProcessing Workbook]({%slug import-export-save-load-workbook%})
+- [How to Eliminate Formatting Issues when Exporting XLSX to PDF Format]({%slug exporting-xlsx-to-pdf-formatting-issues%})
+- [Import/Load and Export/Save RadSpreadProcessing Workbook]({%slug import-export-save-load-workbook%})
 

knowledge-base/populate-table-data-mail-merge.md

@@ -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%})