tWorkdayInputの標準プロパティ

[Property Type] (プロパティタイプ)

プロパティの設定方法を選択します。

[Built-In] (組み込み)および[Repository] (リポジトリー)という2つのオプションが提供されています。

スキーマとは行の説明のことです。処理して次のコンポーネントに渡すフィールド(カラム)数を定義します。Sparkジョブを作成する場合、フィールドの命名時は予約語のlineを避けます。

• [Built-in] (組み込み): そのコンポーネントに対してのみスキーマを作成し、ローカルに保管します。

• [Repository] (リポジトリー): スキーマは作成済みで、リポジトリーに保管されています。さまざまなプロジェクトやジョブデザインで再利用できます。

スキーマを変更するには[Edit schema] (スキーマを編集)をクリックします。変更を加えると、スキーマは自動的に組み込みになります。

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

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

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

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

このボタンをクリックすると、取得したクライアントデータまたはWorkdayクライアントレポートに基づいてスキーマを生成します。

必要な情報(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認証モード)のいずれかを選択します。

Workdayクライアントとの通信は HTTPS プロトコルを使って行われます。SOAP - WS-Security authentication modeの場合、認証情報はメッセージに含まれます。関連情報は、WS Securityをご覧ください。

Workdayへの接続に使うAPIクライアントのクライアントIDを入力します。

このフィールドは、[Authentication mode] (認証モード)ドロップダウンリストからREST - Client id authentication mode (deprecated)を選択した場合に利用できます。

[...]をクリックし、Workdayへの接続に使うAPIクライアントのクライアントシークレットキーを二重引用符で囲んで入力します。

このフィールドは、[Authentication mode] (認証モード)ドロップダウンリストからREST - Client ID authentication mode (deprecated)を選択した場合に利用できます。

SOAPログイン認証モードのユーザー名を入力します。

このフィールドは、[Authentication mode] (認証モード)ドロップダウンリストからSOAP - Login authentication modeを選択した場合に利用できます。

[…]をクリックし、SOAPログイン認証モードのパスワードを入力します。

このフィールドは、[Authentication mode] (認証モード)ドロップダウンリストからSOAP - Login authentication modeを選択した場合に利用できます。

Workdayに接続できるテナントIDを入力します。テナントエイリアスはWorkday管理者が提供します。次に例を示します: tenant_alias

クライアントデータを取得するためのモードを選択します。リストから選択できるのは、Workdayクエリー言語、Report as a service、Workday web servicesです。

モードが有効になるかどうかは、[Authentication mode] (認証モード)ドロップダウンリストから、選択した認証モードによって決まります。詳しい変更は次のとおりです。

• [Authentication mode] (認証モード)ドロップダウンリストから、[OAuth JWT authentication] (OAuth JWT認証)を選択すると、この3つのモードがすべて有効になります。
• [Authentication mode] (認証モード)ドロップダウンリストから、[REST - Client ID authentication mode] (REST - クライアントID認証モード)を選択すると、Workday query languageモードとReport as a serviceモードが有効になります。
• [Authentication mode] (認証モード)ドロップダウンリストから、[SOAP - Login authentication mode] (SOAP - ログイン認証モード)を選択すると、Report as a serviceモードが有効になります。
• [Authentication mode] (認証モード)ドロップダウンリストから、[SOAP - WS-Security authentication mode] (SOAP - WS-Security認証モード)を選択すると、Report as a serviceモードとWorkday web servicesモードが有効になります。

[WS-Security type] (WS-Securityタイプ)

ドロップダウンリストから、[WS Security with basic authentication] (基本認証によるWS Security)または[WS Security with certificate authentication] (証明書認証によるWS Security)というWS-Securityタイプを選択します。

[WS-Security type] (WS-Securityタイプ)ドロップダウンリストは、[Authentication mode] (認証モード)ドロップダウンリストから[SOAP - WS-Security authentication mode] (SOAP - WS Security認証モード)を選択した場合に利用できます。

[Login] (ログイン)と[Password] (パスワード)

SOAP - WS-Security authentication modeのユーザー名とパスワードを入力します。

これらの2つのオプションは、[Authentication mode] (認証モード)ドロップダウンリストからSOAP - WS-Security authentication modeを選択し、[WS-Security type] (WS-Securityタイプ)ドロップダウンリストからWS Security with basic authenticationを選択した場合に利用できます。

[Integration system user] (インテグレーションシステムユーザー)

インテグレーションシステムユーザーを入力します。

インテグレーションシステムユーザーを作成することが、x509証明書でSOAPリクエストをビルドする最初のステップです。Workdayで[Create Integration System User] (インテグレーションシステムユーザーを作成)タスクを実行すると、インテグレーションシステムユーザーを作成できます。

[X509 certificate] (X509証明書)

X509証明書コンテンツを入力します。

Workdayで[Create x509 public key] (x509パブリックキーを作成)タスクを実行すると、X509証明書を作成できます。

[Private key] (プライベートキー)

プライベートキーを入力します。

このフィールドは、[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)を選択した場合に利用できます。

クライアントデータを取得するためのWorkdayクエリー言語ステートメントを入力します。

このフィールドは、[Mode] (モード)リストからWorkday query languageが選択されている場合に使用できます。

取得したクライアントデータのレポート所有者を入力します。

この[Mode] (モード)リストからReport as a serviceが選択されている場合に使用できます。

[Report Name] (レポート名)

取得したクライアントデータのレポート名を入力します。

この[Mode] (モード)リストからReport as a serviceが選択されている場合に使用できます。

サービス

データの取得元となるWorkdayサービスの名前を入力します。

サービス名は、このフィールドの横にある[...]をクリックしてサービス名を入力し、ダイアログボックスのリストボックスから最も頻繁に使用される5つのサービス(Compensation、Financial_Management、Human_Resources、Payroll、Staffing)の一部(または全部)を選択して入力する方法もあります。リストボックスにないサービスを選択するためは、[Use custom value] (カスタム値を使用)オプションを選択し、[Custom value] (カスタム値)フィールドに目的のサービス名を入力します。

[Operation] (操作)

検索されたデータに対して行う操作の名前を入力します。

このフィールドの横にある[...]をクリックして操作名を入力し、表示されるダイアログ ボックスのリストボックスから必要な操作を選択することもできます。このリストボックスに操作が表示されるのは、Workdayサーバーへの接続に必要な情報がすべて提供されている場合に限られます。

現在のところ、実行できるのは名前がGet_で始まる操作のみです。

[Use references] (参照を使用)

検索されたデータにフィルターを設定する場合はこのオプションを選択します。

フィルターを設定するためには、[References] (参照)テーブルの下にあるプラスボタンをクリックしてこのテーブルに行を追加し、[Reference name] (参照名)カラムをクリックしてドロップダウンリストからフィールドを選択し、[Type] (タイプ)カラムをクリックしてドロップダウンリストからタイプを選択して[Value] (値)カラムに値を入力します。[Reference name] (参照名)カラムと[Type] (タイプ)カラムのドロップダウンリストに項目が表示されるのは、Workdayサーバーへの接続に必要な情報がすべて提供されている場合に限られます。

[Use criteria] (基準を使用)

検索されたデータに基準を設定する場合は、このオプションを選択します。

基準を設定する場合は、テーブルの下にあるプラスボタンをクリックし、[Criteria] (基準)テーブルに行を追加します。[Name] (名前)カラムをクリックし、ドロップダウンリストからフィールドを選択します。[Compound type] (複合型)カラムをクリックし、ドロップダウンリストからタイプを選択します。次に、必要であれば[Value] (値)カラムと[Group ID] (グループID)カラムに値を入力します。[Group ID] (グループID)カラムは、同じ名前の行をグループ化する必要がある場合に使用できます。[Name] (名前)カラムと[Compound type] (複合型)カラムのドロップダウンリストに項目が表示されるのは、Workdayサーバーへの接続に必要な情報がすべて提供されている場合に限られます。

[tStatCatcher Statistics] (tStatCatcher統計)

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

[Endpoint pattern] (エンドポイントパターン)

エンドポイントパターンを入力します。

• このフィールドは、[Authentication mode] (認証モード)ドロップダウンリストで[OAuth JWT authentication] (OAuth JWT認証)が選択されている場合のみ利用できます。
• 実際のエンドポイントパターンは、上記のエンドポイントパターンに基づいて顧客エンドポイントに合わせる必要があります。たとえばhttps://wd5-impl-services1.workday.com/ccx/service/customreport2/{tenant_alias}/{report_owner}/{report_name}を使ってWorkdayに接続する場合は、エンドポイントパターンの最初の部分をwd2-impl-services1.workday.comからwd5-impl-services1.workday.comに変更する必要があります。エンドポイントパターンは、[Endpoint pattern] (エンドポイントパターン)フィールドで手動で変更できます。
• このフィールドは、Talendが提供する8.0.1-R2022-12以降のTalend Studioマンスリーアップデートをインストール済みである場合に利用できます。詳細は管理者にお問い合わせください。

認証エンドポイントを入力します

このオプションは、[Basic settings] (基本設定)ビューで[Authentication mode] (認証モード)からREST - Client ID authentication modeを選択した場合に利用できます。

Web サービスのエンドポイントを入力します。

[API version] (APIバージョン)

使用したいAPIのバージョンを設定するために使われます。

このフィールドは、[Basic settings] (基本設定)ビューの[Mode] (モード)ドロップダウンリストから、[Workday web services] (Workday Webサービス)項目を選択した場合に使用できます。

ERROR_MESSAGE

エラー発生時にコンポーネントによって生成されるエラーメッセージ。これはAfter変数で、文字列を返します。

NB_LINE

処理された行数。これはAfter変数で、整数を返します。

使用ルール

このコンポーネントは、通常、ジョブまたはサブジョブの開始コンポーネントとして使い、常に出力リンクが必要です。