How to run a Route - 6.2

Talend Data Fabric Studio User Guide

EnrichVersion
6.2
EnrichProdName
Talend Data Fabric
task
Data Quality and Preparation
Design and Development
EnrichPlatform
Talend Studio

You can execute a Route in several ways. This mainly depends on the purpose of your Route execution and on your user level.

If you are an advanced Java user and want to execute your Route step by step to check and possibly modify it on the run, see How to run a Job in Java Debug mode.

If you do not have advanced Java knowledge and want to execute and monitor your Job in normal mode, see How to run a Job in normal mode.

How to run a Route in normal mode

Note

Make sure you saved your Route before running it in order for all properties to be taken into account.

To run your Route in a normal mode, complete the following:

  1. Click the Run view to access it.

  2. Click the Basic Run tab to access the normal execution mode.

  3. In the Context area to the right of the view, select in the list the proper context for the Route to be executed in. You can also check the variable values.

If you have not defined any particular execution context, the context parameter table is empty and the context is the default one. Related topic: Using contexts and variables.

  1. Click Run to start the execution.

  2. On the same view, the console displays the progress of the execution. The log is provided by the Apache logging utility log4j shipped with the Route designer. By default the message level is set to INFO in the log4j.properties file, as shown below. It includes any error message as well as start and end messages. It also shows the Route output in case you used a System.out.println Java code in a cProcessor component, for example. For more information about the logging utility, see the site http://logging.apache.org/log4j/1.2/.

    This INFO logging level is fixed and can not be changed in Talend Studio. However, when deploying your route in the Talend Runtime, you can decide the level used by the Talend Runtime to log information. For more information about the logging system of Talend Runtime, see the Talend ESB Container Administration Guide.

    An example of the log without errors is shown below.

    The following screenshot shows another example of the log with error messages.

  3. To define the lines of the execution progress to be displayed in the console, select the Line limit check box and type in a value in the field.

  4. Select the Wrap check box to wrap the text to fit the console width. This check box is selected by default. When it is cleared, a horizontal scroll bar appears, allowing you to view the end of the lines.

Before running again a Route, you might want to remove the execution statistics from the designing workspace. To do so, click the Clear button.

Routes are running continuously, so if you want to stop a Route, you will have to click the Kill button. You will need to click the Run button again, to start again the Route.

Talend Studio offers to display execution statistics during the execution of your Route, which facilitate the Route monitoring, as well as a debugging execution mode. Java Debug execution mode works identically for Jobs and Routes, so for more information, see How to run a Job in Java Debug mode and for more information about statistics and other execution features, see How to set advanced execution settings.