• 関連ドキュメント

自動化で Workday を使用する

自動化による Workday 統合は、Jira Service Management Cloud Premium プランまたは Enterprise プランのカスタマーのみ利用できます。プランのアップグレード方法をご確認ください。

Workday アカウントを Jira プロジェクトに接続すると、従業員のオンボーディングやその他の人事タスクのプロセスを自動化できます。Workday を Jira 自動化に接続するには、Jira 管理者である必要があります。

Workday に API クライアントを登録する

プロジェクトと Workday を接続する前に、Workday に API クライアントを登録する必要があります。

  1. Workday のアカウントにサインインします。

  2. ページ上部の検索ボックスに、「Register API client (API クライアントを登録)」と入力します。

  3. [Register API Client (API クライアントを登録)] を選択します。

  4. フォームに入力します。詳細については、Workday コミュニティで「Register API client (API クライアントを登録)」を検索してください。
    フォーム フィールドの説明:

    1. Client Grant Type (クライアントの付与タイプ): [Authorisation Code Grant (認証コードの付与)] を選択します。

    2. Access Token Type (アクセス トークンのタイプ): [Bearer (ベアラー)] を選択します。

    3. Redirection URI: https://id.atlassian.com/outboundAuth/finish

    4. Non-Expiring Refresh Tokens (有効期限のないリフレッシュ トークン): [Yes (はい)] を選択します。

    5. Scope (Functional Areas) (範囲 (機能領域)): [Staffing (人員)] 検索して選択します。

  5. [OK] を選択します。

次の画面では、Jira を Workday に接続するために必要なすべての詳細情報が表示されます。これらの詳細情報は後から Workday で確認できますが、「Client Secret (クライアント シークレット)」は一度しか表示されません。安全な場所に保存しておくことをお勧めします。

Workday での統合に使用する API クライアントを登録する

プロジェクトと Workday を接続する前に、Workday に API クライアントを登録する必要があります。

  1. Workday のアカウントにサインインします。

  2. ページ上部の検索ボックスに、「Register API client for integrations (統合用の API クライアントを登録)」と入力します。

  3. [Register API client for integrations (統合用の API クライアントを登録)] を選択します。

  4. フォームに入力します。
    フォーム フィールドの説明:

    1. Non-Expiring Refresh Tokens (有効期限のないリフレッシュ トークン): [Yes (はい)] を選択します。

    2. Scope (Functional Areas) (範囲 (機能領域)): [Staffing (人員)] 検索して選択します。

  5. [OK] を選択します。

次の画面では、Jira を Workday に接続するために必要な詳細情報の一部が表示されます。これらの詳細情報は後から Workday で確認できますが、「Client Secret (クライアント シークレット)」は一度しか表示されません。安全な場所に保存しておくことをお勧めします。

リフレッシュ トークンを生成するには、次の手順を実行します。

  1. ページ上部の検索ボックスに、「View API clients (API クライアントを表示)」と入力します。

    1. API クライアントと統合用の API クライアントの両方が表示されます。

  2. [API Client for Integrations (統合用の API クライアント)] タブを選択します。

  3. 使用する API クライアントを選択します。

  4. API クライアントのタイトルの横にある [...] (その他のアクション) を選択します。

  5. [API クライアント]、[Manage Refresh Tokens for Integrations (統合用のリフレッシュ トークンを管理)] の順に選択します。

  6. [Workday アカウント] フィールドで、リフレッシュ トークンを関連付けるアカウントを検索します。

  7. [OK] を選択します。

  8. [Generate New Refresh Token (新しいリフレッシュ トークンを生成)] チェックボックスを選択します。

  9. [OK] を選択します。

自動化ルールを Workday と統合する

Workday と統合するトリガーまたは Workday と統合するアクション (またはその両方) を使用して 自動化ルールを作成する ことを選択できます。Workday と統合するルールを作成するたびに、Workday で API クライアントを登録したときに受け取った詳細を使用して接続を作成する必要があります。

はじめる前に

Workday にサインインするには、個人の Workday アカウントまたは統合システム ユーザー (ISU) を使用できます。ISU は統合専用のアカウントであり、実際の従業員には関連付けられていません。ISU は、統合アクティビティを分離し、中断を防ぎ、セキュリティを向上させるため、好まれます。この接続を機能させるには、以下の手順に従って、必要なドメインのアクセス許可を持つ統合システム セキュリティ グループに ISU を割り当てます。

Workday でセキュリティ グループの権限を設定します。

  • [Domain Security Policies permitting View access (閲覧アクセスを許可するドメイン セキュリティ ポリシー)] フィールドの [Report/Task Permissions (レポート/タスク権限)] で、[Worker Data: Public Worker Reports (従業員データ: 公開従業員レポート)] を選択します。

  • [Domain Security Policies permitting Get access (取得アクセスを許可するドメイン セキュリティ ポリシー)] フィールドの [Integration Permissions (統合権限)] で、[Worker Data: Current Staffing Information (従業員データ: 現在の人員情報)] を選択します。

Workday トリガーを使用してルール作成する

「Workday に従業員が追加される」トリガーは、Workday インスタンスに新しい従業員が追加されると実行されます。これは、ワークフローのトリガー、ウェルカム メールの送信、他のチームとのコラボレーションによって、新しい従業員向けのオンボーディング プロセスを開始するのに役立ちます。

このトリガーを使用するルールを作成するには、次の手順に従います。

  1. サービス プロジェクトで、[プロジェクト設定] > [自動化] の順に選択します。

  2. [ルールを作成] を選択します。

  3. [トリガーの追加 ] 検索ボックスで、「Workday」検索し、Workday に追加された作業者 を選択します。

  4. [Connect] を選択します。

  5. Workday に API クライアントを登録したときに受け取った詳細情報をフォームに記入します。

    • SSO (シングル サインオン) をバイパスして、別の方法を使用した接続を承認するには、[認証エンドポイント] フィールドで、認証エンドポイント URL の末尾に「?redirect=n」と入力します。

  6. [Connect] を選択します。

  7. 承認のため、自動で Workday に移動します。

    1. Workday にサインインします。

    2. 「Workday を承認」するように求められたら、[Allow (許可)] を選択します。

  8. API トークン作成して Workday にコピーします。

    1. [API トークンを生成] を選択します。Atlassian API トークンが表示されます。

    2. [API トークンを作成] を選択します。

    3. トークンにラベルを付けて、[作成] を選択します。

    4. [コピー] を選択します。

  9. Workday では、クラウド統合テンプレートを使用して統合システムを作成します。

    1. 「イベント・サブスクリプション」で、「特定のトランザクション・タイプへのサブスクライブ」を選択し、「雇用 - 従業員の雇用イベント」を選択します。

    2. In the External Endpoints section, paste the following:

    • Your Webhook URL into the Notification URL field.

    • Your Atlassian username into the Notification User Name field.

    • Your Atlassian API token into the Notification Password field.

  10. [OK] を選択します。

統合システムの作成方法については、Workday コミュニティで「create integration system (統合システムの作成)」を検索してください。

Workday アクションを使用するルールを作成する

次のアクションが可能です。

Workday から従業員情報を取得

「Workday から従業員情報を取得」アクションを使用すると、Workday から従業員に関する特定の詳細を取得して、Jira プロジェクトで使用できます。これは、オンボーディング プロセスを合理化し、クエリを解決する際に従業員の詳細を収集するのに役立ちます。

カスタム Workday リクエストを送信

[カスタム Workday リクエストを送信] アクションを使用すると、HTTP リクエストの Get、Post、Put、Delete を使用して、Workday にカスタム リクエストを送信できます。これは、Workday での幅広いタスクを自動化する場合に役立ちます。このアクションは JSON エンドポイントを使用する JSON、REST、RAAS のみをサポートし、リクエストは 30 秒未満である必要があります。

XML ペイロードはサポートされていないことに注意してください。

以下のいずれかのアクションを含むルールを作成するには、次の手順を実行します。

  1. サービス プロジェクトで、[プロジェクト設定] > [自動化] の順に選択します。

  2. [ルールを作成] を選択します。

  3. [アクションを追加] 検索ボックスで「Workday」検索し、Workday アクションを選択します。

  4. [Connect] を選択します。

  5. Workday に API クライアントを登録したときに受け取った詳細情報をフォームに記入します。

    • SSO (シングル サインオン) をバイパスして、別の方法を使用した接続を承認するには、[認証エンドポイント] フィールドで、認証エンドポイント URL の末尾に「?redirect=n」と入力します。

  6. [Connect] を選択します。

  7. 承認のため、自動で Workday に移動します。

    1. Workday にサインインします。

    2. 「Workday を承認」するように求められたら、[Allow (許可)] を選択します。

  8. [カスタム Workday リクエストを送信] アクションを選択した場合、プロジェクトに戻って接続を完了します。

    1. この構造 https://{host name}.workday.com/ccx/api/v1/{tenant name}/{resource} に従って、アクションのリクエスト パスを入力します (例: https://wd2-impl-services1.workday.com/ccx/api/staffing/v1/your_tenant_name/workers)。リクエスト パスを表示します。

    2. HTTP メソッドを選択します。

    3. Web リクエスト本文のオプションを選択します。

  9. [次へ] を選択します。

ヒント: Workday RAAS レポートは、アトラシアンにデータを取り込む効率的な方法です。必要なデータ (たとえば、今後 3 か月間に入社する特定地域の従業員のリスト) のみにアクセスするように RAAS をカスタマイズできます。Workday から RAAS を取得するときは、GET メソッドを使用し、リクエストの本文は空のままにします。

接続エラー

自動化ルールに「この接続は動作を停止しました」というエラーが表示される場合、正しいスコープが有効になっていないか、ドメイン セキュリティ ポリシー権限が　Workday で正しく構成されていないことが原因である可能性があります。

スマート値

スマート値を使用すると、Workday のデータにアクセスして、そのデータを Jira プロジェクトで使用できます。

トリガー スマート値

スマート値

説明

{{workday.worker.applicantId}}

Workday から従業員の申請者 ID を返します。

{{workday.worker.departmentName}}

Workday から作業者の部署の名前を返します。

{{workday.worker.employeeId}}

Workday から従業員の従業員 ID を返します。

{{workday.worker.name}}

Workday から従業員のフル ネームを返します。

{{workday.worker.positionDescription}}

Workday から従業員の役職の説明を返します。

{{workday.worker.positionId}}

Workday から従業員の役職 ID を返します。

{{workday.worker.providerId}}

Workday から従業員のプロバイダー ID を返します。

{{workday.worker.startDate}}

Workday から従業員の入社日を返します。

{{workday.worker.workdayId}}

Workday から従業員の一意の Workday ID を返します。

アクション スマート値

スマート値

説明

{{workday.response.body}}

応答の本文を返します。

{{workday.response.status}}

応答のステータスを返します。

{{workday.worker.addressLine}}

Workday から従業員の番地を返します。

{{workday.worker.applicantId}}

Workday から従業員の申請者 ID を返します。

{{workday.worker.areaCode}}

Workday から従業員の電話番号の市外局番を返します。

{{workday.worker.businessTitle}}

Workday から従業員の役職を返します。

{{workday.worker.countryIsoCode}}

Workday から従業員の所在国の ISO コードを返します。

{{workday.worker.departmentName}}

Workday から従業員の部署名を返します。

{{workday.worker.employeeId}}

Workday から従業員の従業員 ID を返します。

{{workday.worker.firstName}}

Workday から従業員の名を返します。

{{workday.worker.hireDate}}

Workday から従業員の雇用日を返します。

{{workday.worker.homeCountryISOCode}}

Workday から従業員の自宅用電話番号の国の ISO コード ("AUS" など) を返します。

{{workday.worker.homeEmailAddress}}

Workday から従業員の自宅用メール アドレスを返します。

{{workday.worker.homeInternationalPhoneCode}}

Workday から従業員の自宅用電話番号の国番号 ("+1" など) を返します。

{{workday.worker.homePhoneAreaCode}}

Workday から従業員の自宅用電話番号の市外局番 ("09" など) を返します。

{{workday.worker.homePhoneNumber}}

Workday から従業員の自宅用電話番号を返します。

{{workday.worker.internationalPhoneCode}}

Workday から従業員の電話番号の国番号を返します。

{{workday.worker.jobClassificationName}}

Workday から従業員の職種名を返します。

{{workday.worker.lastName}}

Workday から従業員の姓を返します。

{{workday.worker.locationName}}

Workday から従業員のロケーション名を返します。

{{workday.worker.locationTypeDescription}}

Workday から従業員のロケーション タイプの説明を返します。

{{workday.worker.managerEmailAddress}}

Workday からマネージャーのメール アドレスを返します。

{{workday.worker.managerFirstName}}

Workday からマネージャーの名を返します。

{{workday.worker.managerHomeEmailAddress}}

Workday からマネージャーの自宅用メール アドレスを返します。

{{workday.worker.managerLastName}}

Workday からマネージャーの姓を返します。

{{workday.worker.managerMiddleName}}

Workday からマネージャーのミドル ネームを返します。

{{workday.worker.managerWorkEmailAddress}}

Workday からマネージャーの仕事用メール アドレスを返します。

{{workday.worker.managerWorkdayId}}

Workday からマネージャーの Workday ID を返します。

{{workday.worker.middleName}}

Workday から従業員のミドル ネームを返します。

{{workday.worker.municipality}}

Workday から従業員の自治体を返します。

{{workday.worker.name}}

Workday から従業員のフル ネームを返します。

{{workday.worker.phoneExtension}}

Workday から従業員の内線電話番号を返します。

{{workday.worker.phoneNumber}}

Workday から従業員の電話番号を返します。

{{workday.worker.positionDescription}}

Workday から従業員の役職の説明を返します。

{{workday.worker.positionId}}

Workday から従業員の役職 ID を返します。

{{workday.worker.positionTitle}}

Workday から従業員の役職名を返します。

{{workday.worker.postalCode}}

Workday から従業員の郵便番号を返します。

{{workday.worker.probationEndDate}}

Workday から従業員の試用期間の終了日を返します。

{{workday.worker.probationStartDate}}

Workday から従業員の試用期間の開始日を返します。

{{workday.worker.providerId}}

Workday から従業員のプロバイダー ID を返します。

{{workday.worker.region}}

Workday から従業員の都道府県を返します。

{{workday.worker.startDate}}

Workday から従業員の入社日を返します。

{{workday.worker.subMunicipality}}

Workday から従業員の区を返します。

{{workday.worker.subRegion}}

Workday から従業員の準地域を返します。

{{workday.worker.workCountryISOCode}}

Workday から従業員の勤務先電話番号の国の ISO コード ("AUS" など) を返します。

{{workday.worker.workdayId}}

Workday から従業員の Workday ID を返します。

{{workday.worker.workEmailAddress}}

Workday から従業員の仕事用メール アドレスを返します。

{{workday.worker.workInternationalPhoneCode}}

Workday から従業員の勤務先電話番号の国番号 ("+1" など) を返します。

{{workday.worker.workPhoneAreaCode}}

Workday から従業員の勤務先電話番号の市外局番 ("09" など) を返します。

{{workday.worker.workPhoneExtension}}

Workday から従業員の勤務先の内線電話番号を返します。

{{workday.worker.workPhoneNumber}}

Workday から従業員の勤務先電話番号を返します。

 

さらにヘルプが必要ですか?

アトラシアン コミュニティをご利用ください。
コミュニティに質問
このページの内容Workday に API クライアントを登録するWorkday での統合に使用する API クライアントを登録する自動化ルールを Workday と統合するWorkday トリガーを使用してルール作成するWorkday アクションを使用するルールを作成するスマート値トリガー スマート値アクション スマート値
コミュニティ質問、ディスカッション、記事