メモ: Workiva が開発したコネクターで、Workiva と Workday プラットフォームを接続できます。Workiva サポートでは、ワークスペース内でのコネクターの構成をガイドさせていただきます。ただし、Workday プラットフォームのエラーやトラブルシューティングは、Workday 管理者またはそのサポート チームが対応する必要があります。
Workday コネクターでは、コマンド をチェーンで使用して、Workday® HR および Financials と対話することができます：
- Workday からのカスタマイズレポートのダウンロード
- 予算データをWorkdayにインポート済み
- Workday Enterprise Interface Builder（EIB）統合の開始
要件
接続を設定するには、以下のものが必要です：
- 接続先の Workday テナント。
- 接続先のWorkday環境のホスト名とドメイン名。
- Workdayで作成された統合システムのユーザーの認証情報。
手順 1：Workday テナント情報を取得する
Workdayパブリック Web サービス WSDL XML ファイルからテナント、ホスト、およびドメイン情報を取得できます。
- Workday の検索バーに「Public Web Services」と入力し、レポートを選択します。
- 使用している特定の統合の Web サービスを検索します。
例としては、Get Workers 向けの人員配置、Import Budget 向けの財務管理、EIB 関連コマンドとの連携などが挙げられます。 - そのサービスの「関連アクション」ボタンをクリックし、次に「Webサービス」メニューの下にある「View WSDL 」をクリックします。
- XML ファイルで、
soapbind:address要素を探します（これは通常、ファイルの一番下にあります）。 -
の属性にある URL を使用して、その URL からテナント、ホスト、およびドメイン情報を抽出します。
URLは次の形式を採用しています：https://{host}.{domain}/ccx/service/{tenant}/public_web_service_name/version_number
例
上記の形式を使用すると、サンプルのWSDL URL（https://wd2-impl-services1.workday.com/ccx/service/mycompany/Financial_Management/v45.1）から、テナント、ホスト、ドメインを特定することができます。
| プロパティ | サンプル値 |
|---|---|
| テナント | マイカンパニー |
| ホスト | wd2-impl-services1 |
| ドメイン | workday.com |
次のステップでコネクタを設定する際、これらの値が必要になります。
ステップ 2: Workday 認証の設定
このコネクタでは、API 経由の OAuth2 とユーザー名＋パスワードの 2 つの認証方法が利用可能です。
OAuth2 API 認証
のOAuth2 API認証（ ）をご利用の場合は、WorkdayでAPIクライアントを設定しておく必要があります。APIクライアントの作成方法については、Workdayサポートページ「」および「 」を参照してください。
このAPIクライアントの設定を行うにあたり、以下の項目が揃っていることを確認してください：
- 「」のベアラーとして「」を選択し、「」のアクセストークンタイプとして「 」を選択しました。
- 以下のチェックボックスをオン（チェックマーク）にしました：
- 有効期限のないリフレッシュトークン
- Workdayが管理する範囲を含める
リダイレクトURL
Workivaでは、コネクタの設定用に地域ごとの「接続オーバーライドURL」が用意されています。 以下の表を参照して、お住まいの地域に応じた正しいURLを選択してください。
| 環境 | リダイレクト URI |
|---|---|
| APAC プロダクション（アジア太平洋地域） | https://h.apac.wdesk.com/s/wdata/oc/app/oauth/callback |
| CA prod（カナダ） | https://h.ca.wdesk.com/s/wdata/oc/app/oauth/callback |
| EU製品（EMEA） | https://h.eu.wdesk.com/s/wdata/oc/app/oauth/callback |
| 米国産（米国、中米、南米） | https://h.app.wdesk.com/s/wdata/oc/app/oauth/callback |
OAuth2 エンドポイント
OAuth2 を使用して接続を検証する場合は、以下のエンドポイント値が必要になります。これらは、Workdayの「」の「APIクライアントの編集」（ ）ページでWorkday APIクライアントを設定する際に一覧表示されます。
| エンドポイント | サンプル値 |
|---|---|
| Workday RESTエンドポイント | https://xxxx.workday.com/ccx/api/v1/xxxx |
| Workday OAuth2 トークンエンドポイント | https://xxxx.workday.com/ccx/oauth2/xxxx/token |
| Workday OAuth2 認証エンドポイント | https://xxxx.workday.com/xxxx/authorize |
ヒント： OAuth2トークンとシークレットを使用する既存のAPIクライアントインスタンスを利用している場合、この情報はWorkdayの「」の「APIを表示」ページ（ ）の上部に表示されています。
基本認証
のベーシック認証（ ）をご利用の場合は、Workdayサポートページ（）を参照し、Workdayで統合システムユーザー（ISU）アカウントを作成する方法については、こちら（ ）の手順に従ってください。
ステップ 3: Workday コネクタの設定
注： 組織のチェーンでこのコネクタを使用可能にするには、組織のセキュリティ管理者が、まずConfiguration から を有効にする必要があります。
- の「Chain Builder」（ ）から、「Connections」（）をクリックし、 を選択した後、右上の「Create」（ ）をクリックします。
- 「コネクタの接続」 において、「Workdayコネクタ」 およびデフォルトのCloudRunnerを選択します。
-
[基本情報]で、接続の識別に役立つ一意の名前と説明を入力します。
-
プロパティ で、接続の詳細を入力します。
OAuth2 を使用している場合は、（Workday REST エンドポイント： ）、（Workday OAuth2 トークンエンドポイント： ）、および（Workday OAuth2 認証エンドポイント： ）の各値を入力する必要があります。
のベーシック認証（ 、ユーザー名＋パスワード）を使用している場合は、これらの欄を空白のままにしてください。フィールド コンテンツ テナント 接続先の Workday テナント。 ホスト 接続先の Workday 環境のホスト。環境のURLにおいて、ドメイン プロパティの前の文字列がホストを表します。 ドメイン 接続先のWorkday環境のドメイン（
）には、workday.com、、またはmyworkday.com、などがあります。Workday RESTエンドポイント Workdayが提供するRESTエンドポイントのURL。
（OAuth2認証を使用する場合のみ。）Workday OAuth2 トークンエンドポイント Workdayが提供するOAuth2トークンのエンドポイントURL。
（OAuth2認証を使用する場合のみ。）Workday OAuth2 認証エンドポイント Workdayが提供するOAuth2エンドポイントのURL。
（OAuth2認証を使用する場合のみ。）
トラブルシューティング
Workday への接続に失敗した場合：
- 統合システムユーザーの認証情報が正しいことを確認します。
- 統合システムのユーザーが、接続のコマンドに関連する機能グループおよびドメインにアクセスするための適切な権限を持っていることを確認してください。
- コネクタに対して、正しいWorkdayテナント、ホスト、およびドメインが入力されていることを確認してください。
- カスタムレポートのダウンロード コマンドを実行する際は、レポートタイプが詳細 に設定されていることを確認してください。現時点では、Workday API を通じて複合レポートを取得することはできません。