Repository.WriteToDiagnosticsLog: Difference between revisions

From ReliaWiki
Jump to navigation Jump to search
No edit summary
No edit summary
Line 4: Line 4:


== Syntax ==
== Syntax ==
*WriteToDiagnosticsLog({{APIPrefix|Optional ByVal}} message {{APIPrefix|As String}} , {{APIPrefix|Optional ByVal}} entrytype {{APIPrefix|As}} [[Repository.XFRACASDiagnosticEntryType|XFRACASDiagnosticEntryType]])
*WriteToDiagnosticsLog(message {{APIPrefix|As String}} , entrytype {{APIPrefix|As}} [[Repository.XFRACASDiagnosticEntryType|XFRACASDiagnosticEntryType]], comment{{APIPrefix|As String}})


Parameters
Parameters
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]](ByVal message As String, ByVal entryType As [[Repository.XFRACASDiagnosticsEntryType|XFRACASDiagnosticsEntryType]])
  MyRepository.[[Repository.WriteToDiagnosticsLog|WriteToDiagosticsLog]](Diagnostics Message TextAs String, ByVal entryType As [[Repository.XFRACASDiagnosticsEntryType|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]](ByVal message As String, ByVal entryType As [[Repository.XFRACASDiagnosticsEntryType|XFRACASDiagnosticsEntryType]])
         MyRepository.[[Repository.WriteToDiagnosticsLog|WriteToDiagosticsLog]](ByVal Diagnostics Message As String, ByVal entryType As [[Repository.XFRACASDiagnosticsEntryType|XFRACASDiagnosticsEntryType]].4)

Revision as of 23:22, 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 As XFRACASDiagnosticsEntryType.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(ByVal Diagnostics Message As String, ByVal entryType As XFRACASDiagnosticsEntryType.4)