FTP Connector

Version 21.0.8222


FTP Connector


The FTP Connector transfers files to and from a remote FTP server.

概要

Each FTP Connector connects uploads to a specified folder and downloads from a set of folders on the remote FTP server.

Files that reach the FTP Connector in the ArcESB flow are uploaded to the upload target folder, and files found in the download target folder(s) are downloaded and entered into the ArcESB flow. The connector supports upload and download filters to only send and receive specified file names and/or file extensions.

Connector Configuration

This section contains all of the configurable connector properties.

Settings Tab

Host Configuration

Settings related to establishing the connection to the remote FTP host.

  • Connector Id The static name of the connector. All connector-specific files are held in a folder by the same name within the Data Directory.
  • Connector Description An optional field to provide free-form description of the connector and its role in the flow.
  • リモートホスト The hostname or IP address of the FTP server.
  • SSL の種類 How to negotiate SSL/TLS when connecting to the server.’Explicit’ に設定すると、プレーンテキスト接続が確立され、その後明示的なコマンドでSSL/TLS が開始されます。When set to ‘Implicit’, SSL/TLS will immediately be negotiated without first establishing a plaintext connection.
  • リモートポート The port on which to connect to the FTP server.

Client Authentication

Settings related to authenticating to the FTP server.

  • ユーザー名 The username credential for logging in to the FTP server.
  • パスワード The password credential for logging in to the FTP server.

Server Authentication

Settings related to verifying the FTP server’s identity.

  • サーバーパブリック証明書 If the FTP server is an SSL server (FTPS), this field should be set to the SSL Certificate that identifies the server. If the server’s certificate is not available, this field can be set to ‘Any Certificate’ to implicitly trust the server’s identity.

Upload

Settings related to uploading files to the FTP server.

  • リモートパス Files processed by the connector will be uploaded to this specified remote folder.

Download

Settings related to downloading from the FTP server.

  • リモートパス The remote folder from which files will be downloaded. Multiple paths can be specified in a comma-delimited list.
  • ファイルマスク A glob pattern that determines which files within the リモートパス should be downloaded (e.g. *.txt).
  • ファイルを削除(受信後) Whether files that are successfully downloaded should be deleted from the FTP server afterwards.

Automation Tab

Automation Settings

Settings related to the automatic processing of files by the connector.

  • アップロード Whether files arriving at the connector will automatically be uploaded.
  • 再試行間隔 The amount of time before a failed upload is retried.
  • Max Attempts The maximum number of times the connector will process the input file. Success is measured based on a successful server acknowledgement. If this is set to 0, the connect will retry the file indefinitely.
  • ダウンロード Whether the connector should automatically poll the remote download path(s) for files to download.
  • ダウンロード間隔 The interval between automatic download attempts.
  • The number of minutes to wait before downloading. Only applicable when ダウンロード間隔 is set to Minute.
  • 毎時何分 The minutes offset for an hourly schedule. Only applicable when ダウンロード間隔 is set to Hourly. For example, if this value is set to 5, the automation service will download at 1:05, 2:05, 3:05, etc.
  • The time within a given day that the download should occur. Only applicable when ダウンロード間隔 is set to Daily, or Weekly, or Monthly.
  • The day on which the download should occur. Only applicable when ダウンロード間隔 is set to Weekly or Monthly.
  • Cron 式 An arbitrary string representing a cron expression that determines when the download should occur. Only applicable when ダウンロード間隔 is set to Advanced.

Performance

Settings related to the allocation of resources to the connector.

  • Max Workers The maximum number of worker threads that will be consumed from the threadpool to process files on this connector. If set, overrides the default setting from the Profile tab.
  • Max Files The maximum number of files that will be processed by the connector each time worker threads are assigned to the connector. If set, overrides the default setting from the Profile tab.

Advanced Tab

SSL Client Authentication

Settings related to client authentication when two-way SSL authentication is required.

  • プライベート証明書 The private certificate presented during SSL client authentication.
  • 証明書のパスワード The password required to access the SSL client certificate.

Other Settings

Settings not included in the previous categories.

  • アカウント The Windows user account whose credentials should be presented to the FTP server.
  • アクティブモード Whether to enable Active or Passive mode on the remote FTP server. Passive mode is less likely to result in firewall interference with the connection.
  • コマンドチャネルをクリア Whether the channel over which FTP commands are sent should be cleartext or encrypted.
  • ダウンロードしない拡張子 A comma-delimited list of file extensions that will not be downloaded by the connector.
  • ダウンロードしないプレフィックス A comma-delimited list of prefixes that instructs the connector not to download filenames that begin with a specified prefix.
  • ファイルサイズ比較を有効化 Whether to cache downloaded file names and sizes; if True then files will only be downloaded if they have not been downloaded before or have changed in size.
  • タイムスタンプ比較を有効化 Whether to cache downloaded file names and last-modified timestamps; if True then files will only be downloaded if they have not been downloaded before or have been modified since they were downloaded.
  • 受信フィルタ A glob pattern filter to determine which files should be downloaded from the remote storage (e.g. *.txt).Negative patterns may be used to indicate files that should not be downloaded (e.g. -*.tmp). This setting should be used when multiple ファイルマスク patterns are desired. Multiple patterns may be separated by commas, with later filters taking priority except when an exact match is found.
  • 送信フィルタ A glob pattern filter to determine which files in the Send folder will be uploaded by the connector (e.g. *.txt).Negative patterns may be used to indicate files that should not be uploaded (e.g. -*.tmp). Multiple patterns may be separated by commas, with later filters taking priority except when an exact match is found.
  • ローカルファイルスキーム A filemask for determining local file names as they are downloaded by the connector. The following macros may be used to reference contextual information:
    %ConnectorId%, %Filename%, %FilenameNoExt%, %Ext%, %ShortDate%, %LongDate%, %RegexFilename:%, %DateFormat:%.
    As an example: %FilenameNoExt%_%ShortDate%%Ext%
  • ログレベル The verbosity of logs generated by the connector. When requesting support, it is recommended to set this to Debug.
  • 最大ダウンロードファイル The maximum number of files that will be downloaded from the FTP server in one polling interval. If set to -1, no limit is applied.
  • 親コネクタ The connector from which settings should be inherited, unless explicitly overwritten within the existing connector configuration. Must be set to a connector of the same type as the current connector.
  • サブディレクトリを再帰 Whether to download files in subfolders of the target remote path.
  • ダウンロードを再開 If enabled, when an error occurs during a file download, the connector will store the portion of the file that was downloaded and attempt to download the remainder of the file on the next download attempt.
  • アップロードを再開 If enabled, when an error occurs during a file upload, the connector will note the number of bytes that were transferred and attempt to upload the remainder of the file on the next upload attempt.
  • 一時的なダウンロードの拡張子 Temporary file extension to append to file downloads while the transfer is in progress.
  • 一時的なアップロードの拡張子 Temporary file extension to append to file uploads while the transfer is in progress.
  • 一時的なアップロードのパス Temporary path on the remote FTP server where files will be uploaded. The file will be moved into the permanent upload path after the transfer is complete.
  • 一時的なアップロードのプレフィックス Temporary file prefix to prepend to file uploads while the transfer is in progress.
  • タイムアウト The duration the connector will wait for a connection response before throwing a timeout error.
  • 転送モード Whether files will be transferred as ASCII or binary. If set to Default, the server will choose the transfer mode.
  • Log Subfolder Scheme Instructs the connector to group files in the Logs folder according to the selected interval. For example, the Weekly option instructs the connector to create a new subfolder each week and store all logs for the week in that folder. The blank setting tells the connector to save all logs directly in the Logs folder. For connectors that process many transactions, using subfolders can help keep logs organized and improve performance.
  • Log Messages Whether the log entry for a processed file will include a copy of the file itself.
  • Save to Sent Folder Whether files processed by the connector should be copied to the Sent folder for the connector.

Miscellaneous

Settings for specific use cases.

  • Other Settings Allows configuration of hidden connector settings in a semicolon-separated list, like setting1=value1;setting2=value2. Normal connector use cases and functionality should not require use of these settings.

Establishing a Connection

Connecting to the remote FTP server requires the following settings:

  • リモートホスト
  • SSL の種類
  • リモートポート
  • ユーザー名
  • パスワード

FTP servers may additionally require サーバーパブリック証明書 and/or SSL クライアント認証 under the Advanced tab.

Uploading Files

The FTP Connector uploads files from the Input/Send Folder that match the Send Filter set in the Advanced tab. Files are automatically uploaded to the FTP server if アップロードオートメーション is enabled in the connector.

リモートパス should be set to the folder on the remote FTP server where files should be uploaded. The application changes directories to the specified folder after logging in to the server. A temporary upload extension, prefix, or path can be set in the Advanced tab to ensure that files have been fully transferred before they end up in the リモートパス folder.

If any files could not be uploaded, the connector attempts to send them later after Retry Interval minutes have elapsed. This process continues until the Max Attempts setting has been reached, after which the connector will raise an error and the file will no longer be sent automatically.

Downloading Files

Downloaded files are displayed in the Output/Receive Folder of the connector, or passed along to the next connector in the flow. Files are automatically downloaded from the FTP server if ダウンロードオートメーション is enabled in the connector, and can be manually downloaded by clicking the Receive button in the Output tab.

リモートパス should be set to the folder on the remote FTP server from which files should be downloaded. The application changes directories to the specified folder after logging in to the server. The ファイルマスク property filters files such that only filenames matching the glob pattern are downloaded from the server. A temporary download extension or prefix can be set in the Advanced tab to ensure that files have been fully transferred before they end up in the Output/Receive Folder.

The Delete files (after download) setting can be used to delete the files on the remote server after successfully downloading them.

After configuring, files will be downloaded according to the Receive Automation settings, or by manually clicking the Receive button within the Output tab.

Subfolder Headers

If Recurse Subdirectories is set to True when receiving a file from the Remote Path in the FTP connector:

  • The message for the file that is received will contain a Subfolder header in its metadata.
  • This header contains the subfolder, relative to the Remote Path in the FTP connector, that the file was received from.
  • This subfolder header will be supported by other connectors that support a Subfolder header in Send operations.

When sending files, if a Subfolder header is present on the message that is sent to the Upload Path in the FTP connector:

  • The file will be placed in the subfolder, relative to the Upload Path in the FTP connector, that is specified in the subfolder header.
  • The subfolder will be created if permissions are available.