The File Operation components manipulate with files and directories.
An overview of all File Operation components is presented below:
Table 58.1. File Operations Comparison
| Component | Inputs | Outputs |
|---|---|---|
| CopyFiles | 0-1 | 0-2 |
| CreateFiles | 0-1 | 0-2 |
| DeleteFiles | 0-1 | 0-2 |
| MoveFiles | 0-1 | 0-2 |
| ListFiles | 0-1 | 1-2 |
For an overview of URL formats supported by File Operations, see Supported URL Formats for File Operations.
| Attribute | Req | Description | Possible values |
|---|---|---|---|
| Input mapping | [1] | defines mapping of input records to component attributes | |
| Output mapping | [1] | defines mapping of results to standard output port | |
| Error mapping | [1] | defines mapping of errors to error output port | |
| Redirect error output | no | if enabled, errors will be sent to the output port instead of the error port | false (default) | true |
[1] If the mapping is omitted, default mapping based on identical names will be used. | |||
The operation will be executed for each input record. If the input edge is not connected, the operation will be performed exactly once.
The attributes of the components may be overridden by the values read from the input port, as specified by the Input mapping.
It is essential to understand the meaning of records on the left-hand side of the Output mapping and Error mapping editor. There may be one or two records displayed.
The first record is only displayed if the component has an input edge connected, because it is the real input record which has been read from the edge. This record has Port 0 displayed in the Type column.
The other record on the left-hand side named Result is displayed always and is the result record generated by the component.
By default, the component will cause the graph to fail if it fails to perform the operation. This can be prevented by connecting the error port. If the error port is connected, the failures will be sent to the error port and the component will continue. The standard output port may also be used for error handling, if the Redirect error output option is enabled.
In case of a failure, the component will not execute subsequent operations unless the Stop processing on fail option is disabled. The information about skipped operations will be sent to the error output port.
See Chapter 58, File Operations next.