tFileOutputExcelの標準プロパティ

[Write Excel 2007 file format (xlsx / xlsm)] (Excel 2007ファイル形式(xlsx/ xlsm)で書き込む)

このチェックボックスをオンにすると、処理されたデータがExcel 2007の.xlsxまたは .xlsm 形式で書き込まれます。

[Use Output Stream] (出力ストリームを使用)

目的のデータフローを処理する場合は、このチェックボックスをオンにします。これを選択すると、[Output Stream] (出力ストリーム)フィールドが表示され、目的のデータフローを入力できます。

対応する代表変数により、コンポーネントでデータを取得できるようにするには、処理するデータフローを追加する必要があります。

この変数は、既にStudio Talendで事前に定義されているか、このコンポーネントと共に使用されているコンテキストやコンポーネントによって提供されている可能性があります。それ以外の場合は、手動で変数を定義し、ジョブのデザインに応じて(たとえばtJavaまたはtJavaFlexを使って)使用できます。

手入力の手間を省くため、変数が適切に定義されることを確認する必要があるものの、予測変換リスト([Ctrl] + [Space])から目的の変数を選択して、現在のフィールドに入力できます。

ストリームの使用方法は、ストリーミングモードでのリモートファイルからのデータの読み取りをご覧ください。

[File name] (ファイル名)

出力ファイルの名前またはパス。

[Use Output Stream] (出力ストリームを使用)チェックボックスをオンにすると、このフィールドは使用できなくなります。

ジョブで変数を定義して使用する方法は、コンテキストと変数を使用をご覧ください。

シート名

XSLシートの名前。

[Include header] (ヘッダーを含める)

ヘッダー行を出力ファイルに含めるには、このチェックボックスをオンにします。

[Append existing file] (既存のファイルを追加)

このチェックボックスをオンにすると、ファイルの最後に新しい行が追加されます。

[Append existing sheet] (既存のシートを追加する): Excelシートの最後に新しい行を追加するには、このチェックボックスをオンにします。

絶対Y位置です。

指定したセルに情報を追加するには、このチェックボックスをオンにします。

[First cell X] (最初のセルX): X軸上のセルの位置(X座標または横座標)。

[First cell Y] (最初のセルY): Y軸上のセルの位置(Y座標)。

[Keep existing cell format] (既存のセル形式を保持): 書き込むセルの元のレイアウトとフォーマットを保持するには、このチェックボックスをオンにします。

[Font] (フォント)

使用するフォントをリストから選択します。

[Define all columns auto size] (全カラムの自動サイズを定義する)

すべてのカラムのサイズを自動的に定義する場合は、このチェックボックスをオンにします。それ以外の場合は、サイズを自動的に定義するカラム名の横にある[Auto size] (自動サイズ) チェックボックスをオンにします。

[Protect file] (ファイルを保護する)

パスワードを使ってファイルを保護するには、このチェックボックスをオンにして、[Password] (パスワード)フィールドにパスワードを入力します。

このコンポーネントは、アジャイル暗号化(現在はAES 128アルゴリズムを使用)を使ってファイルを暗号化します。アジャイル暗号化の詳細は、Apache POI - Encryption supportとEncryptionをご覧ください。

このオプションは、[Write excel2007 file format(xlsx)] (excel2007ファイル形式(xlsx)で書き込む)が選択されていて、[Use Output Stream] (出力ストリームを使う)が選択されていない場合に使えます。

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

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

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

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

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

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

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

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

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

[Built-in] (組み込み): このコンポーネントに対してのみ作成されたスキーマがローカルに保管されます。[Basic settings] (基本設定)タブにあるコンポーネントスキーマの詳細は、[Basic settings] (基本設定)をご覧ください。

[Repository] (リポジトリー): 既存のスキーマがリポジトリーに保管されているので、さまざまなプロジェクトやジョブデザインで再利用できます。[Basic settings] (基本設定)タブにあるコンポーネントスキーマの詳細は、[Basic settings] (基本設定)をご覧ください。

[Create directory if not exists] (ディレクトリーがない場合はディレクトリーを作成)

このチェックボックスはデフォルトで選択されています。このオプションは、出力ファイルが存在しない場合は、出力ファイルを保持するディレクトリーを作成します。

フラッシュバッファーサイズのカスタマイズ

[Row number] (行番号)フィールドにバッファーで許可される最大行数を設定するには、このチェックボックスをオンにします。

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

[Advanced separator (for numbers)] (詳細区切り文字: 数値)

数値に使う区切りを変更するには、このチェックボックスをオンにします。

[Thousands separator] (3桁区切り): 数字3桁の区切り文字を定義します。

[Decimal separator] (小数点区切り): 小数点の区切り文字を定義します。

[Truncate characters exceeding max cell length] (最大セル長を超えた文字は切り詰め)

文字列をセルにエクスポートする前に、セルに許可される最大長(32767文字)を超える文字列を切り詰めるには、このオプションを選択します。このオプションは、大量データを単一Excelセルへエクスポートすることによるジョブの失敗を防ぎます。また、このオプションによるデータ損失が発生する可能性があります。

このオプションは、Excel 2007 (およびそれ以降のバージョン)ファイル用であり、[Basic settings] (基本設定)ビューで [Write Excel 2007 file format (xlsx)] (Excel 2007ファイル形式(xlsx)で書き込む)が選択されている場合に使えます。

このオプションはデフォルトで選択されていません。

Encoding

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

[Recalculate formula] (式を再計算)

指定したExcelファイルの数式を再計算する必要がある場合は、このチェックボックスをオンにします。

このチェックボックスは、[Write Excel 2007 file format (xlsx)] (Excel 2007ファイル形式(xlsx)で書き込む)、[Append existing file] (既存のファイルを追加)、および [Append existing sheet] (既存のシートを追加)の 3つのチェックボックスをすべてオンにした場合にのみ表示されます。

ストリーミングモードで既存のExcel 2007ファイルにデータを書き込む場合は、このオプションを選択します。制限されたメモリで大量のデータを書き込む場合はこのオプションを選択します。

このオプションは、[Basic settings] (基本設定)ビューで[Write Excel 2007 file format (xlsx)] (Excel 2007ファイル形式(xlsx)で書き込む)オプションと[Append existing file] (既存のファイルを追加)オプションが選択されている場合に使えます。

このオプションは、パフォーマンスとファイルサイズのトレードオフを実現します。重複文字列が数多く含まれているXLSXファイルを作成する時に、問題なく動作します。このオプションは、[Basic settings] (基本設定)ビューで[Write Excel 2007 file format (xlsx)] (Excel 2007ファイル形式(xlsx)で書き込む)オプションが選択され、[Append existing file] (既存のファイルを追加)オプションが選択されていない場合に使用できます。

スキーマに動的カラムが含まれており、コンポーネントがメモリ消費モードで動作する場合、1904という日付形式は無視されます。

[tStatCatcher Statistics] (tStatCatcher統計)

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

グローバル変数

NB_LINE: 入力コンポーネントによって読み取られた行の数、または出力コンポーネントに転送された行の数。これはAfter変数で、整数を返します。

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

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

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

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

使用ルール

このコンポーネントは、[Row] (行)リンクを使って他のコンポーネントから渡されたデータを含むMS Excelファイルを作成するために使います。

[Dynamic settings] (ダイナミック設定)

[+]ボタンをクリックしてテーブルに行を追加し、[Code] (コード)フィールドにコンテキスト変数を入力して、ジョブ内で計画した複数の接続からHDFS接続をダイナミックに選択します。この機能は、異なるHDFSシステムまたは異なるディストリビューション内のファイルにアクセスする必要がある場合、特に、 Studio Talend を介さずにジョブをデプロイおよび実行する必要がある時など、ジョブの設定を変更できない環境で作業している場合に役立ちます。

[Dynamic settings] (ダイナミック設定)テーブルは、[Basic settings] (基本設定)ビューで[Use an existing connection] (既存の接続を使用)チェックボックスがオンになっている場合のみ利用できます。ダイナミックパラメーターを定義すると、[Basic settings] (基本設定)ビューの[Component List] (コンポーネントリスト)ボックスは利用できなくなります。

ダイナミックパラメーターの定義法を示すユースケースについては、コンテキストベースのダイナミック接続によってデータベースからデータを読み取りと、ダイナミックにロードされた接続パラメーターを使って異なるMySQLデータベースからデータを読み取りをご覧ください。ダイナミック設定とコンテキスト変数の詳細は、ダイナミックスキーマとコンテキストグループを作成し、その中でコンテキスト変数を定義をご覧ください。

制限事項

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