Catching Errors

Parameters of Action "append"

Name

Type

Direction

Description

name

String

in

Fully qualified file name of the file you want to write, including the path.

data

Blob

in

Content you want to write to the file.

length

Integer

in

Length (in Bytes) of the data you want to append, if you want to only write part of the Blob.

Defining a "append" Action

To append data to a file with the file system adapter, you need to define an append action on an action having the stereotype <<FileSystemAdapter>>. You can do this manually (refer to Figure: The Specification Dialog of the File System Adapter) or with the help of the E2E Action Wizard (see context menu of the action node).

Figure: Appending to a File

BRIDGE > Appending Data to Files > file_system_append.png

The file content needs to be provided as input of type Blob. The input object buffer must be named data.

The directory where the file is located and the file name are defined in the component diagram.

Modes of Action "append"

To action append, two modes can be applied:

append
If mode is empty or set to append, the content stored in data will be appended to the file specified in name. If the file does not exist, it will be created.
overwrite
If mode is set to overwrite, the file specified in name will be overwritten with the content stored in data. If the file does not exist, it will be created.
overwrite will only be applied to the first append. All subsequent appends (e.g. in a loop) automatically get mode append.