pdx:replaceVariableByWordML

Replaces placeholder variables by plain WordML code.

Description

Element definition

This element (avalaible for the seasoned xmldocx user) allows the direct substitution of placeholder variables by WordML code.

Only use this element if you really understand the OOXML standard. xmldocx does not validate the WordML against any scheme so you have to make sure by your own that the WordML is correctly encoded. Moreover, this element does not take care by its own of internal/external relationships included in the WordML code.

Attributes and sub-elements

variable

The names of the placeholder template variables and the WordFragment instances that should replace them as values.

options

key Description
firstMatch If the variable appears more than once within the Word document and firstMatch is set to true, xmldocx will only replace the first ocurrence of the variable within the Word document.
target Possible values are: document. This option sets the scope of the replacement procedure.
replaceType Possible values are:
  • block (default): replaces the variable and removes its containing paragraph,
  • inline: only replaces the variable by the WordFragment inline content (it may be used to replace a variable by formatted text).
Code samples
#Example 1

config.xml

content.xml

settings.xml

The resulting Word document looks like: