Microsoft 365 管理センターに新しいアプリを登録し、クライアント シークレットを生成し、Microsoft 365 管理センターでインポートを設定したら、Node ソリューションを実行してコンソールでトークンを取得できます。 このソリューションを実行すると、Workday などの外部ソースで API 統合を作成するために必要なトークンが生成されます。 GitHub の方法について説明します。
1. ソリューションを実行する
コマンド ラインで次のコマンドを実行して、このアプリをコンピューターに複製します。
git clone https://github.com/microsoft/orgdata_apibasedimport.git次のコンソール値を含めます。
- AppID/ClientID
- クライアント シークレット
- テナント ID のMicrosoft Entra
- コネクタ ID
- スケール ユニット
スクリプトが実行され、新しいブラウザー ウィンドウが開きます。 Microsoft 365 管理センターでインポートを設定するときに、[アプリ ID] または [UPN] に入力したのと同じメールでログインします。
[ HRIS 統合構成] ページで、次の値を安全にコピーします。この値を使用して、Workday Report as a Service (RaaS) などの 外部ソースで統合を作成します 。
- HTTP アドレス
- アクセス トークン
- 更新トークン
- 更新トークン URL
2. Workday でカスタム レポートを作成する
適用対象: Microsoft 365 グローバル管理者または組織データ ソース管理者
Workday を開き、[カスタム レポートの作成] を検索して選択します。
レポートの名前を入力します。
[レポートの種類] の横にある [詳細] を選択します。
[データ ソース] の横にある [HCM レポートの Worker] を選択します。
[ パフォーマンスに最適化] をオフのままにして、メール アドレスを持たないワーカーを除外します。 Microsoft では、メール アドレスでワーカーを識別するため、必須フィールドです。
ページの下部にある [ OK] を選択します。
マネージャーの電子メール フィールドを追加するには:
レポートの名前の右側にある 3 点メニューを選択します。
レポートの 計算フィールド>計算フィールドの作成を選択します。
"マネージャー Email" など、新しいフィールドの名前を入力します。
[ビジネス オブジェクト] の横に「Worker」と入力します。
[関数] の横に「参照関連値」と入力します。
[OK] を選択します。
次の画面で、[ ルックアップ フィールド] の横に「Manager – レベル 01」と入力します。
[戻り値] の横に、パブリック プライマリ作業Emailアドレスなど、目的の電子メール フィールドを入力します。
ページの下部にある [ OK] を選択します。
フィールドを追加し、organizationのニーズに基づいてレポートをカスタマイズします。
レポートの名前の右側にある 3 点メニューを選択します。
[ カスタム レポート>編集] を選択します。
[データ ソース フィルター] の横に、「すべてのアクティブ ワーカー (すべての種類)」と入力します。
[ 列 ] タブで、左上の [+] アイコンを選択してフィールドを追加します。
ここに記載されているほとんどの予約済みフィールドのマッピングの例
[マネージャー Email] フィールドは、上記で設定した計算フィールドを参照します。
これは、各フィールドのマッピングに最適な推測です。具体的には、テナントに適したマッピングが存在する可能性があります。
上記にリンクされている予約済みフィールドは、まだ追加されていない場合は、ここに追加できます。 任意の名前で任意のユーザー設定フィールドを追加することもできます。また、カスタム フィールドを使用するすべてのアプリにインポートすることもできます。
| ビジネス オブジェクト | フィールド | 列見出しのオーバーライド | 列見出しの XML エイリアスのオーバーライド |
|---|---|---|---|
| ワーカー | 従業員 ID | Microsoft_EmployeeID | この列を列見出しのオーバーライドと同じ値に設定します |
| ワーカー | パブリックプライマリワークEmailアドレス | Microsoft_PersonEmail | |
| ワーカー | マネージャー Email | Microsoft_ManagerEmail | |
| ワーカー | 監督機関 | Microsoft_Organization | |
| ワーカー | 管理レベル | Microsoft_LevelDesignation | |
| ワーカー | シングル ジョブ ファミリ | Microsoft_JobDiscipline | |
| ワーカー | ビジネス タイトル | 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 | |
| ワーカー | Public Primary Work の電話番号 | Microsoft_Phone | |
| ワーカー | Cost Center - ID | Microsoft_CostCenter | |
| ワーカー | 部署 | Microsoft_Division |
[フィルター] タブに次のように追加して、メールがないワーカーを フィルター 処理します。
レポートをカスタマイズしたら、[詳細設定] を選択 します。 次に、[ Web サービス オプション] で [ Web サービスとして有効にする] を選択します。
3. 外部ソースで統合を作成する
Workday で API 統合を作成するには、次の手順に従います。
Workday の画面の上部にある [Create EIB]\(EIB の作成\) を検索し、選択します。
[ EIB の作成 ] ページで、次の手順を実行します。
- 統合の名前を入力します。
- [ 送信] を選択します。
- [OK] を選択します。
[ 全般設定] ページで詳細を確認して確認します。 すべてが適切な場合は、[ 次へ] を選択します。
[データの取得] ページで、次の 手順を 実行します。
[データ ソースの種類] の横にある [カスタム レポート] を選択します。
[カスタム レポート] の横で、Azure Blob Storage コネクタと統合するレポートを選択します。
[ 詳細] の [ 代替出力形式] の横にある [CSV] を選択します。
ページの下部にある [ 次へ] を選択します。
[ 変換 ] ページで、変更を加える必要はありません。 [次へ] を選択します。
[配信] ページで、次の 手順を実行 します。
- [ 配信方法] の横にある [ HTTP/SSL] を選択します。
- [ HTTP アドレス] の横に、 上記の手順で生成されたアドレスを入力します。
- [Web サービス呼び出しの種類] の横にある [OAuth 2.0] を選択します。
- [アクセス トークン] の横に、上記の手順で生成されたアクセス トークンを入力します。
- [ 更新トークン] の横に、上記の手順で生成された更新トークンを入力します。
- [ 更新トークン URL] の横に、上記の手順で生成された更新トークン URL を入力します。
- [ クライアント ID] の横に、AppID/ClientID を入力します。
- [ クライアント シークレット] の横に、クライアント シークレットを入力します。
- [ ファイル名] の横に、目的のファイル名を入力します。これは .csv する必要があります。
- [配信] ページの下部にある [次へ] を選択します。
[ 確認と送信] ページで詳細を確認します。 すべてが正常に表示される場合は、[ OK] を選択します。
統合の名前の横にある [アクション] を選択 します。
[統合] にマウス ポインターを合わせ、[Launch/Schedule Integration]\(統合の起動/スケジュール\) を選択します。
[ 起動/スケジュール統合] ページで、次の手順を実行します。
- [ 統合] の横で、作成した統合の名前を選択します。
- [ 実行頻度] の横で、目的の頻度を選択します。
- [OK] を選択します。