tFileOutputExcelの標準プロパティ - 7.3

Excel

Version
7.3
Language
日本語 (日本)
Product
Talend Big Data
Talend Big Data Platform
Talend Data Fabric
Talend Data Integration
Talend Data Management Platform
Talend Data Services Platform
Talend ESB
Talend MDM Platform
Talend Open Studio for Big Data
Talend Open Studio for Data Integration
Talend Open Studio for ESB
Talend Real-Time Big Data Platform
Module
Talend Studio
Content
ジョブデザインと開発 > サードパーティーシステム > ファイルコンポーネント > Excel
データガバナンス > サードパーティーシステム > ファイルコンポーネント > Excel
データクオリティとプレパレーション > サードパーティーシステム > ファイルコンポーネント > Excel

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

Standard tFileOutputExcelコンポーネントはファイルファミリーのコンポーネントです。

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

基本設定

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

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

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

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

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

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

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

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

[File name] (ファイル名)

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

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

ジョブで変数を定義して使用する方法の詳細は、『 Talend Studio ユーザーガイド』を参照してください。

警告: エラーを避けるために、このフィールドには(相対パスの代わりに)絶対パスを使用します。

シート名

XSLシートの名前。

警告: subJobに同じExcelファイルを書き込む複数のtFileOutputExcelコンポーネントが含まれている(つまり、これらのコンポーネントの[File Name (ファイル名)オプションが同じファイルをポイントしている)場合、これらのコンポーネントは同じxslシートを上書きし、エクセルファイルを書き込む最後のtFileOutputExcelコンポーネントのデータのみが残ります。データの損失を回避するには、これらのtFileOutputExcelコンポーネントが異なるサブジョブにあることをご確認ください。

[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] (パスワード)フィールドにパスワードを入力します。

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

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

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

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

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

このダイナミックスキーマ機能は、テーブルの不明なカラムを取得する目的で設計されており、この目的に限り使用をお勧めします。テーブルの作成で使用することは勧められていません。

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

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

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

  • [Update repository connection] (リポジトリー接続を更新): リポジトリーに保存されているスキーマに変更を加え、変更後にそのコンテンツをすべてのジョブにプロパゲートするかどうかを決める場合は、このオプションを選択します。変更を現在のジョブにのみ反映する場合は、変更後、[No] (いいえ)を選択し、[Repository Content] (リポジトリーのコンテンツ)ウィンドウで再びこのスキーマのメタデータを選択します。

 

[Built-in] (組み込み): このコンポーネントに対してのみ作成されたスキーマがローカルに保管されます。関連項目: 『 Talend Studioユーザーガイド』を参照してください。

 

[Repository] (リポジトリー): 既存のスキーマがリポジトリーに保管されているので、さまざまなプロジェクトやジョブデザインで再利用できます。関連項目: 『 Talend Studioユーザーガイド』を参照してください。

詳細設定

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

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

[Custom the flush buffer size] (フラッシュバッファーサイズのカスタマイズ)

[Basic settings] (基本設定)ビューで[Select this check box to write the processed data into theWrite excel2007 file format (xlsx)] (このチェックボックスをオンにして、処理されたデータを「Excel2007ファイル形式(xlsx)で書き込み」に書き込む)が選択されている場合に使用できます。

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

高度な区切り(数字用)

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

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

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

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

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

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

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

注: このオプションは、TalendのR2021-02以降のStudio月次アップデートをインストールした時のみ利用できます。詳細は管理者にお問い合わせください。

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

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

[Don't generate empty file] (空のファイルを生成しない) このチェックボックスをオンにすると、空のファイルは生成されません。

[Recalculate formula] (式を再計算)

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

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

[tStatCatcher Statistics] (tStatCatcher統計情報)

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

グローバル変数

[Global Variables] (グローバル変数)

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

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

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

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

変数の詳細は、『 Talend Studio ユーザーガイド』を参照してください。

使用方法

使用ルール

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

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

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

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

動的パラメーターの使用サンプルは、コンテキストベースの動的接続によるデータベースからのデータの読み取りおよび動的に読み込まれた接続パラメーターを使用した異なるMySQLデータベースからのデータの読み取りを参照してください。[Dynamic settings] (動的設定)とコンテキスト変数については、『Talend Studioユーザーガイド』を参照してください。

制限事項

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