Skip Headers

Oracle TopLink Developer's Guide 10g Release 3 (10.1.3) B13593-01 |
| Home | Solution Area | Contents | Index

Previous | Next |

# Configuring Descriptor Alias

Use the descriptor alias to specify the value of the `ejb-jar.xml` attribute `abstract-schema-name`. This is the logical name that is referenced in EJB QL queries. You should configure a descriptor alias for each CMP entity bean. The descriptor alias defaults to the class name.

Descriptor alias only applies in projects where you configure the persistence type (see "Configuring Persistence Type") to use EJB.

Table 28-6 summarizes which descriptors support descriptor alias configuration.

Table 28-6 Descriptor Support for Descriptor Alias Configuration

Descriptor | Using TopLink Workbench | Using Java
--- | --- | ---
Relational Descriptors |  |
Object-Relational Descriptors |  |
EIS DescriptorsFoot 1 |  |
XML Descriptors |  |

Footnote 1 EIS root descriptors only (see "EIS Root Descriptors").

For more information, see the following:

- "ejb-jar.xml File"

- "EJB Finders"

## Using TopLink Workbench

To specify a descriptor alias, use this procedure:

1. In the Navigator, select a descriptor.

2. Click the Descriptor Info tab in the Property window.

3. Figure 28-4 Descriptor Info Tab, Descriptor Alias Field

   Description of "Figure 28-4 Descriptor Info Tab, Descriptor Alias Field"

In the Descriptor Alias field, enter an alias for this descriptor. This is the value of the `ejb-jar.xml` attribute `abstract-schema-name`. It is the logical name that is referenced in EJB QL queries. The default is the class name.

## Using Java

Use `ClassDescriptor` method `setAlias` passing in the descriptor alias as a `String`.