TITLE
    EOF 2.0 NT ODBC Adaptor Patch
Article ID:
Created:
Modified: 		72477
9/16/98
7/6/99
TOPIC


    This patch is version number 13.3. The ODBC Adaptor shipped with the EOF 2.0 release was version 13.1. You can find the version of the ODBC adaptor in the title of the ODBC Login panel. This patch is only for use with EOF 2.0 installed on Windows NT as part of OPENSTEP or WebObjects.

    The WebObjects Current Patch List, TIL article 70037 , contains information on all available patches and workarounds for all versions of WebObjects, including EOF patches. The OPENSTEP Current Patch List, TIL article 70033 , contains information on all available patches and workarounds for all versions of OPENSTEP, including EOF patches. Please read these documents if you're not sure which patches you need on your system.

DISCUSSION

    Installing the ODBC Adaptor Patch

    Download the patch from:

    ftp://ftp.info.apple.com/Apple_Support_Area/Apple_Software_Updates/MultiCountry/Enterprise/EOF/patches/2.0/ODBCAdaptorPatch_NT.tar.gz

    In order to install this patch, you will need to use gzip and gnutar to expand the attachment. You'll end up with a supplemental NextLibrary directory, which you can then copy into your existing NextLibrary directory. You need to log in as Administrator to install this patch.

    Caution: The patch will replace \NextLibrary\Executables\ODBCEOAdaptor.dll and the entire \NextLibrary\Frameworks\ODBCEOAdaptor.framework directory, so you should take care to create a back up these items before installing over the top of them.

    Assuming you have ODBCAdaptorPatch_NT.tar.gz on c:/tmp and are using the Bourne Shell which ships with WebObjects or OPENSTEP Enterprise, here are the commands to install the patch:
    $ cd $NEXT_ROOT
    $ mv NextLibrary/Executables/ODBCEOAdaptor.dll NextLibrary/Executables/ODBCEOAdaptor.dll.bak
    $ mv NextLibrary/Frameworks/ODBCEOAdaptor.framework NextLibrary/Frameworks/ODBCEOAdaptor.framework.bak
    $ gzip -d -c c:/tmp/ODBCAdaptorPatch_NT.tar.gz | gnutar -xvf -

    EOF ODBC Adaptor Patch Release Notes

    Problems Fixed in This Patch Update

    The following problems have been fixed in this update:

    ODBC EOAdaptor

    References: 73072

    Problems: Attempts to save EO's that use the custom value capability will fail. an example is using the Movies example application and adding an image to a Talent. When you attempt to save the change, you will get an error: "NSImage does not respond to selector length".

    Fix: The ODBCByteColumn and ODBCLongByteColumn classes now have a corrected implementation of takeInputValue: that calls adaptorValueByConvertingAttributeValue: to correctly convert the custom value into a NSString or NSData for storage purposes. See the EOF 2.0 release notes for the corrected implementation.

    References: 73239

    Problems: Attempts to reverse engineer a model from an existing ODBC datasource will fail with a dialog with the following message: "An unexpected error has occured which may cause EOModeler to malfunction. You may want to save copies of your open documents and quit EOModeler. Error: invalid name"

    Fix: During model reverse engineering, the ODBC method desribeModelForTableNames is more careful to create valid names for it's EOEntities and EOAttributes. The previous adaptor just used the table name or column name and these names aren't always valid names for model objects. Additionally, while generating SQL we now add quotes around names of tables and columns if they contain any characters that aren't letters of the alphabet.


    References: 74252

    Problems: Creating an EOModel from a Microsoft Access database that uses replication will leave the s_GUID, s_Generation, and s_Lineage columns even though these aren't useful.

    Fix: The reverse engineering code now looks for this column in Access databases, and will remove them from the list of classProperties and attributesUsedForLocking. If you want these columns included in your model, just mark them as class properties and/or attributes used for locking.

Document Information
Product Area: Apple Software
Category: Enterprise Objects Framework
Sub Category: EOF 2.0 Patches

Copyright © 2000 Apple Computer, Inc. All rights reserved.