Repository.WriteToDiagnosticsLog: Difference between revisions

From ReliaWiki
Jump to navigation Jump to search
No edit summary
Line 11: Line 11:
:''exObject'': The object that can be written into the diagnostics log.
:''exObject'': The object that can be written into the diagnostics log.
:''comment'': Optional comment that can be written into the diagnostics log.
:''comment'': Optional comment that can be written into the diagnostics log.
:''[[Repository.XFRACASDiagnosticsEntryType|XFRACASDiagnosticsEntryType]]: The type of diagnostics entry
:''[[Repository.XFRACASDiagnosticsEntryType Enumeration|XFRACASDiagnosticsEntryType]]: The type of diagnostics entry




Line 31: Line 31:
  MyRepository.[[Repository.ProcessXfracasImports|ProcessXfracasImports]]()
  MyRepository.[[Repository.ProcessXfracasImports|ProcessXfracasImports]]()
  '{{APIComment|Create place to see where code is breaking instead of writing to your own logfile}}
  '{{APIComment|Create place to see where code is breaking instead of writing to your own logfile}}
  MyRepository.[[Repository.WriteToDiagnosticsLog|WriteToDiagosticsLog]](Diagnostics Message TextAs String, {{APIPrefix|ByVal}} entryType {{APIPrefix|As}}[[Repository.XFRACASDiagnosticsEntryType|XFRACASDiagnosticsEntryType]].4)
  MyRepository.[[Repository.WriteToDiagnosticsLog|WriteToDiagosticsLog]](Diagnostics Message TextAs String, {{APIPrefix|ByVal}} entryType {{APIPrefix|As}}[[Repository.XFRACASDiagnosticsEntryType Enumeration|XFRACASDiagnosticsEntryType]].4)


=== Reformatted Usage Example ===
=== Reformatted Usage Example ===
Line 53: Line 53:


{{APIComment|Create place to see where code is breaking instead of writing to your own logfile}}
{{APIComment|Create place to see where code is breaking instead of writing to your own logfile}}
         MyRepository.[[Repository.WriteToDiagnosticsLog|WriteToDiagosticsLog]]({{APIPrefix|ByVal}}Diagnostics Message {{APIPrefix|As}}String, ByVal entryType {{APIPrefix|AS}}[[Repository.XFRACASDiagnosticsEntryType|XFRACASDiagnosticsEntryType]].4)
         MyRepository.[[Repository.WriteToDiagnosticsLog|WriteToDiagosticsLog]]({{APIPrefix|ByVal}}Diagnostics Message {{APIPrefix|As}}String, ByVal entryType {{APIPrefix|AS}}[[Repository.XFRACASDiagnosticsEntryType Enumeration|XFRACASDiagnosticsEntryType]].4)

Revision as of 23:28, 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: The type of diagnostics entry


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(Diagnostics Message TextAs String, ByVal entryType AsXFRACASDiagnosticsEntryType.4)

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(ByValDiagnostics Message AsString, ByVal entryType ASXFRACASDiagnosticsEntryType.4)