Real Time Information Director User Documentation

RTID Metadata Language
Hewlett-Packard Company 15 529618-002
SplitRecord
The SplitRecord class identifies a single record in another table that is related to the
parent record. In the XML Document, fields of this record are at the same level as the
parent record, rather than under a nested tag. The matter of whether to split a record
across multiple tables is a database design issue.
SplitRecord is a subclass of RelatedRecords, so you can put a SplitRecord in the array of
RelatedRecords.
SplitRecords must have at least one parameter, which specifies either the name of the
table containing the split record (tableName) or an enriched record. You can also include
• A Links object that specifies how to link this table to the parent table. See
“Links,” later in this document.
• An enrichment. Enrichments are ways of enhancing inbound or outbound data.
Options are discussed under the heading “Enriching the Data,” later in this
document.
For SplitRecord class constructors, see the Javadoc for SplitRecord.
Links
The Links class explicitly identifies the fields used to relate records in a table to the
parent record in the document.
By default, a key field that has the same name as a key field of the parent table is
assumed to be a link. If all the linking fields of the RelatedRecords have the same names
as keys of the DocumentRecord, you don’t need a Links object.
If some linking fields in a related record match the names of keys in the parent record but
others do not, you need a Links object only to correlate the linking field names that are
different. (If, however, the linking field is a key column in the child table but not in the
parent table, use DependentLinks, as described below.)
You can specify multiple correlations by passing an array of Strings, or by passing two
arrays of strings, one naming the columns in the parent record (parentColumnName), and
the other naming the corresponding columns in the child record (childColumnName).
You must specify the parent columns and the corresponding child columns in the same
order.
For Links class constructors, see the Javadoc for Links. For examples of Links, see
“Metadata Excerpts: An IDoc Definition.”