# tFileInputExcelの標準プロパティ

これらのプロパティは、標準ジョブのフレームワークで実行されているtFileInputExcelを設定するために使われます。

標準のtFileInputExcelコンポーネントは、ファイルファミリーに属しています。

このフレームワーク内のコンポーネントは、すべてのTalend製品で利用できます。

## 基本設定

| [Property type] (プロパティタイプ) | [Built-in] (組み込み)と[Repository] (リポジトリー)のいずれかです。 |
| --- | --- |
|  | [Built-In] (組み込み): 一元的に保存されるプロパティデータはありません。 |
|  | [Repository] (リポジトリー): プロパティを保存するリポジトリーファイルを選択します。次のフィールドは、取得したデータを使用して自動的に完了されます。 |
| ![](https://help.qlik.com/talend/ja-JP/components/7.3/Resources/images/Save_Icon.png) | このアイコンをクリックすると、接続ウィザードが開き、コンポーネント[Basic settings] (基本設定)ビューに設定したExcelファイル接続パラメーターが保存されます。<br><br>ファイル接続パラメーターの設定と保存の詳細は、 *Talend Studioユーザーガイド*を参照してください。 |
| [Read excel2007 file format (xlsx / xlsm)] (Excel 2007ファイル形式(xlsx / xlsm)を読み取る) | Excel 2007の.xlsxまたは.xlsmファイルを読み取るには、このチェックボックスをオンにします。 |
| [File Name/Stream] (ファイル名/ストリーム) | [File name] (ファイル名): 処理するファイルまたは変数の名前。<br><br>[Stream] (ストリーム): 処理されるデータフロー。オートコンプリートリスト([Ctrl] + [Space])のINPUT\_STREAM変数を使ってtFileInputExcelによってデータが収集されるように、データをフローに追加する必要があります。<br><br>ジョブで変数を定義して使う方法は、 *Talend Studioユーザーガイド*をご覧ください。<br><br>情報メモ警告: エラーを避けるために、このフィールドには(相対パスの代わりに)絶対パスを使用します。 |
| [Password] (パスワード) | このフレームの横にある[...]ボタンをクリックして、Excelファイルに設定したパスワードを二重引用符で囲みます。<br><br>このフィールドは、パスワードで保護されたExcel 2007(およびそれ以降のバージョン)ファイル用であり、 [Read Excel 2007 file format (xlsx)] (Excel 2007ファイル形式(xlsx)を読み取る)が選択されている場合に使えます。<br><br>このコンポーネントは、標準の暗号化とアジャイル暗号化をサポートしています。 |
| [All sheets] (すべてのシート) | Excelファイルのすべてのシートを処理するには、このチェックボックスをオンにします。 |
| [Sheet list] (シートリスト) | [+]ボタンをクリックして、処理するExcelシートのリストに必要な数の行を追加します。<br><br>[Sheet (name or position)] (シート(名前または位置)): 処理するExcelシートの名前または位置を入力します。<br><br>正規表現を使用する: 正規表現を使用して処理するシートをフィルタリングする場合は、このチェックボックスをオンにします。 |
| [Header] (ヘッダー) | ファイルの先頭でスキップする行の数を入力します。<br><br>ダイナミックスキーマを使用する場合、ヘッダーフィールド値が設定されているかどうかに関係なく、入力データの最初の行が常にヘッダー行として扱われることにご注意ください。ダイナミックスキーマの詳細は、*Talend Studio* *ユーザーガイド*をご覧ください。 |
| [Footer] (フッター) | ファイルの最後にスキップするレコード数。 |
| [Limit] (制限) | 処理される行の最大数。 |
| [Affect each sheet(header&footer)] (各シートに影響(ヘッダー&フッター)) | [Header] (ヘッダー)フィールドと[Footer] (フッター) フィールドで設定したパラメーターを、処理するすべてのExcelシートに適用する場合は、このチェックボックスをオンにします。<br><br>情報メモ注: このオプションは、[Advanced settings] (詳細設定)ビューの[Generation mode] (生成モード)ドロップダウンリストから[Memory-consuming (User mode) [メモリ消費(ユーザーモード))を選択した場合にのみ使えます。 |
| [Die on error] (エラー発生時に強制終了) | このチェックボックスをオンにすると、エラー発生時にジョブの実行が停止されます。エラーの発生した行をスキップし、エラーが発生していない行の処理を完了するには、このチェックボックスをオフにします。必要に応じてRow &gt; Rejectリンクを使用してエラー発生時に行を収集できます。 |
| [First column] (最初のカラム)と[Last column] (最後のカラム) | [First column] (最初のカラム)フィールド と[Last column] (最後のカラム)フィールドでそれぞれ最初と最後のカラムを設定することにより、処理するカラムの範囲を定義します。 |
| [Schema] (スキーマ)と[Edit schema] (スキーマを編集) | スキーマとは行の説明で、処理された後に次のコンポーネントに渡されるフィールドの数を定義するものです。スキーマは[Built-in] (組み込み)か、[Repository] (リポジトリー)にリモートで保存されます。<br><br><ul> <li> <span>[Built-in] (組み込み)</span>: このコンポーネントに対してのみ作成されたスキーマがローカルに保管されます。関連項目:<em><span>Talend Studio</span>ユーザーガイド</em>をご覧ください。</li> <li> <span>[Repository] (リポジトリー)</span>: スキーマは既に存在し、リポジトリーに保管されているため、さまざまなプロジェクトやジョブフローチャートで再利用できます。関連項目: 『<em> <span>Talend Studio</span>ユーザーガイド</em>』をご覧ください。</li> </ul><br><br>このコンポーネントは、ダイナミックスキーマ機能の利点を備えているので、ソースファイルから不明なカラムを取得したり、各カラムを個別にマッピングしなくてもソースからカラムを一括してコピーしたりできます。ダイナミックスキーマの詳細は、*Talend Studio* *ユーザーガイド*をご覧ください。<br><br>このダイナミックスキーマ機能は、テーブルの不明なカラムを取得する目的で設計されており、この目的に限り使用をお勧めします。テーブルの作成で使用することは勧められていません。<br><br>情報メモ注: ダイナミックスキーマ機能を使用している場合は、スキーマエディターの[Date Pattern] (日付パターン)フィールドで、ダイナミックカラムに日付パターンが設定されていることを確認してください。ダイナミックカラムのデフォルトの日付パターンは、dd-MM-yyyyです。<br><br>スキーマを変更するには[Edit schema] (スキーマを編集)をクリックします。現在のスキーマがリポジトリータイプの場合は、3つのオプションを利用できます。<br><br><ul> <li> <p> <span>[View schema] (スキーマを表示)</span>: スキーマのみを表示する場合は、このオプションを選択します。</p> </li> <li> <p> <span>[Change to built-in property] (組み込みのプロパティに変更)</span>: ローカルで変更を行うためにスキーマを<span>組み込み</span>に変更する場合は、このオプションを選択します。</p> </li> <li> <p> <span>[Update repository connection] (リポジトリー接続をアップデート)</span>: リポジトリーに保存されているスキーマに変更を加え、変更後にそのコンテンツをすべてのジョブにプロパゲートするかどうかを決める場合は、このオプションを選択します。変更を現在のジョブにのみ反映する場合は、変更後、<span>[No] (いいえ)</span>を選択し、<span>[Repository Content] (リポジトリーコンテンツ)</span>ウィンドウで再びこのスキーマのメタデータを選択します。</p> </li> </ul> |

## 詳細設定

| [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)を読み取る]が選択されている場合に使えます。<br><br>このチェックボックスをオンにすると、[Check need convert date column] (チェックが必要な変換日付カラム)が表示されます 。ここでは、指定された日付パターンに基づいて日付値を含む文字列カラムを解析できます。<br><br>[Column] (カラム): ソース.xlsxファイルのスキーマで使用可能なすべてのカラム。<br><br>[Convert] (変換): このチェックボックスをオンにすると、すべてのカラムを変換の対象として選択できます(すべてが文字列型の場合のみ)。変換する各カラムの横にある個別のチェックボックスをオンにすることもできます。<br><br>[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ファイルの読み取りに使うモードを選択します。<br><br><ul> <li> <p> <span>[Less memory consumed for large excel(Event mode)] (大きなExcelで消費されるメモリを少なくする(イベントモード))</span>: 大きなファイルに使われます。これは、Excel 2007ファイルをフローとして読み取るためのメモリ節約モードです。このオプションは、大きなExcelファイルを読み取る時のメモリ消費量が多いためのメモリ不足エラーによるジョブの失敗を防ぐのに役立ちます。</p> <p>このモードを選択すると、パーセント記号%や通貨記号$などの形式記号でデータが抽出されます。さらに、インデックスでふりがなを使用できるように、<span>[Include phonetic runs] (ふりがなを含む)</span>チェックボックスがデフォルトでオンになっています。</p> </li> <li> <p> <span>[Memory-consuming (User mode)] (メモリを消費する(ユーザーモード))</span>: 小さなファイルに使われます。多くのメモリが必要です。このモードを選択すると、フォーマット記号のない純粋なデータが抽出されます。</p> </li> </ul> |
| [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)を読み取る)を選択すると、このチェックボックスは使えなくなります。 |
| [tStatCatcher Statistics] (tStatCatcher統計) | このチェックボックスを選択すると、ジョブレベルやコンポーネントレベルでジョブ処理メタデータが収集されます。 |

## グローバル変数

| グローバル変数 | NB\_LINE: 処理された行の数。これはAfter変数で、整数を返します。<br><br>CURRENT\_SHEET: 処理されているシートの名前。これはFlow変数で、文字列を返します。<br><br>ERROR\_MESSAGE: エラーが発生した時にコンポーネントによって生成されるエラーメッセージ。これはAfter変数で、文字列を返します。この変数はコンポーネントにこのチェックボックスが存在し、[Die on error] (エラー発生時に強制終了)がオフになっている場合のみ機能します。<br><br>Flow変数はのコンポーネントの実行中に機能し、After変数はコンポーネントの実行後に機能します。<br><br>フィールドまたは式に変数を入れるには、Ctrl + スペースを押して変数リストにアクセスし、リストから使用する変数を選択します。<br><br>変数の詳細は、*Talend Studio* *ユーザーガイド*をご覧ください。 |
| --- | --- |

## 使用方法

| **使用ルール** | このコンポーネントを使ってExcelファイルを読み取り、ファイルで識別されたスキーマに応じてデータを個別に出力します。[Row] (行) &gt; [Reject] (リジェクト)リンクを使って、定義されたタイプに対応しないデータをフィルタリングできます。これら2つのリンクの使用方法の例については、[手順](https://help.qlik.com/talend/ja-JP/components/7.3/processing/textractxmlfield-tlogrow-tfileinputdelimited-tfileoutputdelimited-procedure-standard-component-drop)をご覧ください。 |
| --- | --- |
| 制限事項 | ライセンスの互換性の問題のため、このコンポーネントの使用に必要な1つ以上のJARが提供されていません。この特定のコンポーネントに不足しているJARをインストールするには、Component (コンポーネント)タブビューの[Install] (インストール)ボタンをクリックします。Studioの Integration パースペクティブの[Modules] (モジュール)タブでも、不足しているすべてのJARを簡単に見つけて追加できます。詳細は、*外部モジュールのインストール*をご覧ください。外部モジュールをインストールする方法は、Talend Help Center ([https://help.talend.com](https://help.talend.com/) (英語のみ))をご覧ください。 |