Upgrading the Software Development Kit Software

When you upgrade from an older version of the IBM® Cognos® Software Development Kit, ensure that you upgrade to the same version of IBM Cognos software and Framework Manager.

If you have Software Development Kit applications that rely on a previous version of the report specifications, you cannot use Framework Manager to publish your model without losing backward compatibility.

For more information about upgrading IBM Cognos software and Framework Manager, see the Installation and Configuration Guide for your IBM Cognos product.

For information about changes that may affect the product during or after an upgrade, see the release notes and the topics about upgrading in the Software Development Kit developer documentation.

IBM Cognos software automatically upgrades the content store.

If you upgrade from ReportNet, you must make some changes to your Software Development Kit program for it to function with the IBM Cognos software version of the WSDL file. Some methods, classes, and properties have been deprecated in IBM Cognos software. Deprecated features continue to function as before, but will be removed in future releases. Some other methods, classes, and properties are obsolete, and have been removed from the IBM Cognos Software Development Kit.

The XLS and singleXLS output formats are deprecated in this release. Reports that use these formats can be viewed, for backwards compatibility. During upgrade or deployment, some properties where outputFormatEnum can be specified are checked for either of these values and automatically changed to XLWA.

For information about changes to methods, classes, properties, and enumeration sets, see the new features appendixes in the IBM Cognos Software Development Kit Developer Guide.

New report specifications have been added in IBM Cognos software. If you run a report that was created in ReportNet or in a previous version of IBM Cognos software, it is automatically upgraded to the new IBM Cognos software format. After a report is upgraded to the new format, it cannot be returned to the ReportNet or older IBM Cognos software format. Because of the potential for users to upgrade report specifications that Software Development Kit applications may depend on, set access permissions on those reports to limit user access. For more information about setting access permissions, see the IBM Cognos Business Intelligence Administration and Security Guide.

If you have Software Development Kit applications that create, modify, or save report specifications, do not upgrade your report specifications when you install the new version of IBM Cognos software. You must first update your Software Development Kit applications to comply with the IBM Cognos software report specifications schema. Otherwise, your Software Development Kit applications may not be able to access the upgraded report specifications. For information about upgrading report specifications, see the IBM Cognos Software Development Kit Developer Guide.

Do not upgrade your report specifications if you are unsure about whether you have Software Development Kit applications that create, modify, or save report specifications. Contact your Software Development Kit administrator for more information about your Software Development Kit applications.