Filemanager-call

Definition

This plug-in allows you to perform a sequence of file operations on the local filesystem. The operations allowed are:

1. Deletion of one or more file whose name corresponds to a regular expression
2. Rename a file
3. Moving of one or more files, whose name corresponds to a regular expression,from a directory source to a destination directory
4. Copy of one or more files, whose name corresponds to a regular expression,from source directory to a destination directory
5. ZIP compress of one or more files, whose name corresponds to a regular expression,from a source directory to a ZIP file in a destination directory
6. Decompression of ZIP file from a directory source to a target directory
7. Check existence of one or more files whose name corresponds to a given regular expression

GreenVulcano^® ESB provides two different tools, GV Console^® and VulCon^®, to configure all supported plug-ins in GV services.

VulCon / GV Console Configuration

filemanager-call is the operation that must be configured into VulCon^® or GV Console^® System section, to execute files operations.

In order to configure an operation filemanager-call might be defined the following fields:

Attribute	Type	Description
type	fixed	This attribute must assume the value call.
class	fixed	This attribute must assume the value it.greenvulcano.gvesb.virtual.file.reader.FileManagerCall.
name	required	Operation name. Used in the Flow section to associate workflow nodes to VCL operations.

The filemanager-call element must contain at least one of the following FileCommands:

• FileSearchCommand
• FileMoveCommand
• FileDeleteCommand
• FileCopyCommand
• FileZipCommand
• FileUnZipCommand

FileSearchCommand

To execute a search file operation add a "FileSearchCommand" element.

This operation checks if one or more files, whose name conforms to a given regular expression, exists within the specified directory.

The following table shows its attributes:

Attribute	Type	Description
type	fixed	This attribute must assume the value file-command.
class	fixed	This attribute must assume the value it.greenvulcano.gvesb.virtual.file.command.GVSearch.
sourcePath	required	Absolute path of the directory to search in.
filePattern	required	File name to search for. Can be a regular expression.
returnFullPath	optional	If true the found files are inserted in list with full path. Default false.
isCritical	optional	If true an internal error interrupt the command sequence. Default true

On completion of and in the absence of errors are set the following properties of GVBuffer output: 1) GVFM_FIND_FILES_NUM Number of files found (>= 0) 2) GVFM_FIND_FILES_LIST List of names of found files, separated by ','. Set only if the value of field GVFM_FIND_FILES_NUM is greater than 0. Both the name of the file and the directory can be static or contain placeholders that are replaced at runtime.

FileMoveCommand

To move and/or rename a file or directory add a "FileMoveCommand" element.

The following table shows its attributes:

Attribute	Type	Description
type	fixed	This attribute must assume the value file-command.
class	fixed	This attribute must assume the value it.greenvulcano.gvesb.virtual.file.command.GVMove.
sourcePath	required	Absolute path of the directory to move
targetPath	required	Absolute path of the destination file/directory
filePattern	optional	File name to move. Can be a regular expression. Is used only if sourcePath is a directory, and if empty the filter is ignored	isCritical	optional	If true an internal error interrupt the command sequence. Default true

The file name, the source and destination directory names can be static or contain placeholders that are replaced at runtime.

After the replacement of the placeholder, the value of the filename may contain a regular expression, in which case, all files of the source directory, whose name is in accordance with the corresponding pattern will be moved to the destination directory. If the destination directory already contains files with the same name, they will be overwritten.

FileDeleteCommand

To remove a files from a specific directory add "FileDeleteCommand" element.

The following table shows its attributes:

Attribute	Type	Description
type	fixed	This attribute must assume the value file-command.
class	fixed	This attribute must assume the value it.greenvulcano.gvesb.virtual.file.command.GVDelete.
targetPath:	required	Absolute path of the file/directory to remove.
filePattern	optional	File name to remove. Can be a regular expression. Is used only if targetPath is a directory, and if empty the filter is ignored
isCritical	optional	If true an internal error interrupt the command sequence. Default true

Both the file name and directory can be static or contain placeholders that are replaced at runtime. After the replacement of the placeholder, the value of filename may contain a regular expression, in which case, will erase all files in the specified directory whose name is consistent with the corresponding pattern.

FileCopyCommand

To copy a files from a specific directory add "FileCopyCommand" element.

1. sourcePath: Absolute path of the file/directory to copy.
2. targetPath: Absolute path of the destination file/directory.
3. filePattern: File name to copy. Can be a regular espression.Is used only if sourcePath is a directory, and if empty the filter is ignored.
4. isCritical: If true an internal error interrupt the command sequence. Default true

FileZipCommand

To compress one or more files add "FileZipCommand" element and define the following fieds:

1. sourcePath: Absolute path of the source directory
2. filePattern: File name to zip. Can be a regular espression. Is used only if sourcePath is a directory,and if empty the filter is ignored
3. targetPath: Absolute path of the destination directory
4. zipFileName: Name of the zip file
5. isCritical: If true an internal error interrupt the command sequence. Default true.

FileUnZipCommand

To Unpacking the contents of a Zip file add "FileUnZipCommand" element and define the following fieds:

1. sourcePath: Absolute path of the source directory
2. zipFileName: Name of the zip file
3. targetPath: Absolute path of the destination directory
4. isCritical: If true an internal error interrupt the command sequence. Default true.