# UploadFiles

Required Frends version: 5.5+

Required .NET version: 6.0

Compatible Agents: Crossplatform

Source code: <https://github.com/FrendsPlatform/Frends.AzureDataLake/tree/main/Frends.AzureDataLake.UploadFiles>

{% tabs %}
{% tab title="Parameter: Input" %}

| Name                               | Description                                                                                                                                                                                                                            |
| ---------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Source : `Source`                  | <p>Specify source files parameters</p><p><br>Default: <code>-</code><br>Example: <code>-</code></p>                                                                                                                                    |
| Destination : `Destination`        | <p>Specify destination Data Lake parameters</p><p><br>Default: <code>-</code><br>Example: <code>-</code></p>                                                                                                                           |
| Options : `Options`                | <p>Specify options how we should handle data and errors</p><p><br>Default: <code>-</code><br>Example: <code>-</code></p>                                                                                                               |
| Overwrite : `Boolean`              | <p>How the existing file will be handled.</p><p><br>Default: <code>False</code><br>Example: <code>true</code></p>                                                                                                                      |
| UploadFilesRecursively : `Boolean` | <p>True: Upload all files matching pattern, even in nested directories.</p><p>False: Upload files matching pattern, which are only directly in Source Directory</p><p><br>Default: <code>True</code><br>Example: <code>true</code></p> |
| Close : `Boolean`                  | <p>Specifies whether the uploaded file should be finalized (closed) after upload.</p><p>When true, it triggers a "final update" event in Azure Storage Events.</p><p><br>Default: <code>True</code><br>Example: <code>true</code></p>  |
| {% endtab %}                       |                                                                                                                                                                                                                                        |

{% tab title="Result: Result" %}

| Name                                | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| ----------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Success : `Boolean`                 | <p>Operation complete. Returns false if ThrowErrorOnFailure is disabled and error occurred. Returns true otherwise.<br>Example: <code>true</code></p>                                                                                                                                                                                                                                                                                                                                          |
| Data : `Dictionary<String, String>` | <p>This object contains the list of local source file paths and their respective URLs in Azure Data Lake. If an ignorable error occurs, such as when a file already exists and Options.ThrowErrorOnFailure is set to false, the URL will be replaced with the corresponding error message.age.<br>Example: <code>{ { c:\temp\examplefile.txt, <https://storage.dfs.core.windows.net/container/examplefile.txt> }, { c:\temp\examplefile2.txt, File examplefile2 already exists. } }</code></p> |
| ErrorMessage : `String`             | <p>This object contains the error message if task fail.<br>Example: <code>Container ex does not exist</code></p>                                                                                                                                                                                                                                                                                                                                                                               |
| {% endtab %}                        |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |

{% tab title="Changelog" %}

## Changelog

### \[1.4.0] - 2026-01-15

#### Changed

* Updated Azure packages to latest versions:
* Azure.Storage.Files.DataLake 12.25.0
* Azure.Identity 1.17.1

### \[1.3.0] - 2025-05-07

#### Added

* Added new Close parameter to control whether the uploaded file is finalized after upload.
* Use the default parameter value ('true') if you want the upload operation to work as before (automatically closing the stream).
* Set to 'false' if you need to manage the stream lifecycle manually after upload.

### \[1.2.0] - 2024-08-23

#### Changed

* Updated the Azure.Identity package to version 1.12.0.

### \[1.1.0] - 2024-05-20

#### Added

* Added FrendsTaskMetadata.json

### \[1.0.0] - 2024-05-14

#### Added

* Initial implementation of Frends.AzureDataLake.UploadFiles.
  {% endtab %}
  {% endtabs %}
