# General

The Kinesis Consumer step requires definitions for setup, batch, fields, result fields, and Kinesis Data Streams specific options to consume messages.

![Kinesis Consumer step](https://3411831820-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAYwCj9fPr1B2pjC11IOQ%2Fuploads%2Fgit-blob-09b59b7727cde67c185af53086a020661226042d%2FssPDITransStep_KinesisConsumer_PropertiesDialogBox.png?alt=media)

Enter the following information in the **Step name** and **Transformation** fields:

| Option             | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Step name**      | Specifies the unique name of the step on the canvas. The **Step name** is set to Kinesis Consumer by default.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| **Transformation** | <p>Specify the child transformation to execute by performing any of the following actions.- Entering its path.</p><ul><li>Clicking <strong>Browse</strong> to select an existing child transformation.</li><li>Clicking <strong>New</strong> to create and save a new child transformation. See <a href="general/create-and-save-a-new-child-transformation">Create and save a new child transformation</a> for more details.</li></ul><p>The selected child transformation must start with the Get Records from Stream step.</p><p>If you select a transformation that has the same root path as the current transformation, the variable <em>${Internal.Entry.Current.Directory}</em> is automatically inserted in place of the common root path. For example, if the current transformation's path is <code>/home/admin/transformation.ktr</code> and you select a transformation in the directory <code>/home/admin/path/sub.ktr</code>, then the path is automatically converted to <code>*${Internal.Entry.Current.Directory}*/path/sub.ktr</code>.</p><p>If you are working with a repository, you must specify the name of the transformation. If you are not working with a repository, you must specify the XML file name of the transformation.</p><p>Transformations previously specified by reference are automatically converted to be specified by the transformation name in the Pentaho Repository.</p> |
