Page History
Versions Compared
Key
- This line was added.
- This line was removed.
- Formatting was changed.
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.
Task | Action | Mode | Important Parameter | Remarks |
---|---|---|---|---|
Write a complete file in one action. |
| |||
Replace part of a file. | position | Writes the data to the file beginning at the specified position. If the file does not exists you will get the exception FSADM/8 (see Catching Errors). | ||
Append data to a file. | append |
| ||
Write a complete file line by line. | overwrite | Use mode overwrite for all appends.
overwrite will only be applied to the first append. All subsequent appends (e.g. in a loop) automatically get mode append. | ||
Copy a complete file. | copy | Copy a file in one action. Using copy you can even copy huge files because it does not load the complete file into memory. | ||
Manipulate a file and process the file further (e.g. moving it). | Before processing the file further (e.g. moving it), close the file. Otherwise it may be locked. |
Multiexcerpt include | ||||||||
---|---|---|---|---|---|---|---|---|
|
Adding a Filesystem Adapter Operation to a Diagram
Expand the path to the Filesystem adapter in the service panel (Base Types/Bridge Base/Base Components/Add Ons/FileSystem). | |
You can drag out operations from the data model to any diagram: 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):
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. | |||||||||||||
Image Modified | To configure a Filesystem adapter, you have the following options:
| ||||||||||||
Image Modified | 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: | ||||||||||||
Image Modified | 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:
Select the desired alias stereotype an click Save. | |||||||||||||
In the following dialog, name and configure the new alias. Refer to Filesystem for more information on the configuration options of this adapter. Click Save to add the new created alias. |
Otp | ||
---|---|---|
|