# tDSOutput / tDataStewardshipTaskOutput

Qlik Talend Data IntegrationまたはTalend Data Stewardshipに接続し、タスクの形式でスプリント/キャンペーンにデータをロードします。このタスクには、スプリント/キャンペーンで定義されているのと同じスキーマが含まれている必要があります。

情報メモ重要: Talend Studio 8.0 R2025-12以降、tDataStewardshipTask\*コンポーネントはtDS\*コンポーネントに置き換えられます。

* tDataStewardshipTaskInputはtDSInputになります。
* tDataStewardshipTaskOutputはtDSOutputになります。
* tDataStewardshipTaskDeleteはtDSDeleteになります。

これらのコンポーネントを使用すると、Talend Studioを[Qlik Talend Data Integration](https://help.qlik.com/en-US/cloud-services/csh/client/qdi_stewardship_create_job)および[Talend Data Stewardship](https://help.qlik.com/talend/ja-JP/data-stewardship-user-guide/Cloud/talend-cloud-data-stewardship-introduction)に接続できます。

承認されたスプリント/キャンペーン参加者は、Talend Data Stewardshipの機能を使用してタスクに介入し、解決できます。

tSetProxyコンポーネントを使用して、Talend Data Stewardshipに接続するためのプロキシ設定を指定できます。

情報メモ注: 1アカウントにつき20GBのタスクをTalend Cloud Data Stewardshipに保存できます。詳細は、[保存タスクの最大数を設定](https://help.qlik.com/talend/ja-JP/data-stewardship-user-guide/8.0/setting-the-maximum-amount-of-stored-tasks)をご覧ください。

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

## 標準プロパティ

これらのプロパティは、標準ジョブのフレームワークで実行されているtDSOutputおよびtDataStewardshipTaskOutputコンポーネントを設定するために使われます。

標準のtDSOutputおよびtDataStewardshipTaskOutputコンポーネントは、Data Stewardshipファミリーに属しています。

このフレームワーク内のコンポーネントは、すべてのサブスクリプションベースのTalend製品で利用できます。

## Qlik Talend Data Integrationスプリントにデータをロードするための基本設定

| [Properties] (プロパティ) | 説明 |
| --- | --- |
| Cloud | [Qlik Data Stewardship]を選択し、[適用]をクリックします。 |
| プロパティタイプ | [Built-in] (組み込み)または[Repository] (リポジトリー)のいずれかで次の設定を行います。<br><br>[Built-in] (組み込み): そのコンポーネントに対してのみスキーマを作成し、ローカルに保管します。<br><br>[Repository] (リポジトリー): スキーマは作成済みで、リポジトリーに保管されています。さまざまなプロジェクトやジョブデザインで再利用できます。 |
| [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>[Sprint] (スプリント)リストからスプリントを選択すると、tDSOutputではスプリントで定義されているスキーマが認識され、基本設定で同一のスキーマカラムが作成されます。 |
| [URL] | Qlik Cloudテナントのアドレス(例: https://qcs.us.qlikcloud.com/)を入力します。 |
| API key (APIキー) | APIキーを入力します。APIキーの生成については、[APIキーを生成](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/Admin/mc-generate-api-keys.htm)をご覧ください。 |
| スプリント | [...]をクリックし、データをロードするスプリントを選択します。 |
| [Priority] (優先度) (オプション) | いずれかの優先度を選択します。あるいは、[Custom] (カスタム)を選択し、表示される[Custom] (カスタム)フィールドにカスタム式を設定します。<br><br>レベルが選択されない場合、デフォルトでは[Medium] (中)が使用されます。 |
| [Assignee] (割り当て先) | タスクを作成するスプリント参加者を選択します。あるいは、[No assignee] (割り当て先なし) を選択して、タスクを誰にも割り当てずに作成します。 |
| [Tags] (タグ) (オプション) | ロードするタスクに関連付けるタグを入力します。<br><br>このタグを使用して、スプリントにロードするタスクをフィルタリングできます。 |

## Qlik Talend Data Integrationスプリントにデータをロードするための詳細設定

| [Properties] (プロパティ) | 説明 |
| --- | --- |
| [tStatCatcher Statistics] (tStatCatcher統計) | このチェックボックスをオンにすると、ジョブレベルおよび各コンポーネントレベルでジョブ処理メタデータが収集されます。 |
| [Maximum number of retries] (最大再試行回数) | タイムアウト例外を返し、ジョブを強制終了するまでのリクエスト再試行する回数を設定します。 |
| [Batch Size] (バッチサイズ) | 各処理バッチに含める行数を設定します。<br><br>パフォーマンスの問題が発生している場合を除き、デフォルト値は変更しないでください。バッチサイズを大きくするとパフォーマンスが向上しますが、高すぎる値を設定すると、ジョブの失敗の原因となる可能性があります。 |

## Talend Data Stewardshipにデータをロードするための基本設定

| [Properties] (プロパティ) | 説明 |
| --- | --- |
| Cloud | [Talend Data Stewardship]を選択し、[適用]をクリックします。 |
| プロパティタイプ | [Built-in] (組み込み)または[Repository] (リポジトリー)のいずれかで次の設定を行います。<br><br>[Built-in] (組み込み): そのコンポーネントに対してのみスキーマを作成し、ローカルに保管します。<br><br>[Repository] (リポジトリー): スキーマは作成済みで、リポジトリーに保管されています。さまざまなプロジェクトやジョブデザインで再利用できます。 |
| [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>[Find a campaign] (キャンペーンを検索)リストからキャンペーンを選択すると、tDSOutputではキャンペーンで定義されているスキーマが認識され、基本設定で同一のスキーマカラムが作成されます。このコンポーネントでは、カラムTDS\_DUE\_DATEとTDS\_EXTERNAL\_IDもスキーマに追加されます:<br><br><ul> <li> <p> <span>TDS_DUE_DATE</span>: <span>YYYY-MM-DD HH:mm:ss</span>の形式でタスクの期日が保持されます。期日は、<span>Talend Data Stewardship</span>のキャンペーンの作成時に定義したタスクの遅延に基づいて自動的に計算されます。キャンペーンの作成時にタスクの遅延日を定義しない場合、このカラムは空のままになります。 </p> </li> <li> <p> <span>TDS_EXTERNAL_ID</span>: 他のシステムから簡単に取得できるように、任意のタスクの識別子を設定できます。</p> <p>ジョブの作成時にタスクの識別コードを定義しない場合、このカラムは空のままになります。 </p> </li> </ul><br><br>[MERGING] (マージング)または[GROUPING] (グルーピング)キャンペーンでタスクを書き込むように選択した場合、以下のカラムが自動的にスキーマに追加されます:<br><br><ul> <li> <p> <span>TDS_GID</span>: グループ識別コードが保持されます。</p> <p>この識別コードは、タスク内のレコードをグルーピングするために<span>tDSOutput</span>によって使われます。単一のタスク内でグルーピングするソースレコードにはすべて、同じ<span>TDS_GID</span>が必要です。</p> </li> <li> <p> <span>TDS_MASTER</span> (<span>[MERGING] (マージング)</span>キャンペーンのみ): レコードがマスターとソースレコードのどちらであるかを示します。</p> <div>考慮すべき2つのケース:<ul> <li>特定のタスクに対してマスターとして設定されているソースレコードがない場合、<span>Talend Data Stewardship</span>では、キャンペーン作成時に定義したサバイバーシップルールに基づいてマスターレコードを作成するために使用する、一致レコードの属性が決定されます。<p>サバイバーシップルールの詳細は、<a href="https://help.qlik.com/talend/ja-JP/data-stewardship-user-guide/8.0/talend-data-stewardship-examples" target="_blank">Talend Data Stewardshipの例</a>で、<span>マージング</span>キャンペーンにおけるデータモデルの設定に関するセクションをご覧ください。</p> </li> <li>特定のタスクに複数のソースレコードがマスターとして設定されている場合、<span>Talend Data Stewardship</span>はマスターとして設定されている最初のソースを取ります。したがって、1つのタスクに含めるマスターレコードを0または1のどちらかにすることが、ベストプラクティスとなります。</li> </ul> </div> </li> <li> <p> <span>TDS_SOURCE</span>: レコードのソースの名前を保持します(もしあれば)。</p> </li> <li> <p> <span>TDS_RATING</span> (<span>[MERGING] (マージング)</span>キャンペーンのみ): タスク作成時にソースレコードごとにトラストスコアを提供します。キャンペーン作成時に定義されていたスコアは、このスコアによって上書きされます。スコアは0から100までのパーセンテージを表す整数値になります。</p> </li> <li> <p> <span>TDS_SCORE</span>: マッチングアルゴリズムに基づいて計算される入力レコードとマスタレコードの違いを示します。</p> </li> <li> <span>TDS_CREATION</span>: タスクの作成日を保持します。</li> <li> <span>TDS_LAST_UPDATE</span>: タスクの最終アップデート日を保持します。</li> </ul> |
| URL | http://&lt;server\_address&gt;:19999/data-stewardship/)のように、Talend Data Stewardshipサーバーにアクセスするアドレスに*/data-stewardship/*というサフィックスを付けて入力します。<br><br>Talend Cloud Data Stewardshipで作業している場合は、*/data-stewardship/*というサフィックスが付いた対応するデータセンターのURLを使ってアプリケーションにアクセスします。たとえばAWS USデータセンターの場合はhttps://tds.us.cloud.talend.com/data-stewardshipとなります。<br><br>利用できるデータセンターのURLは、[Talend Cloudのアプリケーションにアクセス](https://help.qlik.com/talend/ja-JP/installation-guide-windows/Cloud/talend-cloud-application-url)をご覧ください。 |
| [Username] (ユーザー名)と[Password] (パスワード) | Talend Data Stewardshipにログインするための認証情報を入力します。<br><br>パスワードを入力するためには、パスワードフィールドの横にある[...]ボタンをクリックし、ポップアップダイアログボックスにパスワードを二重引用符で囲んで入力して[OK]をクリックし、設定を保存します。<br><br>Talend Cloud Data Stewardshipを使用しており、<br><br><ul> <li>SSOが有効な場合は、アクセストークンをフィールドに入力します。</li> <li>SSOが有効になっていません。フィールドに次のいずれかを入力してください: <ul> <li>アクセストークン</li> <li>パスワード(非推奨)</li> </ul> </li> </ul> |
| キャンペーン | [Find a campaign] (キャンペーンの検索)をクリックして、Talend Data Stewardshipで利用可能なすべてのキャンペーンのリストを開き、タスクが保存されているキャンペーンの名前を選択します。これは情報提示の読み取り専用フィールドです。 |
| [Type] (タイプ) | キャンペーンの選択後に定義済みのタイプからキャンペーンタイプを表示する読み取り専用リスト。 |
| [Override enforcement of data model] (データモデルの強制オーバーライド) | スキーマタイプが有効でない場合でもTalend Data Stewardshipサーバーでデータを処理する場合は、このチェックボックスを選択してください。この場合、スキーマの入力検証は行われません。<br><br><br>このチェックボックスは、[Merging] (マージング)キャンペーンタイプと[Resolution] (レゾリューション)キャンペーンタイプではデフォルトで選択されています。 |
| State | タスクを作成するワークフロー内の状態をリストから選択します。<br><br>このリストには、キャンペーンワークフロー内で定義するすべての状態の名前が表示されます。ここには、最初と最後の状態、およびTalend Data Stewardshipでキャンペーンを作成する時に追加する検証状態が表示されます。<br><br>さまざまな値に応じてさまざまな状態を定義できるよう値をコンテキスト化したい場合は、[Custom] (カスタム)オプションを使います。たとえば、すべての入力フィールドをチェックしたい場合は[State] (状態)フィールドに"New"という値を割り当てます。入力値が確信できるもので、ただ検証したい場合は、このフィールドに"To validate"という値を割り当てます。 |
| [Assignee] (割り当て先) | タスクを作成するキャンペーン参加者を選択します。あるいは、[No Assignee] (割り当て先なし) を選択して、タスクを誰にも割り当てずに作成します。<br><br>[Custom] (カスタム)オプションを使用すると、表示されているフィールドにコンテキスト変数を定義することで、キャンペーンのデータスチュワードの部分にタスクを動的に割り当てることができます。想定される値はスチュワードのログイン情報となります。<br><br>このオプションを使用し、受信データの指定された属性に基づいて特定のスチュワードにタスクを割り当てることができます。たとえば、フランスの顧客にはフランス人スチュワードJacques Bocuse、米国の顧客にはアメリカ人スチュワードCale Carolinaを割り当てるようにする、顧客サポートレベルがプラチナの場合はサポートチームリードに割り当て、ゴールドの場合はエキスパートに割り当てる、などのようにできます。 |
| [Priority] (優先度)、[Choice] (選択)および[Tags] (タグ) | [Priority] (優先度)(任意): タスク優先度のいずれかを選択します。あるいは、[Custom] (カスタム)を選択し、表示されるフィールドにカスタムの式を設定するために使われます。<br><br>レベルが選択されない場合、デフォルトでは[Medium] (中)が使用されます。<br><br>[Choice] (選択) (任意、[ARBITRATION] (アービトレーション)キャンペーンが選択を選択している場合のみ使用可能): Webアプリケーションでキャンペーンを定義する際、キャンペーンのレコードに設定する任意の選択オプションを選びます。デフォルト値は[No Choice] (選択なし)で、この選択によりデータスチュワードはWebアプリケーションで作業を行うことができます。ただし、ジョブでアービトレーションの選択を設定することで、タスク作成時に最も関連性が高いと思われる選択項目を事前に選択することによりスチュワードをサポートできます。<br><br>タグ(オプション): ロードするタスクに関連付けるタグを入力します。<br><br>このタグを使用して、キャンペーンにロードするタスクをフィルタリングできます。 |
| [Comments] (コメント) (オプション) | 1つまたは複数のスキーマカラムを選択し、ロードするタスクに追加のコメントを入力します。<br><br>このテーブルではデフォルトですべてのスキーマカラムがリスト表示されます。<br><br>キャンペーン参加者は、Talend Data Stewardshipのソースレコードカラムにポインターを置くことで、いつでもコメントを表示できます。この情報はタスクを解決する際に、より多くの情報を得た上で判断するのに役立ちます。 |

## Talend Data Stewardshipにデータをロードするための詳細設定

| [Properties] (プロパティ) | 説明 |
| --- | --- |
| [Campaign ID] (キャンペーンID) | 基本設定でキャンペーンを選択すると、そのキャンペーンの技術的な名前を表示します。ただし、フィールド値を変更して、たとえばコンテキストパラメーターに置き換え、ランタイムにコンテキスト変数をジョブにパスできます。この技術的な名前は、ジョブがTalend Data Stewardshipと通信する時に、[Campaign] (キャンペーン)フィールドの値に関係なく、キャンペーンの特定に常に使用されます。 |
| [Max tasks per commit] (コミットあたりの最大タスク数) | 各回のコミットのタスク数を設定します。<br><br>Talend Data Stewardshipのバッチサイズに制限はありません(オンプレミス)。<br><br>ただし、Talend Cloud Data Stewardshipでは、1回のコミットで200件のタスクを超えないようにする必要があり、大きな値を設定するとジョブで障害が発生します。 |
| [HTTP client configuration] (HTTP Client設定) | [Connect Timeout] (接続タイムアウト): 接続の試行に失敗してジョブが強制終了するまでの時間(ミリ秒)を設定するために使われます。<br><br>[Request Timeout] (リクエストタイムアウト): リクエストの試行に失敗してジョブが強制終了するまでの時間(ミリ秒)を設定するために使われます。<br><br>値を0にすると待ち時間が無限であると解釈されます。 |
| [tStatCatcher Statistics] (tStatCatcher統計) | このチェックボックスをオンにすると、ジョブレベルおよび各コンポーネントレベルでジョブ処理メタデータが収集されます。 |

## グローバル変数

| 変数 | 説明 |
| --- | --- |
| NB\_LINE | 処理されたメッセージの数。これはAfter変数で、整数を返します。 |
| NB\_REJECT | リジェクトされた行数。これはAfter変数で、整数を返します。 |
| NB\_SUCCESS | 正しく処理された行数。これはAfter変数で、整数を返します。 |
| ERROR\_MESSAGE | エラー発生時にコンポーネントによって生成されるエラーメッセージ。これはAfter変数で、文字列を返します。この変数はコンポーネントにこのチェックボックスが存在し、[Die on error] (エラー発生時に強制終了)がオフになっている場合のみファンクションします。 |

## 使用方法

| 使用方法のガイダンス | 説明 |
| --- | --- |
| 使用ルール | このコンポーネントは通常、ジョブまたはサブジョブの終了コンポーネントとして使い、常に入力リンクが必要です。 |

**関連概念**

* [Talend Data Stewardshipでのタスクの動的割り当て](https://help.qlik.com/talend/ja-JP/components/8.0/data-stewardship/tdatastewardshiptaskoutput-tmap-tfileinputdelimited-tfileinputdelimited-assigning-tasks-dynamically-in-talend-data-stewardship-standard-component-enterprise "Talend Data Stewardshipにデータをロードする際には、受信データの属性に基づいて、タスクを特定のスチュワードに動的に割り当てることができます。")
* [キャンペーンIDを使ってキャンペーンを動的に入力する](https://help.qlik.com/talend/ja-JP/components/8.0/data-stewardship/tdatastewardshiptaskoutput-tmap-tmatchgroup-tfileinputdelimited-populating-campaigns-dynamically-using-campaign-ids "このジョブは、キャンペーンの技術名を使ってTalend Data Stewardshipで定義したキャンペーンにタスクをロードします。コンテキストパラメーターは、ランタイムに技術名をコンテキスト変数としてジョブにパスするために使われます。")
* [異なるTalend Data Stewardshipインスタンスの同じキャンペーンにタスクを入力する](https://help.qlik.com/talend/ja-JP/components/8.0/data-stewardship/tdatastewardshiptaskoutput-tmap-tmatchgroup-tfileinputdelimited-populating-tasks-into-same-campaign-on-different-talend-data-stewardship-instances "このジョブは、2つの異なるTalend Data Stewardshipインスタンスで同じデータモデルを使って2つのキャンペーンにタスクをロードします。コンテキスト変数は、各Talend Data Stewardshipインスタンスの接続情報をランタイムにジョブに渡すために使われます。")
* [マージングキャンペーンのタスクの作成](https://help.qlik.com/talend/ja-JP/components/8.0/data-stewardship/writing-tasks-merging-campaign "このジョブではTalend Data Stewardshipで定義される[Merging] (マージング)キャンペーンのタスクをtDataStewardshipTaskOutputコンポーネントの基本設定で定義した条件に基づいてロードします。")
* [Talend Data Stewardshipキャンペーンでタスクを作成](https://help.qlik.com/talend/ja-JP/components/8.0/data-stewardship/tdatastewardshiptaskoutput-tfileinputdelimited-tmatchgroup-tmap-writing-tasks-in-talend-data-stewardship-campaigns-standard-component-enterprise "このジョブはTalend Data Stewardshipで定義された各種キャンペーンにタスクをロードします。タスクはtDataStewardshipTaskOutputコンポーネントの基本設定で定義される条件に基づいてロードされます。")