API Changelog: Difference between revisions

From ReliaWiki
Jump to navigation Jump to search
No edit summary
No edit summary
 
(48 intermediate revisions by 2 users not shown)
Line 1: Line 1:
{{InProgress}}{{Template:API}}
{{Template:API}}{{Template:APIUpgradesNavBox}}
Before you upgrade to the latest version of the ReliaSoft API, 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.




The following is a summary of the changes from Version 9.
'''How to get the latest version of the ReliaSoft API object library file'''


==Major Changes==
The object library file is located in the folder where the ReliaSoft applications are installed. By default, this folder is at "C:\Program Files\ReliaSoft\ReliaSoft 2019".  
* We've added several new methods to the Repository class and organized them into fields named after the object type they apply to. This means that existing methods in the class have also been moved to the appropriate fields. For example, the <code>Repository.GetAllModels()</code> method, which affects model resources, has been renamed to <code>Repository.Model.GetAllModels()</code>; similarly, <code>Repository.ImportBlockSimXMLFile</code> has been renamed to <code>Repository.BlockSim.ImportBlockSimXMLFile</code>, etc. The Version 9 methods still exist so your code is not broken, but they are deprecated and may be removed in future versions of the API.
* In Version 9, you had to get all of a single resource (e.g., all models) from a repository before you could update a single one. In the latest version, we've added new methods that allow you to get just a single resource from the repository and update it.
*We've added new methods that allow access to FMEA and related data from Xfmea/RCM++/RBI.


To get the latest version of the file, choose '''File > Help > Check for Updates''' or download the latest software update from [https://support.hbmprenscia.com HBM Prenscia Support Portal]. You may need to to update the library reference of your custom applications to point to the location of the object library file. For VBA applications, use the ReliaSoftAPI19.tlb file. For .NET applications, use the ReliaSoftAPI19.dll file.


==Minor Changes==
*xxx


== Highlights ==
Here's a brief overview of the most significant enhancements and deprecations in the API since the previous version.


*For a complete list of all new classes and enumerations added to the object library, see [[New Classes and Enumerations]].


==What's New==
*For a complete list of all new methods and properties added to existing objects, see [[New Members and Constants]].
Here's a complete list of all new functionality available in the latest version.


===New methods in the [[Repository Class|Repository]] class===
*For a complete list of all deprecations, see [[Deprecated and Removed Members]].
{| {{APITable}}
|-
| style="width: 240px;"|[[Repository.Model.GetModel|Model.GetModel]]||{{:Repository.Model.GetModel}}
|-
|[[Repository.Model.IsModelUsed|Model.IsModelUsed]]||{{:Repository.Model.IsModelUsed}}
|-
|[[Repository.Model.DeleteModel|Model.DeleteModel]]||{{:Repository.Model.DeleteModel}}
|-
|[[Repository.URD.GetURD|URD.GetURD]]||{{:Repository.URD.GetURD}}
|-
|[[Repository.Variable.GetVariable|Variables.GetVariable]]||{{:Repository.Variable.GetVariable}}
|-
|[[Repository.Task.GetCorrectiveTask|Task.GetCorrectiveTask]]||{{:Repository.Task.GetCorrectiveTask}}
|-
|[[Repository.Task.GetScheduledTask|Task.GetScheduledTask]]||{{:Repository.Task.GetScheduledTask}}
|-
|[[Repository.Crew.GetCrew|Crew.GetCrew]]||{{:Repository.GetCrew}}
|-
|[[Repository.Pool.GetPool|Pool.GetPool]]||{{:Repository.Pool.GetPool}}
|-
| style="width: 240px;"|[[Repository.Action.GetAllActionsDictionary|Action.GetAllActionsDictionary]]||{{:Repository.Action.GetAllActionsDictionary}}
|-
|[[Repository.Action.GetAction|Action.GetAction]]||{{:Repository.Action.GetAction}}
|-
| style="width: 240px;"|[[Repository.Control.GetAllXfmeaControlsDictionary|Control.GetAllXfmeaControlsDictionary]]||{{:Repository.Control.GetAllXfmeaControlsDictionary}}
|-
|[[Repository.Control.GetAllXfmeaControls|Control.GetAllXfmeaControls]]||{{:Repository.Control.GetAllXfmeaControls}}
|-
|[[Repository.Control.AddXfmeaControl|Control.AddXfmeaControl]]||{{:Repository.Control.AddXfmeaControl}}
|-
|[[Repository.Control.UpdateXfmeaControl|Control.UpdateXfmeaControl]]||{{:Repository.Control.UpdateXfmeaControl}}
|-
|[[Repository.Control.GetXfmeaControl|Control.GetXfmeaControl]]||{{:Repository.Control.GetXfmeaControl}}
|-
|[[Repository.XFRACAS.XFRACASCommandTimeout|XFRACAS.XFRACASCommandTimeout]] ||{{APIComment|Gets or sets the wait time before terminating the attempt to execute an XFRACAS command.}}
|-
|[[Repository.XFRACAS.AddSystemMetric1|XFRACAS.AddSystemMetric1]] ||{{APIComment|This can be used to insert reported run hours and the date of the reported run hours.}}
|-
|[[Repository.XFRACAS.AddSystemMetric2|XFRACAS.AddSystemMetric2]]|| {{APIComment|This can be used to insert reported run hours, number of starts, and the date.}}
|-
|[[Repository.XFRACAS.AddSystemMetric3|XFRACAS.AddSystemMetric3]]|| {{APIComment|This can be used to insert reported run hours, number of starts, kw run hours, and the date.}}
|-
|[[Repository.Xfmea.GetAllItemsInSystemHierarchyDictionary Method|Xfmea.GetAllItemsInSystemHierarchyDictionary]]|| {{:Repository.Xfmea.GetAllItemsInSystemHierarchyDictionary Method}}
|-
|[[Repository.Xfmea.GetAllItemsInSystemHierarchy Method|Xfmea.GetAllItemsInSystemHierarchy]]||{{:Repository.Xfmea.GetAllItemsInSystemHierarchy  Method}}
|-
|[[Repository.Xfmea.AddItemToSystemHierarchy Method|Xfmea.AddItemToSystemHierarchy]]||{{:Repository.Xfmea.AddItemToSystemHierarchy  Method}}
|-
|[[Repository.Xfmea.UpdateItemInSystemHierarchy Method|Xfmea.UpdateItemInSystemHierarchy]]||{{:Repository.Xfmea.UpdateItemInSystemHierarchy  Method}}
|-
| style="border-bottom:1pt solid #585858; color:#585858;"|
|-
|[[Repository.Xfmea.GetAllXfmeaFunctionsDictionary Method|Xfmea.GetAllXfmeaFunctionsDictionary]]||{{:Repository.Xfmea.GetAllXfmeaFunctionsDictionary Method}}
|-
|[[Repository.Xfmea.GetAllXfmeaFunctions Method|Xfmea.GetAllXfmeaFunctions]]|| {{:Repository.Xfmea.GetAllXfmeaFunctions Method}}
|-
|[[Repository.Xfmea.GetXfmeaFunction Method|Xfmea.GetXfmeaFunction]]|| {{:Repository.Xfmea.GetXfmeaFunction Method}}
|-
|[[Repository.Xfmea.AddXfmeaFunction Method|Xfmea.AddXfmeaFunction]]|| {{:Repository.Xfmea.AddXfmeaFunction Method}}
|-
|[[Repository.Xfmea.UpdateXfmeaFunction Method|Xfmea.UpdateXfmeaFunction]]|| {{:Repository.Xfmea.UpdateXfmeaFunction Method}}
|-
| style="border-bottom:1pt solid #585858; color:#585858;"|
|-
|[[Repository.Xfmea.GetAllXfmeaFailuresDictionary Method|Xfmea.GetAllXfmeaFailuresDictionary]]||{{:Repository.Xfmea.GetAllXfmeaFailuresDictionary Method}}
|-
|[[Repository.Xfmea.GetAllXfmeaFailures Method|Xfmea.GetAllXfmeaFailures]]||{{:Repository.Xfmea.GetAllXfmeaFailures Method}}
|-
|[[Repository.Xfmea.GetXfmeaFailure Method|Xfmea.GetXfmeaFailure]]||{{:Repository.Xfmea.GetXfmeaFailure Method}}
|-
|[[Repository.Xfmea.AddXfmeaFailure Method|Xfmea.AddXfmeaFailure]]||{{:Repository.Xfmea.AddXfmeaFailure Method}}
|-
|[[Repository.Xfmea.UpdateXfmeaFailure Method|Xfmea.UpdateXfmeaFailure]]||{{:Repository.Xfmea.UpdateXfmeaFailure Method}}
|-
| style="border-bottom:1pt solid #585858; color:#585858;"|
|-
|[[Repository.Xfmea.GetAllXfmeaEffectsDictionary Method|Xfmea.GetAllXfmeaEffectsDictionary]]||{{:Repository.Xfmea.GetAllXfmeaEffectsDictionary Method}}
|-
|[[Repository.Xfmea.GetAllXfmeaEffects Method|Xfmea.GetAllXfmeaEffects]]||{{:Repository.Xfmea.GetAllXfmeaEffects Method}}
|-
|[[Repository.Xfmea.GetXfmeaEffect Method|Xfmea.GetXfmeaEffect]]||{{:Repository.Xfmea.GetXfmeaEffect Method}}
|-
|[[Repository.Xfmea.AddXfmeaEffect Method|Xfmea.AddXfmeaEffect]]||{{:Repository.Xfmea.AddXfmeaEffect Method}}
|-
|[[Repository.Xfmea.UpdateXfmeaEffect Method|Xfmea.UpdateXfmeaEffect]]||{{:Repository.Xfmea.UpdateXfmeaEffect Method}}
|-
| style="border-bottom:1pt solid #585858; color:#585858;"|
|-
|[[Repository.Xfmea.GetAllXfmeaCausesDictionary Method|Xfmea.GetAllXfmeaCausesDictionary]]||{{:Repository.Xfmea.GetAllXfmeaCausesDictionary Method}}
|-
|[[Repository.Xfmea.GetAllXfmeaCauses Method|Xfmea.GetAllXfmeaCauses]]||{{:Repository.Xfmea.GetAllXfmeaCauses Method}}
|-
|[[Repository.Xfmea.GetXfmeaCause Method|Xfmea.GetXfmeaCause]]||{{:Repository.Xfmea.GetXfmeaCause Method}}
|-
|[[Repository.Xfmea.AddXfmeaCause Method|Xfmea.AddXfmeaCause]]|| {{:Repository.Xfmea.AddXfmeaCause Method}}
|-
|[[Repository.Xfmea.UpdateXfmeaCause Method|Xfmea.UpdateXfmeaCause]]||{{:Repository.Xfmea.UpdateXfmeaCause Method}}
|}


===19.0.1===
*Changed the name of the libraries to ReliaSoftAPI19.tlb and ReliaSoftAPI19.dll. The API's are also now version dependent.
*Added the following to the [[Repository Class|Repository]] class:
:*[[Repository.Action.GetFMEAActionLocatorLinkPath|Repository.Action.GetFMEAActionLocatorLinkPath]]
*Added the following methods and properties to [[CCorrectiveTask Class|cCorrectiveTask]] class:
:*[[CCorrectiveTask.GetPools_Method|GetPools]]
:*[[CCorrectiveTask.SetPools_Method|SetPools]]
:*[[CCorrectiveTask.GetTeams_Method|GetTeams]]
:*[[CCorrectiveTask.GetTeams_Method|SetTeams]]
:*Pools
:*Teams
*Removed the following methods and property from the [[CCorrectiveTask Class|cCorrectiveTask]] class:
:*SetCrewIDs
:*GetCrewIDs
:*CrewIDs
*Added the following methods and properties to the [[CScheduledTask Class|cScheduledTask]] class:
:*[[CScheduledTask.OnCondGetTeams_Method|OnCondGetTeams]]
:*[[CScheduledTask.OnCondSetTeams_Method|OnCondSetTeams]]
:*[[CScheduledTask.GetPools_Method|GetPools]]
:*[[CScheduledTask.SetPools_Method|SetPools]]
:*[[CScheduledTask.GetTeams_Method|GetTeams]]
:*[[CScheduledTask.GetTeams_Method|SetTeams]]
:*OnCondTeams
:*Pools
:*Teams
*Removed the following methods and property from the [[CScheduledTask Class|cScheduledTask]] class:
:*SetCrewIDs
:*GetCrewIDs
:*CrewIDs
:*OnCondCrewIDs
*Added the [[PoolInfo|PoolInfo]] structure to be used with the [[CScheduledTask.GetPools_Method|GetPools]] and [[CScheduledTask.SetPools_Method|SetPools]] methods, as well as the Pools property.
*Added the [[TeamInfo Class|TeamInfo]] class which contains the following methods and property:
:*[[TeamInfo.GetCrewIDs_Method|GetCrewIDs]]
:*[[TeamInfo.SetCrewIDs_Method|SetCrewIDs]]
:*CrewIDs
*Added the following properties to the [[XfmeaEffect Class|XFMEAEffect]] class:
:*SubSev1Init
:*SubSev1Rev
:*SubSev2Init
:*SubSev2Rev
:*SubSev3Init
:*SubSev3Rev
:*SubSev4Init
:*SubSev4Rev
:*SubSev5Init
:*SubSev5Rev
:*SubSev6Init
:*SubSev6Rev
:*SubSev7Init
:*SubSev7Rev
:*SubSev8Init
:*SubSev8Rev
*Added the following property to the [[XfmeaItem Class|XFMEAItem]] class:
:*Qty


===New methods in the [[CCorrectiveTask Class|cCorrectiveTask]] class and [[CScheduledTask Class|cScheduledTask]] class===
===18.0.3===
*Added the following methods to the [[Repository Class|Repository]] class:
:*[[Repository.Project.GetUserAccessibleProjects|Repository.Project.GetUserAccessibleProjects]]
:*[[Repository.Project.GetUserPermissions|Repository.Project.GetUserPermissions ]]


{| {{APITable}}
===18.0.2===
|-
*Increased the length of a scheduled task name up to 2,000 characters to match the desktop applications.
| style="width: 240px;"|GetCrewIDs
|-
|SetCrewIDs
|}


===18.0.1===
Initial public release for Version 2018 applications.


===New properties for all resources (e.g., models, URDs, crews, etc.)===
*In the <code>'''[[WeibullDataSet Class|WeibullDataSet]]'''</code> object, the type for the NumberInGroup parameter was changed from Integer to Double to allow fractional failure calculations.
{| {{APITable}}
*In <code>'''[[XfmeaItem Class|XfmeaItem]]'''</code> object, added the ReliabilityPolicyType property.
|-
*Added the following properties to the [[WAPlotSettings Class|WAPlotSettings ]]:
| style="width: 200px;"|{{Template:API_TxtIdentifiers}}
**ShowDataPoints
|}
**Show3PWeibullAdjustedItems
**Show3PWeibullUnadjustedItems
*Added the following methods to the Repository class:
:*[[Repository.Xfmea.AssignActionToXfmeaCause Method|Repository.Xfmea.AssignActionToXfmeaCause]]
:*[[Repository.Xfmea.AssignControlToXfmeaCause Method|Repository.Xfmea.AssignControlToXfmeaCause]]
:*[[Repository.Xfmea.GetXfmeaCauseActions Method|Repository.Xfmea.GetXfmeaCauseActions]]
:*[[Repository.Xfmea.GetXfmeaCauseActionsDictionary Method|Repository.Xfmea.GetXfmeaCauseActionsDictionary]]
:*[[Repository.Xfmea.GetXfmeaCauseControls Method|Repository.Xfmea.GetXfmeaCauseControls]]
:*[[Repository.Xfmea.GetXfmeaCauseControlsDictionary Method |Repository.Xfmea.GetXfmeaCauseControlsDictionary]]


===11.0.1===
Initial public release for Version 11 applications.
*Added new classes and methods for accessing ''profiles'', which is a new type of Synthesis resource introduced in the latest version of the Synthesis desktop applications.
*Removed the obsolete [[ALTAStressProfile_Class|ALTAStressProfile]] class and replaced it with the new [[CProfile Class|cProfile]] class.
*Removed the obsolete [[ALTASegment Class|ALTASegment]] class and replaced it with the new [[ProfileSegment Class|ProfileSegment]] class.


===New property for the [[CModel Class|cModel]] class===
===10.1.4===
{| {{APITable}}
*Added ability to assign a URD to a BlockSim block in a Synthesis repository. Includes ability to get an array of BlockSim block names, RBDs, fault trees and properties.
|-
*Added ability to hide messages when doing batch calculations and customize event procedures for <code>Repository</code>, <code>WeibullDataSet</code> and <code>ALTADataSet</code> objects.
| style="width: 200px;"|Unit ID||Gets or sets the model's unit ID number. '''Integer'''  
*For locally-hosted licensing, added the [http://www.synthesisplatform.net/synthesis_api_ante_service.htm Synthesis API Ante Service] to improve response times.
|}
 
===10.1.1===
*Added ability to get global and reference resources. An optional <code>Filter</code> parameter has been added to the following methods. The filter's default value is 0, which returns local resources.
:*[[Repository.Action.GetAllActions]]
:*[[Repository.Control.GetAllXfmeaControls]] 
:*[[Repository.Model.GetAllModels]]
:*[[Repository.Model.GetAllModelsInfo]]
:*[[Repository.Crew.GetAllCrews]]
:*[[Repository.Pool.GetAllPools]]
:*[[Repository.Task.GetAllScheduledTasks]]
:*[[Repository.Task.GetAllCorrectiveTasks]]
:*[[Repository.URD.GetAllURDs]]
:*[[Repository.Variable.GetAllVariables]]
*Added a class that allows VBA users to change the API library language.
*Added a method for getting a single system hierarchy item.
*Added new user-defined properties to relevant resource classes.
*Deprecated a couple of obsolete properties.
*Various fixes and non-breaking changes.
 
===10.0.3===
Initial public release for Version 10 applications.
 
'''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 <code>Repository.GetAllModels()</code> method, which returns a cModel object, has been renamed to <code>Repository.Model.GetAllModels()</code>; similarly, the <code>Repository.ImportBlockSimXMLFile</code> method has been renamed to <code>Repository.BlockSim.ImportBlockSimXMLFile</code>, 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.

Latest revision as of 17:54, 14 March 2019

APIWiki.png


<< Back to API Main Page

API Changelog

API Reference Documentation

Before you upgrade to the latest version of the ReliaSoft API, 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 ReliaSoft API object library file

The object library file is located in the folder where the ReliaSoft applications are installed. By default, this folder is at "C:\Program Files\ReliaSoft\ReliaSoft 2019".

To get the latest version of the file, choose File > Help > Check for Updates or download the latest software update from HBM Prenscia Support Portal. You may need to to update the library reference of your custom applications to point to the location of the object library file. For VBA applications, use the ReliaSoftAPI19.tlb file. For .NET applications, use the ReliaSoftAPI19.dll file.


Highlights

Here's a brief overview of the most significant enhancements and deprecations in the API since the previous version.

19.0.1

  • Changed the name of the libraries to ReliaSoftAPI19.tlb and ReliaSoftAPI19.dll. The API's are also now version dependent.
  • Added the following to the Repository class:
  • SetCrewIDs
  • GetCrewIDs
  • CrewIDs
  • Added the following methods and properties to the cScheduledTask class:
  • Removed the following methods and property from the cScheduledTask class:
  • SetCrewIDs
  • GetCrewIDs
  • CrewIDs
  • OnCondCrewIDs
  • Added the PoolInfo structure to be used with the GetPools and SetPools methods, as well as the Pools property.
  • Added the TeamInfo class which contains the following methods and property:
  • Added the following properties to the XFMEAEffect class:
  • SubSev1Init
  • SubSev1Rev
  • SubSev2Init
  • SubSev2Rev
  • SubSev3Init
  • SubSev3Rev
  • SubSev4Init
  • SubSev4Rev
  • SubSev5Init
  • SubSev5Rev
  • SubSev6Init
  • SubSev6Rev
  • SubSev7Init
  • SubSev7Rev
  • SubSev8Init
  • SubSev8Rev
  • Added the following property to the XFMEAItem class:
  • Qty

18.0.3

  • Added the following methods to the Repository class:

18.0.2

  • Increased the length of a scheduled task name up to 2,000 characters to match the desktop applications.

18.0.1

Initial public release for Version 2018 applications.

  • In the WeibullDataSet object, the type for the NumberInGroup parameter was changed from Integer to Double to allow fractional failure calculations.
  • In XfmeaItem object, added the ReliabilityPolicyType property.
  • Added the following properties to the WAPlotSettings :
    • ShowDataPoints
    • Show3PWeibullAdjustedItems
    • Show3PWeibullUnadjustedItems
  • Added the following methods to the Repository class:

11.0.1

Initial public release for Version 11 applications.

  • Added new classes and methods for accessing profiles, which is a new type of Synthesis resource introduced in the latest version of the Synthesis desktop applications.
  • Removed the obsolete ALTAStressProfile class and replaced it with the new cProfile class.
  • Removed the obsolete ALTASegment class and replaced it with the new ProfileSegment class.

10.1.4

  • Added ability to assign a URD to a BlockSim block in a Synthesis repository. Includes ability to get an array of BlockSim block names, RBDs, fault trees and properties.
  • Added ability to hide messages when doing batch calculations and customize event procedures for Repository, WeibullDataSet and ALTADataSet objects.
  • For locally-hosted licensing, added the Synthesis API Ante Service to improve response times.

10.1.1

  • Added ability to get global and reference resources. An optional Filter parameter has been added to the following methods. The filter's default value is 0, which returns local resources.
  • Added a class that allows VBA users to change the API library language.
  • Added a method for getting a single system hierarchy item.
  • Added new user-defined properties to relevant resource classes.
  • Deprecated a couple of obsolete properties.
  • Various fixes and non-breaking changes.

10.0.3

Initial public release for Version 10 applications.

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 to Repository.Model.GetAllModels(); similarly, the Repository.ImportBlockSimXMLFile method has been renamed to Repository.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.