Breadcrumbs

Page History

Versions Compared

Old Version 28

changes.mady.by.user Sergio Freire

Saved on Mar 18, 2021

compared with

New Version 29

changes.mady.by.user Unknown User (hslb)

Saved on Jul 14, 2021

Key

This line was added.
This line was removed.
Formatting was changed.

...

This build step will export the Cucumber Tests (i.e., Scenario/Scenario Outlines) in .feature or bundled in a .zip file. The rules for exporting are defined here.

It invokes Xray's Export Cucumber Tests REST API endpoint (see more information here).

...

Xray for Jenkins provides support for pipelines projects, allowing you to use Xray specific tasks.

Here is a simple example of a pipeline script using the Xray: Cucumber Features Export Task

Code Block

language	groovy
title	Jenkinsfile example (declarative)

pipeline {
    agent any
    stages {
        stage('Export Cucumber') {
            steps {
               step([$class: 'XrayExportBuilder', filePath: '\\features', issues: 'IF-1', serverInstance: '2ffc3a3e-9e2f-4279-abcd-e9301fe47bed'])
            }
        }
    }
}

Info

title	Learn more

For Pipeline specific documentation, you may want to give a look at:

Examples

JUnit

This is a declarative example, for JUnit based tests.

There are 3 available steps to be used in a Pipeline project:

XrayImportBuilder - Import test results (Junit, NUnit, etc...) from your Jenkins job to Jira
XrayExportBuilder- Export feature files from Jira to your Jenkins job workspace
XrayImportFeatureBuilder - Import feature files from Jenkins to Jira

Info

title	Generated syntax helper

For each of the steps mentioned above, you can check the generated syntax reference in the official Jenkins documentation website.

`Step: XrayImportBuilder (import test execution results)`

Expand

title	Parameters

Parameter	Required?	Type	Description
`serverInstance`	Yes	String	The ID of the Jira instance configured in the Jenkins System Configuration
`endpointName`	Yes	String	The result file type to be imported. Allowed Values: "" (Xray Json format) "/multipart" (Xray JSON multipart format) "/cucumber" "/cucumber/multipart" "/behave" "/behave/multipart" "/junit" "/junit/multipart" "/nunit" "/nunit/multipart" "/robot" "/robot/multipart" "/bundle" (import of zip file with several cucumber results) "/testng" "/testng/multipart" "/xunit" "/xunit/multipart" Please note that not all endpoints are available for Jira Sever/Cloud. Please refer to the REST API documentation to see what is available in your instance.
`projectKey`	Yes	String	The Jira project key where you want to import your results
`importFilePath`	Yes	String	File path where the result files can be found.
`credentialId`	Yes, if the Jira instance was configured without credentials in System Configuration	String	Credential ID from the Credentials plugin to be used to authenticate the Jira requests
`testEnvironments`	No	String	Test enviroments to be added to the Test Execution issue, seperated by ";". This value will only be used if the `endpointName` is not multipart
`testPlanKey`	No	String	All Tests will be added to the given Test Plan key, if provided. This value will only be used if the `endpointName` is not multipart
`fixVersion`	No	String	Fix version to be added to the Test Execution issue. This value will only be used if the `endpointName` is not multipart
`testExecKey`	No	String	Key of the test Exeution issue to be updated. Leave empty to create a new issue with the import. This value will only be used if the `endpointName` is not multipart
`revision`	No	String	Source code and documentation version used in the test execution. This value will only be used if the `endpointName` is not multipart
`importInfo`	Yes, if multipart endpoint	String	File path to the Test Execution info file OR JSON String with the info.
`inputInfoSwitcher`	Yes, if `importInfo` is being used	String	Allowed values: "filePath" - if `importInfo` field is used and represents a file path "fileContent" - if `importInfo` field is used and represents a JSON text
`testImportInfo`	No	String	File path to the Test info file.
`inputTestInfoSwitcher`	Yes, if `testImportInfo` is being used	String	Allowed values: "filePath" - if `testImportInfo` field is used and represents a file path "fileContent" - if `testImportInfo` field is used and represents a JSON text
`importToSameExecution`	No	String	Allowed values: "true" - to import all created tests and linked them to a single Test Execution issue "" - link a Test Execution issue to every imported Test issue
`importInParallel`	No	String	Allowed values: "true" - to import all result files (if there are multiple) in parallel, in order to speed up the import process "" - to import all result files (if there are multiple) sequentially

Expand

title	Example: simple Junit multi-file result import

Code Block

language	groovy

        stage('Import results to Xray') {
            steps {
                step([$class: 'XrayImportBuilder', endpointName: '/junit', importFilePath: 'java-junit-calc/target/surefire-reports/*.xml', importToSameExecution: 'true', projectKey: 'CALC', serverInstance: 'ecc67055-c359-40cb-8b8a-a44cb9f6ca30'])
            }
        }

Expand

title	Example: xUnit result import with optional fields

Code Block

language	groovy

        stage('Import results to Xray') {
            steps {
                step([$class: 'XrayImportBuilder', endpointName: '/xunit', importFilePath: '/reports/*.xml', importToSameExecution: 'true', projectKey: 'CALC', serverInstance: 'ecc67055-c359-40cb-8b8a-a44cb9f6ca30', importInParallel: '', fixVersion: 'v3.0', testEnvironments: 'linux;firefox', testPlanKey: 'CALC-123', testExecKey: 'CALC-456', revision: 'commit eccc5855b', credentialId: '26dba0be-45ca-4ffd-b959-13dbd241aa82'])
            }
        }

Expand

title	Example: Nunit multipart result import

Code Block

language	groovy

        stage('Import results to Xray (multipart)') {
            steps {
                step([$class: 'XrayImportBuilder', endpointName: '/nunit/multipart', importFilePath: '/reports/*.xml', importToSameExecution: 'true', projectKey: 'CALC', serverInstance: 'ecc67055-c359-40cb-8b8a-a44cb9f6ca30', importInParallel: 'true', importInfo: '/info/my-test-exec-info.json', inputInfoSwitcher: 'filePath' ])
            }
        }

Info
`importInfo` must comply with the same format as the Jira issue create/update REST API format

Expand

title	Example: Nunit multipart result import with Test info and using environment variables

Code Block

language	groovy

        stage('Import results to Xray (multipart)') {
            steps {
                step([$class: 'XrayImportBuilder', endpointName: '/nunit/multipart', importFilePath: '/reports/*.xml', importToSameExecution: 'true', projectKey: 'CALC', serverInstance: 'ecc67055-c359-40cb-8b8a-a44cb9f6ca30', importInParallel: 'true', importInfo: '/info/my-test-exec-info.json', inputInfoSwitcher: 'filePath', inputTestInfoSwitcher: 'fileContent', testImportInfo: '''{
           "fields": {
              "project": {
                 "key": "CALC"
              },
              "summary": "Test Execution for java junit ${BUILD_NUMBER}",
              "issuetype": {
                 "id": "9"
              },
              "customfield_11807": [
                 "CALC-1200"
              ]
           }
        }'''])
            }
        }

Info
`importInfo` and `testImportInfo` must comply with the same format as the Jira issue create/update REST API format

`Step: XrayExportBuilder (export cucumber features from Jira to Jenkins)`

Expand

title	Parameters

Parameter	Required?	Type	Description
`serverInstance`	Yes	String	The ID of the Jira instance configured in the Jenkins System Configuration
`issues`	Yes (not required if `filter` is used)	String	Xray Tests/Test Plans/Test Sets/Test Execution issue keys, seperated by ';'.
`filter`	Yes (not required if `issues` is used)	String	The Jira filter ID containing Xray Tests/Test Plans/Test Sets/Test Execution issues
`filePath`	No	String	The default value is "/features" File path where the feature files will be downloaded
`credentialId`	Yes, if the Jira instance was configured without credentials in System Configuration	String	Credential ID from the Credentials plugin to be used to authenticate the Jira requests

Expand

title	Example: Export features from filter to default folder

Code Block

language	groovy

        stage('Export feature files') {
            step([$class: 'XrayExportBuilder', filter: '12345', serverInstance: 'ecc67055-c359-40cb-8b8a-a44cb9f6ca30'])
        }

Expand

title	Example: Export features from issues to custom folder (with user's credentials)

Code Block

language	groovy

        stage('Export feature files') {
            step([$class: 'XrayExportBuilder', issues: 'CALC-123;CALC-234;CALC-345', serverInstance: 'ecc67055-c359-40cb-8b8a-a44cb9f6ca30', credentialId: '26dba0be-45ca-4ffd-b959-13dbd2410a82', filePath: 'my/feature/folder'])
        }

Expand

title	Example: Export features using variables

Code Block

language	groovy

        stage('Export feature files')

Code Block

language	groovy
title	Jenkinsfile example (declarative)

pipeline { agent any stages { stage('Compile'){ steps

checkout

step([$class: '

GitSCM

XrayExportBuilder',

branches

issues:

[[name: '*/master']], doGenerateSubmoduleConfigurations: false, extensions: [[$class: 'SparseCheckoutPaths', sparseCheckoutPaths: [[path: 'java-junit-calc/']]]], submoduleCfg: [], userRemoteConfigs: [[credentialsId: 'a3285253-a867-4ea7-a843-da349fd36490', url: 'ssh://git@localhost/home/git/repos/automation-samples.git']]]) sh "mvn clean compile -f java-junit-calc/pom.xml" } } stage('Test'){ steps

'${MY_ISSUE_KEYS}', filter: '${MY_FILTER_ID}', filePath: '${MY_FILE_PATH}', serverInstance: 'ecc67055-c359-40cb-8b8a-a44cb9f6ca30', credentialId: '26dba0be-45ca-4ffd-b959-13dbd2410a82'])
        }

`Step: XrayImportFeatureBuilder (import cucumber features from Jenkins to Jira)`

Expand

title	Parameters

Parameter	Required?	Type	Description
`serverInstance`	Yes	String	The ID of the Jira instance configured in the Jenkins System Configuration
`folderPath`	Yes	String	This is the directory containing your feature files. All the files in this directory and sub directories will be imported.
`credentialId`	Yes, if the Jira instance was configured without credentials in System Configuration	String	Credential ID from the Credentials plugin to be used to authenticate the Jira requests
`projectKey`	Yes	String	This is the project where the Tests and Pre-Conditions will be created/updated.
`testInfo`	No	String	File path to the Test info file that will be used to create the new Test issues.
`preconditions`	No	String	File path to the Preconditions info file that will be used to create the new Precondition issues.
`lastModified`	No	String	By entering an integer n here, only files that where modified in the last n hours will be imported. Leave empty if you do not want to use this parameter.

Expand

title	Example: Import features modified in the last day

Code Block

language	groovy

        stage('Export feature files') {
            step([$class: 'XrayImportFeatureBuilder',

sh "mvn test -f java-junit-calc/pom.xml" } }

folderPath: '/my/feature/folder', lastModified: '24', projectKey: 'CALC', serverInstance: 'ecc67055-c359-40cb-8b8a-a44cb9f6ca30'])

Expand

title	Example: Import features with test info and preconditions info

Code Block

language	groovy

        stage('

Import

Export

results

feature

to Xray

files') {

steps {

step([$class:

'XrayImportBuilder', endpointName: '/junit

'XrayImportFeatureBuilder',

fixVersion

credentialId: '

v3.0

f5522808-5cfa-4cd4-8972-8059f80cb3ed',

importFilePath

folderPath: '

java-junit-calc

target

my/

surefire-reports/*.xml

feature/folder',

importToSameExecution

preconditions: '

true

/path/to/precond/precondinfo.json', projectKey: 'CALC', serverInstance: '

552d0cb6

ecc67055-

6f8d

c359-

48ba

40cb-

bbad-50e94f39b722']) }

8b8a-a44cb9f6ca30', testInfo: '/path/to/testInfo/tesinfo.json'])

}

Info

title	Learn more

For Pipeline specific documentation, you may want to give a look at:

`Cucumber Workflow suggestions`

`Cucumber ("standard" workflow)`

This is a declarative example, for Cucumber tests using the "standard" workflow (see Testing in BDD with Gherkin based frameworks (e.g. Cucumber)).

Code Block

language	groovy
title	Jenkinsfile example (declarative)

pipeline {
    agent any
    stages {
        stage('Export features from Xray'){
            steps {
                checkout([$class: 'GitSCM', branches: [[name: '*/master']], doGenerateSubmoduleConfigurations: false, extensions: [], submoduleCfg: [], userRemoteConfigs: [[credentialsId: 'a3285253-a867-4ea7-a843-da349fd36490', url: 'ssh://git@localhost/home/git/repos/automation-samples.git']]])
                step([$class: 'XrayExportBuilder', filePath: 'cucumber_xray_tests/features', filter: '11400', serverInstance: '552d0cb6-6f8d-48ba-bbad-50e94f39b722'])
            }
        }
        
        stage('Test'){
            steps{
                sh "cd cucumber_xray_tests && cucumber -x -f json -o data.json"
            }
        }
        
        stage('Import results to Xray') {
            steps {
                step([$class: 'XrayImportBuilder', endpointName: '/cucumber', importFilePath: 'cucumber_xray_tests/data.json', serverInstance: '552d0cb6-6f8d-48ba-bbad-50e94f39b722'])
            }
        }
    }
}

...

This is a declarative example, for Cucumber tests using the "VCS/Git based" workflow (see Testing in BDD with Gherkin based frameworks (e.g. Cucumber)).

Code Block

language	groovy
title	Jenkinsfile example (declarative)

pipeline {
    agent any
    stages {
         stage('Synch (update) recent tests to Xray'){
            steps {
                checkout([$class: 'GitSCM', branches: [[name: '*/master']], doGenerateSubmoduleConfigurations: false, extensions: [], submoduleCfg: [], userRemoteConfigs: [[credentialsId: 'a3285253-a867-4ea7-a843-da349fd36490', url: 'ssh://git@localhost/home/git/repos/automation-samples.git']]])
                step([$class: 'XrayImportFeatureBuilder', folderPath: 'cucumber_xray_tests/features', lastModified: '10', projectKey: 'CALC', serverInstance: '552d0cb6-6f8d-48ba-bbad-50e94f39b722'])
            }
        }
        
        stage('Export features from Xray'){
            steps {
                checkout([$class: 'GitSCM', branches: [[name: '*/master']], doGenerateSubmoduleConfigurations: false, extensions: [], submoduleCfg: [], userRemoteConfigs: [[credentialsId: 'a3285253-a867-4ea7-a843-da349fd36490', url: 'ssh://git@localhost/home/git/repos/automation-samples.git']]])
                sh "rm -rf cucumber_xray_tests/features"
                step([$class: 'XrayExportBuilder', filePath: 'cucumber_xray_tests/features', filter: '11400', serverInstance: '552d0cb6-6f8d-48ba-bbad-50e94f39b722'])
            }
        }
        
        stage('Test'){
            steps{
                sh "cd cucumber_xray_tests && cucumber -x -f json -o data.json"
            }
        }
        
        stage('Import results to Xray') {
            steps {
                step([$class: 'XrayImportBuilder', endpointName: '/cucumber', importFilePath: 'cucumber_xray_tests/data.json', serverInstance: '552d0cb6-6f8d-48ba-bbad-50e94f39b722'])
            }
        }
    }
}

`Using parameters`

You can ask for human input in your pipeline builds by passing parameters

...

Content

Space Tools

Breadcrumbs

Page History

Versions Compared

Old Version 28

New Version 29

Key

Examples

JUnit

Step: XrayImportBuilder (import test execution results)

Step: XrayExportBuilder (export cucumber features from Jira to Jenkins)

Step: XrayImportFeatureBuilder (import cucumber features from Jenkins to Jira)

Cucumber Workflow suggestions

Cucumber ("standard" workflow)

Using parameters

`Step: XrayImportBuilder (import test execution results)`

`Step: XrayExportBuilder (export cucumber features from Jira to Jenkins)`

`Step: XrayImportFeatureBuilder (import cucumber features from Jenkins to Jira)`

`Cucumber Workflow suggestions`

`Cucumber ("standard" workflow)`

`Using parameters`