Repository Class: Difference between revisions

From ReliaWiki
Jump to navigation Jump to search
No edit summary
No edit summary
Line 1: Line 1:
{{Template:InProgress}}
{{Template:APIClass|Repository Class| }}  
{{Template:APIClass|Repository Class| }}  
This is a class that allows you to access a Synthesis repository. The class has following sections containing methods and properties that allow you to read, create and edit various objects in the repository. See [[#Usage_Example|Example]] at the bottom of this page. Also see the [[#Notes|important note]] for version 9 users.
This is a class that allows you to access a Synthesis repository. The class has following sections containing methods and properties that allow you to read, create and edit various objects in the repository. See [[#Usage_Example|Example]] at the bottom of this page. Also see the [[#Notes|important note]] for version 9 users.

Revision as of 21:25, 7 July 2015

Template:InProgress

This is a class that allows you to access a Synthesis repository. The class has following sections containing methods and properties that allow you to read, create and edit various objects in the repository. See Example at the bottom of this page. Also see the important note for version 9 users.

Repository

Project

  • GetAllProjects Returns an array containing all project names and their IDs from the current repository.
  • GetCurrentProject Returns the name and ID of the current project.
  • SetCurrentProject Opens (sets as current) a project with the specified ID.

Unit

  • GetAllUnits Returns an array containing all units of measurement from the current repository.

Model

  • GetAllModelsInfo Returns an array containing all model names and their IDs from the current project.
  • GetAllModels Returns an array containing all models from the current project.
  • AddModel Saves a new model in the repository.
  • UpdateModel Updates the model in the repository.
  • GetModel Returns the model from the current project with the specified ID. Returns nothing if the model does not exist or is not in the current project. *
  • IsModelUsed Checks if the model is currently in use by other items. *
  • DeleteModel Checks if the model is not in use and deletes the model. Returns true if success, false otherwise. Throws an exception if the model is in use. *

URD

  • GetAllURDs Returns an array containing all URDs from the current project.
  • AddURD Saves a new URD in the repository.
  • UpdateURD Updates the URD in the repository.
  • GetURD Returns the URD with the provided ID. Returns nothing if the URD does not exist. *

Variable

  • GetAllVariables Returns an array containing all variables in the current project.
  • AddVariable Saves a new variable in the repository.
  • UpdateVariable Updates the variable in the repository.
  • GetVariable Returns variable with the provided ID. Returns nothing if the variable doesn't exist. *

Task

Crew

  • GetAllCrews Returns an array containing all crews from the current project.
  • AddCrew Saves the crew in the repository.
  • UpdateCrew Updates the crew in the repository.
  • GetCrew Returns crew with the provided ID. Returns nothing if the crew doesn't exist. *

Pool

  • GetAllPools Returns an array containing all spare parts pools from the current project.
  • AddPool Saves the spare parts pool in the repository.
  • UpdatePool Updates the spare parts pool in the repository.
  • GetPool Returns pool with the provided ID. Returns nothing if the pool doesn't exist. *

Action

  • GetAllActionsDictionary Returns a dictionary of all actions in the current project. *
  • GetAllActions Returns an array containing all actions from the current project.
  • AddAction Saves the action in the repository.
  • UpdateAction Updates the action in the repository.
  • GetAction Returns action with the provided ID. Returns nothing if the action doesn't exist. *

Control

BlockSim

  • ImportBlockSimXMLFile Imports from an XML file to the current project.
  • ExportBlockSimXMLFile Creates a new BlockSim XML file and exports items from the current project. If the XML file already exists it will be overridden.

DataWarehouse

XFRACAS

Xfmea

Usage Example

In this usage example, the API is used to connect to a repository, retrieve one of the models in it and then calculate the reliability at a specified time, based on that model.

 'Declare a new repository connection object. 
 Dim MyRepository As New Repository
 
 'Connect to a Synthesis repository. 
 Dim Success As Boolean = False
 Success = MyRepository.ConnectToRepository("C:\Users\Name\Documents\ReliaSoft\Files\repository.rsr10")
 
 'Get a list of the names/IDs of projects in the connected repository. 
 Dim ListOfProjects() As NameIdPair
 ListOfProjects = MyRepository.Project.GetAllProjects()
 
 'Open the first project in the list. 
 MyRepository.Project.SetCurrentProject(ListOfProjects(0).ID)
 
 'Get a list of the names/IDs of models in the current project. 
 Dim ListOfModels() As NameIdPair
 ListOfModels = MyRepository.Model.GetAllModelsInfo()
 
 'Retrieve the first model in the list. 
 Dim AModel As cModel
 AModel = MyRepository.Model.GetModel(ListOfModels(0).ID)
 
 'Calculate the reliability at time = 50 and save the result. See Reliability. 
 Dim Rel As Double
 Rel = AModel.Reliability(50)
 
 'Disconnect from the repository. 
 MyRepository.DisconnectFromRepository()

Notes

  • Important: If you have upgraded from version 9 and have existing code written using Synthesis API version 9, you should modify your code. In version 9, all methods existed in the Repository class, in version 10 they were moved in sections, according to the object type they apply to. For instance, Repository.GetAllModels is now Repository.Model.GetAllModels; Repository.ImportBlockSimXMLFile is now Repository.BlockSim.ImportBlockSimXMLFile etc. The old methods still exist so your code is not broken, but all old methods are deprecated and may be removed in the future releases.