Repository.WriteToDiagnosticsLog: Difference between revisions

From ReliaWiki
Jump to navigation Jump to search
No edit summary
No edit summary
Line 6: Line 6:
*WriteToDiagnosticsLog({{APIPrefix|Optional ByVal}} message {{APIPrefix|As String}} , {{APIPrefix|Optional ByVal}} entrytype {{APIPrefix|As}} [[Repository.XFRACASDiagnosticEntryType|XFRACASDiagnosticEntryType]])
*WriteToDiagnosticsLog({{APIPrefix|Optional ByVal}} message {{APIPrefix|As String}} , {{APIPrefix|Optional ByVal}} entrytype {{APIPrefix|As}} [[Repository.XFRACASDiagnosticEntryType|XFRACASDiagnosticEntryType]])


Parameters
:''message'': The message that should be displayed in the diagnostics log for the diagnostics entry type
:''entryType'': The type of diagnostics entry type, specified as [[Repository.XFRACASDiagnosticsEntryType Enumeration|XFRACASDiagnosticsEntryType]]
:''exObject'': The object that can be written into the diagnostics log.
:''comment'': Optional comment that can be written into the diagnostics log.
:''[[Repository.XFRACASDiagnosticsEntryType|XFRACASDiagnosticsEntryType]]:


*WriteToDiagnosticsLog({{APIPrefix|ByVal}} exObject {{APIPrefix|As}} System.Exception, {{APIPrefix|ByVal}} entryType {{APIPrefix|As}} [[Repository.XFRACASDiagnosticsEntryType|XFRACASDiagnosticsEntryType]]{{APIPrefix|Optional ByVal}} comment {{APIPrefix|As String}} = "")


== Usage Example ==
== Usage Example ==

Revision as of 22:38, 25 April 2014



This subroutine adds diagnostic information into the diagnostics log. There are two methods that can be used. Both are shown.

Syntax

Parameters

message: The message that should be displayed in the diagnostics log for the diagnostics entry type
entryType: The type of diagnostics entry type, specified as XFRACASDiagnosticsEntryType
exObject: The object that can be written into the diagnostics log.
comment: Optional comment that can be written into the diagnostics log.
XFRACASDiagnosticsEntryType:


Usage Example

Code Block

' Declare a new repository connection class. 
Private WithEvents MyRepository As New Repository
' Connect to the Synthesis repository. 
Dim Success As Boolean = False
Success = MyRepository.ConnectToRepository("RepositoryFileNamePath")
' Get the list of XFRACAS Entities in the current project in the connected repository. 
Dim ListOfXFRACASEntities() As NameIdPair
ListOfXFRACASEntities = MyRepository.GetAllXFRACASEntities()
' Import the XML file into the entity desired.  In this example, the first entity is used. 
Dim ImportXMLSystemID As Integer
ImportXMLSystemID = MyRepository.ImportXFRACASXMLFile(ListOfXFRACASEntities(0).ID,   XFRACASImportType.Incident, "XMLFileName", "XMLFileDescription")
' Process the imported file. 
MyRepository.ProcessXfracasImports()
' Create place to see where code is breaking instead of writing to your own logfile 
MyRepository.WriteToDiagosticsLog(ByVal message As String, ByVal entryType As XFRACASDiagnosticsEntryType)

Reformatted Usage Example

Declare a new repository connection class.

       Private WithEvents MyRepository As New Repository

Connect to the Synthesis repository.

       Dim Success As Boolean = False
       Success = MyRepository.ConnectToRepository("RepositoryFileNamePath")

Get the list of XFRACAS Entities in the current project in the connected repository.

       Dim ListOfXFRACASEntities() As NameIdPair
       ListOfXFRACASEntities = MyRepository.GetAllXFRACASEntities()

Import the XML file into the entity desired. In this example, the first entity is used.

       Dim ImportXMLSystemID As Integer
       ImportXMLSystemID = MyRepository.ImportXFRACASXMLFile(ListOfXFRACASEntities(0).ID, XFRACASImportType.Incident, "XMLFileName", "XMLFileDescription")

Process the imported file.

       MyRepository.ProcessXfracasImports()

Create place to see where code is breaking instead of writing to your own logfile

       MyRepository.WriteToDiagosticsLog(ByVal message As String, ByVal entryType As XFRACASDiagnosticsEntryType)