July 30, 2023

tRouteInput – Docs for ESB 7.x

tRouteInput

Accepts messages in a Data Integration Job from a Mediation Route.

tRouteInput Standard properties

These properties are used to configure tRouteInput running in the Standard Job framework.

The Standard
tRouteInput component belongs to the ESB family.

This component is relevant only when used with one of the
Talend
solutions with ESB, as it should be used with the Service Repository node and the Data Service creation related wizard(s).

Basic settings

Input Schema and Edit
schema

A schema is a row description. It defines the number of fields
(columns) to be processed and passed on to the next component. When you create a Spark
Job, avoid the reserved word line when naming the
fields.

Click Edit
schema
to make changes to the schema. If the current schema is of the Repository type, three options are available:

  • View schema: choose this
    option to view the schema only.

  • Change to built-in property:
    choose this option to change the schema to Built-in for local changes.

  • Update repository connection:
    choose this option to change the schema stored in the repository and decide whether
    to propagate the changes to all the Jobs upon completion. If you just want to
    propagate the changes to the current Job, you can select No upon completion and choose this schema metadata
    again in the Repository Content
    window.

 

Built-in: No property data stored
centrally.

 

Repository: Select the Repository
file where Properties are stored.

Camel

Enter the message parameters corresponding to the columns you
defined in the schema dialog box via the Edit
schema
button using the Simple Expression
Language.

For more information about the Simple Expression Language, see the
site http://camel.apache.org/simple.html.

Advanced settings

tStatCatcher Statistics

Select this check box to gather the Job processing metadata at a
Job level as well as at each component level.

Global Variables

Global Variables 

ERROR_MESSAGE: the error message generated by the
component when an error occurs. This is an After variable and it returns a string. This
variable functions only if the Die on error check box is
cleared, if the component has this check box.

A Flow variable functions during the execution of a component while an After variable
functions after the execution of the component.

To fill up a field or expression with a variable, press Ctrl +
Space
to access the variable list and choose the variable to use from it.

For further information about variables, see
Talend Studio

User Guide.

Usage

Usage rule

This component can be used as starter component and has an
output. It is mandatory that a tRouteInput component is used in the Data Integration Job to be
called by a Route using the cTalendJob
component. The reason for it is that this will prevent the referenced Job from
starting automatically when deployed in Talend Runtime. Instead it will only
start when it gets called by the Route.

For more information about how to use the cTalendJob component, see cTalendJob.

Limitation

The Job using a tRouteInput must
be launched only within a Route using the cTalendJob component.

Exchanging messages between a Job and a Route

This scenario applies only to Talend Open Studio for ESB, Talend Data Services Platform and Talend Data Fabric.

This scenario describes how to accept messages from a Route using the
tRouteInput component and send messages to a Route
using the tRouteOutput component. To do this, we need to
build a Job and a Route to call the Job using the cTalendJob component.

For more information about how to use the
cTalendJob component, see cTalendJob.

Creating an Data Integration Job

In this section, we will build a Job named RouteCommunication to
accept the message from a Route, change the message body and send the message back to
the Route.

Arranging the flow of
the
message

tRouteInput_1.png

  1. Drag and drop a tRouteInput, a tLogRow, a tReplace and a
    tRouteOutput from the Palette onto the design workspace.
  2. Link the components using the Row > Main connection as shown above.

Configuring how the
message is
processed

  1. Double-click the tRouteInput component to
    open its Basic settings view in the
    Component tab.

    tRouteInput_2.png

  2. Click the three-dot button next to Edit
    Schema
    . In the schema dialog box, click the plus button to
    add a new line of String type and name it
    body. Click OK to
    close the dialog box.

    tRouteInput_3.png

  3. In the Simple Expression field for the
    body element, enter "${in.body}" to
    get the body of the input message from the Route.
  4. The tLogRow component will monitor the
    message exchanges and does not need any configuration.
  5. Double-click the tReplace component to
    open its Basic settings view in the
    Component tab.

    tRouteInput_4.png

  6. Click Sync columns to retrieve the schema
    from the tLogRow. In the pop-up dialog box,
    click Yes to propagate the schema to the
    subsequent component.

    Click [+] to add a row to the Search/Replace table. Enter
    World in the Search column and Talend in the
    Replace with column. Clear the
    Whole word check box.
  7. Double-click the tRouteOutput component
    to display its Basic settings view in the
    Component tab.

    tRouteInput_5.png

  8. Make sure that tRouteOutput has one
    element body. Set its type to Body.
  9. Press Ctrl+S to save your Job.

Creating a Mediation Route

In this section, we will create a Route to send a message to the Job and receive the
message sent back to the Route.

Dropping and linking the components

tRouteInput_6.png

  1. Drag and drop a cTimer, a cSetBody, a cTalendJob, and
    a cLog from the Palette onto the design workspace.
  2. Link the components with the Row >
    Route connection as shown
    above.
  3. Label the components for better identification of their roles.

Configuring the components

  1. Double-click the cTimer component to open
    its Basic settings view in the Component tab.

    tRouteInput_7.png

  2. In the Repeat field, enter
    1 to generate the message exchange one time. Keep
    the default settings of the other options.
  3. Double click the cSetBody component to
    display its Basic settings view in the
    Component tab.

    tRouteInput_8.png

  4. Select Simple from the Language list and enter Hello
    World!
    in the Expression
    field.
  5. Double-click the cTalendJob component to
    display its Basic settings view in the
    Component tab.

    tRouteInput_9.png

  6. Select Job RouteCommunication from the
    repository.
  7. The cLog component will monitor the
    message exchanges and does not need any configuration.
  8. Press Ctrl+S to save your Route.

Executing the Route

Click the Run view to display it and click the Run button to launch the execution of your Route. You can
also press F6 to execute it. In the execution log
you can see that the message Hello World! is sent to the Job.
The message body is changed to Hello Talend! and sent back to
the Route.

tRouteInput_10.png


Document get from Talend https://help.talend.com
Thank you for watching.
Subscribe
Notify of
guest
0 Comments
Inline Feedbacks
View all comments
0
Would love your thoughts, please comment.x
()
x