1. Introduction 🚀

In the following documentation, the OpenText Core Software Delivery Platform and OpenText Software Delivery Management will collectively be referred to as 'the product'.

This is a Node.JS library for converting different kinds of test reports into the product's format.

---

2. Table of Contents

• 1. Introduction
• 2. Table of Contents
• 3. Supported Formats
• 4. Getting Started
  • 4.1. Install Package
  • 4.2. Usage Examples
    • 4.2.1. Convert JUnit results
    • 4.2.2. Convert Gherkin results
• 5. Change log

---

3. Supported Formats

The tool supports the following test result formats which can be converted to the format accepted by the product (documentation reference):

• JUnit
• Gherkin

---

4. Getting Started

4.1. Install Package

The library is released as a NPM package: @microfocus/alm-octane-test-result-convertion

Run the following command to install the package via NPM in your project:

$ npm i @microfocus/alm-octane-test-result-convertion

After installing the package, you can import the method needed for convestion as shown below.

---

4.2. Usage Examples

4.2.1. Convert JUnit results

import {convertJUnitXMLToOctaneXML} from '@microfocus/alm-octane-test-result-convertion';

const buildConfig = {
  build_id: '123',
  job_id: 'myJob',
  server_id: 'serverId'
};

const xml = fs
  .readFileSync(TestResources.XML_ONE_TEST_SUITE_PATH)
  .toString();

const convertedXML = convertJUnitXMLToOctaneXML(xml, buildConfig);

4.2.2. Convert Gherkin results

import {convertGherkinXMLToOctaneXML} from '@microfocus/alm-octane-test-result-convertion';

const buildConfig = {
  build_id: '123',
  job_id: 'myJob',
  server_id: 'serverId'
};

const xml = fs
  .readFileSync(TestResources.GHERKIN_TWO_FEATURES_PATH)
  .toString();

const convertedXML = convertGherkinXMLToOctaneXML(xml, buildConfig, 'Cucumber');

5. Change log

25.2.2

• Add external_run_id to test run's properties for test results with multiple test suites.

25.2.1

• Add external_run_id to test run's properties.

25.2.0

• Add artifact_id as a build property into the OctaneBuildConfig interface.

25.1.2

• Convert Gherkin test results to the product's format XML via the convertGherkinXMLToOctaneXML method.

25.1.0

• Fix issue causing skipped test cases to be treated as passed.

1.0.1

• Allows conversion from JUnit format XML to the product's format XML via the convertJUnitXMLToOctaneXML method.