Skip to content

Commit bef4164

Browse files
committed
add links and images
1 parent 092388c commit bef4164

File tree

3 files changed

+10
-21
lines changed

3 files changed

+10
-21
lines changed
17.2 KB
Loading

knowledge-base/nested-mailmerge-radwordsprocessing.md

Lines changed: 9 additions & 21 deletions
Original file line numberDiff line numberDiff line change
@@ -17,21 +17,15 @@ ticketid: 1668943
1717

1818
## Description
1919

20-
When attempting to perform a MailMerge operation with multiple levels of nested data, such as a list within a list (e.g., `Incident` > `Person` > `Phones`), an issue occurs where the nested collection enumerator exhausts prematurely. How can one resolve multi-layer nesting for MailMerge operations in RadWordsProcessing?
21-
22-
This KB article also answers the following questions:
23-
24-
- How to perform a nested MailMerge operation in RadWordsProcessing?
25-
- How to use MailMerge with lists within lists in RadWordsProcessing?
26-
- How to avoid premature exhaustion of the nested collection enumerator during MailMerge in RadWordsProcessing?
20+
Learn how to perform a [MailMerge]({%slug radwordsprocessing-editing-mail-merge%}) operation with multiple levels of nested data, such as a list within a list (e.g., `Incident` > `Person` > `Phones`) in [RadWordsProcessing]({%slug radwordsprocessing-overview%}).
2721

2822
## Solution
2923

30-
To achieve a nested MailMerge operation with multiple levels of data, follow the steps below:
24+
To achieve a nested [MailMerge]({%slug radwordsprocessing-editing-mail-merge%} operation with multiple levels of data, follow the steps below:
3125

3226
1. Prepare your data model to reflect the nested structure. In this case, the model includes `Incident`, `Person`, and `Phone` classes.
3327

34-
2. Use the `MailMerge` method to merge the data with the document template. Ensure your document template has the appropriate merge fields defined for each level of data.
28+
2. Use the [MailMerge]({%slug radwordsprocessing-editing-mail-merge%}) method to merge the data with the document template. Ensure your document template has the appropriate merge fields defined for each level of data.
3529

3630
3. Use special merge fields (`TableStart`, `TableEnd`, `RangeStart`, and `RangeEnd`) to denote the beginning and end of each nested collection.
3731

@@ -89,20 +83,14 @@ In your document template, ensure you have the corresponding merge fields:
8983

9084
### Generating the Necessary Table Structure in the Document
9185

92-
When dealing with nested collections, it's crucial to dynamically create table structures that can accommodate the varying lengths of these collections. Below is an example showing how to generate a table in the document for `People` and their `Phones`:
93-
94-
```csharp
95-
private static void GenerateTable(RadFlowDocumentEditor editor)
96-
{
97-
// Example code to generate a table structure for People and Phones
98-
// This code should be adapted to fit the structure of your document template
99-
}
100-
```
86+
When dealing with nested collections, it's crucial to dynamically create table structures that can accommodate the varying lengths of these collections.
10187

10288
By following these steps and utilizing the provided code snippets, you can effectively perform nested MailMerge operations with multiple levels of data in RadWordsProcessing.
10389

90+
![Nested mail merge](images/nested-mail-merge-result.png)
91+
10492
## See Also
10593

106-
- [Nested MailMerge Documentation](https://docs.telerik.com/devtools/document-processing/libraries/radwordsprocessing/editing/mail-merge#nested-mail-merge)
107-
- [Generating a Word Document with Data Using MailMerge in RadWordsProcessing](https://docs.telerik.com/devtools/document-processing/knowledge-base/generate-doc-template-and-populate-with-collection-data-mail-merge)
108-
- [RadFlowDocument Overview](https://docs.telerik.com/document-processing/libraries/radwordsprocessing/model/radflowdocument)
94+
- [MailMerge]({%slug radwordsprocessing-editing-mail-merge%})
95+
- [Generating a Word Document with Data Using MailMerge in RadWordsProcessing]({%slug generate-doc-template-and-populate-with-collection-data-mail-merge%})
96+
- [Populate a Table with Data using Nested Mail Merge Functionality]({%slug populate-table-data-mail-merge%})

libraries/radwordsprocessing/editing/mail-merge.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -226,3 +226,4 @@ If you want to separate the items into several rows you need to close the group
226226
* [Inserting Images using Mail Merge]({%slug inserting-images-using-mail-merge-radwordsprocessing%})
227227
* [Populate a Table with Data using Nested Mail Merge Functionality]({%slug populate-table-data-mail-merge%})
228228
* [Generating a Word Document Template with Data Using MailMerge in RadWordsProcessing]({%slug generate-doc-template-and-populate-with-collection-data-mail-merge%})
229+
* [Performing Nested MailMerge with Multiple Levels in RadWordsProcessing]({%slug nested-mailmerge-radwordsprocessing%})

0 commit comments

Comments
 (0)