<recipientData> (Data About Single Data Source Record)

Note:

1. Has been connected to a specified external data source containing three records; and

2. Has been configured by the hosting application to not populate a merged document with the record pertaining to John Smith in the external data source.

Consider also that the first time the given WordprocessingML document was connected to the external data source, John Smith's record was in the second record in the data source.

When this merged document is connected to the external data source the <recipientData> element may be used to store the number and value of the column containing the unique key for each data record within the external data source including John Smith's. This setting is represented using the following WordprocessingML to use the hash codes within the <recipientData> element to uniquely identify the three records within the external data source.

<w:recipientData>
  <w:column w:val="1" />
  <w:uniqueTag w:val="1408613399" /> 
</w:recipientData>
<w:recipientData>
  <w:column w:val="1" />
  <w:active w:val="0" />
  <w:uniqueTag w:val="870254691" /> 
</w:recipientData>
<w:recipientData>
  <w:column w:val="1" />
  <w:uniqueTag w:val="1107777181" /> 
</w:recipientData>

Here, the first, second (John Smith record), and third records within the specified data source whose unique key values are 1408613399, 870254691, and 1107777181 have been associated with with recipient data via the <active> element to specify that the record associated with the given record (John Smith's record) shall not be used to populate a merged WordprocessingML document.

With these association in place, if a fourth record is added to the given external data source above John Smith's record, when the given merged WordprocessingML document is reconnected to the external data source, the hosting application will still know that John Smith's record shall not be used to populate a merged WordprocessingML document as it is associated via its unique key value and is not dependent on the given record's ordinal position within the external data source. ]

The following XML Schema fragment defines the contents of this element:

<complexType name="CT_RecipientData">
	<sequence>
	<element name="active" type="CT_OnOff" minOccurs="0"/>
	<element name="column" type="CT_DecimalNumber" minOccurs="1"/>
	<element name="uniqueTag" type="xsd:base64Binary" minOccurs="1"/>
	</sequence>
</complexType>