Namespace: OpenEdge.ABLUnit.Writer
Class
ResultsXmlWriter
Parent classes:
Inherits: Progress.Lang.Object
Implements: OpenEdge.ABLUnit.Writer.IResultsWriter

Copyright (c) 2020 by Progress Software Corporation. All rights reserved.
File:ResultsXmlWriter
Purpose:Writes a test run's output to a jUnit results.xml format
Author(s):pjudge
Created:2020-02-04
Notes:* The format of the XML is per https://llg.cubic.org/docs/junit/ and/or
https://github.com/junit-team/junit5/blob/master/platform-tests/src/test/resources/jenkins-junit.xsd




Method Summary
Options Name Purpose
AddChildEntities (TestEntity, handle, ICollection) /* Writes the details of a particular test case into the given handle @param TestEntity The test entity being written @param handle The parent XML node @param ICollection A collection to hold any X-DOC or X-NODEREF handles for cleanup after writing of the doc */
AddTestcase (handle, TestEntity, handle, ICollection) /* Creates the <testcase> tag element for every test method or test procedure. @param handle An X-NODEREF @param TestEntity The entity for which to write results @param handle The parent X-NODEREF @param ICollection A collection to hold any X-DOC or X-NODEREF handles for cleanup after writing of the doc */
HANDLE CreatePropertiesElement (handle, ICollection) /* Creates a properties element, which has some runtime properties added @param handle The XML document the <properties> element is added to @param ICollection A collection to hold any X-DOC or X-NODEREF handles for cleanup after writing of the doc @return handle The <properties> element */
HANDLE CreateSkippedElement (handle, character, ICollection) /* Adds a 'skipped' element with a message attribute @param handle the X-DOC handle @param character A message string. If an unknonw string is send, no message attribute is added. @param ICollection A collection to hold any X-DOC or X-NODEREF handles for cleanup after writing of the doc @return handle The 'skipped' element */
HANDLE CreateTraceElement (handle, TestTestResult, character, ICollection) /* Creates the trace element with the given name and result in the xml file . Applicable for both error and exception nodeName: the name of the node 'error' or 'failure'. @param handle The XML document @param TestTestResult The test result @param character The name for this trace node (error/failure) @param ICollection A collection to hold any X-DOC or X-NODEREF handles for cleanup after writing of the doc @return handle The newly-populated/created trace */
HANDLE CreateXmlDoc (ICollection) /* Creates an X-DOCUMENT and caches it for later cleanup @param ICollection A collection to hold any X-DOC or X-NODEREF handles for cleanup after writing of the doc @return handle The newly created X-DOCUMENT handle */
HANDLE CreateXmlNode (ICollection) /* Creates an X-NODEREF and caches it for later cleanup @param ICollection A collection to hold any X-DOC or X-NODEREF handles for cleanup after writing of the doc @return handle The newly created X-NODEREF handle */
WriteToFile (character, TestEntity) /* Writes the test results in the xml file @param character The XML file name. @param TestEntity The test to write (root) */
LONGCHAR WriteToLongchar (TestEntity) /* Writes the test results to a longchar @param TestEntity The test to write (root) @param longchar The XML output, with a UTF-8 codepage */
HANDLE WriteXml (TestEntity, ICollection) /* Writes the testENtity as XML @param TestEntity The test to write (root) @param ICollection A collection holding all X-DOC or X-NODEREF handles for cleanup after writing of the doc. An invalid object may be passed in. A valid object will always be passed out. @return handle The XML document (X-DOC) */


Method Detail
Top

AddChildEntities (TestEntity, handle, ICollection)

/* Writes the details of a particular test case into the given handle
Parameters:
pEntity OpenEdge.ABLUnit.Model.TestEntity
pParentNode HANDLE
pXmlRefs OpenEdge.Core.Collections.ICollection
Top

AddTestcase (handle, TestEntity, handle, ICollection)

/* Creates the <testcase> tag element for every test method or test procedure.
Parameters:
pNode HANDLE
pEntity OpenEdge.ABLUnit.Model.TestEntity
pParentNode HANDLE
pXmlRefs OpenEdge.Core.Collections.ICollection
Top

HANDLE CreatePropertiesElement (handle, ICollection)

/* Creates a properties element, which has some runtime properties added
Parameters:
pDoc HANDLE
pXmlRefs OpenEdge.Core.Collections.ICollection
Returns HANDLE
handle The <properties> element
Top

HANDLE CreateSkippedElement (handle, character, ICollection)

/* Adds a 'skipped' element with a message attribute
Parameters:
pDoc HANDLE
pMessage CHARACTER
pXmlRefs OpenEdge.Core.Collections.ICollection
Returns HANDLE
handle The 'skipped' element
Top

HANDLE CreateTraceElement (handle, TestTestResult, character, ICollection)

/* Creates the trace element with the given name and result in the xml file . Applicable for both error and exception
nodeName: the name of the node 'error' or 'failure'.
Parameters:
pDoc HANDLE
pResult OpenEdge.ABLUnit.Results.TestTestResult
pNodeName CHARACTER
pXmlRefs OpenEdge.Core.Collections.ICollection
Returns HANDLE
handle The newly-populated/created trace
Top

HANDLE CreateXmlDoc (ICollection)

/* Creates an X-DOCUMENT and caches it for later cleanup
Parameters:
pXmlRefs OpenEdge.Core.Collections.ICollection
Returns HANDLE
handle The newly created X-DOCUMENT handle
Top

HANDLE CreateXmlNode (ICollection)

/* Creates an X-NODEREF and caches it for later cleanup
Parameters:
pXmlRefs OpenEdge.Core.Collections.ICollection
Returns HANDLE
handle The newly created X-NODEREF handle
Top

WriteToFile (character, TestEntity)

/* Writes the test results in the xml file
Parameters:
pXmlFileName CHARACTER
pTestEntity OpenEdge.ABLUnit.Model.TestEntity
Top

LONGCHAR WriteToLongchar (TestEntity)

/* Writes the test results to a longchar
Parameters:
pTestEntity OpenEdge.ABLUnit.Model.TestEntity
Returns LONGCHAR
Top

HANDLE WriteXml (TestEntity, ICollection)

/* Writes the testENtity as XML
An invalid object may be passed in. A valid object will always be passed out.
Parameters:
pTestEntity OpenEdge.ABLUnit.Model.TestEntity
pXmlRefs OpenEdge.Core.Collections.ICollection
Returns HANDLE
handle The XML document (X-DOC)


Copyright © 2022 Progress Software Corporation. All rights Reserved.

Progress® OpenEdge® Release 11.7.15