> For the complete documentation index, see [llms.txt](https://academy.pentaho.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://academy.pentaho.com/pipeline-designer/concepts-and-terminology/hello-world.md).

# Hello World

{% hint style="warning" %}

#### Workshop - Hello World

In this hands-on workshop, you'll learn the core mechanics of building transformations in Pipeline Designer. You'll work with nodes, hops, and notes to create a simple Transformation & Job.

**What You'll Accomplish:**

* Create a new transformation from scratch
* Add and configure transformation nodes (Generate Rows and Dummy)
* Add and configure job nodes (Start, Transformation, Success)
* Connect nodes using hops to define data flow
* Add notes to document your transformation
* Preview data to verify your logic
* Interpret the execution metrics
* Understand the Logging and Step Metrics tabs for monitoring

By the end of this workshop, you'll have completed your first working transformation & job and established a repeatable development workflow: add nodes, configure properties, preview data, connect with hops, and run. 

**Prerequisites:** Pipeline Designer installed and configured

**Estimated Time:** 10 minutes
{% endhint %}

1. Log into Pentaho 11 User Console (PUC).

<figure><img src="/files/4JDcZdItKY5LOKYfFqYJ" alt=""><figcaption></figcaption></figure>

2. Select: Pipeline Designer.

<figure><img src="/files/5PPEhgP7DdEpFAtsgxuj" alt=""><figcaption><p>Pipeline Designer</p></figcaption></figure>

{% tabs %}
{% tab title="Tour of UI" %}
{% hint style="info" %}

#### Tour of Pipeline Designer UI

For folks familiar with Data Integration the key concepts & features should be familiar ..&#x20;
{% endhint %}

1. Select: Create Transformation in Pipeline Designer.

<figure><img src="/files/v1sFfzgcWE3jJRRueEs1" alt=""><figcaption><p>Pipeline Designer UI</p></figcaption></figure>

<table><thead><tr><th width="98">Feature</th><th>Description</th></tr></thead><tbody><tr><td><div><figure><img src="/files/0kyjBmx3Jq51SOsG8F8L" alt=""><figcaption></figcaption></figure></div></td><td>Collapse the left menu.</td></tr><tr><td><div><figure><img src="/files/cgvUaSZQ36t4UkWxtBFw" alt=""><figcaption></figcaption></figure></div></td><td>Switch bewteen Design &#x26; View mode.</td></tr><tr><td><div><figure><img src="/files/2A5W3jFko3Qv1qZlDRO3" alt=""><figcaption></figcaption></figure></div></td><td>Design Panel. You can also 'Search' for Nodes.</td></tr><tr><td><div><figure><img src="/files/WDMZnpRUeWtnNMQj6iFx" alt=""><figcaption></figcaption></figure></div></td><td>Add a Note</td></tr><tr><td><div><figure><img src="/files/YP9oKUyRiKygVzOWDiE6" alt=""><figcaption></figcaption></figure></div></td><td>Reset the current Transformation. It will clear all Nodes &#x26; connections. Cannot be undone.</td></tr><tr><td><div><figure><img src="/files/uy7SPgKYzM79WZibE6mn" alt=""><figcaption></figcaption></figure></div></td><td>RUN the Transformation. The drop-down Run Options enable: Run Configuration, Logging Level, Parameters &#x26; Variables</td></tr><tr><td><div><figure><img src="/files/17FkIPLdDuSmllXl4d03" alt=""><figcaption></figcaption></figure></div></td><td>Pause RUN.</td></tr><tr><td><div><figure><img src="/files/AqHxT4etKknZaGASAAO8" alt=""><figcaption></figcaption></figure></div></td><td>Stop RUN. </td></tr><tr><td><div><figure><img src="/files/T5d4ueEIFTEAj431LuUB" alt=""><figcaption></figcaption></figure></div></td><td>View the Logging, Preview Data &#x26; Step Metrics panel.</td></tr><tr><td><div><figure><img src="/files/uOn7aLBRFKxeDgQo63I5" alt=""><figcaption></figcaption></figure></div></td><td>View the Kettle Status.</td></tr><tr><td><div><figure><img src="/files/IqQYdoJqMj4QUMuryrTp" alt=""><figcaption></figcaption></figure></div></td><td>View the Transformation Properties.</td></tr><tr><td><div><figure><img src="/files/NzWUsuqUdhsAz4WATuAo" alt=""><figcaption></figcaption></figure></div></td><td>Zoom in or Out of the Canvas.</td></tr><tr><td><div><figure><img src="/files/y4bBovyjL8OFbINzUmdv" alt=""><figcaption></figcaption></figure></div></td><td>Lock the Canvas.</td></tr><tr><td><div><figure><img src="/files/Eor2oF1MLDSNvzpqzSuZ" alt=""><figcaption></figcaption></figure></div></td><td>Switch between Design &#x26; XML view.</td></tr></tbody></table>
{% endtab %}

{% tab title="Transformation" %}
{% hint style="info" %}

#### Transformation - Hello World

This workshop assumes you have some experience of using Data Integration. The intended outcome is to famialize yourself with the new features and options in the UI.&#x20;
{% endhint %}

1. Collapse the left-hand menu.
2. In pipeline Designer, drag & drop the Generate Rows node from Input onto the Canvas.

<figure><img src="/files/yYsRHbhJaHPGxNLjVzXh" alt=""><figcaption><p>Drag &#x26; Drop - Generate Rows</p></figcaption></figure>

3. Drag & Drop the Dummy node from Flow onto the Canvas.

<figure><img src="/files/u5wNJCSXOwWVwR3qsz0L" alt=""><figcaption><p>Drag &#x26; Drop - Dummy</p></figcaption></figure>

4. Create a Hop - place your cursor over the Generate rows output. It will turn to a +. Hold down the left hand mouse button and drag the Hop to the Dummy input.

<figure><img src="/files/TdWbU2kEkVOjgi2i7ldi" alt=""><figcaption><p>Create a Hop</p></figcaption></figure>

5. Double-clcik on the Generate rows node to configure

<figure><img src="/files/W55M80ODyDxJptLdedtJ" alt=""><figcaption><p>Configure Generate rows</p></figcaption></figure>

6. Enter the following details:

<table><thead><tr><th width="159">Setting</th><th>Value</th></tr></thead><tbody><tr><td>Limit</td><td>Keep default value of 10 records / rows.</td></tr><tr><td>Name</td><td>message</td></tr><tr><td>Type</td><td>String</td></tr><tr><td>Value</td><td>Hello World</td></tr></tbody></table>

<figure><img src="/files/uCuZ8608hzlAAbUKQ00n" alt=""><figcaption><p>Configure - Generate rows</p></figcaption></figure>

7. Click Preview. Enter the number of Preview rows.

<figure><img src="/files/cVMQ2Z9CBePkrXazoubJ" alt=""><figcaption><p>Preview data</p></figcaption></figure>

8. Click Cancel > Save.
9. Add a Note - you can also edit the Style.

<figure><img src="/files/PqX8stFcfcBdxmA6OFvu" alt=""><figcaption></figcaption></figure>

10. Click: Save.

<figure><img src="/files/eEwxcBN2a6gACxIHE9ht" alt=""><figcaption><p>Add Note</p></figcaption></figure>

11. Before we RUN the transformation, Save as.

<figure><img src="/files/x5IjkaQ4OuC8lEc7gO4A" alt=""><figcaption></figcaption></figure>

12. Create a Folder: Data Pipelines in 'public'.
13. Save the transformation.

<figure><img src="/files/PuNkWsb6LfiEAcflCuJm" alt=""><figcaption><p>save transformation - gr:hello-world</p></figcaption></figure>

***

{% hint style="info" %}

#### Run the Transformation

{% endhint %}

1. Click: Run.

<figure><img src="/files/lejgqvvgmgzFaRH3OyNE" alt=""><figcaption><p>Run the transformation</p></figcaption></figure>
{% endtab %}

{% tab title="Job" %}
{% hint style="info" %}

#### Job - Hello World

{% endhint %}

1. From the drop-down box, 'Create new' > Job.
2. Drag & drop the Start, Transformation & Success nodes onto the  Canvas.
3. Create the required hops. Place your cursor over the hop for more information.

<figure><img src="/files/P2pxkUsc6bws7G9F4Nfw" alt=""><figcaption><p>Hop information</p></figcaption></figure>

4. Click: Save as and Save the Job in the same folder as the previous hello-world.ktr

<figure><img src="/files/k93wQ73jj6dFiBZvfRvq" alt=""><figcaption><p>Save </p></figcaption></figure>

5. Double click on the Transformation node to configure.

<figure><img src="/files/r5j5QW1IPGK0sWPFwDm5" alt=""><figcaption></figcaption></figure>

6. Click: Select variable to insert and select: ${Internal.Entry.Current.Directory}/&#x20;
7. Add the name of the transformation - hello-world
8. Click: Save.
9. Run

x

x

x

x
{% endtab %}
{% endtabs %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://academy.pentaho.com/pipeline-designer/concepts-and-terminology/hello-world.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.