Configuring Record Format

The EIS descriptor record format determines the EIS record type to which the descriptor's EIS mappings map.

When you create an EIS project using TopLink Workbench, TopLink configures all EIS descriptors with a record format of XML.

When you create an EIS project in Java, you can configure the EIS descriptor record type to any of the supported types, as Table 28-2 shows.

Table 28-2 EIS Record Formats

EISDescriptor Method EIS Record Type

EISDescriptor Method	EIS Record Type
`useMappedRecordFormat`	All EIS mappings owned by this descriptor map to EIS mapped records.
`useIndexedRecordFormat`	All EIS mappings owned by this descriptor map to EIS indexed records.
`useXMLRecordFormat`	All EIS mappings owned by this descriptor map to EIS XML records. If you use the XML record format, you must specify one or more XML schemas in your EIS project (see "Importing an XML Schema"). The TopLink runtime performs XML data conversion based on one or more XML schemas. In an EIS XML project, TopLink Workbench does not directly reference schemas in the deployment XML, but instead exports mappings configured with respect to the schemas you specify. For information on TopLink support for XML namespaces, see "XML Namespaces".

useMappedRecordFormat

All EIS mappings owned by this descriptor map to EIS mapped records.

useIndexedRecordFormat

All EIS mappings owned by this descriptor map to EIS indexed records.

useXMLRecordFormat

All EIS mappings owned by this descriptor map to EIS XML records.

If you use the XML record format, you must specify one or more XML schemas in your EIS project (see "Importing an XML Schema"). The TopLink runtime performs XML data conversion based on one or more XML schemas. In an EIS XML project, TopLink Workbench does not directly reference schemas in the deployment XML, but instead

exports mappings configured with respect to the schemas you specify.

For information on TopLink support for XML namespaces, see "XML Namespaces".

For more information, see "EIS Record Type".

Using Java

To configure the EIS record format for an EIS descriptor, use one of the EISDescriptor methods listed in Table 28-2 as shown in Example 28-1.

Example 28-1 Configuring EISDescriptor Record Format

EISDescriptor descriptor = new EISDescriptor();
descriptor.useIndexedRecordFormat();