オプション 5: Node ソリューションを実行してトークンを取得し、API ベースのインポート用に Workday などの外部ソースに統合を作成する

Microsoft 365 管理センターに新しいアプリを登録し、クライアント シークレットを生成し、Microsoft 365 管理センターでインポートを設定した後、Node ソリューションを実行してコンソールでトークンを取得できます。 このソリューションを実行すると、必要なトークンが生成され、Workday などの外部ソースで API 統合が作成されます。 方法については GitHub を参照してください。

1. ソリューションを実行する

  1. コマンド ラインで次のコマンドを実行して、このアプリをコンピューターに複製します。

    git clone https://github.com/microsoft/orgdata_apibasedimport.git

  2. 次の本体値を含めます:

  • AppID/ClientID
  • クライアント シークレット
  • Microsoft Entra テナント ID
  • コネクタ ID
  • スケール ユニット

  1. スクリプトが実行され、新しいブラウザー ウィンドウが開きます。 Microsoft 365 管理センターでインポートを設定するときに、アプリ ID または UPN に入力したのと同じメール アドレスを使用してログインします。

  2. [HRIS 統合構成] ページで、次の値を安全にコピーします。これらの値は、Workday Report as a Service (RaaS) などの外部ソースで統合を作成するために使用します。

  • HTTP アドレス
  • アクセス トークン
  • 更新トークン
  • 更新トークン URL

2. Workday でカスタム レポートを作成する

適用対象: Microsoft 365 全体管理者または組織のデータ ソース管理者

  1. Workday を開き、[カスタム レポートの作成] を検索して選択します。

    スクリーンショットは、カスタム レポートを検索する方法を示しています。

  2. レポートの名前を入力します。

  3. [レポートの種類] の横にある [詳細設定] を選択します。

  4. [データソース] の横にある [Workers for HCM Reporting] を選択します。

  5. [ パフォーマンスの最適化] をクリアしたままにして、メール アドレスを持たないワーカーをフィルターで除外します。 Microsoft では、ワーカーをメール アドレスで識別しているため、これは必須フィールドです。

    スクリーンショットは、レポートの詳細ページを示しています。

  6. ページの下部にある [ OK] を選択します。

  7. 管理者のメール フィールドを追加するには:

    1. レポート名の右側にある 3 つのドット メニューを選択します。

    2. [レポート>集計フィールドの作成] の [集計フィールド] を選択します。

      集計フィールドの作成方法を示すスクリーンショット。

    3. 新しいフィールドの名前 (「Manager Email」など) を入力します。

    4. [ビジネス オブジェクト] の横に「worker」と入力します。

    5. [ 関数] の横に [Lookup related Value] と入力します。

      スクリーンショットは、集計フィールドの詳細を示しています。

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

    7. 次の画面で、[ ルックアップ フィールド] の横に「マネージャー – レベル 01」と入力します。

    8. [戻り値] の横に、希望のメール フィールド ([Public Primary Work Email Address] など) を入力します。

      スクリーンショットは、集計フィールド ルックアップの詳細を示しています。

    9. ページの下部にある [ OK] を選択します。

  8. フィールドを追加し、organization's のニーズに基づいてレポートをカスタマイズします。

    1. レポート名の右側にある 3 つのドット メニューを選択します。

    2. [カスタム レポート>編集] を選択します。

    3. [ データ ソース フィルター] の横に、「すべてのアクティブなワーカー (すべての種類)」と入力します。

    4. [ 列 ] タブで、左上の [+] アイコンを選択してフィールドを追加します。

      スクリーンショットは、レポートをカスタマイズする方法を示しています。

ここに一覧表示されているほとんどの予約フィールドのマッピングの例

  • [Manager Email] フィールドは、上記で設定した計算フィールドを参照します。

  • これは、各フィールドのマッピングの最適な推測です。具体的には、テナントにより適したマッピングがあるかもしれません。

  • 上記にリンクされている予約フィールドは、まだ設定されていない場合は、ここに追加できます。 任意の名前で任意のカスタム フィールドを追加することもできます。これらはカスタム フィールドを使用する任意のアプリにインポートできます。

ビジネス オブジェクト フィールド 列見出しの上書き 列見出しの上書き XML エイリアス
ワーカー 従業員 ID Microsoft_EmployeeID この列を列見出しの上書きと同じ値に設定します
ワーカー Public Primary Work Email Address Microsoft_PersonEmail
ワーカー Manager Email Microsoft_ManagerEmail
ワーカー 監督機関 Microsoft_Organization
ワーカー 管理レベル Microsoft_LevelDesignation
ワーカー 単一ジョブ ファミリ Microsoft_JobDiscipline
ワーカー Business Title Microsoft_JobTitle
ワーカー 場所 - 名前 Microsoft_CompanyOfficeLocation
ワーカー 採用日 Microsoft_HireDate
ワーカー 名 Microsoft_FirstName
ワーカー 姓 Microsoft_LastName
ワーカー レポート表示形式の正式名称 Microsoft_DisplayName
ワーカー 会社名 Microsoft_Company
ワーカー 作業アドレス - 書式設定された行 1 Microsoft_CompanyOfficeStreet
ワーカー 勤務先住所 - 市区町村 Microsoft_CompanyOfficeCity
ワーカー 勤務先住所 - 都道府県 Microsoft_CompanyOfficeState
ワーカー 勤務先住所 - 郵便番号 Microsoft_CompanyOfficePostalCode
ワーカー 勤務先住所 - 国/地域 Microsoft_CompanyOfficeCountryOrRegion
ワーカー ワーカー タイプ - テキスト Microsoft_EmploymentType
ワーカー アクティブなスキル Microsoft_UserSkillNames
ワーカー パブリック プライマリ オフィスの電話番号 Microsoft_Phone
ワーカー コスト センター - ID Microsoft_CostCenter
ワーカー 部署 Microsoft_Division

[ フィルター ] タブに追加して、メールを持っていないワーカーをフィルターで除外します。

スクリーンショットは、メールを持っていないワーカーをフィルターで除外する方法を示しています。

レポートをカスタマイズした後、[ 詳細設定] を選択します。 次に、[ Web サービス オプション] で、[ Web サービスとして有効にする] を選択します。

3. 外部ソースで統合を作成する

Workday で API 統合を作成するには、次の手順を使用します。

  1. Workday の画面上部で、[EIB の作成] を検索して選択します。

  2. 「 EIBの作成 」ページで:

    1. 統合の名前を入力します。
    2. [ 送信] を選択します。
    3. [OK] を選択します。

  3. [ 全般設定 ] ページで詳細を確認し、確認します。 問題なければ、[ 次へ] を選択します。

  4. [ データの取得 ] ページでの操作:

    1. [ データ ソースの種類] の横にある [ カスタム レポート] を選択します。

    2. [カスタム レポート] の横にある、Azure Blob Storage コネクタと統合するレポートを選択します。

    3. [ 詳細] で、[ 代替出力形式] の横にある [CSV] を選択します。

      スクリーンショットは、[データの取得] ページで詳細を入力する方法を示しています。

    4. ページの下部にある [ 次へ] を選択します。

  5. [ 変換 ] ページでは、変更を加える必要はありません。 [次へ] を選択します。

  6. [ 配信] ページで:

    1. [ 配信方法] の横にある [ HTTP/SSL] を選択します。
    2. [ HTTP アドレス] の横に、 上記の手順で生成されたアドレスを入力します。
    3. [Web サービス呼び出しの種類] の横にある [OAuth 2.0] を選択します。
    4. [ アクセス トークン] の横に、上記の手順で生成されたアクセス トークンを入力します。
    5. [ 更新トークン] の横に、上記の手順で生成された更新トークンを入力します。
    6. [ Refresh Token URL] (更新トークン URL) の横に、上記の手順で生成された更新トークンの URL を入力します。
    7. [ クライアント ID] の横に、AppID/ClientID を入力します。
    8. [ クライアント シークレット] の横に、クライアント シークレットを入力します。
    9. [ ファイル名] の横に、目的のファイル名を入力します (.csv にする必要があります)。
    10. [ 配信 ] ページの下部にある [ 次へ] を選択します。

  7. [ レビューと送信 ] ページで詳細を確認します。 問題なければ、[ OK] を選択します。

  8. 統合の名前の横にある [アクション] を選択します。

  9. [ 統合] をポイントし、[ 起動/統合のスケジュール] を選択します。

  10. [ 起動/統合のスケジュール ] ページでは、次の操作を行います。

    1. [ 統合] の横にある、作成した統合の名前を選択します。
    2. [実行頻度] の横で、目的の頻度を選択します。
    3. [OK] を選択します。

    スクリーンショットは、起動された統合の詳細を入力する方法を示しています。

接続またはデータを変更する

  • Last updated on