メモ: 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の人材派遣、輸入予算の財務管理、EIB関連コマンドの統合など。 - そのサービスの "Related Actions "ボタンをクリックし、"Web Service "メニューのView WSDL 。
- XML ファイルで、
soapbind:address要素を探します（これは通常、ファイルの一番下にあります）。 -
location属性から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 認証の設定
このコネクタは認証に2つの方法を提供する：OAuth2 via API と User+Password です。
OAuth2 API認証
OAuth2 API 認証 を使用する場合は、Workday で API クライアントを設定する必要があります。API クライアントの作成方法については、Workday サポート ページRegister API Clients を参照してください。
このAPIクライアント・コンフィギュレーションの一部として、以下を確認してください：
- Access Token Type としてBearerを選択。
- 以下のチェックボックスを有効（マーク）：
- 期限切れでないリフレッシュ・トークン
- ワークデイの所有範囲を含める
リダイレクトURL
Workiva には、コネクタ設定のための地域固有の接続上書き URL があります。以下の表を参考に、お住まいの地域の正しいURLを選択してください。
北米、中米、南米にお住まいの方は、デフォルトのURLをご利用ください。アジア太平洋地域にお住まいの方は、APACのURLをご利用ください。EMEAにお住まいの方は、EUのURLをご利用ください。
| 環境 | リダイレクトURL |
|---|---|
| APAC製品 | https://h.apac.wdesk.com/s/wdata/oc/app/oauth/callback |
| EU製品 | 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 クライアント インスタンスを使用している場合、この情報は WorkdayView API ページの上部に表示されます。
基本認証
基本認証 を使用している場合は、Workday のサポート ページ統合システム ユーザー（ISU）アカウントの作成 を参照して、統合システム ユーザー（ISU）を作成します。
ステップ 3: Workday コネクタのセットアップ
注： 組織のチェーンでコネクタを使用できるようにするには、組織セキュリティ管理者がまず、構成 から、 コネクタを有効にする必要があります。
- Chain Builder からConnections をクリックし、右上のCreate をクリックする。
-
Connector Connection で、Workday Connector とデフォルトの CloudRunner を選択します。
-
[基本情報]で、接続の識別に役立つ一意の名前と説明を入力します。
-
プロパティ で、接続の詳細を入力します。
OAuth2 を使用している場合は、Workday REST Endpoint 、Workday OAuth2 Token Endpoint 、Workday OAuth2 Authorization Endpoint の値を入力する必要があります。
Basic Authentication (username+password) を使用している場合は、空白のままにしてください。フィールド コンテンツ テナント 接続先の Workday テナント。 ホスト 接続先の Workday 環境のホスト。環境の URL では、Domain プロパティの前の文字がホストを表します。 ドメイン workday.comまたはmyworkday.comのような
接続する Workday 環境のドメイン。Workday REST エンドポイント Workday が提供する REST エンドポイント URL。
(OAuth2認証を使用している場合のみ）。Workday OAuth2 トークン エンドポイント Workday が提供する OAuth2 トークンのエンドポイント URL。
(OAuth2認証を使用している場合のみ）。Workday OAuth2 認証エンドポイント Workday が提供する OAuth2 エンドポイント URL。
(OAuth2認証を使用している場合のみ）。
トラブルシューティング
Workday への接続に失敗した場合：
- 統合システムユーザーの認証情報が正しいことを確認します。
- 統合システムのユーザーが、接続のコマンドに関連する機能グループとドメインにアクセスするための適切な権限を持っていることを確認します。
- コネクタに正しい Workday テナント、ホスト、およびドメインが入力されていることを確認します。
- カスタムレポートのダウンロード コマンドを実行する際は、レポートタイプが詳細 に設定されていることを確認してください。現時点では、複合レポートは Workday API 経由では利用できません。