UnzipFile - Zipファイルの展開
Zipファイルを展開します。
■ストリーム情報
| 入力 | フォーマット | すべて |
|---|---|---|
| 接続数 | 1 | |
| 説明 | すべてのストリームを入力できます。 | |
| 出力 | フォーマット | すべて |
| 説明 | 入力ストリームをそのまま出力します。 |
■コンポーネントプロパティ
| 名前 | プロパティ型 | マッピング | 説明 | ||||||
|---|---|---|---|---|---|---|---|---|---|
| ZIPファイルパス | remoteFile | 入力＆出力 |
展開するZip形式ファイルのパスを指定します。フォルダーが指定された場合は、そのフォルダー下のすべてのZipファイルを展開します。
UNIXシステムの場合は、パス名は接頭辞が "/" の場合に絶対パスとみなします。Windowsシステムの場合は、パス名は接頭辞がドライブ指示子のあとに "\\" が続く場合、または接頭辞が "\\" の場合に絶対パスとみなします。 相対パスで指定した場合は、相対パスの起点 で指定したホームからの相対になります。 「**」と「*」と「?」の3つのワイルドカードが使用できます。「**」は0個以上の任意のパスセグメントに、「*」は0個以上の任意の文字に、「?」は任意の1文字にマッチします。 例： directory/file.txt C:\directory\file.txt \\server\share\file.txt **/*.txt - 相対パスの起点 以下のすべての「*.txt」ファイル C:\directory\*.txt - C:\directory直下の「*.txt」ファイル |
||||||
| 展開先フォルダーパス | remoteFile | 入力＆出力 |
展開後にファイル、フォルダーを保存するフォルダーのパスを指定します。
UNIXシステムの場合は、パス名は接頭辞が "/" の場合に絶対パスとみなします。Windowsシステムの場合は、パス名は接頭辞がドライブ指示子のあとに "\\" が続く場合、または接頭辞が "\\" の場合に絶対パスとみなします。 相対パスで指定した場合は、相対パスの起点 で指定したホームからの相対になります。 |
||||||
| ファイル名のエンコーディング | choice | 入力＆出力 | ファイル名のエンコーディング種別を指定します。 | ||||||
| ファイルパスの詳細設定 | group | - | ファイルパスの詳細設定を行うプロパティ群です。 | ||||||
| 相対パスの起点 | pathResolver | - |
相対パス指定の場合にベースフォルダーを指定します。
|
||||||
| 絶対パスを許可 | boolean | - | 絶対パスを許可するかどうか選択します。 | ||||||
| 「..」を許可 | boolean | - | 上のフォルダへ移動する記述に「..」を許可するかどうか選択します。 | ||||||
| ファイル名のパターン | string | 入力＆出力 |
特定のファイルのみZip形式ファイルから展開する場合に、ファイル名を指定します。
「*」と「?」の2つのワイルドカードを使用してファイルを指定することができます。「*」は0個以上の任意の文字に、「?」は任意の1文字にマッチします。 |
||||||
| パスワード | password | 入力＆出力 | 展開するZip形式ファイルが暗号化されている場合のパスワードを指定します。 | ||||||
| 上書き処理 | choice | 入力＆出力 |
展開先に同名のファイルが既に存在した場合の動作を指定します。
|
||||||
| ZIPファイルを削除 | boolean | 入力＆出力 |
展開後にZipファイルを削除するかどうかを指定します。
|
■トランザクション処理
| コミット | 何もしません。 |
|---|---|
| ロールバック | 何もしません。 |
■エラー処理
| タイプ | パラメーター | エラー処理フロー
へのストリーム | エラー
コード | 説明 |
|---|---|---|---|---|
| ZIPファイルが存在しない | なし | コンポーネントの入力ストリーム | 2 | ZIPファイルパス で指定したZipファイルが見つからなかった場合 |
| 展開先ファイルが既に存在する | なし | コンポーネントの入力ストリーム | 3 | 展開先のファイルがZipファイルと種別(フォルダー or ファイル)の異なるファイルとして存在していた場合 |
| 汎用 | なし | コンポーネントの入力ストリーム | 4 | 展開先フォルダーパス で指定したフォルダーが存在せず、作成もできなかった場合 |
| 5 | ZIPファイルパス で指定したZipファイルの展開ができなかった場合。ファイル形式の誤り、パスワードの誤りなど。 | |||
| 6 | ファイル名のエンコーディングが不正な場合 | |||
| 9 | ファイルパスの指定が誤っている場合や、相対パスの起点 が「実行ユーザーのホームフォルダー」の場合に、実行ユーザーが存在しないため相対パスが解決できなかった場合 | |||
| 10 | その他のIOException。
一部のファイルのみ展開に成功し、途中でエラーになることがあります。 |