# tWorkdayOutput

データをWorkdayクライアントに書き込みます。

情報メモ注:

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

## tWorkdayOutput の標準プロパティ

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

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

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

情報メモ注: このコンポーネントは、Talendが提供する8.0.1-R2022-09以降のTalend Studioマンスリーアップデートをインストール済みである場合のみ利用できます。詳細は管理者にお問い合わせください。

## 基本設定

| プロパティ | 説明 |
| --- | --- |
| [Property Type] (プロパティタイプ) | プロパティの設定方法を選択します。<br><br>[Built-In] (組み込み)および[Repository] (リポジトリー)という2つのオプションが提供されています。<br><br><ul> <li> <span>[Built-In] (組み込み)</span>: <span>[Basic settings] (基本設定)</span>および<span>[Advanced settings] (詳細設定)</span>ビューで現在のコンポーネントに設定されているプロパティを使います。</li> <li> <span>[Repository] (リポジトリー)</span>: リポジトリーに保管されているプロパティを使います。</li> </ul> |
| [Schema] (スキーマ)と[Edit schema] (スキーマを編集) | スキーマとは行の説明のことです。処理して次のコンポーネントに渡すフィールド(カラム)数を定義します。Sparkジョブを作成する場合、フィールドの命名時は予約語のlineを避けます。<br><br><ul> <li> <p> <span>[Built-in] (組み込み)</span>: そのコンポーネントに対してのみスキーマを作成し、ローカルに保管します。</p> </li> <li> <p> <span>[Repository] (リポジトリー)</span>: スキーマは作成済みで、リポジトリーに保管されています。さまざまなプロジェクトやジョブデザインで再利用できます。</p> </li> </ul><br><br>スキーマを変更するには[Edit schema] (スキーマを編集)をクリックします。変更を加えると、スキーマは自動的に組み込みになります。<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> |
| [Guess Schema] (推測スキーマ) | このボタンをクリックすると、入力されたWorkdayクライアント認証情報に基づいてスキーマが生成されます。<br><br>Workdayサーバーへの接続に必要な情報を入力し、このボタンをクリックします。 |
| [Authentication mode] (認証モード) | 認証モードとして、[OAuth JWT authentication] (OAuth JWT認証) (デフォルト)、[REST - Client ID authentication mode] (REST - クライアントID認証モード) (非推奨)、[SOAP - Login authentication mode] (SOAP - ログイン認証モード)、[SOAP - WS-Security authentication mode] (SOAP - WS-Security認証モード)のいずれかを選択します。<br><br>Workdayクライアントとの通信は HTTPS プロトコルを使って行われます。SOAP - WS-Security authentication modeの場合、認証情報はメッセージに含まれます。関連情報は、[WS Security](https://ja.wikipedia.org/wiki/WS-Security)をご覧ください。<br><br>情報メモ注:<br><br><ul> <li><span>[OAuth JWT authentication] (OAuth JWT認証)</span>オプションは<span>[Workday web services] (Workday Webサービス)</span>モードにのみ適用されます。<span>[Mode] (モード)</span>ドロップダウンリストから、<span>[Workday web services] (Workday Webサービス)</span>モードを選択できます。</li> <li><span>[OAuth JWT authentication] (OAuth JWT認証)</span>オプションは、<span>Talend</span>が提供する8.0.1-R2022-12以降の<span>Talend Studio</span>マンスリーアップデートをインストール済みである場合のみ利用できます。詳細は管理者にお問い合わせください。</li> </ul> |
| [Client Identifier] (クライアント識別子) | Workdayへの接続に使うAPIクライアントのクライアントIDを入力します。<br><br>このフィールドは、[Authentication mode] (認証モード)ドロップダウンリストからREST - Client id authentication mode (deprecated)を選択した場合に利用できます。 |
| [Client Secret] (クライアントシークレット) | [...]をクリックし、Workdayへの接続に使うAPIクライアントのクライアントシークレットキーを二重引用符で囲んで入力します。<br><br>クライアントシークレットを入力するには、[Client secret] (クライアントシークレット)フィールドの横にある[...]ボタンをクリックし、[Enter a new password] (新しいパスワードを入力)ダイアログボックスを表示させ、テキストフィールドにクライアントシークレットを入力して[OK]をクリックします。クライアントシークレットは、[pure password] (純粋なパスワード)モードではJSON文字列で、[Java mode] (Javaモード)ではJava式として入力できます。テキストフィールドの上部にある[switch to Java mode] (Javaモードに切り替え)または[switch to pure password mode] (純粋なパスワードに切り替え)をクリックすることで、2つのモードの間で切り替えられます。<br><br>このフィールドは、[Authentication mode] (認証モード)ドロップダウンリストからREST - Client ID authentication mode (deprecated)を選択した場合に利用できます。 |
| [User login] (ユーザーログイン) | SOAPログイン認証モードのユーザー名を入力します。<br><br>このフィールドは、[Authentication mode] (認証モード)ドロップダウンリストからSOAP - Login authentication modeを選択した場合に利用できます。 |
| [User password] (ユーザーパスワード) | […]をクリックし、SOAPログイン認証モードのパスワードを入力します。<br><br>ユーザーパスワードを入力するには、[User Password] (ユーザーパスワード)フィールドの横にある[...]ボタンをクリックし、[Enter a new password] (新しいパスワードを入力)ダイアログボックスを表示させ、テキストフィールドにユーザーパスワードを入力して[OK]をクリックします。ユーザーパスワードは、[pure password] (純粋なパスワード)モードではJSON文字列で、[Java mode] (Javaモード)ではJava式として入力できます。テキストフィールドの上部にある[switch to Java mode] (Javaモードに切り替え)または[switch to pure password mode] (純粋なパスワードに切り替え)をクリックすることで、2つのモードの間で切り替えられます。<br><br>このフィールドは、[Authentication mode] (認証モード)ドロップダウンリストからSOAP - Login authentication modeを選択した場合に利用できます。 |
| [Tenant Alias] (テナントエイリアス) | Workdayに接続できるテナントIDを入力します。テナントエイリアスはWorkday管理者が提供します。 |
| [Mode] (モード) | クライアントデータを書き込むためのモードを選択します。リストから選択できるのは、Workdayクエリー言語、Report as a service、Workday web servicesです。<br><br>モードが有効になるかどうかは、[Authentication mode] (認証モード)ドロップダウンリストから、選択した認証モードによって決まります。詳しい変更は次のとおりです。<br><br><ul> <li><span>[Authentication mode] (認証モード)</span>ドロップダウンリストから、<span>[OAuth JWT authentication] (OAuth JWT認証)</span>を選択すると、<span>[Workday web services] (Workday Webサービス)</span>モードが有効になります。</li> <li><span>[Authentication mode] (認証モード)</span>ドロップダウンリストから、<span>[REST - Client ID authentication mode] (REST - クライアントID認証モード)</span>を選択すると、<span>Workday query language</span>モードと<span>Report as a service</span>モードが有効になります。</li> <li><span>[Authentication mode] (認証モード)</span>ドロップダウンリストから、<span>[SOAP - Login authentication mode] (SOAP - ログイン認証モード)</span>を選択すると、<span>Report as a service</span>モードが有効になります。</li> <li><span>[Authentication mode] (認証モード)</span>ドロップダウンリストから、<span>[SOAP - WS-Security authentication mode] (SOAP - WS-Security認証モード)</span>を選択すると、<span>Report as a service</span>モードと<span>Workday web services</span>モードが有効になります。</li> </ul><br><br>情報メモ注:<br><br><ul> <li><span>[OAuth JWT authentication] (OAuth JWT認証)</span>モードの場合、<span>[Mode] (モード)</span>ドロップダウンリストから、選択されたモード用に、<span>[Advanced settings] (詳細設定)</span>ビューの<span>[Endpoit pattern] (エンドポイントパターン)</span>フィールドで特定のエンドポイントを設定する必要があります。 </li> <li><span>[Workday web services] (Workday Webサービス)</span>項目は、<span>Talend</span>が提供する8.0.1-R2022-08以降の<span>Talend Studio</span>マンスリーアップデートをインストール済みである場合のみ利用できます。詳細は管理者にお問い合わせください。</li> </ul> |
| [WS-Security type] (WS-Securityタイプ) | ドロップダウンリストから、[WS Security with basic authentication] (基本認証によるWS Security)または[WS Security with certificate authentication] (証明書認証によるWS Security)というWS-Securityタイプを選択します。<br><br>[WS-Security type] (WS-Securityタイプ)ドロップダウンリストは、[Authentication mode] (認証モード)ドロップダウンリストから[SOAP - WS-Security authentication mode] (SOAP - WS Security認証モード)を選択した場合に利用できます。<br><br>情報メモ注: [WS Security with JWT authentication] (JWT認証によるWS Security)セキュリティタイプは、Talendが提供する8.0.1-R2022-12以降のTalend Studioマンスリーアップデートをインストール済みである場合にOAuth JWT認証モードによって実装されます。OAuth JWT認証は、[Authentication mode] (認証モード)で[OAuth JWT authentication] (OAuth JWT認証)を選択すれば有効にできます。詳細は管理者にお問い合わせください。 |
| [Login] (ログイン)と[Password] (パスワード) | SOAP - WS-Security authentication modeのユーザー名とパスワードを入力します。<br><br>パスワードを入力するには、[Password] (パスワード)フィールドの横にある[...]ボタンをクリックし、[Enter a new password] (新しいパスワードを入力)ダイアログボックスを表示させ、テキストフィールドにパスワードを入力して[OK]をクリックします。パスワードは、[pure password] (純粋なパスワード)モードではJSON文字列で、[Java mode] (Javaモード)ではJava式として入力できます。テキストフィールドの上部にある[switch to Java mode] (Javaモードに切り替え)または[switch to pure password mode] (純粋なパスワードに切り替え)をクリックすることで、2つのモードの間で切り替えられます。<br><br>これらの2つのオプションは、[Authentication mode] (認証モード)ドロップダウンリストからSOAP - WS-Security authentication modeを選択し、[WS-Security type] (WS-Securityタイプ)ドロップダウンリストからWS Security with basic authenticationを選択した場合に利用できます。 |
| [Integration system user] (インテグレーションシステムユーザー) | インテグレーションシステムユーザーを入力します。<br><br>インテグレーションシステムユーザーを作成することが、x509証明書でSOAPリクエストをビルドする最初のステップです。Workdayで[Create Integration System User] (インテグレーションシステムユーザーを作成)タスクを実行すると、インテグレーションシステムユーザーを作成できます。<br><br>情報メモ注: このフィールドは、[WS-Security type] (WS-Securityタイプ)ドロップダウンリストから[WS Security with certificate authentication] (証明書認証によるWS Security)を選択した場合に利用できます。 |
| [X509 certificate] (X509証明書) | X509証明書コンテンツを入力します。<br><br>Workdayで[Create x509 public key] (x509パブリックキーを作成)タスクを実行すると、X509証明書を作成できます。<br><br>情報メモ注: このフィールドは、[WS-Security type] (WS-Securityタイプ)ドロップダウンリストから[WS Security with certificate authentication] (証明書認証によるWS Security)を選択した場合に利用できます。 |
| [Private key] (プライベートキー) | プライベートキーを入力します。<br><br>プライベートキーを入力するには、[Private key] (プライベートキー)フィールドの横にある[...]ボタンをクリックし、[Enter a new password] (新しいパスワードを入力)ダイアログボックスを表示させ、テキストフィールドにプライベートキーを入力して[OK]をクリックします。プライベートキーは、[pure password] (純粋なパスワード)モードではJSON文字列で、[Java mode] (Javaモード)ではJava式として入力できます。テキストフィールドの上部にある[switch to Java mode] (Javaモードに切り替え)または[switch to pure password mode] (純粋なパスワードに切り替え)をクリックすることで、2つのモードの間で切り替えられます。<br><br>このフィールドは、[Authentication mode] (認証モード)ドロップダウンリストから[OAuth JWT authentication] (OAuth JWT認証)を選択するか、同じく[Authentication mode] (認証モード)ドロップダウンリストから[WS-Security type] (WS-Securityタイプ)ドロップダウンリストから[SOAP - WS Security authentication mode] (SOAP - WS-Security認証モード)を選択し、[WS-Security type] (WS-Securityタイプ)ドロップダウンリストから[WS Security with certificate authentication] (証明書認証によるWS Security)を選択した場合に利用できます。 |
| [WQL Query] (WQLクエリー) | クライアントデータを書き込むためのWorkdayクエリー言語ステートメントを入力します。<br><br>このフィールドは、[Mode] (モード)リストからWorkday query languageが選択されている場合に使用できます。 |
| [Report Owner] (レポート所有者) | 書き込むクライアントデータのレポート所有者を入力します。<br><br>この[Mode] (モード)リストからReport as a serviceが選択されている場合に使用できます。 |
| [Report Name] (レポート名) | 書き込むクライアントデータのレポート名を入力します。<br><br>この[Mode] (モード)リストからReport as a serviceが選択されている場合に使用できます。 |
| サービス | データの書き込み先となるWorkdayサービスの名前を入力します。<br><br>サービス名は、このフィールドの横にある[...]をクリックしてサービス名を入力し、ダイアログボックスのリストボックスから最も頻繁に使用される5つのサービス(Compensation、Financial\_Management、Human\_Resources、Payroll、Staffing)の一部(または全部)を選択して入力する方法もあります。リストボックスにないサービスを選択するためは、[Use custom value] (カスタム値を使用)オプションを選択し、[Custom value] (カスタム値)フィールドに目的のサービス名を入力します。<br><br>情報メモ注: このフィールドは、[Mode] (モード)ドロップダウンリストから、[Workday web services] (Workday Webサービス)を選択した場合に使用できます。 |
| [Operation] (操作) | 書き込むデータに対して行う操作の名前を入力します。<br><br>このフィールドの横にある[...]をクリックして操作名を入力し、表示されるダイアログ ボックスのリストボックスから必要な操作を選択することもできます。このリストボックスに操作が表示されるのは、Workdayサーバーへの接続に必要な情報がすべて提供されている場合に限られます。<br><br>現在のところ、実行できるのは名前が*Get\_*で始まる操作のみです。<br><br>情報メモ注: このフィールドは、[Mode] (モード)ドロップダウンリストから、[Workday web services] (Workday Webサービス)を選択した場合に使用できます。 |

## 詳細設定

| プロパティ | 説明 |
| --- | --- |
| [tStatCatcher Statistics] (tStatCatcher統計) | このチェックボックスを選択すると、ジョブレベルおよび各コンポーネントレベルでジョブ処理メタデータが収集されます。 |
| [Endpoint pattern] (エンドポイントパターン) | エンドポイントパターンを入力します。<br><br>このフィールドは、[Authentication mode] (認証モード)ドロップダウンリストで[OAuth JWT authentication] (OAuth JWT認証)が選択されている場合のみ利用できます。<br><br>[OAuth JWT authentication] (OAuth JWT認証)モードでは[Workday web services] (Workday Webサービス)モードだけがサポートされており、エンドポイントパターンをhttps://wd2-impl-services1.workday.com/ccx/service/${tenant}にする必要があります。<br><br>[OAuth JWT authentication] (OAuth JWT認証)モードでは、リストボックスでエンドポイントパターンがプリセットされています。そのため、[Endpoint pattern] (エンドポイントパターン)フィールドにエンドポイントアドレスを手動で入力するだけでなく、リストボックスにアクセスし、そのリストボックスからプリセットのエンドポイントパターンを選択することもできます。リストボックスには、フィールドの横にある[...]をクリックしてアクセスします。<br><br>情報メモ注:<br><br><ul> <li>このフィールドは、<span>[Authentication mode] (認証モード)</span>ドロップダウンリストで<span>[OAuth JWT authentication] (OAuth JWT認証)</span>が選択されている場合のみ利用できます。</li> <li>実際のエンドポイントパターンは、上記のエンドポイントパターンに基づいて顧客エンドポイントに合わせる必要があります。たとえば<kbd>https://wd5-impl-services1.workday.com/ccx/service/customreport2/{tenant_alias}/{report_owner}/{report_name}</kbd>を使ってWorkdayに接続する場合は、エンドポイントパターンの最初の部分を<kbd>wd2-impl-services1.workday.com</kbd>から<kbd>wd5-impl-services1.workday.com</kbd>に変更する必要があります。エンドポイントパターンは、<span>[Endpoint pattern] (エンドポイントパターン)</span>フィールドで手動で変更できます。</li> <li>このフィールドは、<span>Talend</span>が提供する8.0.1-R2022-12以降の<span>Talend Studio</span>マンスリーアップデートをインストール済みである場合に利用できます。詳細は管理者にお問い合わせください。</li> </ul> |
| [Authentication endpoint] (認証エンドポイント) | 認証エンドポイントを入力します<br><br>このオプションは、[Basic settings] (基本設定)ビューで[Authentication mode] (認証モード)からREST - Client ID authentication modeを選択した場合に利用できます。 |
| [Service endpoint] (サービスエンドポイント) | Web サービスのエンドポイントを入力します。<br><br>[SOAP - WS-Security authentication mode] (SOAP - WS-Security認証モード)では、サービスエンドポイントを次のように設定した場合のみコンポーネントが正常に動作します。<br><br><ul> <li><span>[Mode] (モード)</span>ドロップダウンリストから、<span>Report as a service</span>を選択した場合は、サービスエンドポイントを <kbd>https://wd2-impl-services1.workday.com/ccx/service/customreport2/${tenant}</kbd>に設定します。 </li> <li><span>[Mode] (モード)</span>ドロップダウンリストから、<span>Workday web services</span>を選択した場合は、サービスエンドポイントを <kbd>https://wd2-impl-services1.workday.com/ccx/service/${tenant}</kbd>に設定します。 </li> </ul><br><br>[SOAP - WS-Security authentication mode] (SOAP - WS-Securit 認証モード)の場合、この2つのエンドポイントアドレスはリストボックスにプリセットされています。そのため、[Service endpoint] (サービスエンドポイント)フィールドにエンドポイントアドレスを手動で入力するだけでなく、リストボックスにアクセスし、そのリストボックスからプリセットのエンドポイントアドレスを選択することもできます。リストボックスには、フィールドの横にある[...]をクリックしてアクセスします。<br><br>情報メモ注:<br><br><ul> <li>プリセットされたこの2つのエンドポイントアドレスと<span>[...]</span>ボタンは、<span>[Authentication mode] (認証モード)</span>ドロップダウンリストから<span>[SOAP - WS-Security authentication mode] (SOAP - WS-Security認証モード)</span>が選択されている場合のみ利用できます。</li> <li>このフィールドのデフォルトは<kbd>https://wd2-impl-services1.workday.com/ccx/service/customreport2/${tenant}</kbd>です。<span>[Mode] (モード)</span>ドロップダウンリストから、<span>Workday web services</span>を選択した場合は、このフィールドを明示的に変更する必要があります。</li> <li>実際のサービスエンドポイントは、上記の2つのサービスエンドポイントに基づいて顧客エンドポイントに合わせる必要があります。たとえば<kbd>https://wd5-impl-services1.workday.com/ccx/service/customreport2/{tenant_alias}/{report_owner}/{report_name}</kbd>を使ってWorkdayに接続する場合は、サービスエンドポイントの最初の部分を<kbd>wd2-impl-services1</kbd>から<kbd>wd5-impl-services1</kbd>に変更する必要があります。サービスエンドポイントは、<span>[Service endpoint] (サービスエンドポイント)</span>フィールドで手動で変更できます。</li> </ul> |
| [API version] (APIバージョン) | 使用したいAPIのバージョンを設定するために使われます。 |
| [Request link] (リクエストリンク) | このフィールドの横にある[...]ボタンをクリックし、リクエスト文字列へのリンクをこのフィールドに表示させます。ブラウザーで生成されたリクエスト文字列は、このリンクをコピーしてブラウザーのアドレスバーに貼り付ければ確認できます。なお、リンクの生成は、ユーザーアカウントの認証情報を入力し、[Basic settings] (基本設定)ビューでサービスや操作を適切に設定した場合のみ可能です。<br><br>このフィールドはユーザーが自分のリクエストをチェックするためのもので、コンポーネントが動作するためには必要ありません。 |

## グローバル変数

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

## 使用方法

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

**関連概念**

[Workdayクラアントのデータをアップデート](https://help.qlik.com/talend/ja-JP/components/8.0/workday/updating-workday-client-data-c "このシナリオでは、Workdayクライアントの特定データをアップデートし、そのデータを取得することでアップデートする方法を説明します。")