Configuration

In order to maximize your transformation impact, all actions can be configured through the Configuration section.

General

When the Transformation Center is first created, no configuration is present in your project. To start configuring, click on “Add” button, then select which of the actions you want to start your configuration with. You will be able to edit and add other configuration elements after this first step.

Transform configuration

Metadata

This feature allows you to configure the metadata.ini file, which will be consumed by the Transform action and provides information about the inputs you provide for the transformation (types, encoding, etc…).

You will be able to provide custom values for the global section of this file as well as create entirely custom sections.
Creating a new Metadata configuration starts by providing a new section. There are two metadata section types :

  • File : This section will create a configuration for a set of properties related to the files targeted by the wildcard you will provide as a name. For instance, the properties under a File section named COB/** will be applied to all files located on the COB folder.
  • Global : This section will create a configuration for a set of generic properties related to the project as a whole, specifying some important aspects of your inputs.

For both section types, you will have to provide a name, whether it is the desired wildcard for a File type or “global” for the Global section. Then, depending on the chosen type, the related properties will be displayed and you will be able to choose which ones you want to import in your configuration to be overridden. The other ones will be used with their default values when the Transform action is launched. A tooltip is present next to each property to explain its behavior and scope.
When your choice is made, click on the “Add” button.

On the configuration table, you will be able to add other values to be overridden by clicking on the “Add” button and selecting the Transform/Metadata menu.

You can change the value of a property by selecting it on the table, then clicking on the “Edit properties” button at the bottom. You will be asked to write the new value, then click on the “Update” button.
You can have a preview of the file, as it will be consumed by the Transform action, by clicking on the Transform/Metadata element on the table, then on the “View” button. A read-only editor will be displayed with the content on the configuration file.

You can also download the resulting configuration file by clicking on the “Download” button.

Property Set

This feature allows you to configure the global behavior of the Transform action, by specifying a set of pre-configured properties.
You can start configuring them by selecting the “Transform/Property Set” menu of the “Add” button. A pop-up will appear displaying the available properties to be customized for this action, with a tooltip next to each one of them to explain its behavior and scope.
You will be able to choose which ones you want to import in your configuration to be overridden. The other ones will be used with their default values when the Transform action is launched.
When your choice is made, click on the “Add” button.

On the configuration table, you will be able to add other values to be overridden by clicking on the “Add” button and selecting the “Transform/Property Set” menu.
You can change the value of a property by selecting it on the table, then clicking on the “Edit properties” button at the bottom. You will be asked to write the new value, then click on the “Update” button.


You can have a preview of the file, as it will be consumed by the Transform action, by clicking on the Transform/Property Set element on the table, then on the “View” button. A read-only editor will be displayed with the content on the properties file.


You can download the resulting properties file by clicking on the “Download” button.
You can also delete a property be selecting it and clicking on the “Delete” button. This will reset its value to the default one, when the action is launched. Deleting the whole “Transform/Property Set” section will reset all properties to their default values.

Refactor configuration

This action will refactor your intermediate elements by applying some hand-craft Java code to them, which can modify their content before the Generate action.

The Java code which will be executed by this action then needs to be uploaded, and it is done here by selecting the “Refactor” menu of the “Add” button.
You can then drop a zip/7z file or click on the displayed pop-up to select the archive to upload from your computer. Please note that the content of this zip/7z file is strict and it won’t be applied if anything outside of the desired format is provided. When the archive is chosen, you can click on the “Upload” button.

You can delete the uploaded zip/7z file by selecting the element on the table and click on the “Delete” button.

Generate configuration

SQL Model

The SQL model file is used by the Generate action to provide useful information regarding the DB2 elements of your inputs. This file is not mandatory to run a Generate action but this process greatly relies on its content to improve the quality of the generating code, especially while executing database operations.
This file is generated by the Transform action when importing your legacy SQL elements, and you can provide it as a configuration here to be consumed on the next transformation phase by clicking on the “Generate/SQL Model” menu of the “Add” button.

You can then drop your JSON file or click on the displayed pop-up to select the file to upload from your computer. Please note that the JSON format for this file is strict and it won’t be applied if anything outside of the desired format is provided. When the file is chosen, you can click on the “Upload” button.

You can delete the uploaded JSON file by selecting the element on the table and click on the “Delete” button.

Property Set

This feature allows you to configure the global behavior of the Generate action, by specifying a set of pre-configured properties.
You can start configuring them by selecting the “Generate/Property Set” menu of the “Add” button. A pop-up will appear displaying the available properties to be customized for this action, with a tooltip next to each one of them to explain its behavior and scope.
You will be able to choose which ones you want to import in your configuration to be overridden. The other ones will be used with their default values when the Generate action is launched.
When your choice is made, click on the “Add” button.

On the configuration table, you will be able to add other values to be overridden by clicking on the “Add” button and selecting the “Generate/Property Set” menu.
You can change the value of a property by selecting it on the table, then clicking on the “Edit properties” button at the bottom. You will be asked to write the new value, then click on the “Update” button.
You can have a preview of the file, as it will be consumed by the Generate action, by clicking on the Generate/Property Set element on the table, then on the “View” button. A read-only editor will be displayed with the content on the properties file.
You can download the resulting properties file by clicking on the “Download” button.
You can also delete a property be selecting it and clicking on the “Delete” button. This will reset its value to the default one, when the action is launched. Deleting the whole “Generate/Property Set” section will reset all properties to their default values.

Velocity Patches

This feature allows you to create Java patches to apply to your legacy inputs. You can start configuring them by selecting the “Generate/Patch” menu of the “Add” button.

A pop-up will appear to create a new patch, which needs two information:

  • name: a unique identifier to target the patch when inserting the patch tags in the legacy input;
  • body: the body with which to replace the generated code.

When these two information has been filled, click on “Save” to create the patch.

You can see your newly created patch under the “Generate/Patch” section of the configuration table.

You can change the properties of a patch by selecting it on the table, then clicking on the “Edit properties” button at the bottom. The name and the body can then be changed in the displayed pop-up. At the end, click on “Save” to persist the modifications.
You can also delete a patch be selecting it and clicking on the “Delete” button.