You are here: Section Rules Reference > Section Rules Summary > TextMergeParagraph

TextMergeParagraph

Use this section level rule to merge data for embedded variable fields in a text area with text. The Move_It or MoveNum rules are most often used with this rule to move data from the extract file into embedded variable fields. The system then rewraps the text area

Note This rule is not necessary if you are developing resources in Documaker Studio. This rule was created for and used in the older, legacy Documaker development tools. In a Studio environment, the system manages the functionality implemented via these rules automatically and offers improved performance. If you are importing a legacy MRL that includes this rule, Studio ignores it.

The system writes the FAP information into the NAFILE.DAT file, which is used by the GenPrint program. If a section includes this rule, the Can Grow attribute setting in the section’s FORM.DAT file must match the text area’s Can Grow attribute in the FAP file.

Note If you include the Can Grow attribute for a multiline text field, be aware the field can both grow and shrink, depending on the data. If you do not want the text area to change sizes, turn off the Can Grow attribute.

Using this rule can slow performance, so use it only as necessary. If you must use this rule, it is better not to mix other objects with the text area in this FAP file. The more objects are mixed, the worse your performance, because all of the information about these objects will be written to NAFILE.DAT file also. If these objects are separated into another FAP file, they can be part of the compiled overlay and need not be loaded into the NAFILE.DAT file.

Performance is affected even more if you include graphics in the FAP file and you are sending the data stream to an AFP printer. This is because the LoadFAPBitmap option in the RunMode control group is set to Yes and is needed to print the graphics. This INI option also affects performance. Avoid it as much as possible.

Note System variables, such as Send Copy To, cannot be used as an embedded variable field text area.

Syntax

TextMergeParagraph( )

No parameters are necessary. Only include this rule if your section has embedded variable fields in a text area.

See also