Copyright © TIBCO Software Inc. All Rights Reserved
Copyright © TIBCO Software Inc. All Rights Reserved


Appendix C Creating XML Documents : Understanding Other Field Attributes

Understanding Other Field Attributes
You’ll have seen several other columns in the field map. Learn about them, from left to right, in this section.
Group Name
Occasionally, you might have to have a starting tag and an ending tag that enclose a group of related fields. For example, you might want to collect the fields Position, Department, and Salary in a group called HRData to denote that they are the responsibility of the Human Resources Department, as illustrated here:
 
In this example, the three fields to be grouped happen to be in contiguous locations in the field map, but that is not a requirement. Fields are grouped based only on the case-sensitive value in the Group Name column. You can also set up multiple group names.
The following figure shows an example of the XML code.
 
Format Rules
In the two columns for format rules, you specify the name of a rule that reformats the field value. One column applies to the production or writing of the XML document and the other to its consumption or reading.
On entry to the rule, the local variable NEW_FIELD_VALUE contains the current field value. Your rule can change that value to the one you want displayed (on output) or passed to the database table (on input).
Usage
The Usage column defines the context for the field. For example, an XML document can contain fields that are present only on input and not on production of the document. For most of your applications, the fields have the default of Input & Output.
Table Override
When an XML document is being consumed or read, the data normally updates the table associated with the field map. To direct the data to a different table, specify the table name in this column. This step could be useful, for example, for saving incoming data away from production data until you have verified that the former fully conforms to your requirements.
Empty Element Name
In the display for Employee 83020, notice that the empty element DEPTNO appears as <Department value=”20” />. You can specify a name in the Empty Element Name column to replace the word value, for example, replace it with number. See the following figure.
 

Copyright © TIBCO Software Inc. All Rights Reserved
Copyright © TIBCO Software Inc. All Rights Reserved