X4 Produktdokumentation

Operation: AppendFile

With the AppendFile operation, you attach a file to an existing file.

For more information on other operations of the Microsoft Azure Data Lake Gen 1 Storage Connector, see Microsoft Azure Data Lake Gen 1 Storage Connector.

Parameters

authEndpoint

✳️

This parameter is required.

OAuth 2.0 Token Endpoint (v1)

Possible values:

String with a valid endpoint, e.g.:

https://login.microsoftonline.com/<DirectoryID>/oauth2/token

clientID

✳️

This parameter is required.

Client ID of the Azure Active Directory application

Possible values:

Any string with the client ID, e.g.:

10925xxx-1111-4444-bd3d-82165c0d3841

clientSecret

✳️

This parameter is required.

Secret client key of the Azure Active Directory application

Possible values:

String containing the secret client key.

accountName

✳️

This parameter is required.

Fully qualified Data Lake Storage Account Name (FQDN)

Possible values:

String containing the FQDN, e.g.: <your_account_name>.azuredatalakestore.net

fileName

✳️

This parameter is required.

File name

Possible values:

String with the file name, e.g. :

inputFile.txt or root/subfolder/inputFile.txt

Note:

The string can contain the full file path (root/subfolder/inputFile.txt), as well as the file name (fileNameinputFile.txt) and folder name (folderPathroot/subfolder).

folderPath

Folder path. Can start and end with a slash.

Note:

If the folderPath parameter is empty, the file is created in the root folder of the user account. If the path specified in the folderPath parameter does not exist, the corresponding path is newly created.

Possible values:

  • /: Root folder

  • Any valid path, e.g. root/subfolder/.../lastFolder

Status values

1

The adapter operation was executed successfully

-1

The operation failed due to a technical error.

Input

For the AppendFile operation, the adapter expects a file with any XML structure.

Output

If the AppendFile operation was executed successfully (status 1), the adapter outputs the desired input document including the file to be attached.

If the operation was unsuccessful, i.e. in the event of an error (status -1⁣), the adapter returns an XML document with the error description, e.g.:

image-20250130-123114.png