Syntax:
com.ibi.agents.XDSFTPDirectFileTransfer
iIT Service Object:
format: SFTP Direct Transfer
Description: Transfers file directly to or from the disk via SFTP or SCP protocol.
Parameters:
|
Parameter |
Description |
|---|---|
|
Host Name * |
The DNS name (or IP address) of the SFTP server that you want to connect to. |
|
Remote Port * |
The port to connect to on the SFTP site. Leave blank for default port 22. |
|
Buffer Size |
The size of the SFTP buffer to be used when sending or retrieving data. The default value of 32768 is used if this field is not set. A larger buffer may improve performance, but setting this field to a value greater than 65536 will default to 65536. The value must be entered as a whole number (for example, 32768, 65536). iWay recommends leaving the buffer size at 32768. |
|
Proxy Settings |
|
|
Proxy Type |
The proxy protocol to use. |
|
Proxy Host Name |
The DNS name (or IP address) of the proxy server that you want to connect to. |
|
Proxy Port |
The port to connect to on the proxy site. |
|
Proxy User ID |
The user ID on the proxy server. |
|
Password |
The proxy user's password on the proxy server. |
|
SSH Parameters |
|
|
User Name |
The user ID on the SSH-enabled server. |
|
Password |
The user's password on the SSH-enabled server. |
|
Private Key |
The path to the private key file for public-key authentication.. |
|
Passphrase |
The passphrase used to protect the Private Key. |
|
Provider |
The name of the SSH Client Security Provider to use. If no Provider name is specified, enter the user name and either a password or a Private Key and passphrase values (Passphrase is required only if the Private Key file is passphrase protected). |
|
Validate Host Keys |
If set to true, keys sent from SSH hosts are validated. If valid, the keys are cached by this server. If false, any host key will be accepted by this server. |
|
Host Key Repository |
The path to the Known Host Keys repository on this server. |
|
Agent Parameters |
|
|
Use SCP |
Use Secure Copy protocol for file copy. Not all servers support the use of SCP. |
|
Name of File * |
The file to be read or written. Relative or absolute file paths are supported explicitly or through an SREG or XPATH expression evaluated using the incoming document. |
|
Host Directory |
An optional directory to be used if Name of File is not absolute. |
|
Working Directory * |
The path to the iSM working directory. |
|
Transfer Type * |
The direction of transfer. Select retrieve to retrieve the file from the server. Select send to send the file to the server. |
|
Return |
|
|
File Protect |
Emit a temporary name, and then rename it to the desired name. |
|
Delete After Read |
This parameter configures the action to be taken after the read. The options are:
|
|
Action on Failure |
Determines whether an input document or status document is returned on failure. |
|
Connection Retry |
Determines the attempted failed connects to the SFTP server. |
|
Retry Interval |
Retry interval in seconds (allows for xxhxxmxxs format). Omit or use 0 for no retry. |
Edges:
The following table lists the available Line Edges for the SFTP Direct Transfer Service (com.ibi.agents.XDSFTPDirectFileTransfer).
|
Line Edge |
Description |
|---|---|
|
OnError |
An exception occurred during execution. |
|
OnSuccess |
The operation was successful. |
|
OnFailure |
A fail condition occurred during execution. |
|
OnParseError |
Could not parse a document. |
|
OnFailedConnection |
Could not connect to the external system. |
|
OnFailedOperation |
Could not perform the operation requested . |
|
OnFailSecurity |
Could not operate dues to a security violation.. |