マイクロアプリ

Workdayの統合

Workdayと統合して、要求の送信、要求のステータスに関する通知の受信、および通知への対応を簡単に行えるようにします。このプロセスを完了すると、Citrixマイクロアプリの使用によって実行されたすべてのアクションを含む、既存のレベルの監査ログが保持されます。以下のプロセスを使用して、Workday統合を有効にします。追加設定不要のWorkdayマイクロアプリの一覧については、「Workdayマイクロアプリの使用」を参照してください。

2つのWorkday統合テンプレートが提供されています。キャッシュされたデータ構造を構成するためのより強力な機能を提供するため、ほとんどのユースケースでは新しいHTTP統合を使用することをお勧めします。各統合で使用可能なマイクロアプリについて詳しくは、「Workdayマイクロアプリの使用」を参照してください。

この手順では、新しいHTTPテンプレート統合をセットアップする方法について説明します。レガシーテンプレートに関する情報が必要な場合は、「レガシー統合の追加」を参照してください。プロセスの概要:

  1. マイクロアプリで統合をセットアップする前に、前提条件を満たしていることを確認してから、以下に詳細が記載されている次の手順を完了します:

    • APIクライアントを登録し、クライアントIDとクライアントシークレットを生成および収集することによって、APIアクセスを有効にします。
    • カスタムレポートを作成します。
    • カスタムレポートエンドポイントパスを生成します。
    • 有給休暇の種類をフィルタリングして、有給休暇のマイクロアプリを特定の種類の有給休暇に制限します。
    • Workspaceでディープリンクをセットアップします。
    • 休暇申請用のビジネスプロセスを編集します。
    • セキュリティグループの権限を管理します。
    • URL、インスタンスURL、およびテナントを特定します。
  2. Workday統合をセットアップします。詳しくは、「Citrix WorkspaceマイクロアプリへのWorkday統合の追加」を参照してください。
  3. サービスアクションパラメーターを設定します。詳しくは、「データの読み込み変数とサービスアクション変数の置換」を参照してください。

不明な点は、一般的なWorkday統合エラーのトラブルシューティングの記事をご覧ください。

必須条件の確認

このセットアッププロセスでは、Workdayコネクタの管理者アカウントおよび次のサービスアカウント権限が必要です。

  • 非一時カスタムレポートの作成へのアクセス。
  • 人事、統合、パフォーマンス管理、リソース管理、およびカスタムレポートAPIへのアクセス。
  • ディープリンクセットアッププロセスの一部であるマイルストーンデータのダウンロードでは、管理者に次のセキュリティグループが割り当てられている必要があります:
    • 人事管理者
    • 情報管理者
  • Citrix GatewayがWorkdayのシングルサインオンに対応するように構成して、ユーザーがログインすると、再度資格情報を入力しなくても自動的に再ログインできるようにします。Workday Single Sign-on構成の手順に従ってください。SSOの構成について詳しくは、「Citrix Gatewayサービス」を参照してください。

Workdayでこの統合をセットアップした後、マイクロアプリで統合をセットアップするときに、これらのアカウントの資格情報を入力するには、以下のアーティファクトが必要です:

  • URL
  • ユーザー名(Workdayユーザー名)
  • パスワード(Workdayパスワード)
  • Workdayテナント
  • クライアントID
  • クライアントシークレット
  • Workday REST APIエンドポイント
  • トークンエンドポイント
  • 承認エンドポイント
  • 収集されたカスタムレポートURL

Workday APIクライアントの登録

APIクライアントを登録して、各環境のクライアントIDとクライアントシークレットを生成します。複数の環境がある場合は、個々の環境ごとにAPIクライアントを登録する必要があります。Workday統合の場合、2つのコールバックURLを追加する必要があります。つまり、ユーザーアクション用と同期用に、2つの異なるAPIクライアントを登録する必要があります。この手順を2回実行します。最初にサービス認証のために 、次にサービスアクション認証のために実行します。これらの認証はコールバックURLが異なります。レガシー統合テンプレートの場合、2番目の操作のみを実行してクライアントを登録します。

OAuthサーバーの構成

統合を介してデータを読み取るようにOAuthサーバーを構成します。統合を構成するときに、これらの詳細をサービス認証に使用します。これは、HTTP統合に対してのみ実行されます。

  1. 管理者としてWorkdayにログインし、[Register API Client] を探します。以下の必須フィールドに入力します:

    • [Client Name] を入力します。
    • [Client Grant Type][Authorization Code Grant] を選択します。
    • [Access Token Type][Bearer] を選択します。
    • [Redirection URI] を入力します:https://{yourmicroappserverurl}/admin/api/gwsc/auth/serverContext。コールバックはターゲットアプリケーションによって異なり、統合の作成時にURLアドレスバーに表示されます。セクション{yourmicroappserverurl}は、テナント部分、リージョン部分、環境部分で構成されています:https://{tenantID}.{region(us/eu/ap-s)}.iws.cloud.com
    • [Refresh Token Timeout (in days)] に値300を入力します。
    • 以下の [Scope (Functional Areas)] を選択します:
      • Organizations and Roles
      • Staffing
      • Tenant Non-Configurable
  2. [OK] を選択します。クライアントIDとクライアントシークレットが生成されます。収集し、後でセットアッププロセス中に使用するために保存します。統合を構成するときに、これらの詳細をサービス認証に使用します。
  3. [Done] を選択して完了し、終了します。

OAuthクライアントの構成

統合を通じてデータをライトバックするようにOAuthクライアントを構成します。統合を構成するときに、これらの詳細をサービスアクション認証に使用します。

  1. 管理者としてWorkdayにログインし、[Register API Client] を探します。以下の必須フィールドに入力します:

    • [Client Name] を入力します。
    • [Client Grant Type][Authorization Code Grant] を選択します。
    • [Access Token Type][Bearer] を選択します。
    • [Redirection URI] を入力します:https://{yourmicroappserverurl}/app/api/auth/serviceAction/callback。コールバックはターゲットアプリケーションによって異なり、統合の作成時にURLアドレスバーに表示されます。セクション{yourmicroappserverurl}は、テナント部分、リージョン部分、環境部分で構成されています:https://{tenantID}.{region(us/eu/ap-s)}.iws.cloud.com
    • [Refresh Token Timeout (in days)] に値300を入力します。
    • 以下の [Scope (Functional Areas)] を選択します:
      • Organizations and Roles
      • Staffing
      • Tenant Non-Configurable
  2. [OK] を選択します。クライアントIDとクライアントシークレットが生成されます。収集し、後でセットアッププロセス中に使用するために保存します。統合を構成するときに、これらの詳細をサービスアクション認証に使用します。
  3. [Done] を選択して完了し、終了します。

API呼び出しのテスト

この記事では、すべてのAPI呼び出しを一覧で記載し、Workdayインスタンスでこれらの呼び出しの準備ができているすべてのエンドポイントがあるかどうかをテストする方法について詳しく説明します。詳しくは、「Workday API呼び出しのテスト」を参照してください。

カスタムレポートの作成

以下の各レポートについて、Workdayでカスタムレポートを作成します。添付のスプレッドシートをダウンロードし、スプレッドシートの説明に従って正確に詳細を入力します。入力した詳細が提供されているレポートと異なる場合、このプロセスは機能しません。たとえば、間違った名前を使用すると、レポートは生成されますが、データはダウンロードされません。

以下のレポートが現在のレポートです。この統合に新しいエンドポイントを追加すると、製品ドキュメントのここに追加されます。

  1. 以下のカスタムレポートスプレッドシートのいずれかを開きます:

  2. Workdayで [Create Custom Report] を探します。
  3. [Report Name] を入力します。この名前は、URLを作成するレポートのスプレッドシートと同一である必要があります。
  4. [Report Type] として [Advanced] を選択します。
  5. [Data Source] を入力します。この値は、URLを作成するレポートのスプレッドシートと同一である必要があります。
  6. [Optimized for Performance] チェックボックスはオンにしないでください。
  7. [Temporary Report] チェックボックスはオンにしないでください。
  8. [Enable As Web Service] チェックボックスをオンにします。
  9. [OK] を選択します。

    カスタムレポートは、入力した3つのフィールド以外は未入力で開きます。

  10. スプレッドシートに記載されているとおりに詳細を正確に入力します。見出しに注意してください。見出しはWorkday UIのタブと一致します。
  11. [Column Heading Override XML Alias] フィールドは、列に入力しているとおりに自動生成されます。[Column Heading Override XML Alias] の値がスプレッドシートの指示と一致することを確認します。この値は頻繁に変化します。
  12. [OK] を選択します。カスタムレポートが作成されます。

カスタムレポートエンドポイントパスの生成

前の手順で生成されたWSDLを使用して、カスタムレポートパスを収集します。セットアップ手順でTime off types per plan report pathおよびEvent records for milestone pathにカスタムレポートURLを入力するときに、これを使用します。

  1. 生成されたWSDLリンクをWebブラウザーで開きます。
  2. 一番下までスクロールして、2つのURLを見つけます。2番目のURLはReportRESTという名前です。これを使用します。
  3. このURLからパスをコピーし、Workday統合をセットアップするときに使用します。(パスの例:</ccx/service/customreport2/company_tenant/user_name/report_name>)。

有給休暇の種類のフィルタリング

PTOマイクロアプリを、バケーションや病気休暇などの特定の有給休暇タイプに限定します。Workdayで次のカスタムレポートを作成した場合、Workdayで計算フィールドを作成し、次の手順でカスタムレポートをフィルタリングする必要があります。

  • Event records for time off requests
  • Absence requests
  • All time offs and balance

有給休暇申請マイクロアプリの計算フィールドの作成

2つの計算フィールドを作成する必要があります。最初の計算フィールドは、有給休暇イベントから休暇の種類を取得することを目的としているため、2番目の計算フィールドを使用できます。2番目の計算フィールドは、カスタムレポートのフィルターとして使用されます。

  1. Workdayインスタンスにログオンし、[計算フィールドの作成]を見つけます。
  2. すべてのフィールドに入力します:
    • フィールド名 計算フィールドの名前を入力します。たとえば、次の形式では「SANDOVAL CF LKP Absence Type」としました:{(レポート作成者)(CF=calculated field:計算フィールド)(LKP=lookup related value:関連する値の参照)(このフィールドが返す値)}。
    • ビジネスオブジェクト [Time Off Event] を見つけて選択します。計算フィールドをこのビジネスオブジェクトの一部にしたいと思います。
    • 関数 [関連する値の参照] を見つけて選択します。
  3. 左下の [OK] をクリックします。
  4. [計算] タブで、次のフィールドに入力します:
    • 参照フィールド [Time Off Event] を見つけて選択します。
    • 戻り値 [Time Off Types for Time Off Event] を見つけて選択します
  5. [OK] > [完了] の順にクリックします。

計算フィールドを作成しました。次に、有給休暇イベントを取得し、フィルターとして使用される2番目のフィールドを作成します。

  1. 繰り返しになりますが、Workdayインスタンスから [計算フィールドの作成] を見つけます。
  2. すべてのフィールドに入力します:
    • フィールド名 計算フィールドの名前を入力します。たとえば、次の形式では「SANDOVAL CF LKP Time Off Event for Business Process」としました:{(レポート作成者)(CF=calculated field:計算フィールド)(LKP=lookup related value:関連する値の参照)(このフィールドが返す値)}。
    • ビジネスオブジェクト [アクションイベント] を見つけて選択します。計算フィールドをこのビジネスオブジェクトの一部にしたいと思います。
    • 関数 [関連する値の参照] を見つけて選択します。
  3. 左下の [OK] をクリックします。
  4. [計算] タブで、次のフィールドに入力します:
    • 参照フィールド [Time Off Event] を見つけて選択します。
    • 戻り値 作成した最初の計算フィールドを見つけて選択します。この例では、「SANDOVAL CF LKP Absence Type」です。
  5. [OK] > [完了] の順にクリックします。

有給休暇申請マイクロアプリの計算フィールドを使用したカスタムレポートのフィルタリング

有給休暇の種類をホワイトリストに追加するためにさきほど作成した新しい計算フィールドを使用して、有給休暇承認に関連するカスタムレポートにフィルターを追加します。これにより、選択したすべての有給休暇の種類を取得できます。

  1. Workdayインスタンスから [カスタムレポートの編集] を見つけ、有給休暇の承認に関連するカスタムレポートを選択します。この例では、「Event Records for Time Off Requests」です。
  2. [フィルター] タブを選択し、[+] をクリックして新しいフィルターを追加します。
  3. 次のフィールドに入力します:
    • および/または および
    • フィールドSANDOVAL CF LKP Time Off Event for Business Process」の例では、作成した2番目の計算フィールドを見つけて選択します。
    • 演算子 選択リストから任意のものを見つけて選択します。
    • 比較タイプ このフィルターで指定された値を見つけて選択します。
    • 比較値 ホワイトリストに追加する有給休暇の種類を見つけて選択します。例:
      • 年次休暇(日)
      • 年次休暇(法定)
      • 個人休暇(日)
      • 病気休暇(日)
      • 有給休暇
  4. [OK] をクリックして保存します。

注:

有給休暇の種類を禁止するには、*演算子フィールドを [選択リストなし] に変更してください。これにより、選択された有給休暇の種類を統合が取得できなくなります。

有給休暇申請の作成および自分の有給休暇申請マイクロアプリの既存のフィールドを使用したカスタムレポートのフィルタリング

カスタムレポートのフィルタリング: All time offs and balance

注:

すべてのカスタムレポートで同じ有給休暇の種類を使用することをお勧めします。このように、結果をホワイトリストに追加する、または禁止する場合、[比較値] の値はすべてのカスタムレポートで同じです。

  1. Workdayインスタンスから [カスタムレポートの編集] を見つけ、有給休暇の承認に関連するカスタムレポートを選択します。この例では、「 All time offs and balance」です。
  2. [フィルター] タブを選択し、[+] をクリックして新しいフィルターを追加します。
  3. 次のフィールドに入力します:
    • および/または および
    • フィールド カスタムレポートTime Off Typeを見つけて選択します。
    • 演算子 選択リスト内から見つけて選択します。
    • 比較タイプ このフィルターで指定された値を見つけて選択します。
    • 比較値 ホワイトリストに追加する有給休暇の種類を見つけて選択します。例:
      • 年次休暇(日)
      • 年次休暇(法定)
      • 個人休暇(日)
      • 病気休暇(日)
      • 有給休暇
  4. [OK] をクリックして保存します。

カスタムレポートのフィルタリング: Absence requests

  1. Workdayインスタンスから [カスタムレポートの編集] を見つけ、有給休暇の承認に関連するカスタムレポートを選択します。この例では、「Absence requests」です。
  2. [サブフィルター] タブを選択し、フィルターを追加した方法と同様に、[+]をクリックして新しいサブフィルターを追加します。
  3. 次のフィールドに入力します:
    • および/または および
    • フィールド カスタムレポートTime Off Type for Time Off Entryを見つけて選択します。
    • 演算子 選択リスト内から見つけて選択します。
    • 比較タイプ このフィルターで指定された値を見つけて選択します。
    • 比較値 ホワイトリストに追加する有給休暇の種類を見つけて選択します。例:
      • 有給休暇(日)
      • 病気休暇(日)
      • 病気休暇(時間)
  4. [OK] をクリックして保存します。

Workspaceでのディープリンクのセットアップ

この記事を参照したら、管理者に連絡して、WorkdayでCitrix Workspaceマイクロアプリのディープリンクをセットアップするように依頼してください。

以下のユースケースでは、対応するディープリンクが必要です。たとえば、ドメインがimpl.workday.comでテナントがcitrix_gms2vの場合、経費レポートの作成用のURLは次のようになります:https://impl.workday.com/citrix_gms2/d/task/2997$995.htmld

  • 経費レポートの作成 https://your_domain/your_tenant/d/task/2997$995.htmld

  • 職務変更の作成 https://your_domain/your_tenant/d/task/2997$4819.htmld

  • 職務変更の承認/拒否(職務変更申請) https://your_domain/your_tenant/d/unifiedinbox/initialinbox/2998$17139.htmld

注:

このデータを保存していない場合は、Workdayアカウントにログインして、URLからコピーしてください。統合が新しく追加されるたびに、これらのディープリンクを設定する必要があります。

休暇申請用のビジネスプロセスの編集

使用しているWorkdayテナントに応じて、休暇申請を作成するビジネスプロセスを確立させます。そのビジネスプロセスを、以下の手順に示すように変更します。

  1. Workdayで、[bp: request time off]を探して、[Request Time Off for Global Modern Services]を選択します。
  2. [Actions]>[Business Process]>[Edit Definition] と進みます。
  3. 必要な場合以外は [Effective Date] は変更せず、[OK]を選択します。
  4. [Business Process Steps] で、[+]アイコンを選択して新しい行を追加します。
  5. [Order]「b」 を入力します。
  6. [Type]「Approval」 を入力します。
  7. [Group] で、メニューから [Manager] を選択します。
  8. [OK] を選択して、[Done]を選択します。

セキュリティグループの権限の管理

セキュリティグループの適切なセキュリティ権限を有効にするには、2つの手順を実行します。最初にグループに権限を追加し、設定をアクティブ化します。次に、セキュリティグループを追加してすべてのリストを表示し、設定をアクティブ化します。

統合権限の追加とアクティブ化

  1. Workdayで、[view security group]を探します。
  2. 必要なセキュリティグループを検索して選択し、[OK] を選択します。
  3. [Actions]>[Security Group]>[Maintain Security Permissions] と移動します。
  4. [Integration Permissions] セクションにある [Domain Security Policies permitting Get access] フィールドで、次の権限のリストを検索し、それらすべてを追加します。検索ではコロン (:) を使用しないでください:

    Workday統合権限

    • Manage: Organization Integration
    • Worker Data: Public Worker Reports
    • Set Up: Spend Categories
    • Worker Data: Headcount Reports
    • Business Process Administration
    • Business Process Reporting
    • Set Up: Expense Item
    • Process: Purchase Order – View
    • Process: Expense Report – View
    • Worker Data: Active Employees
    • Worker Data: Current Staffing Information
    • Worker Data: Time Off (Time Off Balances)
    • Worker Data: Time Off (Time Off)
    • Worker Data: Time Off
    • Reports: Time Tracking
  5. [OK] を選択して確認し、[Done]を選択します。
  6. [Activate Pending Security Policy Changes] を探します。
  7. [Comment] フィールドに 「Activate」 と入力し、[OK]を選択します。
  8. [Confirm] チェックボックスをオンにして、[OK]を選択します。 権限が更新され、アクティブ化されました。

セキュリティグループを追加してアクティブ化し、すべてのリストを表示する

  1. [bp:change job] を探して、[Change Job for Global Modern Services]を選択します。
  2. [Actions]>[Business Process]>[Edit] と進みます。

    Workdayビジネスプロセスの画面

  3. [View All] セクションまでスクロールします。すべてを表示できるセキュリティグループのリストに、セキュリティグループを追加します。
  4. [OK] を選択して、[Done]を選択します。
  5. [Activate Pending Security Policy Changes] を探します。
  6. [Comment] フィールドに 「Activate」 と入力し、[OK]を選択します。
  7. [Confirm] チェックボックスをオンにして、[OK]を選択します。 権限が更新され、アクティブ化されました。

[View security group] を探し、自分のセキュリティグループを選択することによって、セキュリティグループを表示できます。現在、[Domain Security Policy Permissions][Business Process Security Policy Permissions] の2つのタブがあります。

ベースURLの検索

API呼び出しを有効にするには、Workday環境のベースURL(ドメイン)を入力する必要があります。形式はhttps://{domain}.workday.comです。たとえば、Workday REST APIエンドポイントhttps://wd2-impl-services1.workday.com/ccx/api/v1/citrix_gmsの場合、ベースURLはwd2-impl-services1です。次の手順に従って、ベースURLを特定します。

  1. 管理者としてWorkdayにログオンし、[View API Clients] を探します。
  2. [Workday REST API Endpoint] という最初のフィールドを見てください。形式はhttps://{domain}.workday.com/ccx/api/v1/{tenant}です。

Citrix WorkspaceマイクロアプリへのWorkday統合の追加

Workday統合をCitrix Workspaceマイクロアプリに追加して、アプリケーションに接続します。これにより、通知とアクションが設定済みとなっている追加設定不要のマイクロアプリを、Workspace内で使用できるようになります。

次の手順に従って、Workday HTTP統合をセットアップします。認証オプションは事前に選択されています。プロセスの完了時に、これらのオプションが選択されていることを確認してください。ほとんどのユースケースでは、この新しいHTTP統合を使用することをお勧めします。このHTTP統合は、キャッシュされたデータ構造を構成するためのより強力な機能です。

次の手順を実行します:

  1. [マイクロアプリ統合] ページで [新しい統合を追加] および [Citrix提供のテンプレートから新しい統合を追加する] を選択します。
  2. カタログの [統合] カテゴリからWorkdayタイルを選択します。
  3. 統合の [統合名] を入力します。
  4. コネクタのパラメーターを入力します。
    • インスタンスの [ベースURL] を入力します。これは、たとえばwd2-impl-services1など、Workday環境のドメインです。ベースURLの特定の詳細については、「ベースURLの検索」を参照してください。
    • アイコンライブラリから統合のアイコンを選択するか、デフォルトのアイコンのままにしておきます。
    • オンプレミス接続を作成する場合は、[オンプレミスインスタンス] を有効にします。詳しくは、「オンプレミスインスタンス」を参照してください。

    Workday HTTPパラメーター

  5. [Workdayユーザー名] を入力します。
  6. [Workdayパスワード] を入力します。
  7. [Workdayテナント] を入力します。テナントの特定について詳しくは、「ベースURLの検索」を参照してください。
  8. [サービス認証][認証方法] メニューから [Basic] を選択して認証の詳細を完了します。
  9. [ユーザー名][パスワード] を入力します。

    Workday HTTPサービス認証

  10. [サービスアクション認証][[アクション]で個別のユーザー認証を使用する] トグルを有効にします。サービスアクション認証は、サービスアクションレベルで認証します。

    1. [認証方法] メニューから [OAuth 2.0] を選択して認証の詳細を完了します。
    2. [許可の種類] メニューで [認証コード] を選択します。これによって、クライアントが交換するアクセストークン用の一時コードが付与されます。コードは認証サーバーから取得され、そこでクライアントが要求している情報を確認できます。この許可の種類のみが、安全なユーザーの偽装を有効にします。これにより、アプリケーションの登録時に使用する [コールバックURL] が表示されます
    3. [トークン認証] メニューから [認証ヘッダー] を選択します。
    4. [認証URL]を入力します。次はこの形式です: {instance_url}/{tenant}/authorize。これが、ターゲットアプリケーション統合をセットアップするときに提供される承認サーバーのURLです。ベースURLとテナントの特定について詳しくは、「ベースURLの検索」を参照してください。
    5. [トークンURL]を入力します。次はこの形式です: {base_url}.workday.com/ccx/oauth2/{tenant}/token。これが、アクセス承認トークンのURLです。
    6. [クライアントID] を入力します。クライアントIDは、承認サーバーに固有のクライアント登録情報を表す文字列です。GoogleアカウントでOAuthクライアントを登録して、これとシークレットを収集します。統合構成ページに表示される [コールバックURL] を追加する必要があります。
    7. [クライアントシークレット] を入力します。クライアントシークレットは、ターゲットアプリケーション統合のセットアップ時に発行される一意の文字列です。

    Workday HTTPサービスアクション認証

  11. (オプション)この統合のレート制限をアクティブ化する場合は、[要求レート制限] を有効にし、[時間間隔] あたりの [要求数] を設定します。
  12. (オプション)サポートのために24時間のログを保持するには、[ログ] を有効にします。

    レート制限とログの切り替え

  13. [保存] を選択して続行します。
  14. [OAuth認証][承認] を選択して、サービスアカウントにログインします。Workdayのログイン画面がポップアップで表示されます。
    1. サービスアカウントのユーザー名とパスワードを入力し、[ログイン] を選択します。
    2. [同意] を選択します。 サービス認証

データの読み込み変数とサービスアクション変数の置換

このセットアップを完了するには、使用するテナントおよび認証に使用するユーザーの資格情報に、Workday統合構成の{tenant}変数と{user}変数を置き換える必要があります。

  1. [マイクロアプリ統合] ページから、Workday統合の横にあるメニューを選択し、[編集] を選択します。[データの読み込み] 画面が開きます。開かない場合は、左側のナビゲーション列から [データの読み込み] を選択します。
  2. データエンドポイントごとに、次の詳細情報を手動で追加する必要があります:{tenant}/{user}。これを6回行います。エンドポイントの横にあるメニューを選択し、[編集] を選択します。

  3. [データエンドポイントの編集] 画面の [パス] タブで、使用するテナントユーザーを空のフィールドに追加します。
  4. [適用] を選択して、確定します。他の5つのデータエンドポイントについても繰り返します。

    詳細情報が入力されたサービスアクションパラメーター

  5. サービスアクションごとに、次の詳細情報を手動で追加する必要があります:{tenant}。これを2回行います。統合の編集中に、左側のナビゲーション列から [サービスアクション] を選択します。いずれかのサービスアクションの横にあるメニューを選択し、[編集] を選択します。

    詳細情報が入力されたサービスアクションパラメーター

  6. [サービスアクションの編集] 画面の [アクションの実行][PATH] タブにあるテナントの値(citrix_gms2)を使用するテナントに置き換えます。

    詳細情報が入力されたサービスアクションパラメーター

  7. [アクション後のデータ更新] を削除して再作成する必要があります。[アクション後のデータ更新] ラベルの横にある [削除] アイコンを選択してこのセクションを削除します。
  8. [+ データ更新の追加] を選択します。
  9. [データエンドポイント] メニューから [休暇申請] を選択します。
  10. [クエリ] タブを選択し、[+ パラメーターの追加] を選択します。
  11. パラメーター名 に「Completed_Date_On_or_After」と入力します。[パラメーターの選択] メニューから、[タイムスタンプ] を選択します。

    詳細情報が入力されたサービスアクションパラメーター

  12. [保存] を選択して終了します。他のサービスアクションについてもこの手順を繰り返します。

これで、最初のデータ同期を設定して実行する準備ができました。統合アプリケーションからマイクロアプリプラットフォームに大量のデータをプルできるので、[テーブル] ページを使用して、最初のデータ同期のエンティティをフィルタリングし、同期を高速化することをお勧めします。詳しくは、「必要なエンティティの確認」を参照してください。同期ルール、スケジュールを満たさない同期、および拒否ルールの詳細については、「データの同期」を参照してください。

APIエンドポイントとテーブルエンティティについて詳しくは、「Workday HTTPコネクタの仕様」を参照してください。

Workdayマイクロアプリの使用

Workday HTTP統合テンプレートには、以下の設定済みで追加設定不要のマイクロアプリが付属しています:

有給休暇申請の作成: 有給休暇(PTO)申請を提出します。

通知またはページ ユースケースワークフロー
休暇申請ページ タイプ、開始日、終了日の選択、およびオプションでのコメントの追加を含む、有給休暇(PTO)申請を作成するためのフォームを提供します。

職務変更: 職務変更申請を表示して承認します。

通知またはページ ユースケースワークフロー
承認が必要な新規職務変更申請通知 新しい職務変更の承認依頼を受け取ると、承認者は通知を受け取ります。
職務変更の承認ページ 職務変更申請の詳細ビューを備えたアクション可能なフォームを提供します。
承認が必要な職務変更ページ 承認者の承認待ちの職務変更申請の読み取り専用ビューを提供します。

職務変更の作成: 職務変更申請を作成します。

通知またはページ ユースケースワークフロー
職務変更の作成ページ 職務変更を作成するためのページを提供します。WorkdayでCitrix Workspaceマイクロアプリのディープリンクをセットアップする必要があります。

経費レポートの作成: 経費レポートを作成します。

通知またはページ ユースケースワークフロー
経費レポートの作成ページ 経費レポートを作成するためのフォームを提供します。WorkdayでCitrix Workspaceマイクロアプリのディープリンクをセットアップする必要があります。

自分の有給休暇申請: パーソナライズされた休暇申請一覧を表示します。

通知またはページ ユースケースワークフロー
休暇申請状況更新通知 有給休暇申請の状況が変更されると、有給休暇申請の所有者は通知を受け取ります。
自分の有給休暇ページ 休暇申請の提出日とその状況を含むユーザーのアクティブな休暇申請の読み取り専用ビューを提供します。
有給休暇詳細ページ ユーザーのすべての休暇申請の詳細ビューを提供します。

有給休暇申請: 有給休暇(PTO)申請を表示して承認します。

通知またはページ ユースケースワークフロー
承認が必要な新規休暇通知 新規休暇の承認依頼を受け取ると、承認者は通知を受け取ります。
休暇申請の承認ページ 休暇申請の詳細ビューを備えたアクション可能なフォームを提供します。
承認が必要な休暇申請ページ 承認者の承認待ちの休暇申請の読み取り専用ビューを提供します。

レガシー統合の追加

次の手順に従って、レガシー統合をセットアップします。

カスタムレポートの作成

以下の各レポートについて、Workdayでカスタムレポートを作成します。添付のスプレッドシートをダウンロードし、スプレッドシートの説明に従って正確に詳細を入力します。入力した詳細が提供されているレポートと異なる場合、このプロセスは機能しません。たとえば、間違った名前を使用すると、レポートは生成されますが、データはダウンロードされません。

次のレポートはレガシーレポートです。この統合に新しいエンドポイントを追加すると、製品ドキュメントのここに追加されます。

  1. 以下のカスタムレポートスプレッドシートのいずれかを開きます:

  2. 上記のプロセスに従ってください。

カスタムレポートURLの生成

カスタムレポートのデータをダウンロードして通知を生成するには、カスタムレポートのURLを生成し、WSDLをダウンロードする必要があります。マイクロアプリの設定手順を完了するには、これらのURLが必要です。

  1. Workdayで、作成したカスタムレポートを開きます。
  2. [Actions] を選択し、レポートの名前を選択して設定を開きます。
  3. [Actions]>[Web Service]>[View URLs] >[WSDLs]を選択します。
  4. [Entered On] フィールドに日付を入力します。
  5. [Workday XML]セクションにあるWSDLリンクを右クリックして、[Copy URL]を選択します。(URLの例:https://wd2-impl-services1.workday.com/ccx/service/customreport2/company_tenant/user_name/report_name?wsdl)

このURLを保存して、「Citrix Workspaceマイクロアプリへの統合の追加」手順でマイクロアプリをセットアップするときに使用します。

有給休暇の種類のフィルタリング

PTOマイクロアプリを、バケーションや病気休暇などの特定の有給休暇タイプに限定します。Workdayで次のカスタムレポートを作成した場合、Workdayで計算フィールドを作成し、次の手順でカスタムレポートをフィルタリングする必要があります。

  • Event Records for time off requests
  • Time off request details
  • Time off types per plan

有給休暇申請マイクロアプリの計算フィールドの作成

2つの計算フィールドを作成する必要があります。最初の計算フィールドは、有給休暇イベントから休暇の種類を取得することを目的としているため、2番目の計算フィールドを使用できます。2番目の計算フィールドは、カスタムレポートのフィルターとして使用されます。

  1. Workdayインスタンスにログオンし、[計算フィールドの作成]を見つけます。
  2. すべてのフィールドに入力します:
    • フィールド名 計算フィールドの名前を入力します。たとえば、次の形式では「SANDOVAL CF LRV Absence Type」としました:{(レポート作成者)(CF=calculated field:計算フィールド)(LRV=lookup related value:関連する値の参照)(このフィールドが返す値)}。
    • ビジネスオブジェクト [Time Off Event] を見つけて選択します。計算フィールドをこのビジネスオブジェクトの一部にしたいと思います。
    • 関数 [関連する値の参照] を見つけて選択します。
  3. 左下の [OK] をクリックします。
  4. [計算] タブで、次のフィールドに入力します:
    • 参照フィールド [Time Off Event] を見つけて選択します。
    • 戻り値 [Time Off Types for Time Off Event] を見つけて選択します
  5. [OK] > [完了] の順にクリックします。

計算フィールドを作成しました。次に、有給休暇イベントを取得し、フィルターとして使用される2番目のフィールドを作成します。

  1. 繰り返しになりますが、Workdayインスタンスから [計算フィールドの作成] を見つけます。
  2. すべてのフィールドに入力します:
    • フィールド名 計算フィールドの名前を入力します。たとえば、次の形式では「SANDOVAL CF LRV Time Off Event for Business Process」としました:{(レポート作成者)(CF=calculated field:計算フィールド)(LRV=lookup related value:関連する値の参照)(このフィールドが返す値)}。
    • ビジネスオブジェクト [アクションイベント] を見つけて選択します。計算フィールドをこのビジネスオブジェクトの一部にしたいと思います。
    • 関数 [関連する値の参照] を見つけて選択します。
  3. 左下の [OK] をクリックします。
  4. [計算] タブで、次のフィールドに入力します:
    • 参照フィールド [Time Off Event] を見つけて選択します。
    • 戻り値 作成した最初の計算フィールドを見つけて選択します。この例では、「SANDOVAL CF LRV Absence Type」です。
  5. [OK] > [完了] の順にクリックします。

有給休暇申請マイクロアプリの計算フィールドを使用したカスタムレポートのフィルタリング

有給休暇の種類をホワイトリストに追加するためにさきほど作成した新しい計算フィールドを使用して、有給休暇承認に関連するカスタムレポートにフィルターを追加します。これにより、選択したすべての有給休暇の種類を取得できます。

  1. Workdayインスタンスから [カスタムレポートの編集] を見つけ、有給休暇の承認に関連するカスタムレポートを選択します。この例では、「Event Records for Time Off Requests」です。
  2. [フィルター] タブを選択し、[+] をクリックして新しいフィルターを追加します。
  3. 次のフィールドに入力します:
    • および/または および
    • フィールドSANDOVAL CF LRV Time Off Event for Business Process」の例では、作成した2番目の計算フィールドを見つけて選択します。
    • 演算子 選択リストから任意のものを見つけて選択します。
    • 比較タイプ このフィルターで指定された値を見つけて選択します。
    • 比較値 ホワイトリストに追加する有給休暇の種類を見つけて選択します。例:
      • 年次休暇(日)
      • 年次休暇(法定)
      • 個人休暇(日)
      • 病気休暇(日)
      • 有給休暇
  4. [OK] をクリックして保存します。

注:

有給休暇の種類を禁止するには、*演算子フィールドを [選択リストなし] に変更してください。これにより、選択された有給休暇の種類を統合が取得できなくなります。

有給休暇申請の作成および自分の有給休暇申請マイクロアプリの既存のフィールドを使用したカスタムレポートのフィルタリング

「Time off types per plan」カスタムレポートをフィルタリングします。

注:

すべてのカスタムレポートで同じ有給休暇の種類を使用することをお勧めします。このように、結果をホワイトリストに追加する、または禁止する場合、[比較値] の値はすべてのカスタムレポートで同じです。

  1. Workdayインスタンスから [カスタムレポートの編集] を見つけ、有給休暇の承認に関連するカスタムレポートを選択します。この例では、「Time off request details」です。
  2. [フィルター] タブを選択し、[+] をクリックして新しいフィルターを追加します。
  3. 次のフィールドに入力します:
    • および/または および
    • フィールド カスタムレポートTime Off Typeを見つけて選択します。
    • 演算子 選択リスト内から見つけて選択します。
    • 比較タイプ このフィルターで指定された値を見つけて選択します。
    • 比較値 ホワイトリストに追加する有給休暇の種類を見つけて選択します。例:
      • 年次休暇(日)
      • 年次休暇(法定)
      • 個人休暇(日)
      • 病気休暇(日)
      • 有給休暇
  4. [OK] をクリックして保存します。

「Time off request details」カスタムレポートをフィルタリングします。

  1. Workdayインスタンスから [カスタムレポートの編集] を見つけ、有給休暇の承認に関連するカスタムレポートを選択します。この例では、「Time off request details」です。
  2. [サブフィルター] タブを選択し、フィルターを追加した方法と同様に、[+]をクリックして新しいサブフィルターを追加します。
  3. 次のフィールドに入力します:
    • および/または および
    • フィールド カスタムレポートTime Off Type for Time Off Entryを見つけて選択します。
    • 演算子 選択リスト内から見つけて選択します。
    • 比較タイプ このフィルターで指定された値を見つけて選択します。
    • 比較値 ホワイトリストに追加する有給休暇の種類を見つけて選択します。例:
      • 有給休暇(日)
      • 病気休暇(日)
      • 病気休暇(時間)
  4. [OK] をクリックして保存します。

Workspaceでのディープリンクのセットアップ

この記事を参照したら、管理者に連絡して、WorkdayでCitrix Workspaceマイクロアプリのディープリンクをセットアップするように依頼してください。

以下のユースケースでは、対応するディープリンクが必要です。たとえば、ドメインがimpl.workday.comでテナントがcitrix_gms2vの場合、経費レポートの作成用のURLは次のようになります:https://impl.workday.com/citrix_gms2/d/task/2997$995.htmld

  • 経費レポートの作成 https://your_domain/your_tenant/d/task/2997$995.htmld

  • マイルストーンの作成 https://your_domain/your_tenant/d/task/2998$8704.htmld

  • 職務変更の作成 https://your_domain/your_tenant/d/task/2997$4819.htmld

  • 職務変更の承認/拒否(職務変更申請) https://your_domain/your_tenant/d/unifiedinbox/initialinbox/2998$17139.htmld

注:

このデータを保存していない場合は、Workdayアカウントにログインして、URLからコピーしてください。統合が新しく追加されるたびに、これらのディープリンクを設定する必要があります。

Citrix Workspaceマイクロアプリへの統合の追加

次の手順に従って、レガシーのWorkday統合をセットアップします。

次の手順を実行します:

  1. 概要ページから、[はじめに]を選択します。

    [統合の管理]ページが開きます。

  2. [新しい統合を追加] および [Citrix提供のテンプレートから新しい統合を追加する] を選択します。
  3. Workdayタイルを選択します。
  4. [統合名] を入力します。
  5. 前提条件として収集したコネクタのパラメーターを入力します。
    • URLを入力してAPI呼び出しを有効にします。これは、たとえばwd2-impl-services1など、Workday環境のドメインです。ベースURLの特定の詳細については、「ベースURLの検索」を参照してください。
    • [インスタンスURL] にWorkdayインスタンスを入力します。Workday環境にログインし、インスタンスのURLをコピーして、インスタンスドメインを見つけます。たとえば、https://impl.workday.comなどです。
    • Workdayの [テナント] の場所を入力します。「ベースURLの検索」でWorkdayテナントを識別する例を見つけます。
    • 前提条件の手順で収集した [クライアントID][クライアントシークレット] を入力します。
    • [ユーザー名][パスワード] を入力します。
    • 読み込む日数 を入力して、データを読み込むときの日数の制限を設定します。
  6. Workdayが計算する休暇申請を作成して、データをダウンロードし、そのデータに基づいて通知を生成する場合は、[休暇モジュールを有効にしますか?][はい] に切り替えます。これらのURLとパスは、「カスタムレポートURLの生成」および「カスタムレポートパスの生成」の手順で収集しました。

    • [Time off request detailsレポートURL] にカスタムレポートURLを入力します。
    • [Time off types per plan report path] にカスタムレポートパスを入力します。
    • [Event records for time off requestsレポートURL] にカスタムレポートURLを入力します。
  7. Workdayが計算する職務変更申請を作成して、データをダウンロードし、そのデータに基づいて通知を生成する場合は、[職務変更モジュールを有効にしますか?][はい] に切り替えます。これらのURLは「カスタムレポートURLの生成」の手順で収集しました。

    • [Event records for change jobレポートURL] にカスタムレポートURLを入力します。
    • [Staffing activitiesレポートURL] にカスタムレポートURLを入力します。
  8. Workdayが計算する経費レポートを作成して、データをダウンロードし、そのデータに基づいて通知を生成する場合は、[経費モジュールを有効にしますか?][はい] に切り替えます。これらのURLは「カスタムレポートURLの生成」の手順で収集しました。

    • [Event records for expensesレポートURL] にカスタムレポートURLを入力します。
  9. 注文書を作成して、データをダウンロードし、そのデータに基づいて通知を生成する場合は、[注文書モジュールを有効にしますか?][はい] に切り替えます。これはパブリックAPIを使用しており、カスタムレポートが必要です。

  10. マイルストーンアイテムを作成して、データをダウンロードし、そのデータに基づいて通知を生成する場合は、[マイルストーンアイテムをダウンロードしますか?][はい] に切り替えます。これらのパスは「カスタムレポートパスの生成」の手順で収集しました。

    • [Event records for milestone path] にカスタムレポートURLを入力します。
  11. [追加] を選択します。

[マイクロアプリ統合] ページが開き、追加した統合とそのマイクロアプリが表示されています。ここから別の統合を追加したり、追加設定不要のマイクロアプリのセットアップを続行したり、この統合用の新しいマイクロアプリを作成したりできます。

レガシーのWorkdayマイクロアプリ

レガシーのWorkday統合テンプレートには、以下の設定済みで追加設定不要のマイクロアプリが付属しています:

職務変更申請: 職務変更申請を表示して承認します。

通知またはページ ユースケースワークフロー
承認が必要な新規職務変更申請通知 新しい職務変更の承認依頼を受け取ると、承認者は通知を受け取ります。
職務変更の承認ページ 職務変更申請の詳細ビューを備えたアクション可能なフォームを提供します。
承認が必要な職務変更ページ 承認者の承認待ちの職務変更申請の読み取り専用ビューを提供します。

職務変更の作成: 職務変更申請を作成します。

通知またはページ ユースケースワークフロー
職務変更の作成ページ 職務変更を作成するためのページを提供します。WorkdayでCitrix Workspaceマイクロアプリのディープリンクをセットアップする必要があります。

経費レポートの作成: 経費レポートを作成します。

通知またはページ ユースケースワークフロー
経費レポートの作成ページ 経費レポートを作成するためのフォームを提供します。WorkdayでCitrix Workspaceマイクロアプリのディープリンクをセットアップする必要があります。

マイルストーンの作成: マイルストーンを作成します。

通知またはページ ユースケースワークフロー
マイルストーンの作成ページ マイルストーンを作成するためのフォームを提供します。WorkdayでCitrix Workspaceマイクロアプリのディープリンクをセットアップする必要があります。

有給休暇申請の作成: 有給休暇(PTO)申請を提出します。

通知またはページ ユースケースワークフロー
有給休暇申請ページ タイプ、開始日、終了日の選択、およびオプションでのコメントの追加を含む、有給休暇(PTO)申請を作成するためのフォームを提供します。

経費レポート: 経費レポートを表示して承認します。

通知またはページ ユースケースワークフロー
承認が必要な新規経費レポート通知 新しい経費の承認依頼を受け取ると、承認者は通知を受け取ります。
経費レポートの承認ページ 経費レポートの詳細ビューを備えたアクション可能なフォームを提供します。
承認が必要な経費レポートページ 承認者の承認待ちの経費レポート申請の読み取り専用ビューを提供します。

マイルストーン: マイルストーンの詳細を表示し、マイルストーンの更新を受信します。

通知またはページ ユースケースワークフロー
マイルストーン状況の更新通知 マイルストーンが更新されると、マイルストーンが割り当てられた従業員は通知を受け取ります。
マイルストーンの詳細 ユーザーのすべてのマイルストーンの詳細ビューを提供します。
マイルストーン 検索可能なユーザーのマイルストーンの一覧を提供します。

自分の経費: パーソナライズされた、レポートの詳細と個々の経費項目の詳細を含む経費レポート一覧を表示します。

通知またはページ ユースケースワークフロー
経費申請状況更新通知 経費の申請状況が変更されると、経費申請の所有者は通知を受け取ります。
経費レポートの詳細ページ ユーザーのすべての経費の詳細ビューを提供します。
経費レポート報告系統の詳細ぺージ ユーザーの費用の1つの詳細ビューを提供します。
自分の経費ぺージ ユーザーの経費の読み取り専用ビューを提供します。

自分の有給休暇申請: パーソナライズされた休暇申請一覧を表示します。

通知またはページ ユースケースワークフロー
有給休暇申請状況更新通知 有給休暇申請の状況が変更されると、有給休暇申請の所有者は通知を受け取ります。
自分の有給休暇申請ページ 休暇申請の提出日とその状況を含むユーザーのアクティブな休暇申請の読み取り専用ビューを提供します。
有給休暇申請の詳細ページ ユーザーのすべての休暇申請の詳細ビューを提供します。

注文書: 注文書の詳細を含む注文書を表示します。

通知またはページ ユースケースワークフロー
自分の注文書ページ ユーザーのアクティブな注文書の読み取り専用ビューを提供します。
注文書の詳細ページ ユーザーのすべての注文書の詳細ビューを提供します。

有給休暇の残り日数: パーソナライズされた残りの休暇日数の一覧を表示します。

通知またはページ ユースケースワークフロー
有給休暇の残り日数ページ ユーザーの残りの休暇日数の読み取り専用ビューを提供します。

有給休暇申請: 有給休暇(PTO)申請を表示して承認します。

通知またはページ ユースケースワークフロー
承認が必要な新規休暇通知 新規休暇の承認依頼を受け取ると、承認者は通知を受け取ります。
休暇申請の承認ページ 休暇申請の詳細ビューを備えたアクション可能なフォームを提供します。
承認が必要な休暇申請ページ 承認者の承認待ちの休暇申請の読み取り専用ビューを提供します。