Description:
This step outputs selected columns during the transformation.
Inputs
- transforms – Configure transform list
Returns
- None
Usage:
Prerequisite:
The ETL process engine service should be running to execute the ETL definitions.
Example:
Let’s build and execute the “clsOutputColumnsTransformDef” example.
- Create a new ETL definition named “clsOutputColumnsTransformDef” and open it in designer mode.
- Drag “clsInputCSV, clsOutputColumnsTransform, and clsOutputCSV” steps to the canvas.
- Connect the dots between the “clsInputCSV” step and other steps, as shown above.
- Define a variable or a global to hold the virtual path.
- Click the "clsInputCSV" step to configure its "Required" properties. Provide a name for the step. Specify the path to the input CSV file on the application server. Select the ETL data schema from the drop-down list. Note: The schema's column names must match those in the input file. Click Save. Click here to learn about the ETL Data Schema Designer.
- Click the "clsInputCSV" step to view its "Optional" properties. Select the Show Schema button. The pop-up window displays the schema columns as shown below. This function helps you understand the schema at a glance.
- Click the "clsOutputColumnsTransform" step to configure its "Required" properties. Enter the step name, then click the button to configure the columns to transform. Finally, click the Save button.
- Click the "clsOutputColumnsTransform" step to configure its "Required" properties. Click the column button to open the transform list configuration window. Click the Add Row (+) button to insert an empty row. Select a column from the drop-down list, then click the Save button. You may add multiple columns for transformation using the Add Row button.
- Click the "clsOutputCSV" step to configure its "Required" properties. Enter a name for the step and the path to the output CSV file on the application server. Click the Save button.
- Click the "clsOutputCSV" step to configure its "Optional" properties. Provide a name for the step and specify the variable or global reference that will hold the virtual output path. Click the Save button.
- The “Logging” configuration is necessary for documentation and to measure workflow progress and percent complete. This is done by configuring the step state and percent fields individually, as shown below. Configure the “Logging” using the following properties.
- Save the ETL definition, create a new ETL instance, and execute it. Render the ETL instance. Click the ETL step to view its properties. The “clsOutputColumnsTransform” step should order columns according to the output file’s configuration. The variable or global contains the output file’s virtual path, as shown below.
Definition Sample:
You may download the sample definition(s) from the provided link and later import them (drag-and-drop) into your FlowWright ETL Definition (XML file) page.
Note: Please verify and complete any missing configuration steps, such as file path references and database connections, after the import. Then, save the definition to confirm the changes.