Description:
This step is used to configure the output XML file path.
Inputs
- filePath – input file path
- xmlRootName - XML root element name
- xmlNodeName - XML node element name
- variableOrGlobal - variable/global to hold the virtual file path
Returns
- None
Usage:
Prerequisite:
ETL process engine service should be running to execute the ETL definitions.
Example:
Let’s build and execute the “clsInputXMLDef” example.
- Create a new definition called “clsInputXMLDef”
- Select the definition and click the “design” button
- Drag “clsInputXML, clsTransformCase, and clsOutputXML” step from the toolbox
- Connect the dots between the Start and other steps as above
- Define variables/globals required for the execution
- Click the "clsInputXML" step to configure its "Required" properties. Provide a name to the step. Provide the input XML file path on the application server. Provide the XML node element name that contains all the data. Select the ETL data schema from the drop-down list. Note: The column names in the schema should match the columns in the input file. Click the Save button.
- Click the "clsInputXML" step to view its "Optional" properties. Select the Show Schema button. The popup window renders the schema columns as below. This function helps to understand the schema as a quick view.
- Click the "clsTransformCase" step to configure its "Required" properties. Provide the step name. Click the button to configure the transform list. Click the Save button.
- Click the "clsTransformCase" step to configure the transform list. The popup window is displayed for configuration. Click the Add Row (+) button to insert an empty row. Select the column name (string type) from the drop-down list. Select the case type to transform from the drop-down list. Click the Save button. Click the Add Row button to insert multiple columns for transform.
- Click the "clsOutputXML" step to configure its "Required" properties. Provide a name to the step. Provide the output XML file path on the application server. Click the Save button.
- Click the "clsOutputXML" step to configure its "Optional" properties. Provide the XML root element name. Provide the XML node name. Provide the variable/global reference to hold the virtual output path. Click the Save button.
- The “Logging” setting configuration is necessary for documentation and also measures the workflow progress and the percent complete. This is achieved by configuring the step state and percent fields individually, as shown in the images below. Configure the “Logging” using the following properties.
- Save the ETL definition, create a new instance, and execute. Render the ETL instance. Click the Items—Variables menu option to view the variable values. The “clsInputXML” step facilitates the transformation of the input file. The variable/global holds the output file virtual path as below.
- The input XML image is included here for reference.
- The output XML image is included here for reference.
Definition Sample:
You may download the sample definition(s) from the link here and later import it (drag-drop) to your FlowWright ETL Process Definition (XML file) page.
NOTE: Please verify and complete the process steps for any missing configurations, such as file path references and database connections after import. Then, save the definition to confirm the changes.