Welcome Guest! Log in
Stambia versions 2.x, 3.x, S17, S18, S19 and S20 are reaching End of Support January, 15th, 2024. Please consider upgrading to the supported Semarchy xDI versions. See Global Policy Support and the Semarchy Documentation.

The Stambia User Community is moving to Semarchy! All the applicable resources have already been moved or are currently being moved to their new location. Read more…


The Stambia DI Designer features an interesting utility that offers the possibility to select a list of Mappings and Processes that should be built into a package.

This list, called a Launch Package Configuration, can be stored and shared for future use and for automating the build tasks.

You can find in this article the basics to start using this utility in your Designer.

Prerequisites:
  • Stambia DI Designer S19.0.0 or higher

Important Note:

Packages generated through a Launch Package Configuration are supported in build scripts since Stambia DI Runtime S17.6.0 and not yet in Analytics (this is being implemented and will be supported in upcoming releases.)

 

About Launch Package Configuration

The final goal of a Launch Package Configuration is to generate a unique Package file (.pck file) in which will be built all the Mappings and Processes specified by the user.

Once configured, the Launch can be saved and shared, giving the user the possibility to re-generate its Package easily with one click or through the command line utility.

This allows to automate the generation of Packages, which can for instance represent a whole project, containing multiple Mappings and Processes, to ease its publication and production.

 

Creation of a Launch Package Configuration

The first step to create a new Launch is to access the Launch Package Configuration window, which is under the following menu:

Build/Execute > Build > Package Configuration...

 

This menu is available in the Designer's top menu but also in the right click context menu in Mappings and Processes.

The wizard will open and allow you to create a new Launch Package Configuration:

 

launch new

 

You can then specify its name, an optional description, and start configuring it:

 

configuration launch name

Click on Apply to save your modifications or Revert to cancel it

 

Configuration of the Launch Package Configuration

Adding Mappings and Processes

The next step is to add all the Mappings and Processes that you want to be built in your final Package, which can be done as follow:

  1. Click on the '+' button
  2. Select the mappings and processes. You can use the “Select All” and “Deselect All” buttons. Multiple selection is possible with the "shift" key.
  3. Click on 'OK' to finish

package02

 

Click on Apply to save your modifications or Revert to cancel it

 

Package Options

Finally, you can find in the Package Options a list of additional parameters that will help to configure the Launch accordingly to your needs.

Simply click on the Package Options tab and specify the values as you want:

configuration packageOptions

 

Here are the available options:

Option Description
Generate Documentation

Specifies if the documentation of the Processes and Mappings should be generated in the Package.

This corresponds to the Build > Package With Documentation action that can be done manually In Mappings and Processes.

Package Name

Specifies the name of the Package file that will be created.

If it is not set, the Launch Package Configuration name will be used instead

Package Location
  • Default: The Package file is generated in the default Packages folder

    <designer Installation Directory>/stambiaRuntime/build/packages

  • Local file: The Package file is generated in the specified local folder path

    The Browse button can be used to navigate in the local folders

  • Workspace: The Package file is generated in the current Workspace, in the specified Project / Folder

    The Browse button can be used to navigate in the Workspace Projects

 

Save Build Specification as

The Specification is the file containing all the information about the Launch Package Configuration, and this option is used to specify where to store it, depending if you want to share it or not, for instance.

  • Local file: The specification file is stored locally in internal files
  • Shared file: Path in the current Workspace where the specification file should be stored. You can use this option if you plan to share this file on versioning systems, for instance, or if you want to keep it in a Project.
Click on Apply to save your modifications or Revert to cancel it

 

Generation of the Package

From the Designer

From the Designer, simply click on the Build Package button to build the Package of your Launch.

It will be generated in the folder specified in the Packages Options.

launch build package

Important Note:

Packages generated through a Launch Package Configuration are supported in build scripts since Stambia DI Runtime S17.6.0 and not yet in Analytics (this is being implemented and will be supported in upcoming releases.)

 

From command line

The other possibility is to use the command line utility to generate the Package, by giving it the Launch Specification file.

For this method you must have stored the Launch Specification file as a 'Shared File' in the Package Options.

Please refer to this article for further information about the command line utility.

Important Note:

Packages generated through a Launch Package Configuration are supported in build scripts since Stambia DI Runtime S17.6.0 and not yet in Analytics (this is being implemented and will be supported in upcoming releases.)

 

 

Articles

Suggest a new Article!