# tSambaList

Lists files in a directory under a shared directory and passes the file information to the subsequent component. This component supports Samba version 2 and Samba version 3.

## tSambaList Standard properties

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

The Standard tSambaList component belongs to the Internet family.

The component in this framework is available in all subscription-based Talend products.

Information noteNote: This component is available only when you have installed the 8.0.1-R2022-04 Talend Studio Monthly update or a later one delivered by Talend. For more information, check with your administrator.

## Basic settings

| Properties | Description |
| --- | --- |
| Property Type | Select the way the connection details<br>will be set.<br><br><ul> <li> <p> <span>Built-In</span>: The connection details will be set                          locally for this component. You need to specify the values for all                          related connection properties manually.</p> </li> <li> <p> <span>Repository</span>: The connection details stored                              centrally in <span><span>Repository</span><abbr> &gt; </abbr><span>Metadata</span></span> will be reused by this component.</p> <p>You need to click                              the <span>[...]</span> button next to it and in the pop-up                              <span>Repository Content</span> dialog box, select the                              connection details to be reused, and all related connection                              properties will be automatically filled in.</p> </li> </ul><br><br>This option is not available when you select the Use an existing<br>connection option and select a component from the<br>Component List dropdown list. |
| Use an existing connection | Select this check box and in the Component<br>List drop-down list, select the desired connection component to<br>reuse the connection details you already defined.<br><br>Information noteNote: When a Job contains the parent Job and the child Job, do the following if you<br>want to share an existing connection between the parent Job and the child Job (for example,<br>to share the connection created by the parent Job with the child Job).<br><br><ol> <li>In the parent level, register the database connection to be shared               in the <span>Basic settings</span> view of the               connection component which creates that very database connection. </li> <li>In the child level, use a dedicated connection component to read               that registered database connection. </li> </ol><br><br>For an example about how to share a database connection across Job levels,<br>see [Sharing a database connection](https://help.qlik.com/talend/r/en-US/7.3/studio-user-guide/sharing-database-connection). |
| Schema and Edit schema | A schema is a row description. It defines the number of fields<br>(columns) to be processed and passed on to the next component. When you create a Spark<br>Job, avoid the reserved word line when naming the<br>fields.<br><br><ul> <li> <p> <span>Built-In</span>: You create and store the schema locally for this component                only.</p> </li> <li> <p> <span>Repository</span>: You have already created the schema and stored it in the                Repository. You can reuse it in various projects and Job designs.</p> </li> </ul><br><br>Click Edit<br>schema to make changes to the schema. If the current schema is of the Repository type, three options are available:<br><br><ul> <li> <p> <span>View schema</span>: choose this                option to view the schema only.</p> </li> <li> <p> <span>Change to built-in property</span>:                choose this option to change the schema to <span>Built-in</span> for local changes.</p> </li> <li> <p> <span>Update repository connection</span>:                choose this option to change the schema stored in the repository and decide whether                to propagate the changes to all the Jobs upon completion.</p> <p>If you just want to                propagate the changes to the current Job, you can select <span>No</span> upon completion and choose this schema metadata                again in the <span>Repository Content</span>                window.</p> </li> </ul><br><br>Click Sync columns to retrieve the schema from the previous component connected in the Job. |
| Guess schema | Click this button to generate the schema using the following columns.<br><br><ul> <li> <span>FileName</span>, type <span>String</span> </li> <li> <span>FileName_with_Path</span>, type                        <span>String</span> </li> <li> <span>Length</span>, type <span>Long</span> </li> <li> <span>Change_Time</span>, type <span>Date</span> </li> <li> <span>Creation_Time</span>, type <span>Date</span> </li> <li> <span>Last_Access_Time</span>, type <span>Date</span> </li> <li> <span>Last_Write_Time</span>, type <span>Date</span> </li> </ul> |
| Host | The IP address or hostname of the Samba host.<br><br>This field is not available if you select the Use an existing connection option. |
| Username and<br>Password | Enter the authentication information required to access the Samba host.<br><br>To enter the password, click the [...] button<br>next to the Password field to bring out the Enter a new<br>password dialog box, enter the password in the text field, and click<br>OK. Note that you can enter the password either in a JSON string<br>in the pure password mode or as a Java expression in the Java<br>mode. You can toggle between the two modes by clicking switch to<br>Java mode or switch to pure password mode on the top<br>of the text field.<br><br>Information noteNote:<br><br><ul> <li>The two password modes are available only when you have installed the                  8.0.1-R2022-05 <span>Talend Studio</span>                  monthly update or a later one delivered by <span>Talend</span>. For more information, check with your administrator.</li> <li>If the 8.0.1-R2022-05 <span>Talend Studio</span>                  monthly update or a later one delivered by <span>Talend</span>                  is not installed, you can enter passwords in the <span>Java mode</span>                  only. </li> </ul><br><br>These two fields are not available if you select the Use an existing<br>connection option. |
| Domain | Enter the Samba host domain name.<br><br>This field is not available if you select the Use an existing connection option. |
| Share directory | Enter the share name of the shared directory where the desired directory<br>resides. The shared directory will be the parent directory of the desired<br>directory. |
| Remote path | Enter the relative path to the directory whose files will be<br>listed. |
| Includes subdirectories | Select this option to also list the files under all the subdirectories of<br>the directory specified by the Remote path field. |
| File mask | Add a line by clicking the plus button on the bottom and type in a file mask in<br>the line to filter the files to be listed.<br><br>You can enter multiple file masks by adding a line for each of the file<br>masks. |
| Die on error | Select the checkbox to stop the execution of the Job when an error<br>occurs. |

## Advanced settings

| Properties | Description |
| --- | --- |
| tStatCatcher Statistics | Select this checkbox to gather the Job processing metadata at the Job level<br>as well as at each component level. |

## Global Variables

| Variables | Description |
| --- | --- |
| ERROR\_MESSAGE | The error message generated by the component when an error<br>occurs. This is an After variable and it returns a string. |
| NB\_LINE | The number of rows processed. This is an After variable and<br>it returns an integer. |

## Usage

| Usage guidance | Description |
| --- | --- |
| **Usage rule** | This component passes file information to the subsequent<br>component through a Row &gt; Main connection. It can<br>also be used to trigger other components or subJobs. |