com.hp.lft.report

Class Reporter

  • java.lang.Object
    • com.hp.lft.report.Reporter


  • public class Reporter
    extends java.lang.Object
    Accesses the OpenText Functional Testing for Developers HTML Report.
    • Constructor Summary

      Constructor and Description
      Reporter() 
    • Method Summary

      Modifier and TypeMethod and Description
      static voidaddRunInformation(java.lang.String fieldName, java.lang.String fieldValue)
      Adds a custom entry to the top section of the OpenText Functional Testing for Developers report.
      static voidendReportingContext()
      Ends the section in the OpenText Functional Testing for Developers report.
      static voidendTest()
      Ends the current test level and sets the test status as passed.
      static voidendTest(Status status)
      Ends the current test level and sets the specified status for the test.
      static java.lang.StringgenerateReport()
      Generates the OpenText Functional Testing for Developers report.
      static Status

      getCurrentExecutionContextStatus()

      Returns the status of the current execution context. The execution context is equivalent to any superior structure that contains operations (e.g.: test method, reporting context).
      static ReportConfigurationgetReportConfiguration()
      Returns the ReportConfiguration interface, which enables you to customize the OpenText Functional Testing for Developers report behavior.
      static java.lang.StringgetReportDescription()
      Returns the OpenText Functional Testing for Developers report description.
      static ReportLevelgetReportLevel()
      Returns the report level used to generate the OpenText Functional Testing for Developers report.
      static java.lang.StringgetReportTitle()
      Returns the OpenText Functional Testing for Developers report title.
      static CaptureLevelgetSnapshotCaptureLevel()
      Returns the snapshot capture level used to generate the OpenText Functional Testing for Developers report.
      static StatusgetStatus()
      Returns the runtime status of the OpenText Functional Testing for Developers report.
      static voidinit()
      Initializes the report with the default configuration, as defined in the report section of the leanft.properties file.
      static voidinit(ModifiableReportConfiguration configuration)
      Initializes the report with provided the report configuration.
      static voidreportEvent(java.lang.String stepName, java.lang.String description)
      Adds a custom step to the OpenText Functional Testing for Developers report with default status "Passed".
      static voidreportEvent(java.lang.String stepName, java.lang.String description, Status status)
      Adds a custom step to the OpenText Functional Testing for Developers report.
      static voidreportEvent(java.lang.String stepName, java.lang.String description, Status status, java.lang.Exception ex, java.awt.image.RenderedImage image)
      Adds a custom step to the OpenText Functional Testing for Developers report including the provided exception and image object.
      static voidreportEvent(java.lang.String stepName, java.lang.String description, Status status, java.awt.image.RenderedImage image)
      Adds a custom step to the OpenText Functional Testing for Developers report including the provided image object.
      static voidreportEvent(java.lang.String stepName, java.lang.String description, Status status, java.lang.String imagePath)
      Adds a custom step to the OpenText Functional Testing for Developers report including the image from the specified path.
      static voidreportEvent(java.lang.String stepName, java.lang.String description, Status status, java.lang.Throwable e)
      Adds a custom step to the OpenText Functional Testing for Developers report including the provided exception.
      static voidreportEvent(java.lang.String stepName, java.lang.String description, Status status, java.lang.Throwable e, java.lang.String imagePath)
      Adds a custom step to the OpenText Functional Testing for Developers report including exception details and the image from the specified path.
      static voidreportEvent(java.lang.String stepName, ReportAdditionalInfo reportAdditionalInfo)

      Adds a custom step to the OpenText Functional Testing for Developers report including the information about the step as a ReportAdditionalInfo object.

      static voidreportRuntimeError(java.lang.Throwable throwable)
      Adds a runtime error node to the report with the supplied Throwable object as the reason.
      static voidreportVerification(Status status, VerificationData verificationData)
      Adds a custom verification step to the OpenText Functional Testing for Developers report.
      static voidsetReportDescription(java.lang.String reportDescription)
      Sets the OpenText Functional Testing for Developers report description.
      static voidsetReportLevel(ReportLevel reportLevel)
      Sets the report level used to generate the OpenText Functional Testing for Developers report.
      static voidsetReportTitle(java.lang.String reportTitle)
      Sets the report title.
      static voidsetSnapshotCaptureLevel(CaptureLevel snapshotCaptureLevel)
      Sets the snapshot capture level used to generate the OpenText Functional Testing for Developers report.
      static voidstartReportingContext(java.lang.String contextName)
      Starts a named section in the OpenText Functional Testing for Developers report.
      static voidstartReportingContext(java.lang.String contextName, java.lang.String contextDescription)
      Starts a named section in the OpenText Functional Testing for Developers report.
      static voidstartReportingContext(java.lang.String contextName, ReportContextInfo reportContextInfo)
      Starts a named section in the OpenText Functional Testing for Developers report.
      static voidstartReportingContext(java.lang.String contextName, java.lang.String contextDescription, Map<String, Object> data)
      Starts a named section in the OpenText Functional Testing for Developers report.
      static voidstartScreenRecording(java.lang.Boolean useCompression, java.lang.String outputPath)
      Starts screen recording.
       
      static voidstartScreenRecording(java.lang.Boolean useCompression)
      Starts screen recording to the report folder.
       
      static voidstartScreenRecording(java.lang.String outputPath)
      Starts screen recording of a time lapse video.
       
      static void

      startScreenRecording()

      Starts screen recording of a time lapse video saved to the reporter folder.
       
      static voidstartTest(java.lang.String testName)
      Starts a new test node in the OpenText Functional Testing for Developers report test flow tree.
      static voidstartTest(java.lang.String testName, java.lang.String testDescription)
      Starts a new test node in the OpenText Functional Testing for Developers report test flow tree.
      static voidstopScreenRecording ()
      Stops screen recording.
       
      • Methods inherited from class java.lang.Object

        clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
    • Constructor Detail

      • Reporter

        public Reporter()
    • Method Detail

      • getReportConfiguration

        public static ReportConfiguration getReportConfiguration()
        Returns the ReportConfiguration interface, which enables you to customize the OpenText Functional Testing for Developers report behavior.
        Returns:
        Report Configuration.
      • reportEvent

        public static void reportEvent(java.lang.String stepName,
                                       java.lang.String description,
                                       Status status)
                                throws ReportException
        Adds a custom step to the OpenText Functional Testing for Developers report.
        Parameters:
        stepName - the name of the reported step. This name is the label of the step node in the report.
        description - the description of the reported step. The description is displayed in the Details pane of the report.
        status - the Status for the step.
        Throws:
        ReportException - if error occurs in the report
      • reportEvent

        public static void reportEvent(java.lang.String stepName,
                                       java.lang.String description,
                                       Status status,
                                       java.lang.String imagePath)
                                throws ReportException
        Adds a custom step to the OpenText Functional Testing for Developers report including the image from the specified path.
        Parameters:
        stepName - the name of the reported step. This name is the label of the step node in the report.
        description - the description of the reported step. The description is displayed in the Details pane of the report.
        status - the Status for the step.
        imagePath - the full path of the image to display for the step. Supported image types: BMP, GIF, JPEG, PNG, TIFF
        Throws:
        ReportException - if error occurs in the report
      • reportEvent

        public static void reportEvent(java.lang.String stepName,
                                       java.lang.String description,
                                       Status status,
                                       java.lang.Throwable e)
                                throws ReportException
        Adds a custom step to the OpenText Functional Testing for Developers report including the provided exception.
        Parameters:
        stepName - the name of the reported step. This name is the label of the step node in the report.
        description - the description of the reported step. The description is displayed in the Details pane of the report.
        status - the Status for the step.
        e - the error that occurred.
        Throws:
        ReportException - if error occurs in the report
      • reportEvent

        public static void reportEvent(java.lang.String stepName,
                                       java.lang.String description,
                                       Status status,
                                       java.lang.Throwable e,
                                       java.lang.String imagePath)
                                throws ReportException
        Adds a custom step to the OpenText Functional Testing for Developers report including exception details and the image from the specified path.
        Parameters:
        stepName - the name of the reported step. This name is the label of the step node in the report.
        description - the description of the reported step. The description is displayed in the Details pane of the report.
        status - the Status for the step.
        e - the error that occurred.
        imagePath - the full path of the image to display for the step. Supported image types: BMP, GIF, JPEG, PNG, TIFF
        Throws:
        ReportException - if error occurs in the report
      • reportEvent

        public static void reportEvent(java.lang.String stepName,
                                       java.lang.String description)
                                throws ReportException
        Adds a custom step to the OpenText Functional Testing for Developers report with default status "Passed".
        Parameters:
        stepName - the name of the reported step. This name is the label of the step node in the report.
        description - the description of the reported step. The description is displayed in the Details pane of the report.
        Throws:
        ReportException - if error occurs in the report
      • reportEvent

        public static void reportEvent(java.lang.String stepName,
                                       java.lang.String description,
                                       Status status,
                                       java.awt.image.RenderedImage image)
                                throws ReportException
        Adds a custom step to the OpenText Functional Testing for Developers report including the provided image object.
        Parameters:
        stepName - the name of the reported step. This name is the label of the step node in the report.
        description - the description of the reported step. The description is displayed in the Details pane of the report.
        status - the Status for the step.
        image - the RenderedImage object to use for the step.
        Throws:
        ReportException - if error occurs in the report
      • reportEvent

        public static void reportEvent(java.lang.String stepName,
                                       java.lang.String description,
                                       Status status,
                                       java.lang.Exception ex,
                                       java.awt.image.RenderedImage image)
                                throws ReportException
        Adds a custom step to the OpenText Functional Testing for Developers report including the provided exception and image object.
        Parameters:
        stepName - the name of the reported step. This name is the label of the step node in the report.
        description - the description of the reported step. The description is displayed in the Details pane of the report.
        status - the Status for the step.
        ex - the exception that occurred.
        image - the RenderedImage object to use for the step.
        Throws:
        ReportException - if error occurs in the report
      • reportEvent

        public static void reportEvent(java.lang.String stepName,
        				ReportAdditionalInfo reportAdditionalInfo)
        			throws ReportException
        Adds a custom step to the OpenText Functional Testing for Developers report including the information about the step as a ReportAdditionalInfo object.
        Parameters:
        stepName - the name of the reported step. This name is the label of the step node in the report.
        reportAdditionalInfo - a ReportAdditionalInfo object that contains the information to describe the event.
        Throws:
        ReportException - if error occurs in the report
      • addRunInformation

        public static void addRunInformation(java.lang.String fieldName,
                                             java.lang.String fieldValue)
        Adds a custom entry to the top section of the OpenText Functional Testing for Developers report.
        Parameters:
        fieldName - the entry name.
        fieldValue - the entry value
      • startScreenRecording

         
        public static void startScreenRecording(java.lang.Boolean useCompression, java.lang.String outputPath)
        					throws ReportException
        Starts a screen recording, saved as an .avi file. A test cannot start multiple screen recordings in parallel. To stop the recording, use stopScreenRecording.
        Parameters:
        useCompression - Specifies whether to record the whole scene or present a time-lapse video. true. The recorded video represents a time lapse of the recorded scene. false. the full scene is recorded.
        outputPath - The target location for the recorded video. A link to the recording is added to the test results. If you enter a relative path, the path is relative to the report folder.
        Throws:
        ReportException - if error occurs in the report
      • startScreenRecording

         
        public static void startScreenRecording(java.lang.Boolean useCompression)
        					throws ReportException
        Starts screen recording, saved as an .avi file to the report folder. A test cannot start multiple screen recordings in parallel. To stop the recording, use stopScreenRecording.
        Parameters:
        useCompression - Specifies whether to record the whole scene or present a time-lapse video. true. The recorded video represents a time lapse of the recorded scene. false. the full scene is recorded.
        Throws:
        ReportException - if error occurs in the report
      • startScreenRecording

         
        public static void startScreenRecording(java.lang.String outputPath)
        					throws ReportException
        Starts screen recording of a time lapse video, saved as an .avi file. A test cannot start multiple screen recordings in parallel. To stop the recording, use stopScreenRecording.
        Parameters:
        outputPath - The target location for the recorded video. A link to the recording is added to the test results. If you enter a relative path, the path is relative to the report folder.
        Throws:
        ReportException - if error occurs in the report
      • startScreenRecording

         
        public static void startScreenRecording()
        			throws ReportException
        Starts screen recording of a time lapse video saved as an .avi file. to the reporter folder. A test cannot start multiple screen recordings in parallel. To stop the recording, use stopScreenRecording.
        Throws:
        ReportException - if error occurs in the report
      • stopScreenRecording

         
        public static void stopScreenRecording()
        			throws ReportException
        Stops screen recording. A link to the .avi recording is added to the report. To start the recording use startScreenRecording.
        Throws:
        ReportException - if error occurs in the report
      • startReportingContext

        public static void startReportingContext(java.lang.String contextName)
                                          throws ReportException
        Starts a named section in the OpenText Functional Testing for Developers report.
        Parameters:
        contextName - the section name.
        Throws:
        ReportException - if error occurs in the report
      • startReportingContext

        public static void startReportingContext(java.lang.String contextName,
                                                 java.lang.String contextDescription)
                                          throws ReportException
        Starts a named section in the OpenText Functional Testing for Developers report.
        Parameters:
        contextName - the section name.
        contextDescription - the section description.
        Throws:
        ReportException - if error occurs in the report
      • startReportingContext

        public static void startReportingContext(java.lang.String contextName,
        					ReportContextInfo reportContextInfo)
        				throws ReportException
        Starts a named section in the OpenText Functional Testing for Developers report.
        Parameters:
        contextName - the section name.
        reportContextInfo - a ReportContextInfo object which contains the information to describe the section.
        Throws:
        ReportException - if error occurs in the report
      • startReportingContext

        public static void startReportingContext(java.lang.String contextName,
                                                 java.lang.String contextDescription, 
                                                 Map<String, Object> data)
        				throws ReportException
        Starts a named section in the OpenText Functional Testing for Developers report.
        Parameters:
        contextName - the section name.
        contextDescription - the section description.
        data - the map containing additional custom information.
        Throws:
        ReportException - if error occurs in the report
      • endReportingContext

        public static void endReportingContext()
                                        throws ReportException
        Ends the section in the OpenText Functional Testing for Developers report.
        Throws:
        ReportException - if error occurs in the report
      • startTest

        public static void startTest(java.lang.String testName)
                              throws ReportException
        Starts a new test node in the OpenText Functional Testing for Developers report test flow tree. Required only when using Reporter in a class that does not inherit from UnitTestBase.
        Parameters:
        testName - name of the test.
        Throws:
        ReportException - if error occurs in the report
      • startTest

        public static void startTest(java.lang.String testName,
                                     java.lang.String testDescription)
                              throws ReportException
        Starts a new test node in the OpenText Functional Testing for Developers report test flow tree.
        Parameters:
        testName - the test name.
        testDescription - the test description.
        Throws:
        ReportException - if error occurs in the report
      • endTest

        public static void endTest()
                            throws ReportException
        Ends the current test level and sets the test status as passed.
        Throws:
        ReportException - if error occurs in the report
      • endTest

        public static void endTest(Status status)
                            throws ReportException
        Ends the current test level and sets the specified status for the test.
        Parameters:
        status - the Status for the current test.
        Throws:
        ReportException - if error occurs in the report
      • init

        public static void init()
                         throws ReportException
        Initializes the report with the default configuration, as defined in the report section of the leanft.properties file.
        Throws:
        ReportException - if error occurs in the report
      • generateReport

        public static java.lang.String generateReport()
                                               throws ReportException
        Generates the OpenText Functional Testing for Developers report.
        Returns:
        the XML file path on which the OpenText Functional Testing for Developers report is based.
        Throws:
        ReportException - if error occurs in the report
      • getCurrentExecutionContextStatus

        public static Status getCurrentExecutionContextStatus()

        Returns the status of the current execution context. The execution context is equivalent to any superior structure that contains operations (e.g.: test method, reporting context).

        Returns:

        The status of the current execution context as a Status object.

      • getReportDescription

        public static java.lang.String getReportDescription()
        Returns the OpenText Functional Testing for Developers report description. The description appears directly below the title in the OpenText Functional Testing for Developers report. By default, the description is empty.
        Returns:
        report the OpenText Functional Testing for Developers report description.
      • setReportDescription

        public static void setReportDescription(java.lang.String reportDescription)
        Sets the OpenText Functional Testing for Developers report description. The description appears directly below the title in the OpenText Functional Testing for Developers report.
        Parameters:
        reportDescription - The description to use for the report.
      • getReportTitle

        public static java.lang.String getReportTitle()
        Returns the OpenText Functional Testing for Developers report title. Default = Run Results.
        Returns:
        the OpenText Functional Testing for Developers report title.
      • setReportTitle

        public static void setReportTitle(java.lang.String reportTitle)
        Sets the report title.
        Parameters:
        reportTitle - the report description to use.
      • getReportLevel

        public static ReportLevel getReportLevel()
        Returns the report level used to generate the OpenText Functional Testing for Developers report.
        Returns:
        the ReportLevel.
      • setReportLevel

        public static void setReportLevel(ReportLevel reportLevel)
        Sets the report level used to generate the OpenText Functional Testing for Developers report.
        Parameters:
        reportLevel - the report level to use. Possible values: ReportLevel
      • getSnapshotCaptureLevel

        public static CaptureLevel getSnapshotCaptureLevel()
        Returns the snapshot capture level used to generate the OpenText Functional Testing for Developers report.
        Returns:
        the CaptureLevel.
      • setSnapshotCaptureLevel

        public static void setSnapshotCaptureLevel(CaptureLevel snapshotCaptureLevel)
        Sets the snapshot capture level used to generate the OpenText Functional Testing for Developers report.
        Parameters:
        snapshotCaptureLevel - the CaptureLevel to use.
      • getStatus

        public static Status getStatus()
        Returns the runtime status of the OpenText Functional Testing for Developers report.
        Returns:
        the Status.
      • reportVerification

        public static void reportVerification(Status status,
                                              VerificationData verificationData)
                                       throws ReportException
        Adds a custom verification step to the OpenText Functional Testing for Developers report.
        Parameters:
        status - Specify if the verification was passed or not.
        verificationData - The report verification data.
        Throws:
        ReportException - if error occurs in the report
      • reportRuntimeError

        public static void reportRuntimeError(java.lang.Throwable throwable)
        Adds a runtime error node to the report with the supplied Throwable object as the reason. The report status will be set to failed.
        Parameters:
        throwable - the reason for the report failure.