Difference between revisions of "Filemanager-call"

From GreenVulcano Wiki
Jump to: navigation, search
(→‎{{VULCON}} / {{GVCONSOLE}} Configuration)
(→‎{{VULCON}} / {{GVCONSOLE}} Configuration)
Line 25: Line 25:
 
| name || required || Operation name. Used in the [[Flow]] section to associate workflow nodes to VCL operations.
 
| 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.
 
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.  
 
This operation checks if one or more files, whose name conforms to a given regular expression, exists within the specified directory.  
 
   
 
   
Line 46: Line 57:
 
|}
 
|}
  
 +
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:
 +
{|class="gvtable"
 +
! 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:
 +
{|class="gvtable"
 +
! 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.
  
−
To move a file in other directories add "'''FileMoveCommand'''" element and define the following fieds:
 
−
#sourcePath:Absolute path of the file/directory to move
 
−
#targetPath: Absolute path of the destination file/directory
 
−
#filePattern: File name to move. Can be a regular espression. Is used only if sourcePath is a directory,and if empty the filter is ignored
 
−
#isCritical:  If true an internal error interrupt the command sequence. Default true
 
−
To remove a files from a specific directory add "'''FileDeleteCommand'''" element and define the following fieds:
 
−
#targetPath: Absolute path of the file/directory to remove.
 
−
#filePattern: File name to remove. Can be a regular espression. 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
 
−
To copy a files from a specific directory add "'''FileCopyCommand'''" element and define the following fieds:
 
 
#sourcePath: Absolute path of the file/directory to copy.
 
#sourcePath: Absolute path of the file/directory to copy.
 
#targetPath:  Absolute path of the destination file/directory.
 
#targetPath:  Absolute path of the destination file/directory.
 
#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.
 
#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.
 
#isCritical: If true an internal error interrupt the command sequence. Default true
 
#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:
 
To compress one or more files add "'''FileZipCommand'''" element and define the following fieds:
 
#sourcePath:  Absolute path of the source directory
 
#sourcePath:  Absolute path of the source directory
Line 68: Line 125:
 
#zipFileName: Name of the zip file
 
#zipFileName: Name of the zip file
 
#isCritical: If true an internal error interrupt the command sequence. Default true.
 
#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:
 
To Unpacking the contents of a Zip file add "'''FileUnZipCommand'''" element and define the following fieds:
 
#sourcePath: Absolute path of the source directory
 
#sourcePath: Absolute path of the source directory

Revision as of 12:20, 8 February 2012

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

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.
Retrieved from "https://gvwiki.greenvulcano.com/gvwiki/index.php?title=Filemanager-call&oldid=1613"