tFileInputExcelの標準プロパティ

[Property type] (プロパティタイプ)

[Built-in] (組み込み)と[Repository] (リポジトリー)のいずれかです。

• [Built-In] (組み込み): 一元的に保存されるプロパティデータはありません。

• [Repository] (リポジトリー): プロパティを保存するリポジトリーファイルを選択します。次のフィールドは、取得したデータを使用して自動的に完了されます。

このアイコンをクリックすると、接続ウィザードが開き、コンポーネント[Basic settings] (基本設定)ビューに設定したExcelファイル接続パラメーターが保存されます。

ファイル接続パラメーターの設定と保存の詳細は、接続パラメーターを設定をご覧ください。

[Read excel2007 file format (xlsx)] (Excel 2007ファイル形式(xlsx)を読み取る)

Excel 2007の.xlsxまたは.xlsmファイルを読み取るには、このチェックボックスをオンにします。

[File Name/Stream] (ファイル名/ストリーム)

[File name] (ファイル名): 処理するファイルまたは変数の名前。

[Stream] (ストリーム): 処理されるデータフロー。オートコンプリートリスト([Ctrl] + [Space])のINPUT_STREAM変数を使ってtFileInputExcelによってデータが収集されるように、データをフローに追加する必要があります。

ジョブでの変数の定義と使い方は、ジョブまたはルートで変数を使用をご覧ください。

[Password] (パスワード)

このフレームの横にある[...]ボタンをクリックして、Excelファイルに設定したパスワードを二重引用符で囲みます。

このフィールドは、パスワードで保護されたExcel 2007(およびそれ以降のバージョン)ファイル用であり、 [Read Excel 2007 file format (xlsx)] (Excel 2007ファイル形式(xlsx)を読み取る)が選択されている場合に使えます。

このコンポーネントは、標準の暗号化とアジャイル暗号化をサポートしています。

[All sheets] (すべてのシート)

Excelファイルのすべてのシートを処理するには、このチェックボックスをオンにします。

[Sheet list] (シートリスト)

[+]ボタンをクリックして、処理するExcelシートのリストに必要な数の行を追加します。

[Sheet (name or position)] (シート(名前または位置)): 処理するExcelシートの名前または位置を入力します。

正規表現を使用する: 正規表現を使用して処理するシートをフィルタリングする場合は、このチェックボックスをオンにします。

[Header] (ヘッダー)

ファイルの先頭でスキップする行の数を入力します。

ダイナミックスキーマを使用する場合、ヘッダーフィールド値が設定されているかどうかに関係なく、入力データの最初の行が常にヘッダー行として扱われることにご注意ください。ダイナミックスキーマの詳細は、ダイナミックスキーマをご覧ください。

[Footer] (フッター)

ファイルの最後にスキップするレコード数。

[Limit] (制限)

処理される行の最大数。

[Affect each sheet(header&footer)] (各シートに影響(ヘッダー&フッター))

[Die on error] (エラー発生時に強制終了)

このチェックボックスをオンにすると、エラー発生時にジョブの実行が停止されます。エラーの発生した行をスキップし、エラーが発生していない行の処理を完了するには、このチェックボックスをオフにします。必要に応じてRow > Rejectリンクを使用してエラー発生時に行を収集できます。

[First column] (最初のカラム)と[Last column] (最後のカラム)

[First column] (最初のカラム)フィールド と[Last column] (最後のカラム)フィールドでそれぞれ最初と最後のカラムを設定することにより、処理するカラムの範囲を定義します。

[Schema] (スキーマ)および[Edit schema] (スキーマを編集)

スキーマとは行の説明で、処理された後に次のコンポーネントに渡されるフィールドの数を定義するものです。スキーマは[Built-in] (組み込み)か、[Repository] (リポジトリー)にリモートで保存されます。

• [Built-in] (組み込み): このコンポーネントに対してのみ作成されたスキーマがローカルに保管されます。
• [Repository] (リポジトリー): スキーマは既に存在し、リポジトリーに保管されているため、さまざまなプロジェクトやジョブフローチャートで再利用できます。

このコンポーネントは、ダイナミックスキーマ機能の利点を備えているので、ソースファイルから不明なカラムを取得したり、各カラムを個別にマッピングしなくてもソースからカラムを一括してコピーしたりできます。ダイナミックスキーマの詳細は、ダイナミックスキーマをご覧ください。

ダイナミックスキーマ機能は、テーブルの不明なカラムを取得するしくみになっており、その他の目的には使用しないことをお勧めします。テーブルの作成には推奨しません。

スキーマを変更するには[Edit schema] (スキーマを編集)をクリックします。現在のスキーマがリポジトリータイプの場合は、3つのオプションを利用できます。

• [View schema] (スキーマを表示): スキーマのみを表示する場合は、このオプションを選択します。

• [Change to built-in property] (組み込みのプロパティに変更): ローカルで変更を行うためにスキーマを組み込みに変更する場合は、このオプションを選択します。

• [Update repository connection] (リポジトリー接続をアップデート): リポジトリーに保存されているスキーマに変更を加え、変更後にそのコンテンツをすべてのジョブにプロパゲートするかどうかを決める場合は、このオプションを選択します。

  変更を現在のジョブにのみ反映する場合は、変更後、[No] (いいえ)を選択し、[Repository Content] (リポジトリーコンテンツ)ウィンドウで再びこのスキーマのメタデータを選択します。

[Advanced separator] (高度な区切り)

このチェックボックスをオンにすると、データの区切りを変更できます。

すべてのカラムをトリム

このチェックボックスを選択すると、先行ホワイトスペースおよび後続ホワイトスペースがすべてのカラムから削除されます。このチェックボックスをオフにすると、[Check column to trim] (トリミングするカラムをチェック)テーブルが表示され、トリミングする特定のカラムを選択できます。

[Check columns to trim] (トリミングするカラムをチェック)

このテーブルは使用されているスキーマで自動入力されます。トリミングするカラムに対応するチェックボックスをオンにします。

[Convert date column to string] (日付カラムを文字列に変換)

[Basic settings] (基本設定)ビューで[Read Excel 2007 file format (xlsx) (Excel 2007ファイル形式(xlsx)を読み取る]が選択されている場合に使えます。

このチェックボックスをオンにすると、[Check need convert date column] (チェックが必要な変換日付カラム)が表示されます 。ここでは、指定された日付パターンに基づいて日付値を含む文字列カラムを解析できます。

[Column] (カラム): ソース.xlsxファイルのスキーマで使用可能なすべてのカラム。

[Convert] (変換): このチェックボックスをオンにすると、すべてのカラムを変換の対象として選択できます(すべてが文字列型の場合のみ)。変換する各カラムの横にある個別のチェックボックスをオンにすることもできます。

[Date pattern] (日付パターン): ここで日付形式を設定するために使われます。

[Encoding] (エンコーディング)

リストからエンコーディングを選択するか、[CUSTOM] (カスタム)を選択して、手動で定義します。このフィールドはデータベースのデータ処理で必須です。

[Read real values for numbers] (数値の実際の値を読み取る)

このチェックボックスをオンにすると、数値が実際の値で読み取られます。[Basic settings] (基本設定)ビューで[Read Excel 2007 file format (xlsx)] (Excel 2007ファイル形式(xlsx)を読み取る)を選択すると、このチェックボックスは使えなくなります。

[Stop reading on encountering empty rows] (空の行に遭遇した時に読み取りを停止する)

このチェックボックスをオンにすると、検出された空行が無視されます。空の行がある場合は、この空の行に続く行も無視されます。[Basic settings] (基本設定)ビューで[Read Excel 2007 file format (xlsx)] (Excel 2007ファイル形式(xlsx)を読み取る)を選択すると、このチェックボックスは使えなくなります。

Generation mode (生成モード)

[Basic settings] (基本設定)ビューで[Read Excel 2007 file format (xlsx) (Excel 2007ファイル形式(xlsx)を読み取る]が選択されている場合に使えます。Excel 2007ファイルの読み取りに使うモードを選択します。

• [Less memory consumed for large excel(Event mode)] (大きなExcelで消費されるメモリを少なくする(イベントモード)): 大きなファイルに使われます。これは、Excel 2007ファイルをフローとして読み取るためのメモリ節約モードです。このオプションは、大きなExcelファイルを読み取る時のメモリ消費量が多いためのメモリ不足エラーによるジョブの失敗を防ぐのに役立ちます。

  このモードを選択すると、参照変数がパーセント記号%や通貨記号$などの形式記号で抽出されます。さらに、インデックスでふりがなを使用できるように、[Include phonetic runs] (ふりがなを含む)チェックボックスがデフォルトでオンになっています。イベントモードは主な目的であるメモリ節約モードなので、メモリとCPU時間を節約するためにセル形式がいくつか失われます。

• [Memory-consuming (User mode)] (メモリを消費する(ユーザーモード)): 小さなファイルに使われます。多くのメモリが必要です。このモードを選択すると、フォーマット記号のない純粋なデータが抽出されます。

[Don't validate the cells] (セルを検証しない)

データを検証しないようにするには、このチェックボックスをオンにします。[Basic settings] (基本設定)ビューで[Read Excel 2007 file format (xlsx)] (Excel 2007ファイル形式(xlsx)を読み取る)を選択すると、このチェックボックスは使えなくなります。

[Ignore the warning] (警告を無視する)

Excelファイルのエラーを示すために生成されたすべての警告を無視するには、このチェックボックスをオンにします。[Basic settings] (基本設定)ビューで[Read Excel 2007 file format (xlsx)] (Excel 2007ファイル形式(xlsx)を読み取る)を選択すると、このチェックボックスは使えなくなります。

[Set minimum inflation rate] (最小膨張率を設定)

高圧縮ファイル爆弾を検出するよう圧縮バイトと膨張バイトの比率を設定する場合は、このオプションを選択します。表示されるテキストボックスに新しい最小膨張率を入力します。関連情報は、https://poi.apache.org/apidocs/dev/org/apache/poi/openxml4j/util/ZipSecureFile.htmlでsetMinInflateRatioをご覧ください。

最小膨張率が不適切だと、Excelファイルを開こうとする時にZip bomb detected (高圧縮ファイル爆弾が検出されました)という例外が発生することがあります。このタイプの例外は、最小膨張率をより小さな値に設定すれば解消できます。

このオプションは、[Basic settings] (基本設定)ビューで[Read Excel 2007 file format (xlsx) (Excel 2007ファイル形式(xlsx)を読み取る]が選択されている場合に利用できます。

[tStatCatcher Statistics] (tStatCatcher統計)

このチェックボックスを選択すると、ジョブレベルやコンポーネントレベルでジョブ処理メタデータが収集されます。

グローバル変数

NB_LINE: 処理された行の数。これはAfter変数で、整数を返します。

CURRENT_SHEET: 処理されているシートの名前。これはFlow変数で、文字列を返します。

ERROR_MESSAGE: エラーが発生した時にコンポーネントによって生成されるエラーメッセージ。これはAfter変数で、文字列を返します。この変数はコンポーネントにこのチェックボックスが存在し、[Die on error] (エラー発生時に強制終了)がオフになっている場合のみ機能します。

Flow変数はのコンポーネントの実行中に機能し、After変数はコンポーネントの実行後に機能します。

フィールドまたは式に変数を入力する場合は、Ctrl + スペースを押して変数リストにアクセスし、使用する変数を選択します。

変数の詳細は、コンテキストと変数を使用をご覧ください。

使用ルール

このコンポーネントを使ってExcelファイルを読み取り、ファイルで識別されたスキーマに応じてデータを個別に出力します。[Row] (行) > [Reject] (リジェクト)リンクを使って、定義されたタイプに対応しないデータをフィルタリングできます。この2つのリンクを使用する方法の例は、手順をご覧ください。

ライセンスの互換性の問題のため、このコンポーネントの使用に必要な1つ以上のJARが提供されていません。この特定のコンポーネントに不足しているJARをインストールするには、Component (コンポーネント)タブビューの[Install] (インストール)ボタンをクリックします。Studio TalendのIntegrationパースペクティブにある[Modules] (モジュール)タブでも、不足しているすべてのJARを簡単に見つけて追加できます。詳細は、外部モジュールをインストールをご覧ください。