Skip to main content

Veritran Docs

Assemble an Implementation Package

An implementation package is a compressed file that contains all the required elements to execute an implementation in a client environment.

At minimum, the package includes:

  • A BAP (business application package with both front and back compilations ready to be deployed in the client environment).

  • A steps2run.vt file, which acts as a “recipe” that indicates vt-wizard which implementations to execute and in what order.

Pre-requisites

  • Have a BAP available with the front and back components that need to be implemented in the target environment (exported from Studio). Read Create a Business Application Package to learn more.

  • Have an implementations folder already created in repo.veritran.com. Example: VTQA-PACKAGES. If you do not have the folder created, follow the steps explained below to create the structure in your repository.

Assemble the Implementation Package

To assemble the package, follow the instructions below.

  1. Create the structure in the repository:

    1. Access https://repo.veritran.com/.

    2. Locate the folder corresponding to the client.

    3. Select the environment where the implementation will be prepared.

    4. Create a folder for the implementation inside VTQA-PACKAGES. i.e: IMPLE_TEST_BAP_V001.

    5. Create a subfolder named VT_NET_OBJECTS.

    6. Upload the BAP into the VT_NET_OBJECTS folder exactly as it is downloaded from Studio.

    7. Attach any additional files as needed (for example: business parameters, transaction response codes, etc.).

    8. Attach the steps2run.vt file. This file must specify the exact name of the BAP and the NODE identifier where the implementation will be executed, following this structure: <BAP name:nodeID>. I.e: business-application-test-bapd-0.0.1-rc001.tar.gz:NDA1

  2. Create the implementation in Jenkins:

    1. Access Jenkins and go to the implementations section of the repository.

    2. In the run_implementation option, select Build with parameters.

    3. Complete the following:

      1. IMPLENAME: Name of the folder containing the implementation in the repository.

      2. NODE: Unique identifier of the server/node where the implementation will be executed.

      3. TOKEN: API token generated in Workspace in the target environment. This enables the deployment of the BAP. This field is optional, as it can also be entered when executing vt-wizard in the target environment.

    4. Click Build to start packaging the full implementation package.

    5. Monitor the generation status in Jenkins. The tool notifies when the implementation is ready.

You will find the VT-FULL-IMPLE_TEST_BAP_V001.tar.gz file in the VTQA-PACKAGES implementations folder. This file contains: the BAP, additional files (parameters, response codes, etc.), the steps2run.vt file and vt-wizard scripts required to execute the implementation in the defined environment.

The package will then be available either for direct download or for FTP transfer to the client environment.

In this section: