sap-jenkins-library/documentation/docs/steps/mtaBuild.md

mtaBuild

Description

Executes the SAP MTA Archive Builder to create an mtar archive of the application.

Prerequisites

• SAP MTA Archive Builder - available for download on the SAP Marketplace.
• Java 8 or higher - necessary to run the mta.jar file.
• NodeJS installed - the MTA Builder uses npm to download node module dependencies such as grunt.

Parameters

parameter	mandatory	default	possible values
script	yes
buildTarget	yes		'CF', 'NEO', 'XSA'
mtaJarLocation	no

• script The common script environment of the Jenkinsfile running. Typically the reference to the script calling the pipeline step is provided with the this parameter, as in script: this. This allows the function to access the commonPipelineEnvironment for retrieving, for example, configuration parameters.
• buildTarget The target platform to which the mtar can be deployed.
• mtaJarLocation The path of the mta.jar file. If no parameter is provided, the path is retrieved from the Jenkins environment variables using env.MTA_JAR_LOCATION. If the Jenkins environment variable is not set it is assumed that mta.jar is located in the current working directory.

Return value

The file name of the resulting archive is returned with this step. The file name is extracted from the key ID defined in mta.yaml.

Side effects

1. The file name of the resulting archive is written to the commonPipelineEnvironment with variable name mtarFileName.
2. As version number the timestamp is written into the mta.yaml file, that is packaged into the built archive.

Exceptions

• AbortException
  • If there is an invalid buildTarget.
  • If there is no key ID inside the mta.yaml file.

Example

def mtarFileName
dir('/path/to/FioriApp'){
  mtarFileName = mtaBuild script:this, buildTarget: 'NEO'
}