Use Embedded Fields (Mail Merge)

<< Click to Display Table of Contents >>

Raynet One Data Hub > 14.0 > Dashboards and Reports Customization Guide > Designing Reports > Use Report Elements > Manipulate Report Elements 

Use Embedded Fields (Mail Merge)

This topic describes how to provide data to report controls using the advanced Mail Merge binding method. This feature allows you to create templates in which data source values populate specific fields while other text remains constant (that is, allows you to combine static and dynamic content within the same control).

 

Embed Fields in a Control Text

You can apply mail merge to the control's Text property only. Double-click the required control on the design surface to invoke the in-place editor. Insert data field names with square brackets to create embedded fields and use any prefixes or postfixes.

 

eurd-web-mail-merge-insert-data-fields

 

You can embed a parameter's value into a control's content using the ?ParameterName syntax.

 

eurd-web-mail-merge-insert-parameters

 

Embedded fields are replaced with values obtained from an assigned data source when previewing or exporting a report:

 

eurd-web-mail-merge-preview-result

 

Consider the following specifics and limitations when using embedded fields:

 

Field names should not use spaces to be interpreted correctly.

Mail Merge is not available for a table's nested fields in a master-detail hierarchy.

Embedded fields cannot be exported to XLS and XLSX as values; they are always exported as plain text. We recommend using text formats instead if you need to accompany dynamic data with static text.

 

Format Embedded Fields

You can add a format to the target data field by separating it from the field name with the ! symbol and apply this format to field values when previewing a document.

 

eurd-web-mail-merge-format-string-result

 

Supported Controls

You can apply the mail merge feature to the Text of the following report controls:

 

Barcode

Character Comb

Check Box

Label

Rich Text

Table Cell