Oracle Developer Tools for Visual Studio Release Notes


The latest downloads, information, and community forums can be found here:  http://www.oracle.com/technology/tech/dotnet/tools/index.html.

Release 11.2.0.3.20

September 2012

Copyright(c) 2005, 2012, Oracle. All rights reserved.

This file contains important information about Oracle Developer Tools for Visual Studio.  The following topics are covered:

 

System Requirements

 

Support and Product Feedback

Oracle is very interested to hear your comments related to this release, including feature requests and bug reports. Please visit the Oracle Technology Network (OTN) ODT community forum to tell us what you think! (Registration with OTN required)
 
The ODT Discussion Forum Frequently Asked Question List is a good place to find answers to common questions and problems with ODT.

 

General Information and Dependencies

Microsoft Visual C++ Redistributable Packages

The Microsoft Visual C++ 2005 SP1 Redistributable Package is automatically installed with the Oracle Database 11g Release 2 (11.2) software. Please do not remove this package from the Add or Remove Programs interface in the Control Panel or ODT will cease to work properly.

 

ODT should only be installed in one Oracle Home

ODT should only be installed in one Oracle home. If ODT is installed in multiple homes, and then one of them is subsequently deinstalled, any remaining installation of ODT will not work properly.

 

Uninstall previous version of ODT

Before installing this version of ODT, you should uninstall older versions of ODT.

 

Do not install Oracle Developer Tools into an Oracle8, Oracle9, or Oracle 10 Oracle Home

Installing the Oracle Developer Tools into an Oracle8, Oracle9, Oracle 10.1 or Oracle 10.2 Oracle home is not supported. By default, the Oracle Installer will create a new Oracle 11.2 Oracle home.

 

Integrated online help

If the ODT Help does not show up as part of Visual Studio Help in Visual Studio 2008, please follow the following steps:

1. Start Visual Studio and select ‘Search’ option from the Help menu.
2. Search for VSCC (Visual Studio Combined Help Collection).
3. Click on Visual Studio Combined Help Collection Manager from the Results window.

4. Scroll down to the bottom of the page and check off the ODT Help box if it is not checked or uncheck it if it is checked.

5. Click Update VSCC button. Close and restart Visual Studio.
6. If you unchecked the ODT Help in step 4, repeat steps 1 to 5 to check off ODT Help on the VSCC page.

 

Oracle connection errors after installing Oracle Developer Tools in new Oracle home

If you start receive Oracle connection errors immediately after installing Oracle Developer Tools, check to see if you created a new Oracle home during the install. If you did, you will need to copy over the TNSNAMES.ORA file from your old Oracle home to the new one.

 

Local Database option may not be visible from connection dialog drop down list
In order for a locally installed database to show up as a "Local Database" in the connection dialog box, Oracle Developer Tools must be installed in the same Oracle Home as the database. 

 

Oracle Explorer is no longer available in Visual Studio 2008 or later

For Visual Studio 2008 and Visual Studio 2010, Oracle Explorer has been removed and has been replaced by Visual Studio Server Explorer. Please refer to the online documentation for more information about Server Explorer.

Online Help

Only U.S English version of the help is shipped with this product.

 

Features not Covered by Documentation 

New Features for Oracle Developer Tools for Visual Studio Release 11.2.0.3.20

 

Oracle Developer Tools for Visual Studio release 11.2.0.3.20 includes the following:

Oracle Developer Tools for Visual Studio now supports Visual Studio 2012.

 

Entity Framework Designer and Wizards

 

New Query Window Features – Scrollable Resultset with Auto-Fetching;  Parameterized Anonymous PL/SQL Blocks

 

PL/SQL Debugger troubleshooting

When debugging PL/SQL for the first time, please check the documentation to make sure all configuration steps have been performed. In particular please follow the steps listed in the “Debugging Setup Checklist” in the “PL/SQL Debugging Setup” section of the online help.

There are several scenarios where the database is not able to connect to the PL/SQL debugger:

                     ORA-01031: insufficient privileges
                     ORA-06512: at "SYS.DBMS_DEBUG_JDWP", line 68
                     ORA-06512: at line 1"

                     To solve the problem, do the following:

             1. Grant the "debug connect privilege" (for 10g databases) to the connected user.
             2. Grant the "debug" and "execute" privilege on the PL/SQL program to the connected user, or
             3. Grant the "debug any procedure" privilege to the connected user.

          In this scenario, you will get the following message from ODT: "Could not begin PL/SQL debugging.  There are no available ports".
          To solve the problem, you have to modify the PL/SQL Debugging Options page to add the ports for debugging.

Please note: a port number randomly selected from the range specified in the ODT Debugging options page is reserved at the moment that the Oracle Application Debugging menu option is checked off. The specific port number reserved by the debugger is displayed to the user in the Output window.

          In this scenario, you will get the following message from ODT:
            "An error occurred while executing the procedure/function:
             ORA-30683: failure establishing connection to debugger
             ORA-12535: TNS:operation timed out
             ORA-06512: at "SYS.DBMS_DEBUG_JDWP", line 68
             ORA-06512: at line 1"

To solve the problem, make sure all the ports set in the PL/SQL Debugging Options page can be opened for external access.  You can test by attempting to "ping" your development machine while logged into the database machine.

 

If you are still having problems, see the PL/SQL Debugger Known Issues in the section below.   

Oracle Query Window

 

User Defined Types

 

Filters Settings

 

 

Known Issues

External Schema Objects not visible in Visual Studio Lightswitch

Visual Studio Lightswitch developers who connect to Oracle with a user account that has been granted permissions on other schemas will find that they cannot see those external schemas from the Lightswitch tool, even if they modify the "Filters" tab on the Server Explorer connection node.  For example, user HR is granted permissions on SCOTT.EMP. When the developer connects as HR in Lightswitch and modifies “Filters” tab in the Visual Studio Add Connection Dialog to include “SCOTT” in the displayed schemas, SCOTT.EMP will still not be shown in the displayed list of tables in Lightswitch.

 

Visual Studio 2010 Entity Designer

 

Visual Studio 2012 Entity Designer

FLOAT

DATE

INTERVAL YEAR TO MONTH

INTERVAL DAY TO SECOND

TIMESTAMP WITH TIMEZONE

TIMESTAMP WITH LOCAL TIMEZONE

For example, when generating an entity model from database, Interval Year to Month is mapped to EDM Type Decimal, but when you generate the SQL from model using "Generate Database from Model" feature, the generated SQL script will create a NUMBER column instead of an Interval Year to Month column. Also, generating DDL for an entity with a float EDM property may fail, if the entity type was originally created from a FLOAT column of a table.

 

Visual Studio Crashes in Module 'oran11.dll' when connecting with Server Explorer or gives “Package did not load correctly”

Due to locking of OCI.DLL during installation of ODAC into a pre-existing Oracle Home, the old version of the OCI.DLL can remain and will be out of synch with the other DLLs. This can lead to  a crash of Visual Studio when connecting to Oracle from Server Explorer or from a wizard or it could result in a message during launch stating “The Oracle Developer Tools for Visual Studio .NET package did not load correctly". The easiest solution is to simply reinstall into a new Oracle Home (directory). If you must use the same Oracle Home name and directory, you will still need to delete the now corrupted  Oracle home and then reinstall, using the following steps:

 

1) Use the installer to uninstall the entire oracle home that is crashing

2) Look at the home in windows explorer. OCI.dll should still be there

3) Rename oci.dll to oci.delete

4) Reboot machine

5) Go back to windows explorer and delete all remaining files in the oracle home, including oci.delete

6) Install ODAC

 

Visual Studio throws “Type Initializer for Oracle.DataAccess.Client.OracleClientFactory” Exception

Both the  Visual Studio Tools and an Entity Framework application require that the entry in your machine.config for the Provider Factory  be set to the correct version of ODP.NET or that the policy DLL for ODP.NET 11.2.0.3.0 or later be installed. If, after you installed this release, you installed an older version of ODP.NET, either from an older ODAC or as part of an older Oracle Database install, this machine.config setting may now be set to the older version of ODP.NET, and the Policy DLL may have been removed, resulting in this error.

 

The easiest solution is to simply reinstall this version of ODAC.

 

Server Explorer Synonym Node Paging

Synonym Node paging and the Previous, Next, First, Last menu options used in Synonyms collection node are not available in this release. Any Navigation Page Size set in the Options page has no effect. If you expand the Synonyms collection node, all the synonyms as per your filter selections will be displayed. This may take an excessive amount of time to populate and so using filters is advised.

Data Source Configuration Wizard error: "Failed to find or load the registered .NET Framework Data Provider"
The Data Source Configuration Wizard can fail with the error "Failed to find or load the registered .NET framework data provider" if some other data provider has not been cleanly uninstalled and still has an entry in the machine.config file. Specifically, if the entry for Oracle Data Provider for .NET in the machine.config.xml file in the DbProviderFactories section comes after an already uninstalled data provider, this error will occur. The fix is to edit machine.config and move the Oracle Data Provider for .NET to the first item in the DbProviderFactories section.

Visual Studio 2008 known issues

PL/SQL Debugger known issues

 

Server Explorer Node Renaming does not work with Visual Studio 2008

Oracle schema nodes cannot be renamed in Server Explorer with Visual Studio 2008.

 

PL/SQL types as parameter types for stored procedure/function/package method

Some of the PL/SQL data types (such as NATURAL or INTEGER) are aliases to database native types (for example, NUMBER). When these PL/SQL types (NATURAL, INTEGER) are used as parameter types in stored procedure or function, the PL/SQL data type displayed in the properties window for these parameters will reflect the database native type.

 

PL/SQL autocompletion with synonyms.

In a PL/SQL editor window, synonyms nested beyond 2 levels will not expand for autocompletion.

 

Connecting with SYSOPER role

Connecting with SYSOPER role is not supported.

 

Case sensitivity and special characters in name

To preserve the case in a name for a schema object, the name needs to enclosed in double quotes. Otherwise, when the focus is moved out of the text box where the schema object name is entered the schema object name will be automatically uppercased.

 

Retrieving table or view data

When retrieving data from a table or view, editing of data for the following Oracle types is not supported:

 

Table/View Designer

 

Running a stored procedure or function

 

OracleDataAdapter Wizard

 

Oracle Project

 

Oracle .NET Deployment Wizard

 

Oracle Project in Visual Studio 2008

 

Oracle Query Window

 

Oracle Database Script Project

 

Generating Custom Classes for Oracle User Defined Types

 

Visual Studio 2008 Designers and Wizards

 

Importing Table Data from Microsoft SQL Server or Microsoft Access Database

When importing tables from data connections using the Microsoft SQLServer or Microsoft Access Database File providers (SQL Server Databases, Excel files etc.), the character columns for the corresponding new Oracle tables will use character length semantics by default. This could result in larger storage requirements. If the character columns store multi-byte data, it is recommended that you specify the length semantics (byte or character) and the column length.

 

Creating and Deleting ADDM Tasks