Stereotype Attributes

DirectoryAliasDirectory Alias

Multiexcerpt

MultiExcerptName	directory_alias

Attribute	Description	Allowed Values / Example
Name	Specify a name for the alias.	any string
Standard
directory	Specify a path to a directory. This directory will be treated as a base directory. It will be either used directly (for a Filesystem adapter operating directly on directories), or as a base directory for a path segment given by a dynamic file name parameter. It is not possible to jump out of the base directory by `../../aDirectory` tricks. The base directory can only be changed in the service settings on the Bridge.	tmp/Export
fileEncoding	Specify the default encoding be used with the directory. This default encoding can be overwritten on adapter calls, using a dynamic encoding parameter, e.g. on Filesystem adapter calls reading lines, or with the Flat File adapter.	Refer to Charset Definitions for possible values.
		default, when empty	iso-8859-1
		Designer default	utf-8

FileAliasFile Alias

Multiexcerpt

MultiExcerptName	file_alias

Attribute	Description	Allowed Values / Examples
Name	Specify a name for the alias.	any string
Standard
file	Specify name and path of the file you want to access.	tmp/Export/ProductExport.txt
encoding	Specify the encoding of the file.	Refer to Charset Definitions for possible values.
		default, when empty	iso-8859-1
		Designer default	utf-8
resource	This attribute currently cannot be used in Designer context.

Parameters File Handling

read

.

File System Adapter

Attribute

Description

Allowed Values

alias

Specify the File or Directory alias the adapter should use to establish the connection.

any valid File or Directory alias

action

Multiexcerpt include

SpaceWithExcerpt	INTERNAL
MultiExcerptName	info_alias_attribute_action
PageWithExcerpt	INTERNAL:_designer_excerpts

mode

If you are using an append operation, you need to select the corresponding mode. See append operation for detailed information.

append (default), overwrite

Filesystem Adapter File Operations

append Operation

Multiexcerpt

MultiExcerptName	append_modes

You can use operation append in two modes:

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.

append ( data : Blob, name : String, length : Integer )

Multiexcerpt

MultiExcerptName	append

Name	Type	Direction	Description
data	Blob	in	Content you want to write to the file.
name	String	in	Fully qualified file name of the file you want to write, including the path.
length	Integer	in	Length (in Bytes) of the data you want to append, if you want to only write part of the Blob.

close Operation

close ( name : String )

Multiexcerpt

MultiExcerptName	close

Name	Type	Direction	Description
name	String	in	Fully qualified file name of the file you want to close, including the path.

copy Operation

copy ( source : String, traget : String )

Multiexcerpt

MultiExcerptName	copy

Name	Type	Direction	Description
source	String	in	Fully qualified file name of the file you want to copy, including the path.
target	String	in	Fully qualified file name of the target file, including the path.

read Operation

read ( name : String, position : Integer, length.in : Integer, data : Blob, length.out : Integer )

Multiexcerpt

MultiExcerptName	read

/out

Name	Type	Direction	Description
name	String	in	Fully qualified file name of the file you want to read, including the path.
position	Integer	in	Position (in Bytes) from which you want to start reading the file.
length.in	Integer	in		Length (in Bytes) of the snippet of the file you want to read. The actual length of the read data is given back (e.g. on file end).
data	Blob	out	Content that has been read.
length.out	Integer	out	Length (in Bytes) of the snippet of the file you want to read. The actual length of the read data is given back (e.g. on file end).

readLine Operation

readLine ( name : String, encoding : String, length : Integer, line : String )

Multiexcerpt

MultiExcerptName	readLine

lineStringFile content line NULLlengthIntegerLength (in Bytes) length 0

Name	Type	Direction	Description
name	String	in	Fully qualified file name of the file you want to read, including the path.
encoding	String	in	Encoding of the file. Default encoding is iso-8859-1. For a list of possible encodings see Charset Definitions .
length	Integer	out	Length (in Bytes) of the line that has been read. On file end,	length is	0.
line	String	out	File content of the line that has been read. On file end,	line is	NULL.

write

remove Operation

remove ( name : String )

Multiexcerpt

MultiExcerptName	writeremove

Name	Type	Direction	Description
name	String	in	Fully qualified file name of the file you want to writeremove, 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 write, if you want to only write part of the Blob.
position	Integer	in	Position (in Bytes) from which you want to start writing the file.

append

Multiexcerpt

MultiExcerptName	append_modes

You can use operation append in two modes:

rename Operation

readLine ( name : String, newName : String )

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.

Multiexcerpt

MultiExcerptName	appendrename

Name

Type

Direction

Description

name

String

in

Fully qualified file name of the file you want to

write

rename, including the path.

datanewName

BlobString

in

Content

New name you want to

write to

rename 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.

status

to. We recommend to provide a fully qualified file name (including the path).

status Operation

status ( name : String, size : Integer, type : String, accessTime : DateTime, creationTime : DateTime, modificationTime : DateTime )

Multiexcerpt

MultiExcerptName	status

.Type of accessed element (File or Directory)

Name

Type

Direction

Description

name

String

in

Fully qualified file name of the file/directory you want to read, including the path

type

String

out

.

size

Integer

out

Size of the file in Bytes.

Info

icon	false

size is meaningless for directories, as it is not the combined size of all contained files and subfolders, but rather some constant defined by the operating system (e.g. 0 or 4096).

type

String

out

Type of accessed element (File or Directory).

accessTime

DateTime

out

Timestamp when the file/directory was accessed for the last time.

creationTime

DateTime

out

Timestamp when the file/directory was created.

modificationTime

DateTime

out

Timestamp when the file/directory was modified for the last time.

rename

write Operation

write ( data : Blob, name : String, position : Integer, length : Integer )

Multiexcerpt

MultiExcerptName	renamewrite

Multiexcerpt

MultiExcerptName	remove

Name	Type	Direction	Description
namedata	StringBlob	in	Fully qualified file name of the file Content you want to rename, including the path.
newName	String	in	New name you want to rename the file to. We recommend to provide a fully qualified file name (including the path).

remove

Description

Name	Type	Direction	write to the file.
name	String	in	Fully qualified file name of the file you want to removewrite, including the path.

copymultiexcerpt

position

Integer

MultiExcerptName	copy

Name

Type

Direction

Description

source

String

in

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

target

String

in

Fully qualified file name of the target file, including the path.

close

in	Position (in Bytes) from which you want to start writing the file.
length	Integer	in	Length (in Bytes) of the data you want to write, if you want to only write part of the Blob.

Filesystem Adapter Directory Operations

createDirectory Operation

createDirectory ( name : String )

Multiexcerpt

MultiExcerptName	createDirectory

Multiexcerpt

MultiExcerptName	close

Name	Type	Direction	Description
name	String	in	Fully qualified file name of the file directory you want to closecreate, including the path.

Parameters Directory Handling

readDirectory Operation

readDirectory ( name : String, entries : String[] )

Multiexcerpt

MultiExcerptName	readDirectory

Name	Type	Direction	Description
name	String	in	Fully qualified path to the directory you want to read.
entries	Array of String	out	readDirectory returns an array of String containing the names of the content elements. The array elements do not contain the directory prefix (path).

createDirectory

Multiexcerpt

MultiExcerptName	createDirectory

Fully qualified file name of the directory you want to create, including the path

Name	Type	Direction	Description
name	String	in	.

status

Multiexcerpt includeMultiExcerptNamestatus

PageWithExcerptFilesystem

remove Operation

You can only remove an empty directory with the remove operation. In case the directory contains files or subfolders, use removeRecursively (see below).

remove ( name : String )

Multiexcerpt

MultiExcerptName	remove_directory

Name	Type	Direction	Description
name	String	in	Fully qualified file name of the directory you want to remove, including the path.

Anchor

	removeRecursively
	removeRecursively

removeRecursively Operation

removeRecursively ( name : String )

Multiexcerpt

MultiExcerptName	removeRecursively_directory

Name	Type	Direction	Description
name	String	in	Fully qualified file name of the top node of the directory tree you want to remove, including the path.

status Operation

status ( name : String, type : String, size : Integer, accessTime : DateTime, creationTime : DateTime, modificationTime : DateTime )

Multiexcerpt include

MultiExcerptName	status
PageWithExcerpt	Filesystem

Otp

Floating	false

Rp
Filesystem Adapter Charset Definitions Catching Errors

Page tree

Versions Compared

Old Version 14

New Version 15

Key

Stereotype Attributes

DirectoryAliasDirectory Alias

FileAliasFile Alias

Parameters File Handling

File System Adapter

Filesystem Adapter File Operations

append Operation

close Operation

copy Operation

read Operation

readLine Operation

remove Operation

append

rename Operation

status Operation

write Operation

remove

close

Filesystem Adapter Directory Operations

createDirectory Operation

readDirectory Operation

createDirectory

status

remove Operation

removeRecursively Operation

status Operation

Page tree

Page History

Versions Compared

Old Version 14

New Version 15

Key

Stereotype Attributes

DirectoryAliasDirectory Alias

FileAliasFile Alias

Parameters File Handling

File System Adapter

Filesystem Adapter File Operations

append Operation

close Operation

copy Operation

read Operation

readLine Operation

remove Operation

append

rename Operation

status Operation

write Operation

remove

close

Filesystem Adapter Directory Operations

createDirectory Operation

readDirectory Operation

createDirectory

status

remove Operation

removeRecursively Operation

status Operation