# tSalesforceOutputBulk

バルク処理のためにtSalesforceBulkExecコンポーネントで処理するファイルを生成します。

デフォルトで、このコンポーネントはTalend Studioと共には出荷されていません。機能マネージャーを使ってインストールする必要があります。 詳細は、[機能マネージャーを使って機能をインストール](https://help.qlik.com/talend/r/ja-JP/8.0/studio-user-guide/install-features-to-talend-studio)をご覧ください。

tSalesforceOutputBulkコンポーネントとtSalesforceBulkExecコンポーネントは、2ステップのプロセスで一緒に使われます。最初のステップでは、出力ファイルが生成されます。2番目のステップでは、Salesforceデータベースをフィードするためにこのファイルを使います。これら2つのステップは、tSalesforceOutputBulkExecコンポーネント内で融合しています。2つの別々のステップを使う利点は、Salesforceにロードする前にデータを変換できることです。

## tSalesforceOutputBulkの標準プロパティ

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

標準のtSalesforceOutputBulkコンポーネントは、ビジネスファミリーとCloudファミリーに属しています。

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

## 基本設定

| プロパティ | 説明 |
| --- | --- |
| [Schema] (スキーマ)と[Edit schema] (スキーマを編集) | スキーマとは行の説明のことです。処理して次のコンポーネントに渡すフィールド(カラム)数を定義します。Sparkジョブを作成する場合、フィールドの命名時は予約語のlineを避けます。<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>: リポジトリーに保存されているスキーマに変更を加え、変更後にそのコンテンツをすべてのジョブにプロパゲートするかどうかを決める場合は、このオプションを選択します。</p> <p>変更を現在のジョブにのみ反映する場合は、変更後、<span>[No] (いいえ)</span>を選択し、<span>[Repository Content] (リポジトリーコンテンツ)</span>ウィンドウで再びこのスキーマのメタデータを選択します。</p> </li> </ul><br><br>ジョブで接続している先行コンポーネントからスキーマを取得するためには、[Sync columns] (カラムを同期)をクリックします。<br><br>このコンポーネントは、ダイナミックスキーマ機能の利点を備えているので、ソースファイルから不明なカラムを取得したり、各カラムを個別にマッピングしなくてもソースからカラムを一括してコピーしたりできます。ダイナミックスキーマの詳細は、[ダイナミックスキーマ](https://help.qlik.com/talend/r/ja-JP/8.0/studio-user-guide/dynamic-schema)をご覧ください。<br><br>ダイナミックスキーマ機能は、テーブルの不明なカラムを取得するしくみになっており、その他の目的には使用しないことをお勧めします。テーブルの作成には推奨しません。 |
| [Bulk File Path] (バルクファイルパス) | 生成するファイルへのパスを指定します。 |
| [Append] (追加) | このチェックボックスをオンにすると、ファイルが既に存在する場合は、既存のデータが上書きされるのではなく、ファイルの末尾に新しいデータが追加されます。 |
| [Ignore Null] (Nullを無視) | NULL値を無視する場合は、このチェックボックスをオンにします。 |

## 詳細設定

| プロパティ | 説明 |
| --- | --- |
| [Relationship mapping for upsert] (リレーションシップマッピングのUPSERT) | [+]ボタンをクリックして、必要に応じて行を追加し、入力フローの外部IDフィールド、アップサートモジュールのルックアップリレーションシップフィールド、ルックアップモジュール、ルックアップモジュールの外部IDフィールドを指定します。<br><br><ul> <li> <p><span>[Column name of <span>Talend</span> Schema] (Talendスキーマのカラム名)</span>: 入力フローの外部IDフィールドの名前。これは、先行コンポーネントのスキーマのフィールドを参照しています。このカラムは、<span>[External id name] (外部ID名)</span>カラムで指定された外部IDフィールド(<span>[Module name] (モジュール名)</span>カラムで指定されたルックアップモジュールのフィールド)と照合することを目的としています。</p> </li> <li> <p> <span>[Lookup relationship field name] (ルックアップ関係フィールド名)</span>: ルックアップ関係フィールドの名前。これは、<span>tSalesforceBulkExec</span>コンポーネントの<span>[Basic settings] (基本設定)</span>ビューの<span>[Module Name] (モジュール名)</span>フィールドで指定されたモジュールのルックアップ関係フィールドを参照し、このテーブルの<span>[Module name] (モジュール名)</span>カラムで指定されたルックアップモジュールとの関係を確立することを目的としています。組み込み関係フィールドとカスタム関係フィールドを入力できます。ルックアップ関係フィールドを定義する方法、および<span>[Lookup relationship field name] (ルックアップ関係フィールド名)</span>フィールドに正しい名前を入力する方法は、Salesforce Webサイトにアクセスし、Salesforce Data Loaderアプリケーションを起動して適切なアクションと情報を入手してください。</p> </li> <li> <p><span>[Module name] (モジュール名)</span>: ルックアップモジュールの名前。</p> </li> <li> <p><span>[Polymorphic] (ポリモーフィック)</span>: リレーションシップマッピングにポリモーフィックフィールドが使われている時のみ、このチェックボックスをオンにします。このチェックボックスをポリモーフィックフィールドに対してオフのままにするか、ポリモーフィックではないフィールドに対してオンにすると、エラーが発生します。ポリモーフィックフィールドの詳細は、<a href="http://www.salesforce.com/us/developer/docs/api_asynch/" target="_blank">http://www.salesforce.com/us/developer/docs/api_asynch/</a>で<kbd>polymorphic</kbd>を検索してください。</p> </li> <li> <p><span>[External id name] (外部ID名)</span>: <span>[Module name] (モジュール名)</span>カラムで指定されたルックアップモジュールの外部IDフィールドの名前。</p> </li> </ul> |
| [tStatCatcher Statistics] (tStatCatcher統計) | このチェックボックスをオンにすると、ジョブレベルおよび各コンポーネントレベルでジョブ処理メタデータが収集されます。 |

## グローバル変数

| 変数 | 説明 |
| --- | --- |
| NB\_LINE | 処理された行数。これはAfter変数で、整数を返します。 |
| ERROR\_MESSAGE | エラー発生時にコンポーネントによって生成されるエラーメッセージ。これはAfter変数で、文字列を返します。 |

## 使用方法

| 使用方法のガイダンス | 説明 |
| --- | --- |
| **使用ルール** | このコンポーネントは、一般にtSalesforceBulkExecコンポーネントと共に使います。一緒に使うと、Salesforce.comで情報をフィードまたは変更する時にパフォーマンスが向上します。 |