レター XML データの生成

XML データには、次の形式で追加要素が含まれており、プレースホルダー変数およびフィールドの値が指定されています。

<data-root> 
<fields>  <!--starting element for fields --> 
      <field name="field1">value1</field> <!-- field's display-name is field1 and its value is set to value1. --> 
      <field name="field2" somExpr="xfa[0].template[0].field2">value2</field> <!-- Attribute somexpr is optional and can be used when display name is not sufficient to identify field uniquely --> 
   </fields> 
 
   <variables> <!--starting element for place holder variables--> 
         <variable name="var1">value1</variable> <!-- variable name is var1 and its value is set to value1 --> 
    </variables> 
</data-root>

renderLetter() は、XML データで指定される値を検討し、対応する DDE/PH/Field で使用できる値がある場合は、その値を DDE/PH/Field に設定します。その他のすべての値は、バインディングを通じて解決されます。フィールド/変数のバインディングでは、XML データが変数またはフィールドで使用できるかどうかは検討されません。例えば、保護されていないデータディクショナリにフィールドがバインドされていて、そのフィールドの値が XML データに指定されている場合は、指定された値はレターのレンダリングに使用されます。XML データの一部として値が設定されてない場合、変数/フィールドの値は、バインディングが存在する場合はバインディングを使用して設定され、User をバインドする場合は空になります。例えば、保護されていないデータディクショナリに変数がバインドされていて、XML データに値が指定されていない場合は、レターをレンダリングする際にデータディクショナリの値が使用されます。