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

オペレーション名

リストのみの読み取り

機能概要

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

データモデル

本コンポーネントのデータモデルはXML型です。
入出力のスキーマについては「スキーマ」を参照してください。

プロパティ

基本設定

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

必須設定

項目名 必須/省略可 変数の使用 説明 補足
接続先 必須 使用不可 グローバルリソースを選択します。
グローバルリソースの設定方法については「グローバルリソースのプロパティ」を参照してください。
  • [追加]:
    新規にグローバルリソースを追加します。
  • [一覧の編集]:
    「リソース一覧の編集」プロパティにて、グローバルリソースの設定を編集することができます。
 
パス 必須
-
パスを指定します。

各列は以下のボタンで操作することができます。
  • [追加]:
    列を追加します。
  • [上へ]:
    選択している列の順序を一つ上に上げます。
  • [下へ]:
    選択している列の順序を一つ下に下げます。
  • [削除]:
    列を削除します。
 
パス/リモートパス 必須 使用可 FTPサーバ側のパス名を"/"(スラッシュ)から始まる絶対パスで入力します。
  • ファイル名にはワイルドカード("*")が使用できます。
  • 大文字小文字を区別します。

読み取り設定

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

互換性

完全互換です。

コメント

項目名 必須/省略可 変数の使用 説明 補足
コメント 省略可 使用不可 このアダプタの簡単な説明を記述することができます。
説明を記述すると、仕様書に反映させることができます。
 

スキーマ

<?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 常に空データ

大容量データ処理

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

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

コンポーネント変数名 説明
count 取得したディレクトリ数とファイル数を合計した数を返します。
directory_count 取得したディレクトリ数を返します。
file_count 取得したファイル数を返します。
error_type エラーが発生したときに、エラーの種類を返します。
java.io.FileNotFoundExceptionというような形式で返されます。
エラーが発生しなかった時にはnullを返します。
バージョンにより、内容が変わる可能性があります。
error_message エラーが発生したときのエラーメッセージを返します。
バージョンにより、内容が変わる可能性があります。
error_trace エラーが発生したときのトレース情報を返します。
バージョンにより、内容が変わる可能性があります。

主な例外

例外名 原因 対策
ResourceNotFoundException
リソース定義が見つかりませんでした。名前:[]
[接続先]が指定されていません。 [接続先]を指定してください。
ResourceNotFoundException
リソース定義が見つかりませんでした。名前:[<グローバルリソース名>]
[接続先]で選択されたリソース定義が見つかりません。 [接続先]で指定したグローバルリソースを確認してください。
com.enterprisedt.net.ftp.FTPException FTPサーバが何らかのエラーを返した場合の例外です。 メッセージの内容を確認してください。
java.net.UnknownHostException 指定したFTPサーバが見つからない例外です。 FTPサーバの設定を確認してください。
java.net.ConnectException FTPサーバに接続できない例外です。 ポート番号、あるいは、FTPサーバが起動していることを確認してください。

注意事項