addUserAttribute

addUserAttribute(entityDesc: JadeRelationalEntityIF;
                 attrDesc:   JadeRelationalAttributeIF);

The addUserAttribute method of the RelationalView class adds a user-defined (soft) attribute to the user-defined (soft) table specified in the entityDesc parameter, if it exists in the relational view.

This method does not apply to RPS mappings.

The name returned by the entityDesc.getSQLName method is called to obtain the table name. If a table by that name is not found or if the table is not a user-defined table, an exception is raised.

The value of the entityDesc parameter specifies an implementation of the JadeRelationalAttributeIF interface that correctly describes the attribute being added.

Calls to this method can raise the following exceptions.

JErr_Table_Not_Found : Relational Table not found.
JErr_Attribute_Name_Conflict : Attribute name null or already used as column in the selected table.
JErr_SQL_Type_Not_Mapped : JADE Type specified does not have a supported SQL type mapping.
String_Too_Long : Attribute name exceeds maximum of 80 characters.
JErr_Invalid_For_RpsMapping : May only be called for ODBC Relational Views.
JErr_No_Jade_Type : No JADE Type defined for this attribute. entityDesc.getJadeType() returned null.
JErr_Not_Soft_Table : The table exists in the View, but it is not a user defined table.