Remotemanager-call

From GreenVulcano Wiki
Revision as of 09:23, 3 February 2012 by Anonymous (talk) (Created page with "==Description== This {{GVESB}} plug-in allows you to perform a sequence of file operations in a remote file system accessible via an (S)FTP account. =={{VULCON}} / {{GVCONSOLE}...")
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to: navigation, search

Description

This GreenVulcano® ESB plug-in allows you to perform a sequence of file operations in a remote file system accessible via an (S)FTP account.

VulCon / GV Console Configuration

The operations allowed are:

  • Download a file/directory from a remote directory to a local directory
  • Upload a file/directory from a local directory to a remote directory
  • Control of one or more files (whose name corresponds to a date regular expressions) in a remote directory
  • Deleting a file/directory from a remote directory - Rename/move a file/directory in a remote directory


The remotemanager-call Element is used by Channel and routed-call. It has the attributes:

  • type: call.
  • class: it.greenvulcano.gvesb.virtual.file.remote.RemoteManagerCall.
  • name: Operation name. Used in the Flow section to associate workflow nodes to VCL operations.

and the subelements:

RemoteCommands

The RemoteCommands element contains the sequence of FTP operations to be carried out. These operations will be performed in the order they were configured. An error in one of the operation marked as critical will terminate the execution of the entire sequence.

The RemoteCommands Element is used by remotemanager-call and internally, it is possible to configure more of the following operations:

  • RemoteSearchCommand
  • RemoteMoveCommand
  • RemoteDeleteCommand
  • RemoteDownloadCommand
  • RemoteUploadCommand

The following table shows its details:

Operation Use this for... Attributes
RemoteSearchCommand
RemoteMoveCommand Moving/renaming a file/directory.
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.
type: remote-command.
class: it.greenvulcano.gvesb.virtual.file.remote.command.GVMove.
targetPath: Absolute path of the file/directory where is the file to move.
oldName: File name to move.
newName: File name moved.
isCritical: If true an internal error interrupt the command sequence. Default true.
RemoteDeleteCommand Deleting a file/directory.
Both the file name and the directory 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, will erase all files in the specified directory whose name is consistent with the corresponding pattern.
type: remote-command.
class: it.greenvulcano.gvesb.virtual.file.remote.command.GVDelete.
targetPath: Absolute path of the file/directory to remove.
filePattern: File name to remove.
Can be a regular espression. It is used only if targetPath is a directory, and if empty the filter is ignored.
isCritical: If true an internal error interrupt the command sequence. Default true.
RemoteDownloadCommand Downloading file/directory from remote directory and saved in the local directory you specified (or in GVBuffer).
File names and directories can be static or contain placeholders that are replaced at runtime.
type: remote-command.
class: it.greenvulcano.gvesb.virtual.file.remote.command.GVDownload.
remotePath: Pathname of remote directory containing the file to download. It can be an absolute pathname or relative, in the second case it is relative to home directory of ftp user.
remoteFilePattern: The name of the file to download.
toGVBufferExpression: GVBuffer OGNL expression used to specify how to handle the current downloaded file. In the expression, the downloaded file will be referenced by the variable #input, and will be a byte [].
targetPath: Pathname of the local directory to save the downloaded file. Must be an absolute pathname.
isCritical: If true an internal error interrupt the command sequence. Default true.
RemoteUploadCommand