API Changelog: Difference between revisions
Kate Racaza (talk | contribs) m (moved API Upgrades to API Changelog: Needs a better page name) |
Kate Racaza (talk | contribs) mNo edit summary |
||
| Line 1: | Line 1: | ||
<!--THIS PAGE IS LINKED TO THE COMMON HELP FILE --> | |||
{{Template:API}}{{Template:APIUpgradesNavBox}} | {{Template:API}}{{Template:APIUpgradesNavBox}} | ||
Revision as of 23:33, 11 January 2016
 |
Before you upgrade to the latest version of the Synthesis API object library file, review what's new and what has changed since the last version. The latest version may have introduced some code-breaking changes, requiring you to make changes to your code before upgrading.
How to get the latest version of the Synthesis API object library file
The Synthesis API object library file is installed with the Synthesis Platform; hence, you can get the latest version of the file by simply installing or upgrading to the latest version of Synthesis.
To get the latest version of a Synthesis application, choose File > Help > Check for Updates or download the latest update from our website at http://www.ReliaSoft.com/synthesis/downloads.htm. Note that for VBA, the bit version (32- vs. 64-bit) of the Synthesis Platform that you've installed must match your installed version of Microsoft Office. If they do not match, you may see an error related to ActiveX controls. (See ReliaSoft KB article RS20024.)
The Synthesis API object library file is located in the folder where you've installed the Synthesis applications. By default, this folder is at “C:\Program Files\ReliaSoft\Synthesis 10”. (For Version 9, it's in a folder called "Synthesis 9".) You may need to to update the library reference of your custom applications to point to the file in that location. For VBA applications, use the SynthesisAPI.tlb file. For .NET applications, use the SynthesisAPI.dll file.
What's New in Synthesis API Version 10
Here's an overview of the most significant enhancements and deprecations in the API since the previous version.
10.0.4
No updates.
10.0.3
Initial public release for Version 10 API.
Improved flexibility
- Added all new classes and methods for accessing FMEA and related data from Xfmea, RCM++ and RBI.
- Added several new methods in the Repository class to provide more options for manipulating Synthesis resources. The most significant of these is the ability to get a single resource from a Synthesis repository. You are no longer limited to using arrays to access a particular resource item.
New features incorporated
- Added new properties and enumerations in the cAction class to take advantage of the expanded action-tracking capabilities introduced in the latest version of the Synthesis platform. This includes action properties relevant to the project planner and Xfmea/RCM++/RBI test plans.
- For all resource objects (e.g., cModel, cURD, cCrew, etc.), added a new set of properties for accessing the Synthesis identifiers fields in the platform.
Deprecations
- The Repository class has been restructured to organize its growing number of members. All of its members are now organized into fields named after the object type they apply to. For example, the
Repository.GetAllModels()method, which returns a cModel object, has been renamed toRepository.Model.GetAllModels(); similarly, theRepository.ImportBlockSimXMLFilemethod has been renamed toRepository.BlockSim.ImportBlockSimXMLFile, etc. The previous versions of the methods still exist so your code is not broken, but they are deprecated and may be removed in future versions of the API.
- The Repository class has been restructured to organize its growing number of members. All of its members are now organized into fields named after the object type they apply to. For example, the
For a complete list of all new classes and enumerations added to the object library, see New Classes and Enumerations.
For a complete list of all new methods and properties added to existing objects, see New Members and Constants.
For a complete list of all deprecations, see Deprecated and Removed Members.