The Filesystem adapter gives you access to the filesystem in service context. You can read and write files (even incrementally), and read and create directories.
Find below a table listing some common tasks you can use the Filesystem adapter for, and which action to use for which task.
The example on the left shows how to add a Filesystem adapter operation to a BPMN execution diagram.
Configuring the Filesystem Adapter Operation
Once an operation has been added to a diagram, it needs to be configured as a Filesystem adapter.
Select the newly added Filesystem adapter operation and switch to the Attributes panel. Depending on the diagram type you can see the following information (example BPMN execution diagram):
Attribute
Description
Allowed Values / Examples
Name
The name of the Filesystem adapter operation.
createDirectory
Type
The path to the operation within the data model.
Base Components.Add Ons.FileSystem.Directory
Symbol Type
Operations added to an execution diagram are execution steps.
Execution Step
All this is predefined and cannot be changed.
Click Add Stereotype to define the selected operation as to bea FileSystem adapter.
Select FileSystem Adapter from the list of available adapter stereotypes. Click Save.
The Attributes panel now shows the added adapter stereotype. Now you still need to configure the adapter.
Expand the stereotype by clicking the arrow on the right.
To configure a Filesystem adapter, you have the following options:
alias A Filesystem adapter is configured via its alias. For more information see below.
action The adapter action derives from the used operation. Do not configure this.
mode This option is only relevant for append operations. For more information, see Filesystem Adapter Reference.
You can select an existing alias from a drop-down list by clicking the text Select alias.
If you want to remove an added alias, click the corresponding icon on the right side or select None from the drop-down list:
You can also create and add a new alias by clicking the corresponding icon.
Refer to Aliases for more information on how to create a new alias.
A new dialog opens where you can choose an alias stereotype:
DirectoryAlias
FileAlias
Select the desired alias stereotype an click Save.
In the following dialog, name and configure the new alias.