リストとデータの読み取り処理

オペレーション名

リストとデータの読み取り

機能概要

ファイルのリストとファイルの内容を取得します。

データモデル

本コンポーネントのデータモデルはXML型です。

プロパティ

= 備考 =

変数の使用については、「変数」を参照してください。

基本設定

項目名	必須/省略可	変数の使用	説明	備考
名前	必須	使用不可	スクリプトキャンバス上での名前を入力します。

必須設定

項目名	必須/省略可	変数の使用	説明	備考
接続先	必須	使用不可	コネクションリソースを選択します。 [追加] 新規にコネクションリソースを追加します。 [一覧の編集] > HULFT INTEGRATE > コネクションで、コネクションリソースの設定を編集することができます。
パス	必須	-	パスを指定します。各列は以下のボタンで操作することができます。 [上へ] 選択している列の順序を一つ上に上げます。 [下へ] 選択している列の順序を一つ下に下げます。 [追加] 列を追加します。 [削除] 列を削除します。
パス/リモートパス	必須	使用可	FTPサーバー上のファイル/ディレクトリーを「/」から始まる絶対パスで入力します。	ファイル名にはワイルドカード(「」・「?」)が使用できます。例: /upload/.csv /uploadディレクトリー直下に存在する、拡張子がcsvのファイルが該当します。例: /upload/売り上げデータ??.xls uploadディレクトリー直下に存在する、「売り上げデータ」で始まり、そのあとに2文字続く拡張子がxlsのファイルが該当します。大文字小文字を区別します。
パス/ローカルパス	必須	使用可	HULFT Square ストレージ上のディレクトリーまたはファイルを「/」から始まる絶対パスで入力します。	[リモートパス]でワイルドカード(「*」・「?」)を使用している場合は、ディレクトリー名を入力してください。大文字小文字を区別しません。
パス/データタイプ	必須	使用不可	データタイプを選択します。 [ASCII] [BINARY] (デフォルト)

読み取り設定

項目名	必須/省略可	変数の使用	説明	備考
ディレクトリーオプション	必須	使用不可	データ取得時のディレクトリーの扱いを選択します。 [無視] (デフォルト) ディレクトリーについては無視し、転送を行いません。また結果となるリストにもディレクトリーの情報は含まれません。 [再帰的] 指定した階層のファイル/ディレクトリーについて、再帰的にダウンロードします。
日付オプション	必須	使用不可	日付情報を含めるかどうかを選択します。 [含めない] (デフォルト) 結果に日付情報を含めません。 [含める] 結果に日付情報を含めます。
ファイルを転送する際に更新を確認	省略可	使用不可	ファイルを転送する際にローカルファイルの更新確認を行うかどうかを選択します。 [チェックあり] (デフォルト) [更新する際の条件]で指定した条件に適合した場合のみ転送を行います。 [チェックなし] 強制的に転送します。
更新する際の条件	必須	使用不可	ファイルを更新する際の条件を選択します。 [更新日時] (デフォルト) FTPサーバー側のファイルの更新日時とHULFT Square ストレージ側の更新日時を比較して、FTPサーバー側のファイルが新しい場合には転送します。注意 FTPサーバーがMDTMコマンドをサポートしている必要があります。 FTPサーバー側にファイルが多数存在すると、ファイルの日時比較処理によってCPUやメモリの負荷が高くなる場合があります。 [存在] HULFT Square ストレージ側のパスにファイル/ディレクトリーが存在しない場合に転送します。	[ファイルを転送する際に更新を確認]にチェックを入れた場合、有効になります。

項目名	必須/省略可	変数の使用	説明	備考
コメント	省略可	使用不可	このコネクターの簡単な説明を記述することができます。

スキーマ

入力スキーマ

ありません。

出力スキーマ

<?xml version="1.0"?>
<ftpserver name="" port="" user="">
  <pathnames>
    <pathname date="" filetype="" local="" remote="" size="" status="" type=""/>
  </pathnames>
</ftpserver>

要素名	属性名	説明	備考
ftpserver	-
	name	接続したFTPサーバーのホスト名を出力します。
	port	接続したFTPサーバーのポート番号を出力します。
	user	FTPサーバーに接続する際に使用したユーザ名を出力します。
pathnames	-
pathname	-	取得したファイル/ディレクトリーごとに出現します。
	date	取得したファイルの最終更新日時をyyyyMMddHHmmss形式で出力します。例: 「20071016131522」は2007年10月16日午後1時15分22秒を示しています。	注意 [日付オプション]が[含める]の場合のみ取得します。ディレクトリーの場合は空データとなります。
	filetype	取得したファイル/ディレクトリーのファイルタイプを出力します。 File ファイル Directory ディレクトリー
	local	取得したファイル/ディレクトリーのHULFT Square ストレージ上の絶対パスを出力します。
	remote	取得したファイル/ディレクトリーのFTPサーバー上の絶対パスを出力します。
	size	取得したファイルのサイズを出力します。単位はバイトです。	注意ディレクトリーの場合は空データとなります。
	status	ダウンロード状態を出力します。 Updated ダウンロードされ、HULFT Square ストレージ上のファイルが更新された状態です。 Uptodated ダウンロードされなかった状態です。[更新する際の条件]に[更新日時]を選択し、FTPサーバー上の対象ファイルがHULFT Square ストレージ上のファイルよりも新しくなかった場合に出力されます。 Exists ダウンロードされなかった状態です。[更新する際の条件]に[存在]を選択し、FTPサーバー上の対象ファイルがHULFT Square ストレージ上に存在した場合に出力されます。 NG エラーが発生したため、ダウンロードされなかった状態です。
	type	データの種類を出力します。 ASCII ASCII形式でダウンロードした場合に出力されます。 BINARY BINARY形式でダウンロードした場合に出力されます。	注意ディレクトリーの場合は空データとなります。

Mapperでのスキーマ読み込み

スキーマは自動で読み込まれます。

= 備考 =

詳細については、「スキーマ編集」を参照してください。

大容量データ処理

大容量データ処理には対応していません。

PSPでの使用について

PSPでは使用できません。

使用できるコンポーネント変数

コンポーネント変数名	説明	備考
count	読み取ったファイル/ディレクトリーの数が格納されます。	デフォルト値はnullです。「directory_count」と「file_count」の合計です。
directory_count	読み取ったディレクトリーの数が格納されます。	デフォルト値はnullです。
file_count	読み取ったファイルの数が格納されます。	デフォルト値はnullです。
message_category	エラー発生時、発生したエラーに対応するメッセージコードのカテゴリが格納されます。	デフォルト値はnullです。
message_code	エラー発生時、発生したエラーに対応するメッセージコードのコードが格納されます。	デフォルト値はnullです。
message_level	エラー発生時、発生したエラーに対応するメッセージコードの重要度が格納されます。	デフォルト値はnullです。
error_type	エラー発生時、発生したエラーの種類が格納されます。	デフォルト値はnullです。エラーの種類は、以下のような形式となります。例:「java.io.FileNotFoundException」
error_message	エラー発生時、発生したエラーのメッセージが格納されます。	デフォルト値はnullです。
error_trace	エラー発生時、発生したエラーのトレース情報が格納されます。	デフォルト値はnullです。

メッセージコード、例外メッセージ、制限事項

コネクター	メッセージコード	例外メッセージ	制限事項
FTP コネクターのメッセージおよび制限事項