リストのみの読み取り処理

オペレーション名

リストのみの読み取り

機能概要

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

データモデル

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

プロパティ

= 備考 =

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

基本設定

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

必須設定

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

項目名

必須/省略可

変数の使用

説明

備考

接続先

必須

使用不可

コネクションリソースを選択します。

[追加]: 新規にコネクションリソースを追加します。
[一覧の編集]: > HULFT INTEGRATE > コネクションで、コネクションリソースの設定を編集することができます。

パス

必須

パスを指定します。

各列は以下のボタンで操作することができます。

[上へ]: 選択している列の順序を一つ上に上げます。
[下へ]: 選択している列の順序を一つ下に下げます。
[追加]: 列を追加します。
[削除]: 列を削除します。

パス/リモートパス

必須

使用可

FTPサーバー上のファイル/ディレクトリーを「/」から始まる絶対パスで入力します。

ファイル名にはワイルドカード(「*」・「?」)が使用できます。
- 例
  
  /upload/*.csv
  
  /uploadディレクトリー直下に存在する、拡張子がcsvのファイルが該当します。
- 例
  
  /upload/売り上げデータ??.xls
  
  uploadディレクトリー直下に存在する、「売り上げデータ」で始まり、そのあとに2文字続く拡張子がxlsのファイルが該当します。
大文字小文字を区別します。

読み取り設定

項目名	必須/省略可	変数の使用	説明	備考
ディレクトリーオプション	必須	使用不可	データ取得時のディレクトリーの扱いを選択します。 [指定階層のみ] (デフォルト) 指定した階層のみディレクトリー情報を取得します。 [再帰的] 指定した階層のディレクトリーについて、再帰的にダウンロードします。
日付オプション	必須	使用不可	日付情報を含めるかどうかを選択します。 [含めない] (デフォルト) 結果に日付情報を含めません。 [含める] 結果に日付情報を含めます。

項目名

必須/省略可

変数の使用

説明

備考

ディレクトリーオプション

必須

使用不可

データ取得時のディレクトリーの扱いを選択します。

[指定階層のみ]

(デフォルト)

指定した階層のみディレクトリー情報を取得します。

[再帰的]

指定した階層のディレクトリーについて、再帰的にダウンロードします。

日付オプション

必須

使用不可

日付情報を含めるかどうかを選択します。

[含めない]

(デフォルト)

結果に日付情報を含めません。

[含める]

結果に日付情報を含めます。

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

スキーマ

入力スキーマ

ありません。

出力スキーマ

<?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	常に空データが出力されます。
	remote	取得したファイル/ディレクトリーのFTPサーバー上の絶対パスを出力します。
	size	取得したファイルのサイズを出力します。単位はバイトです。	注意ディレクトリーの場合は空データとなります。
	status	常に空データが出力されます。
	type	常に空データが出力されます。

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 コネクターのメッセージおよび制限事項