> 継続的なプロセス改善 > 従業員の入社手続き > Microsoft Dynamics 365 Human Resources > データテンプレート

従業員のオンボーディング用データテンプレート

Microsoft Dynamics 365 Human Resources

従業員のオンボーディングの属性(18) 従業員のオンボーディングのアクティビティ(16) データ抽出ガイド(4)

従業員のオンボーディング用データテンプレート

このデータテンプレートは、従業員のオンボーディングプロセスを分析するために必要な情報を集める際の指針となります。必要なデータ属性や記録すべき主なアクティビティを示し、データ抽出に役立つ情報も掲載しています。このテンプレートに沿って準備することで、オンボーディングのワークフローを正確に分析できます。

詳細な分析に必要な、収集を推奨するデータ属性
プロセス内で記録すべき主なアクティビティとマイルストーン
ソースシステムからデータを抽出する際の手順

イベントログを初めて作成する方はこちら：プロセスマイニング用イベントログの作成方法.

テンプレートをダウンロード

従業員のオンボーディングの属性

従業員のオンボーディングプロセスを詳しく分析するには、イベントログに次のデータ項目を含めることをおすすめします。

3 必須 6 推奨 9 任意

	名前	説明
	アクティビティ名 ActivityName	オンボーディングプロセスの特定の時点で発生したタスクまたはマイルストーンの名前。
説明この属性は、オンボーディングの流れにおける1つのステップを表します。たとえば、「内定承諾」「バックグラウンドチェック完了」「初日のオリエンテーション実施」などです。各アクティビティがプロセス内のイベントにあたります。アクティビティの分析は、プロセスマイニングの中心です。この属性を使ってプロセスマップを作成し、ステップ間のボトルネックを特定し、アクティビティの所要時間を測定して、標準業務手順からの逸脱を検出します。どのような業務が、どの順序で行われているかを把握できます。重要な理由この属性はプロセスマップの各ステップを定義し、プロセスの流れの可視化やボトルネックの特定、プロセスのバリアント分析に欠かせません。入手先 Microsoft Dynamics 365 Human Resourcesで、従業員のプロファイルやオンボーディングチェックリストに記録されたステータス変更、タスクの完了、特定のイベントから算出します。例内定承諾バックグラウンドチェック開始ITアカウントの準備開始30日後の面談実施
	イベント発生時刻 EventTime	オンボーディングの特定のアクティビティまたはイベントが発生した正確な日時。
説明このタイムスタンプは、イベントログ内で各アクティビティが発生した時刻を示します。オンボーディングケースごとにプロセスの流れを再構成するために必要な時系列情報を提供します。タイムスタンプは、時間に基づくプロセスマイニング分析に欠かせません。アクティビティ間のサイクルタイムやオンボーディングプロセス全体の所要時間の算出、遅延の特定、時間の経過に伴うプロセスパフォーマンスの分析に使います。パフォーマンスに関する分析結果の信頼性を確保するには、正確なタイムスタンプが必要です。重要な理由イベントを正しい順序に並べ、サイクルタイムやボトルネック分析など、時間に基づく計算を行うための基本情報です。入手先 Microsoft Dynamics 365 Human Resourcesのタスク、チェックリスト、ステータス更新に関連付けられた作成日または完了日に該当します。例 2023-10-01T09:00:00Z2023-10-02T14:30:00Z2023-10-05T11:25:10Z
	オンボーディングケース OnboardingCase	内定承諾から初期の定着期間まで、新入社員のオンボーディングプロセス全体を識別する一意のID。
説明オンボーディングケースは、新入社員1人に関連するすべてのアクティビティ、文書、マイルストーンを結び付ける中心的な識別子です。1つのケースが、従業員1人のオンボーディング期間中の流れを表します。プロセスマイニングでは、この属性がケース単位の分析の基礎となります。個々のオンボーディングの流れを再構成し、プロセスのバリアントを比較したり、全体のサイクルタイムを算出したりできます。一貫したケース識別子がなければ、プロセスの流れを正確に分析できません。重要な理由新入社員ごとに関連イベントをまとめるための必須のケース識別子です。オンボーディングプロセス全体を分析できます。入手先通常、Microsoft Dynamics 365 Human Resourcesの人事または採用の基本モジュールで、候補者のステータスが「採用済み」に変わったときに生成されます。例 ONB-2024-00123ONB-2024-00124ONB-2024-00125
	イベント終了時刻 EventEndTime	所要時間のあるアクティビティが完了した時刻を示すタイムスタンプです。瞬時に完了するイベントでは、開始時刻と同じ場合があります。
説明 StartTimeがアクティビティの開始を示すのに対し、EndTimeは終了を示します。「バックグラウンドチェック」や「必須研修」など、所要時間を測定できるタスクで特に役立ちます。終了時刻を個別に記録すると、各アクティビティの処理時間を正確に測定できます。アクティビティ間の待ち時間だけでなく、特定のタスクにかかった時間を把握できます。リソースの効率を分析し、時間を要しているアクティビティを特定するうえでも重要です。重要な理由個々のアクティビティにかかった時間を正確に算出できるため、時間を要するタスクの特定に役立ちます。入手先 Microsoft Dynamics 365 Human Resourcesのタスクまたはチェックリスト項目にある「完了日」または「解決日」フィールドに該当します。例 2023-10-01T10:15:00Z2023-10-04T11:00:00Z2023-10-06T17:00:00Z
	オンボーディング状況 OnboardingStatus	オンボーディング案件の現在の全体的な状況です。
説明この属性は、オンボーディング案件の大まかな状況を示します。例として、「未開始」「進行中」「完了」「キャンセル」などがあります。各案件が現在どの段階にあるかを確認できます。「オンボーディング進捗のリアルタイム確認」ダッシュボードでは、進行中の案件全体をすばやく把握できます。関係者が現在の作業量を確認し、停滞している可能性のある案件を特定するのに役立ちます。また、サイクルタイム分析から未完了またはキャンセル済みの案件を除外し、結果の偏りを防ぐこともできます。重要な理由案件の進捗状況を大まかに把握できます。進行中または完了した案件に絞り込めるため、業務の状況確認に役立ちます。入手先 Microsoft Dynamics 365 Human Resourcesの文書を参照してください。オンボーディングの主要エンティティにあるステータスフィールド、または最後に完了したアクティビティに基づいて算出される値の場合があります。例進行中完了遅延キャンセル
	コンプライアンス対応期限 ComplianceDueDate	コンプライアンス関連の特定のアクティビティを完了する期限です。
説明この属性には、書類の提出や必須研修の受講など、期限が定められた重要なタスクの目標完了日が記録されます。期限は、法的要件や社内規定に基づいて設定されることがよくあります。「オンボーディングのコンプライアンス状況」ダッシュボードと「オンボーディング段階の遵守率」重要業績評価指標（KPI）で重要な属性です。実際のアクティビティ完了時刻（「EventTime」）と「ComplianceDueDate」を比較することで、プロセスがコンプライアンス要件を満たしているかを判断できます。リスクの軽減と、法的要件や社内規定を期限内に満たすことに役立ちます。重要な理由重要なタスクのコンプライアンス遵守状況と期限内の完了状況を測定できます。法務面および業務面のリスク軽減に役立ちます。入手先 Microsoft Dynamics 365 Human Resourcesの文書を参照してください。特定のタスクまたはチェックリスト項目にある「Due Date」フィールドの場合があります。例 2023-11-15T23:59:59Z2023-12-01T23:59:59Z2023-11-20T23:59:59Z
	役職名 PositionTitle	新入社員の正式な職名です。
説明この属性には、採用時の職種や役職が設定されます。例として、ソフトウェアエンジニア、アカウントマネージャー、財務アナリストなどがあります。特に「新入社員のオンボーディング処理状況」ダッシュボードで役立つ分析軸です。職種や職位ごとにオンボーディングの実績を分けて確認でき、特定の職種で期間が長くなったり、手順が複雑になったりしていないかを把握できます。分析結果をもとに、職種群に応じたオンボーディング計画を作成できます。重要な理由職種ごとにオンボーディングプロセスを絞り込み、比較できます。職種によって必要な要件や所要時間が異なる場合の分析に役立ちます。入手先 Microsoft Dynamics 365 Human Resourcesの文書を参照してください。新入社員に関連付けられたJobまたはPositionエンティティで確認できます。例シニアソフトウェアエンジニアマーケティングコーディネーター人事ジェネラリスト
	採用マネージャー HiringManagerName	新入社員の直属の上司となるマネージャーの氏名です。
説明この属性は、新入社員の採用を担当するマネージャーを特定します。採用マネージャーは、チームへの紹介やオンボーディング計画の作成など、オンボーディングで重要な役割を担うことがよくあります。採用マネージャー別にプロセスを分析すると、チームごとのオンボーディングの進め方の違いが分かります。「部門別オンボーディング実績」ダッシュボードでは、部門から個々のマネージャーへドリルダウンできます。オンボーディングに関する追加のトレーニングが必要なマネージャーや、効率的な進め方を実践しているマネージャーを特定するのに役立ちます。重要な理由チーム単位でプロセスの違いを分析し、オンボーディングの成功に大きく関わるマネージャーを特定できます。入手先 Microsoft Dynamics 365 Human Resourcesの文書を参照してください。通常、従業員のPositionレコードにある「Reports to」または「Manager」フィールドに保存されています。例ジョン・スミスエミリー・ジョーンズマイケル・ブラウン
	部門 DepartmentName	新入社員が所属する部門または事業部門です。
説明この属性には、新入社員が所属する営業、IT、財務などの組織内の部門が設定されます。分析における重要な組織軸です。部門ごとにプロセスを分けて分析すると、「部門別オンボーディング実績」ダッシュボードで、オンボーディングのサイクルタイム、コンプライアンス遵守率、プロセスのバリアントを比較できます。効率的に進めている部門や、追加の支援または標準化が必要な部門を把握できます。重要な理由事業部門ごとの実績を比較し、優れた取り組みや改善・標準化が必要な領域を特定できます。入手先 Microsoft Dynamics 365 Human Resourcesの文書を参照してください。通常、新入社員に関連付けられたPositionまたはJobエンティティに保存されています。例営業・マーケティング情報技術人事財務
	IT環境準備のリードタイム ITProvisioningLeadTime	ITアカウントの設定開始から、新入社員への機器の納品までにかかる時間です。
説明この指標は、オンボーディングの重要なサブプロセスである、新入社員に必要なITアクセス権とツールを用意するまでの期間を測定します。「ITアカウント設定開始」イベントから「機器納品」イベントまでの時間が対象です。「重要な経路におけるアクティビティ所要時間」および「IT・機器準備サイクル」ダッシュボードで使う重要なKPIです。この期間が長いと、新入社員が初日から業務を始めるうえで直接影響します。指標を確認することで、IT部門内や外部の機器ベンダーとの間にあるボトルネックを特定できます。重要な理由重要なIT環境の準備プロセスの効率を測定できます。新入社員が初日から業務を始められるかどうかに直接関わります。入手先イベントログに記録された各案件の「ITアカウント設定開始」と「機器納品」アクティビティのタイムスタンプの差から算出します。例 7日3時間10日1時間5日6時間
	アクション実行者 UserPerformingAction	アクティビティを実行したユーザーまたはシステムエージェントです。
説明この属性は、オンボーディングプロセスの各タスクを完了した担当者または自動システムを特定します。人事担当者、採用マネージャー、IT自動化ボットなどが該当します。誰がどのタスクを実行しているかを分析すると、リソースの配分や自動化の状況を把握できます。特定のチームや担当者が原因となっているボトルネックを見つけ、自動化の余地を特定するのにも役立ちます。たとえば、ITアカウントの設定を1人が手作業で行っている場合、その担当者が不在になると業務が止まるおそれがあり、自動化を検討する候補になります。重要な理由作業負荷の分布を分析し、リソースに起因するボトルネックを特定するとともに、プロセスの自動化状況を把握できます。入手先通常、監査証跡や履歴ログに記録されています。タスクレコードの「Modified By」または「Completed By」フィールドに保存されていることがよくあります。例 hr.specialist@company.commanager.jane.doe@company.comITサービスアカウントrecruiter.bob@company.com
	オンボーディング全体のサイクルタイム OverallOnboardingCycleTime	オンボーディング案件で「内定承諾」アクティビティから「30日後の面談実施」アクティビティまでにかかった合計時間です。
説明この計算指標は、新入社員1人のオンボーディングプロセス全体にかかる期間を測定します。プロセス全体の効率を示す重要業績評価指標（KPI）です。「オンボーディング全体のサイクルタイム」ダッシュボードの主要指標です。このKPIを経時的に、また部門や職種ごとに追跡すると、プロセス改善の取り組みがもたらした変化を確認できます。サイクルタイムの短縮は、新入社員が早く業務で成果を上げられるようになるため、多くの場合、主要な目標となります。重要な理由プロセス全体の効率を測る重要なKPIであり、オンボーディング期間の短縮など、戦略目標の達成状況を確認できます。入手先ソースシステムのフィールドではありません。データ変換時に、各案件の最初と最後の関連イベントの時刻差を計算して求めます。例 35日4時間42日8時間29日2時間
	ソースシステム SourceSystemName	データの抽出元となった情報システムの名前。
説明この属性は、プロセスデータの取得元を示します。企業では、1つのプロセスに関するデータが複数のシステムに分散している場合があるため、データガバナンスや検証のために取得元を追跡することが重要です。分析時にはデータの来歴を確認でき、複数のシステムが関係する場合は、取得元でデータを絞り込むこともできます。このビューでは値が常に「Microsoft Dynamics 365 Human Resources」となり、データの取得元を確認できます。重要な理由データの出所を特定します。データガバナンスやトラブルシューティング、データのコンテキストを把握するうえで重要であり、特に複数のシステムを利用する環境で役立ちます。入手先通常は、データの抽出・変換時にデータセットの出所を示すために追加される固定値です。例 Microsoft Dynamics 365 Human Resources
	最終データ更新日時 LastDataUpdateTime	ソースシステムからデータが最後に更新された日時を示すタイムスタンプです。
説明この属性には、Microsoft Dynamics 365 Human Resourcesからデータを最後に抽出した日時が記録されます。分析対象データがどの程度新しいかを把握するための情報です。レポートやダッシュボードを確認する際、分析結果がどの時点のデータに基づいているかを判断するのに役立ちます。リアルタイムで監視する場合は新しいタイムスタンプが重要です。一方、過去のデータを分析する場合は、対象期間を確認する基準になります。重要な理由データの鮮度を把握できるため、プロセス分析の結果が現在の状況にどの程度当てはまるかを判断するうえで役立ちます。入手先データ抽出時に、データパイプラインまたはETLツールによって生成されるタイムスタンプです。例 2024-05-21T02:00:00Z
	勤務地 Location	新入社員が勤務するオフィス、都市、または国です。
説明この属性には、新入社員の勤務地が設定されます。地域ごとの法規制やオフィスの手順、物流上の課題によって、オンボーディングの進め方が異なる場合があります。勤務地別に分けて分析すると、拠点や地域ごとのオンボーディング効率を比較できます。特定の国で機器の納品が遅れるなど、地域特有のボトルネックを把握できます。また、現地で効率よく運用されている手順を見つけ、ほかの拠点に取り入れることもできます。重要な理由勤務地別にオンボーディングプロセスを分析し、地域ごとの実績やコンプライアンスの違いを把握できます。入手先 Microsoft Dynamics 365 Human Resourcesの文書を参照してください。WorkerまたはPositionエンティティに関連付けられた住所または勤務地情報で確認できます。例米国ニューヨーク英国ロンドンシンガポールリモート
	手戻りの有無 IsRework	アクティビティが手戻りのループに含まれるかどうかを示す真偽値です。
説明この計算属性は、プロセスの後戻りや繰り返しに該当するアクティビティを示します。たとえば、「新入社員に書類を送付」が「新入社員が書類を記入完了」の後に発生した場合、誤りや情報不足による手戻りの可能性があります。「プロセスのバリアントと手戻り分析」ダッシュボードで重要な属性です。手戻りを直接定量化し、プロセスの非効率、トレーニング不足、データ品質の問題を明らかにできます。手戻りのアクティビティに絞り込むことで、分析担当者は無駄な繰り返しの根本原因を調べられます。重要な理由繰り返しや順序どおりでないアクティビティを示して、プロセスの非効率を定量化し、エラーや遅延の根本原因の特定に役立ちます。入手先ソースシステムにはない属性です。イベントログに記録された各案件のアクティビティの順序を分析し、業務ルールを適用して手戻りを特定することで算出します。例 truefalse
	新入社員の氏名 NewHireName	オンボーディングの対象となる従業員の氏名です。
説明この属性には、オンボーディング案件に関連付けられた新入社員の氏名が含まれます。各案件を人が読み取れる形で識別できます。プライバシー保護のため、統計分析には通常使用しません。一方、運用面では、プロセス全体の分析で見つかった遅延や問題を調べるために、特定の従業員のオンボーディングの経過を確認する際に役立ちます。抽象的なプロセスデータを実際の個人に結び付ける情報です。重要な理由各案件を人が読み取れる形で識別できます。特定のオンボーディングの経過を調べたり、関係者と結果を共有したりしやすくなります。入手先 Microsoft Dynamics 365 Human Resourcesの文書を参照してください。オンボーディング案件に関連付けられたEmployeeまたはWorkerエンティティから取得します。例アリス・ジョンソンデビッド・チェンマリア・ガルシア
	雇用形態 EmploymentType	新入社員の雇用区分です。正社員、パートタイム、契約社員などがあります。
説明この属性は、雇用契約に基づいて新入社員を分類します。雇用形態によってオンボーディングの手順が一部異なる場合があります。たとえば、契約社員は福利厚生に関する一部の手順が不要なことがあります。雇用形態別にプロセスを分析すると、各区分で適切なプロセスのバリアントが実施されているかを確認できます。また、臨時雇用者やパートタイム従業員にはすべてのオンボーディング手順が必要でない場合があり、手順を効率化できる余地も見つけられます。重要な理由従業員区分ごとのプロセスのバリアントを分析し、それぞれに適したオンボーディング手順が実施されているかを確認できます。入手先 Microsoft Dynamics 365 Human Resourcesの文書を参照してください。WorkerまたはEmploymentエンティティの標準フィールドです。例正社員パートタイム従業員契約社員インターン

必須推奨任意

従業員のオンボーディングのアクティビティ

オンボーディングの流れを正確に把握して分析するため、イベントログに記録すべき重要なプロセスのステップとマイルストーンです。

7 推奨 9 任意

	アクティビティ	説明
	30日後の面談実施	新入社員とマネージャーまたは人事担当者との間で予定されていた、入社30日後のフォローアップ面談が完了したことを示すイベントです。オンボーディング期間を延長して実施する場合、最後のタスクとして追跡されることが一般的です。
重要な理由プロセス分析における明確な終了イベントです。完了率を追跡すると、エンゲージメントを測定でき、新入社員の懸念に早期に対処する機会にもなります。入手先 Dynamics 365 HRのオンボーディングチェックリストまたはパフォーマンス管理モジュールにある「30日後の面談」タスクの完了タイムスタンプから推定します。記録入社30日後の面談に関する特定のタスクの完了タイムスタンプから推定します。イベントタイプ inferred
	バックグラウンドチェック完了	新入社員のバックグラウンドチェックが正常に完了し、問題がないことを確認した状態を示します。通常、チェックリストの項目を完了にしたときや、専用のステータスフィールドを更新したときに記録されます。
重要な理由雇用手続きの次の段階に進むための条件となることが多い、重要なマイルストーンです。このアクティビティまでのリードタイムを測定すると、ボトルネックを特定できます。入手先オンボーディングのチェックリストにあるバックグラウンドチェックタスクの完了タイムスタンプ、または従業員レコードのステータスが「完了」や「確認済み」に変更された時刻から推定します。記録「バックグラウンドチェック」のチェックリスト項目のステータスが「完了」に変更された時刻から推定します。イベントタイプ inferred
	人事プロファイル作成	Dynamics 365 Human Resourcesで新入社員の正式な従業員レコードを作成するアクティビティです。システム上で明示的に実行され、以降のオンボーディング手順に必要な基本データが作成されます。
重要な理由給与計算やIT環境の準備など、多くの後続プロセスがこのアクティビティに依存するため、実施時期が重要です。ここで遅延が起きると、オンボーディング全体の大きなボトルネックになります。入手先 Dynamics 365 Human Resourcesに明示的に記録されるイベントです。たとえば、HcmWorkerテーブルにある従業員レコードの作成タイムスタンプを使用できます。記録従業員の基本エンティティにあるシステムフィールドcreatedDateTimeを使用します。イベントタイプ explicit
	内定承諾	候補者が内定を承諾した時点で発生するイベントで、オンボーディングプロセスの正式な開始を示します。通常、採用モジュールで候補者のステータスが更新されたとき、または人事システムで新入社員のレコードが作成されたときに記録されます。
重要な理由オンボーディングケースの主要な開始イベントとして、プロセス全体のサイクルタイムを算出する基準になります。プロセス全体の所要期間を把握するには、この開始点の分析が欠かせません。入手先 Dynamics 365 Human Resourcesでは、候補者のレコードが採用済みに変更されたときや、内定承諾日を含む新しい従業員レコードが作成されたときに記録されることが一般的です。記録新しい従業員レコードの作成日、または候補者レコードのステータス変更から推定します。イベントタイプ inferred
	初日のオリエンテーション実施	新入社員が初日に受けるオリエンテーションを完了したことを示すアクティビティです。オンボーディング計画のタスクを完了して記録する、重要なマイルストーンです。
重要な理由新入社員のオンボーディングにおける大きなマイルストーンです。「内定承諾」からこの時点までの期間を分析すると、入社前の準備の効率を測定できます。入手先従業員に割り当てられたオンボーディングのチェックリストまたはガイドにある「初日のオリエンテーション」タスクの完了日から推定します。記録「オリエンテーション」のチェックリスト項目の完了タイムスタンプから推定します。イベントタイプ inferred
	必須研修の完了	新入社員に割り当てられた必須研修をすべて完了したことを示します。必須コースの受講ステータスが「完了」に更新されたときに記録されます。
重要な理由研修の完了率を測定し、組織がポリシー上の要件を満たしているか確認するための、コンプライアンス上重要なチェックポイントです。入手先 Dynamics 365 HRの学習モジュールにある割り当て済みコースの完了日から記録します。すべての必須コースのうち、最後に完了した日付を使用できます。記録従業員に割り当てられたコースレコードの完了タイムスタンプ。イベントタイプ explicit
	新入社員による書類の提出完了	新入社員が雇用開始前に必要な書類をすべて記入し、返送したことを示すアクティビティです。通常、Dynamics 365 HRでチェックリスト項目を完了にして記録します。
重要な理由コンプライアンス上の重要なマイルストーンです。期限に対する完了時期を測定することで、スムーズな業務開始とコンプライアンスの遵守を確認できます。入手先 Dynamics 365 HRのオンボーディング機能にある該当チェックリスト項目の完了タイムスタンプから推定します。記録書類の記入を完了するオンボーディングタスクのステータスが「完了」に変更された時刻から推定します。イベントタイプ inferred
	ITアカウントの準備開始	システムアカウントやメールなどのアクセス権を作成する依頼を送る、ITオンボーディングプロセスの開始を示します。オンボーディングガイドやチェックリストの専用タスクで追跡することが一般的です。
重要な理由 IT環境の準備にかかるリードタイムを測定する起点です。このステップの開始が遅れると、新入社員が初日から業務を始められるかどうかに直接影響します。入手先 Dynamics 365 HRのオンボーディングチェックリスト機能にある「IT環境の準備」または「アカウント作成」タスクの作成日から推定できます。記録オンボーディングのチェックリストにあるIT環境準備タスクの作成タイムスタンプから推定します。イベントタイプ inferred
	オンボーディング計画の完了	新入社員に割り当てられた正式なオンボーディングチェックリストのタスクをすべて完了したことを示すマイルストーンです。オンボーディングガイド全体のステータスが完了になったときに記録されます。
重要な理由初期オンボーディング段階の事務手続き上の明確な終点です。必要な手続きや研修がすべて完了したことを示します。入手先特定の従業員向けオンボーディングガイドまたはチェックリスト内のすべてのタスクが「完了」になり、タイムスタンプが記録された時点から推定できます。記録従業員に割り当てられたオンボーディングチェックリストの項目がすべて完了になっているかを確認して算出します。イベントタイプ inferred
	チームへの紹介完了	新入社員が直属のチームメンバーに正式に紹介されたことを示すアクティビティです。採用担当マネージャー向けのチェックリスト項目として追跡する、オンボーディングの補助的なステップであることが一般的です。
重要な理由新入社員のチームへの適応や体験を分析するうえで重要なアクティビティです。確実に実施することで、従業員の満足度向上やチームへの早期定着につながる場合があります。入手先 Dynamics 365 HRのオンボーディングチェックリストで、採用担当マネージャー向けの画面にある「チームへの紹介」タスクの完了から推定します。記録マネージャーに割り当てられた特定のチェックリスト項目の完了タイムスタンプから推定します。イベントタイプ inferred
	バックグラウンドチェック開始	新入社員のバックグラウンドチェックを正式に開始した時点を示すアクティビティです。Dynamics 365でステータスフィールドを更新したときや、オンボーディングのチェックリストに専用タスクを作成したときに記録されることが一般的です。
重要な理由重要で時間がかかることの多いサブプロセスの開始を示します。所要時間を追跡すると、オンボーディングを停滞させる外部委託先や社内の遅延を特定できます。入手先オンボーディングのチェックリストにあるバックグラウンドチェックタスクの作成日、または従業員のオンボーディングレコードのステータス変更から推定できます。記録オンボーディングのチェックリストに「バックグラウンドチェック」の項目が作成された時刻、またはステータスが「進行中」に変更された時刻から推定します。イベントタイプ inferred
	ワークスペースの準備完了	デスクの設置やシステムへのアクセス権を含め、新入社員が使う物理的または仮想のワークスペースの準備がすべて整ったことを示します。通常、入社前の準備における最後のステップです。
重要な理由 IT環境と施設の準備が整ったことを示すアクティビティです。新入社員に良い体験を提供し、初日から業務を始められるよう、入社前に完了しておくことが重要です。入手先 Dynamics 365 HRのオンボーディングチェックリストにある「ワークスペースの準備」タスクの完了タイムスタンプから推定できます。記録ワークスペースやデスクの準備に関するチェックリスト項目の完了から推定します。イベントタイプ inferred
	必須研修の割り当て	コンプライアンス研修や職務に応じた研修コースを新入社員に割り当てた時点を示すイベントです。通常、Dynamics 365 HRの学習管理機能で管理します。
重要な理由コンプライアンス研修の段階を開始するアクティビティです。研修が適切な時期に割り当てられているかを追跡し、期限までに受講できる時間を確保できます。入手先 Dynamics 365 HRの従業員の学習記録にあるコース割り当ての作成日から記録できます。記録従業員に割り当てられたコースの一覧に、コースが追加された時刻。イベントタイプ explicit
	新入社員への書類送付	雇用開始前に必要な書類を新入社員に送付したことを示すイベントです。専用のオンボーディングタスクを開始したときや、文書管理システムとの連携を通じて記録できます。
重要な理由このアクティビティを追跡すると、オンボーディングの事務手続きの効率を分析できます。書類の再送が必要な場合は、手戻りのループが始まる最初のステップにもなります。入手先オンボーディングモジュールで、新入社員への書類送付に関するチェックリスト項目を作成または開始した日付から推定します。記録書類送付のオンボーディングタスクが開始済みになった時刻、または作成された時刻から推定します。イベントタイプ inferred
	機器の発注	新入社員に必要なノートパソコンや電話などのハードウェアを発注した時点を示します。通常、IT環境の準備に関する一連のチェックリスト内のアクティビティです。
重要な理由このステップを追跡すると、機器の依頼が遅れた場合と、発送や納品が遅れた場合を区別できます。IT環境の準備にかかる期間をより詳しく把握できます。入手先オンボーディングのチェックリストにある機器発注のサブタスクが開始または完了になった時刻から推定できます。記録「ハードウェアを発注」のチェックリスト項目のステータス変更または完了時刻から推定します。イベントタイプ inferred
	機器の納品	新入社員の勤務場所に機器が納品されたことを確認したアクティビティです。通常、オンボーディングプロセスのチェックリスト項目のステータスを更新して記録します。
重要な理由 IT環境の準備にかかるリードタイムを算出するうえで重要な終点です。業務に必要な物理的な機器が新入社員の手元に届いたことを確認できます。入手先 Dynamics 365 HRのオンボーディング機能にある「機器の納品」タスクまたはチェックリスト項目の完了タイムスタンプから推定します。記録「機器を納品」のチェックリスト項目が「完了」になった時刻から推定します。イベントタイプ inferred

推奨任意

データ抽出ガイド

Microsoft Dynamics 365 Human Resourcesからデータを取得する方法

ステップ

データ管理ワークスペースを開く：適切な権限を持つアカウントでMicrosoft Dynamics 365 Human Resourcesにログインします。メインナビゲーションメニューから「ワークスペース」に移動し、「データ管理」ワークスペースを選択します。
新しいエクスポートプロジェクトを作成する：「データ管理」ワークスペースで「エクスポート」タイルを選択し、新しいデータエクスポートプロジェクトを作成します。「ProcessMind_Onboarding_Export」など、内容が分かる名前を付けます。
出力するデータ形式を選択する：プロジェクトの設定で、出力するデータ形式を指定します。ProcessMindとの互換性を確保するため、「CSV」を選択します。文字化けを防ぐため、エンコードは「Unicode」に設定します。
データエンティティを追加する：必要なデータエンティティをプロジェクトに追加します。オンボーディングのすべてのアクティビティを取得するには、複数のエンティティが必要です。主なエンティティは、作業者、Employment、Onboarding checklist task、Course tablesです。機器の支給状況などを追跡する場合は、構成に応じてエンティティを追加してください。
エンティティのマッピングを定義する：各エンティティについて、ソースフィールドをイベントログの列に対応付けます。Dynamics 365のフィールドをOnboardingCase、ActivityName、EventTimeなどの属性に割り当てる、特に重要な手順です。作業者やEmploymentなどのエンティティからイベントを作成する場合は、ActivityNameを固定値で設定します。詳しいマッピングは「クエリ」セクションを参照してください。
フィルターを適用する：エクスポートするデータの範囲を絞るため、各エンティティにフィルターを設定します。雇用開始日やタスク完了日など、関連するフィールドに日付範囲を指定し、たとえば直近12か月分に限定することをおすすめします。
エクスポートジョブを実行する：プロジェクトの設定が完了したら、エクスポートジョブを実行します。すぐに実行するか、システムへの影響を抑えるため、利用の少ない時間帯に実行するようスケジュールできます。
エクスポートしたファイルをダウンロードする：ジョブが正常に完了したら、生成されたCSVファイルをダウンロードします。プロジェクト内のデータエンティティごとに、個別のファイルが作成されます。
データを結合して変換する：エクスポートしたファイルを1つのイベントログにまとめます。Microsoft ExcelのPower Query、Power BI、Pythonなどのスクリプト言語を使って変換します。各ファイルの列が最終的なイベントログの構成と一致していることを確認し、整形したデータセットを1つのテーブルに結合します。
イベントログを仕上げる：結合したデータをOnboardingCase、続いてEventTimeの順に並べ、時系列を整えます。完成したテーブルを1つのCSVファイルとして保存します。このファイルをProcessMindにアップロードできます。

設定

主なデータエンティティ：抽出には複数の主要エンティティを使います。正確な名前はD365のバージョンによって異なる場合があります。
- 作業者：「HR Profile Created」イベントの作成と従業員情報の取得に使います。
- Employment：「Offer Accepted」イベントを記録します。多くの場合、雇用開始日で表されます。
- Onboarding checklist task：「Background Check Completed」「Paperwork Sent」「First Day Orientation Conducted」など、ほとんどのアクティビティの主なデータソースです。実装によっては、Onboarding guide taskなど別の名前が使われる場合があります。
- Course tables：「Mandatory Training Assigned」と「Mandatory Training Completed」イベントの抽出に使います。
期間フィルター：データ量を調整するには、期間フィルターの設定が欠かせません。詳細な分析には、Employment Start Dateを基準に6～12か月分のデータを使うことをおすすめします。
会社のフィルター：組織で複数の法人を使用している場合は、分析対象の会社コードでデータを絞り、プロセスのコンテキストを統一してください。
前提条件：エクスポートを実行するユーザーには、「データ管理」ワークスペースへのアクセス権と、指定したすべてのデータエンティティの読み取り権限を持つセキュリティロールが必要です。通常はData management administratorロールで対応できます。
パフォーマンスに関する考慮事項：大量のデータをエクスポートすると、システムリソースを大きく消費する場合があります。過去の全データを読み込む場合は、業務への影響を避けるため、夜間または週末にエクスポートジョブを実行するようスケジュールしてください。

クエリの例 config

The following describes the configuration for the export project. Since the Data Management Framework exports entities separately, you must create an export for each source entity listed below, then combine the outputs into a single event log file.

**Source 1: Worker Entity**
This entity is used to generate the 'HR Profile Created' event.
*   **Entity Name**: `Worker`
*   **Field Mapping**:
    *   `OnboardingCase`: Map from `PersonnelNumber`
    *   `ActivityName`: Set as a fixed value: "HR Profile Created"
    *   `EventTime`: Map from `CreatedDateTime`
    *   `EventEndTime`: Map from `CreatedDateTime`
    *   `DepartmentName`: Map from `PrimaryAddressLocation` or related party information.
    *   `HiringManagerName`: Map from `ReportsToPerson` or related worker information.
    *   `PositionTitle`: Map from primary position details linked to the worker.
    *   `OnboardingStatus`: Set as a fixed value: "In Progress"
    *   `ComplianceDueDate`: Set to null

**Source 2: Employment Entity**
This entity generates the 'Offer Accepted' event, typically using the employment start date as the timestamp.
*   **Entity Name**: `Employment`
*   **Field Mapping**:
    *   `OnboardingCase`: Map from `PersonnelNumber`
    *   `ActivityName`: Set as a fixed value: "Offer Accepted"
    *   `EventTime`: Map from `EmploymentStartDate`
    *   `EventEndTime`: Map from `EmploymentStartDate`
    *   `DepartmentName`: Map from `DepartmentNumber`
    *   `HiringManagerName`: Join to worker entity to find manager name.
    *   `PositionTitle`: Join to position entity to find position title.
    *   `OnboardingStatus`: Set as a fixed value: "Initiated"
    *   `ComplianceDueDate`: Set to null

**Source 3: Onboarding Checklist Task Entity**
This is the primary source for most task-based activities. One export from this entity will generate rows for multiple activity types. A transformation step will be needed to map the task name to the correct standard activity name.
*   **Entity Name**: `Onboarding checklist task` (or a similar custom name like `HcmOnboardingGuideTask`)
*   **Filter Logic**: Only include tasks with a `CompletionDateTime`.
*   **Field Mapping**:
    *   `OnboardingCase`: Map from `PersonnelNumber`
    *   `ActivityName`: Map from `TaskName`. You must then apply logic to transform source values (e.g., 'Initiate employee background check') into the required standard names (e.g., 'Background Check Initiated'). This mapping should cover:
        *   "Background Check Initiated"
        *   "Background Check Completed"
        *   "Paperwork Sent To New Hire"
        *   "Paperwork Completed By New Hire"
        *   "IT Account Provisioning Initiated"
        *   "Equipment Ordered"
        *   "Equipment Delivered"
        *   "Workspace Setup Completed"
        *   "First Day Orientation Conducted"
        *   "Team Introduction Completed"
        *   "Onboarding Plan Completed"
        *   "30-Day Check-in Performed"
    *   `EventTime`: Map from `CompletionDateTime` for completion events. For initiation events, map from `CreationDateTime` or `StartDate`.
    *   `EventEndTime`: Map from `CompletionDateTime`.
    *   `DepartmentName`: Join to worker or employment entities.
    *   `HiringManagerName`: Join to worker or employment entities.
    *   `PositionTitle`: Join to worker or employment entities.
    *   `OnboardingStatus`: Map from a status field on the checklist or task.
    *   `ComplianceDueDate`: Map from `DueDate`.

**Source 4: Course Tables Entity**
This source tracks training-related activities.
*   **Entity Name**: `Course tables` (or a similar learning management entity)
*   **Logic**: You will need to create two transformations from this source: one for assignment and one for completion.
*   **Field Mapping (Assignment Event)**:
    *   `OnboardingCase`: Map from `PersonnelNumber`
    *   `ActivityName`: Set as a fixed value: "Mandatory Training Assigned"
    *   `EventTime`: Map from `AssignmentDate`
    *   `EventEndTime`: Map from `AssignmentDate`
    *   Other Attributes: Populate from related entities as needed.
*   **Field Mapping (Completion Event)**:
    *   `OnboardingCase`: Map from `PersonnelNumber`
    *   `ActivityName`: Set as a fixed value: "Mandatory Training Completed"
    *   `EventTime`: Map from `CompletionDate`
    *   `EventEndTime`: Map from `CompletionDate`
    *   Other Attributes: Populate from related entities as needed.

ステップ

TDSエンドポイントを有効にする：Power Platform管理センターを開きます。対象の環境を選択し、「設定」＞「製品」＞「機能」に進み、「TDSエンドポイントを有効にする」がオンになっていることを確認します。変更を保存してください。
エンドポイントURLを確認する：環境のサーバーURLは通常、[your-org-name].crm.dynamics.comの形式です。このURLは、Power Platform管理センターで環境の詳細を開くと確認できます。
SQLクライアントを設定する：SQL Server Management Studio（SSMS）やDBeaverなど、Azure Active Directory認証に対応したSQLクライアントを開きます。エンドポイントURLを使ってサーバーに接続します。認証方式として「Azure Active Directory - Universal with MFA」または同様のAzure ADオプションを選び、Dynamics 365の認証情報を入力してください。
データベースを選択する：接続すると、Dataverse環境に対応するデータベースが1つ表示されます。以降のクエリはすべてこのデータベースに対して実行します。
SQLクエリを確認する：提示されたSQLクエリの内容を確認してください。このクエリは共通テーブル式（CTE）で従業員の詳細を取得した後、オンボーディングの各アクティビティに対応する複数のSELECT文をUNIONで結合します。アクティビティがmsdyn_onboardingtaskbaseのようなエンティティに記録されていることを前提としています。
クエリを環境に合わせて調整する：Dynamics 365 HRの設定に合わせてクエリを変更します。テーブル名（例：msdyn_onboardingtaskbase）、列名（例：subject）、タスクを識別するテキスト（例：「バックグラウンドチェック開始」）の変更が必要な場合があります。WHERE句の日付フィルターも、対象期間に合わせて更新してください。
クエリを実行する：調整したSQLクエリをクライアントで実行します。処理時間は、対象期間とデータ量によって異なります。
結果をエクスポートする：クエリの完了後、結果全体をCSVファイルにエクスポートします。多くのSQLクライアントでは、結果のグリッドを右クリックするとエクスポートできます。
アップロード用に準備する：エクスポートしたCSVファイルの列見出しが、必須および推奨属性と完全に一致していることを確認します。対象の属性は、OnboardingCase、ActivityName、EventTime、EventEndTime、DepartmentName、HiringManagerName、PositionTitle、OnboardingStatus、ComplianceDueDateです。
ProcessMindにアップロードする：CSVファイルをProcessMindにアップロードして分析できます。

設定

TDSエンドポイント：Dataverse環境でTDSエンドポイントを有効にする必要があります。直接SQL接続を行うための前提条件です。
ユーザー権限：エンドポイントに接続するユーザーには、クエリで参照するすべてのテーブル（hcmworkerbase、hcmemploymentbase、msdyn_onboardingtaskbase、systemuserbase、hcmdepartmentbase、hcmpositiondetailbaseなど）に対する読み取り権限を持つDataverseのセキュリティロールが必要です。
期間による絞り込み：提示されたクエリには、過去6か月以内に雇用が開始した従業員を対象にするためのプレースホルダーが含まれています。データ量を抑え、クエリのパフォーマンスを高めるには、日付フィルターの設定が欠かせません。初回の分析では3～6か月分をおすすめします。
スキーマのカスタマイズ：このクエリは、オンボーディングタスクがmsdyn_onboardingtaskbaseのようなエンティティに保存され、subjectフィールドで識別される標準的なデータモデルを前提としています。組織で異なるエンティティやカスタムエンティティを使用している場合は、大幅な修正が必要です。
パフォーマンスに関する考慮事項：稼働中のDataverse環境に対して複数の結合を含む複雑なクエリを実行すると、アプリケーションのパフォーマンスに影響する場合があります。大量のデータを抽出する場合は、業務の少ない時間帯に実行してください。

クエリの例 sql

-- The following query reconstructs the Employee Onboarding process by querying the Dataverse TDS endpoint.
-- It assumes that most onboarding activities are tracked in a task entity like 'msdyn_onboardingtaskbase'.
-- Placeholders to be reviewed and updated:
-- 1. Date filter: The 'WHERE emp.startdate >= ...' line should be set to your desired date range.
-- 2. Task Subjects: The text literals in the WHERE clauses (e.g., 'Background Check', 'Order Equipment') must match the subject lines used in your system's onboarding tasks.
-- 3. Table and Column Names: If your environment uses custom entities or fields, update the table and column names accordingly.

WITH WorkerInfo AS (
  SELECT
    w.hcmworkerid AS workerid,
    w.personnelnumber AS personnelnumber,
    emp.startdate AS employmentstartdate,
    d.name AS departmentname,
    pos.description AS positiontitle,
    mgr.fullname AS managername,
    w.createdon AS workercreatedon
  FROM hcmworkerbase AS w
  LEFT JOIN hcmemploymentbase AS emp ON w.hcmworkerid = emp._hcmworkerid_value
  LEFT JOIN hcmdepartmentbase AS d ON emp._hcmdepartmentid_value = d.hcmdepartmentid
  LEFT JOIN hcmpositionworkerassignmentbase AS pwa ON w.hcmworkerid = pwa._hcmworkerid_value AND pwa.isprimaryposition = 1
  LEFT JOIN hcmpositiondetailbase AS posd ON pwa._hcmpositionid_value = posd._hcmpositionid_value
  LEFT JOIN hcmpositionbase AS pos ON pwa._hcmpositionid_value = pos.hcmpositionid
  LEFT JOIN systemuserbase AS mgr ON pos.reports_to_position_id = mgr._hcmpositionid_value
  WHERE emp.startdate >= DATEADD(month, -6, GETUTCDATE()) -- Placeholder: Filter for the last 6 months
    AND emp.employmenttype = 0 -- Example: Filter for Employees, not Contractors
)
-- 1. Offer Accepted (proxied by employment record creation)
SELECT
  w.personnelnumber AS OnboardingCase,
  'Offer Accepted' AS ActivityName,
  w.employmentstartdate AS EventTime,
  w.employmentstartdate AS EventEndTime,
  w.departmentname AS DepartmentName,
  w.managername AS HiringManagerName,
  w.positiontitle AS PositionTitle,
  'In Progress' AS OnboardingStatus,
  NULL AS ComplianceDueDate
FROM WorkerInfo AS w

UNION ALL

-- 2. HR Profile Created
SELECT
  w.personnelnumber AS OnboardingCase,
  'HR Profile Created' AS ActivityName,
  w.workercreatedon AS EventTime,
  w.workercreatedon AS EventEndTime,
  w.departmentname AS DepartmentName,
  w.managername AS HiringManagerName,
  w.positiontitle AS PositionTitle,
  'In Progress' AS OnboardingStatus,
  NULL AS ComplianceDueDate
FROM WorkerInfo AS w

UNION ALL

-- 3. Background Check Initiated
SELECT
  w.personnelnumber AS OnboardingCase,
  'Background Check Initiated' AS ActivityName,
  t.createdon AS EventTime,
  NULL AS EventEndTime,
  w.departmentname AS DepartmentName,
  w.managername AS HiringManagerName,
  w.positiontitle AS PositionTitle,
  'In Progress' AS OnboardingStatus,
  t.scheduledend AS ComplianceDueDate
FROM msdyn_onboardingtaskbase AS t
JOIN WorkerInfo AS w ON t._msdyn_workerid_value = w.workerid
WHERE t.subject LIKE '%Background Check%'

UNION ALL

-- 4. Background Check Completed
SELECT
  w.personnelnumber AS OnboardingCase,
  'Background Check Completed' AS ActivityName,
  t.actualend AS EventTime,
  t.actualend AS EventEndTime,
  w.departmentname AS DepartmentName,
  w.managername AS HiringManagerName,
  w.positiontitle AS PositionTitle,
  'In Progress' AS OnboardingStatus,
  NULL AS ComplianceDueDate
FROM msdyn_onboardingtaskbase AS t
JOIN WorkerInfo AS w ON t._msdyn_workerid_value = w.workerid
WHERE t.subject LIKE '%Background Check%' AND t.statecode = 1

UNION ALL

-- 5. Paperwork Sent To New Hire
SELECT
  w.personnelnumber AS OnboardingCase,
  'Paperwork Sent To New Hire' AS ActivityName,
  t.createdon AS EventTime,
  NULL AS EventEndTime,
  w.departmentname AS DepartmentName,
  w.managername AS HiringManagerName,
  w.positiontitle AS PositionTitle,
  'In Progress' AS OnboardingStatus,
  t.scheduledend AS ComplianceDueDate
FROM msdyn_onboardingtaskbase AS t
JOIN WorkerInfo AS w ON t._msdyn_workerid_value = w.workerid
WHERE t.subject LIKE '%Send Paperwork%'

UNION ALL

-- 6. Paperwork Completed By New Hire
SELECT
  w.personnelnumber AS OnboardingCase,
  'Paperwork Completed By New Hire' AS ActivityName,
  t.actualend AS EventTime,
  t.actualend AS EventEndTime,
  w.departmentname AS DepartmentName,
  w.managername AS HiringManagerName,
  w.positiontitle AS PositionTitle,
  'In Progress' AS OnboardingStatus,
  NULL AS ComplianceDueDate
FROM msdyn_onboardingtaskbase AS t
JOIN WorkerInfo AS w ON t._msdyn_workerid_value = w.workerid
WHERE t.subject LIKE '%Complete Paperwork%' AND t.statecode = 1

UNION ALL

-- 7. IT Account Provisioning Initiated
SELECT
  w.personnelnumber AS OnboardingCase,
  'IT Account Provisioning Initiated' AS ActivityName,
  t.createdon AS EventTime,
  NULL AS EventEndTime,
  w.departmentname AS DepartmentName,
  w.managername AS HiringManagerName,
  w.positiontitle AS PositionTitle,
  'In Progress' AS OnboardingStatus,
  t.scheduledend AS ComplianceDueDate
FROM msdyn_onboardingtaskbase AS t
JOIN WorkerInfo AS w ON t._msdyn_workerid_value = w.workerid
WHERE t.subject LIKE '%IT Account Provisioning%'

UNION ALL

-- 8. Equipment Ordered
SELECT
  w.personnelnumber AS OnboardingCase,
  'Equipment Ordered' AS ActivityName,
  t.actualend AS EventTime, -- Assuming task completion means ordered
  t.actualend AS EventEndTime,
  w.departmentname AS DepartmentName,
  w.managername AS HiringManagerName,
  w.positiontitle AS PositionTitle,
  'In Progress' AS OnboardingStatus,
  NULL AS ComplianceDueDate
FROM msdyn_onboardingtaskbase AS t
JOIN WorkerInfo AS w ON t._msdyn_workerid_value = w.workerid
WHERE t.subject LIKE '%Order Equipment%' AND t.statecode = 1

UNION ALL

-- 9. Equipment Delivered
SELECT
  w.personnelnumber AS OnboardingCase,
  'Equipment Delivered' AS ActivityName,
  t.actualend AS EventTime,
  t.actualend AS EventEndTime,
  w.departmentname AS DepartmentName,
  w.managername AS HiringManagerName,
  w.positiontitle AS PositionTitle,
  'In Progress' AS OnboardingStatus,
  NULL AS ComplianceDueDate
FROM msdyn_onboardingtaskbase AS t
JOIN WorkerInfo AS w ON t._msdyn_workerid_value = w.workerid
WHERE t.subject LIKE '%Confirm Equipment Delivery%' AND t.statecode = 1

UNION ALL

-- 10. Workspace Setup Completed
SELECT
  w.personnelnumber AS OnboardingCase,
  'Workspace Setup Completed' AS ActivityName,
  t.actualend AS EventTime,
  t.actualend AS EventEndTime,
  w.departmentname AS DepartmentName,
  w.managername AS HiringManagerName,
  w.positiontitle AS PositionTitle,
  'In Progress' AS OnboardingStatus,
  NULL AS ComplianceDueDate
FROM msdyn_onboardingtaskbase AS t
JOIN WorkerInfo AS w ON t._msdyn_workerid_value = w.workerid
WHERE t.subject LIKE '%Workspace Setup%' AND t.statecode = 1

UNION ALL

-- 11. First Day Orientation Conducted
SELECT
  w.personnelnumber AS OnboardingCase,
  'First Day Orientation Conducted' AS ActivityName,
  t.actualend AS EventTime,
  t.actualend AS EventEndTime,
  w.departmentname AS DepartmentName,
  w.managername AS HiringManagerName,
  w.positiontitle AS PositionTitle,
  'In Progress' AS OnboardingStatus,
  NULL AS ComplianceDueDate
FROM msdyn_onboardingtaskbase AS t
JOIN WorkerInfo AS w ON t._msdyn_workerid_value = w.workerid
WHERE t.subject LIKE '%First Day Orientation%' AND t.statecode = 1

UNION ALL

-- 12. Mandatory Training Assigned
SELECT
  w.personnelnumber AS OnboardingCase,
  'Mandatory Training Assigned' AS ActivityName,
  t.createdon AS EventTime,
  NULL AS EventEndTime,
  w.departmentname AS DepartmentName,
  w.managername AS HiringManagerName,
  w.positiontitle AS PositionTitle,
  'In Progress' AS OnboardingStatus,
  t.scheduledend AS ComplianceDueDate
FROM msdyn_onboardingtaskbase AS t
JOIN WorkerInfo AS w ON t._msdyn_workerid_value = w.workerid
WHERE t.subject LIKE '%Mandatory Training%'

UNION ALL

-- 13. Mandatory Training Completed
SELECT
  w.personnelnumber AS OnboardingCase,
  'Mandatory Training Completed' AS ActivityName,
  t.actualend AS EventTime,
  t.actualend AS EventEndTime,
  w.departmentname AS DepartmentName,
  w.managername AS HiringManagerName,
  w.positiontitle AS PositionTitle,
  'In Progress' AS OnboardingStatus,
  NULL AS ComplianceDueDate
FROM msdyn_onboardingtaskbase AS t
JOIN WorkerInfo AS w ON t._msdyn_workerid_value = w.workerid
WHERE t.subject LIKE '%Mandatory Training%' AND t.statecode = 1

UNION ALL

-- 14. Team Introduction Completed
SELECT
  w.personnelnumber AS OnboardingCase,
  'Team Introduction Completed' AS ActivityName,
  t.actualend AS EventTime,
  t.actualend AS EventEndTime,
  w.departmentname AS DepartmentName,
  w.managername AS HiringManagerName,
  w.positiontitle AS PositionTitle,
  'In Progress' AS OnboardingStatus,
  NULL AS ComplianceDueDate
FROM msdyn_onboardingtaskbase AS t
JOIN WorkerInfo AS w ON t._msdyn_workerid_value = w.workerid
WHERE t.subject LIKE '%Team Introduction%' AND t.statecode = 1

UNION ALL

-- 15. Onboarding Plan Completed
SELECT
  w.personnelnumber AS OnboardingCase,
  'Onboarding Plan Completed' AS ActivityName,
  g.actualend AS EventTime,
  g.actualend AS EventEndTime,
  w.departmentname AS DepartmentName,
  w.managername AS HiringManagerName,
  w.positiontitle AS PositionTitle,
  'Completed' AS OnboardingStatus,
  NULL AS ComplianceDueDate
FROM msdyn_onboardingguidebase AS g
JOIN WorkerInfo AS w ON g._msdyn_workerid_value = w.workerid
WHERE g.statecode = 1

UNION ALL

-- 16. 30-Day Check-in Performed
SELECT
  w.personnelnumber AS OnboardingCase,
  '30-Day Check-in Performed' AS ActivityName,
  t.actualend AS EventTime,
  t.actualend AS EventEndTime,
  w.departmentname AS DepartmentName,
  w.managername AS HiringManagerName,
  w.positiontitle AS PositionTitle,
  'Completed' AS OnboardingStatus,
  NULL AS ComplianceDueDate
FROM msdyn_onboardingtaskbase AS t
JOIN WorkerInfo AS w ON t._msdyn_workerid_value = w.workerid
WHERE t.subject LIKE '%30-Day Check-in%' AND t.statecode = 1

ORDER BY OnboardingCase, EventTime;

ステップ

前提条件：Azure ADアプリケーションを設定する
- Azure Active Directoryテナントに新しいアプリケーションを登録します。
- アプリケーションのクライアントシークレットを作成し、安全に保管します。
- アプリケーションに「Dynamics ERP」のAPIアクセス許可を付与します。「user_impersonation」の委任されたアクセス許可を選択してください。
- Dynamics 365 Human Resourcesで「システム管理」＞「設定」＞「Azure Active Directoryアプリケーション」に進み、登録したアプリのアプリケーション（クライアント）IDを追加します。関連するデータエンティティの読み取り権限を持つユーザーを割り当ててください。
Python環境を準備する
- Python 3.6以降がインストールされていることを確認します。
- pipを使って必要なライブラリをインストールします：pip install requests pandas msal。
Pythonスクリプトを設定する
- 提示されたPythonスクリプトをエディターで開きます。
- 「CONFIGURATION」セクションのプレースホルダー変数を、Dynamics 365環境の情報に置き換えます：TENANT_ID、CLIENT_ID、CLIENT_SECRET、RESOURCE_URL（D365 HRのベースURL）。
アクティビティのマッピングを調整する
- スクリプト内のactivity_task_mapping辞書を確認します。この辞書では、イベントログに必要な標準アクティビティ名を、Dynamics 365のオンボーディングチェックリストで組織が使用しているタスク名に対応付けます。
- "[Background Check Task Name]"などのプレースホルダーを、システム内の該当タスクの正確な名称に必ず置き換えてください。
抽出期間を設定する
- スクリプト内のstart_date_strとend_date_str変数に値を設定し、データの抽出期間を指定します。完了日または作成日を基準にイベントを絞り込みます。
スクリプトを実行する
- ターミナルで次のコマンドを実行します：python your_script_name.py。
- スクリプトがDynamics 365 Web APIで認証し、指定した各オンボーディングアクティビティのデータを取得して変換します。
イベントログを取得する
- 正常に実行されると、同じディレクトリにd365_onboarding_event_log.csvというCSVファイルが作成されます。
内容を確認してアップロードに備える
- 生成されたCSVファイルを表計算ソフトで開き、データに不足や誤りがないか確認します。
- 列見出しが必須属性と一致していることを確認します：OnboardingCase、ActivityName、EventTimeなど。
- ファイルをProcessMindにアップロードできる状態になりました。

設定

認証：スクリプトではOAuth 2.0のクライアント資格情報フローを使用します。Dynamics 365に登録され、認可されたAzure ADアプリケーションのテナントID、クライアントID、クライアントシークレットが必要です。
APIエンドポイント：RESOURCE_URL変数には、Dynamics 365 Human Resources環境のベースURLを設定します（例：https://your-org.hr.d365.dynamics.com）。
期間：start_date_strとend_date_str変数で抽出期間を指定します。データ量を抑え、大規模な抽出の前に結果を確認できるよう、まずは3～6か月分から始めることをおすすめします。
アクティビティとタスクのマッピング：activity_task_mapping辞書は重要です。標準のアクティビティ名を、D365のオンボーディングチェックリストに設定されている正確なタスクの説明に対応付けてください。マッピングが正しくないと、アクティビティが欠落します。
データエンティティ：スクリプトでは主に、Workers、Employments、Positions、OnboardingGuides、OnboardingChecklistItemsのデータエンティティを照会します。サービスアカウントのユーザーには、これらのエンティティの読み取り権限が必要です。
会社による絞り込み：既定では、すべての法人を対象に照会します（cross-company=true）。特定の会社に絞るには、APIリクエストURLのdataAreaIdに$filter句を追加します。

クエリの例 python

import requests
import pandas as pd
import msal
import datetime

class=class="hl-string">"hl-comment"># --- CONFIGURATION ---
class=class="hl-string">"hl-comment"># Replace with your Azure AD and Dynamics 365 environment details
TENANT_ID = class="hl-string">"your_tenant_id"
CLIENT_ID = class="hl-string">"your_client_id"
CLIENT_SECRET = class="hl-string">"your_client_secret"
RESOURCE_URL = class="hl-string">"https://your-org.hr.d365.dynamics.com" class=class="hl-string">"hl-comment"># Base D365 HR URL
API_ENDPOINT = fclass="hl-string">"{RESOURCE_URL}/data"

class=class="hl-string">"hl-comment"># Define the date range for the extraction
start_date_str = class="hl-string">"2023-01-01"
end_date_str = class="hl-string">"2023-12-31"

class=class="hl-string">"hl-comment"># CRITICAL: Map standard activity names to the exact task names in your D365 Onboarding Checklists
class=class="hl-string">"hl-comment"># The script will query OnboardingChecklistItems based on the class="hl-string">'Task' field values.
activity_task_mapping = {
    class="hl-string">"Background Check Initiated": class="hl-string">"[Background Check Task Name]",
    class="hl-string">"Background Check Completed": class="hl-string">"[Background Check Completed Task Name]",
    class="hl-string">"Paperwork Sent To New Hire": class="hl-string">"[Send Paperwork Task Name]",
    class="hl-string">"Paperwork Completed By New Hire": class="hl-string">"[Complete Paperwork Task Name]",
    class="hl-string">"IT Account Provisioning Initiated": class="hl-string">"[Request IT Account Task Name]",
    class="hl-string">"Equipment Ordered": class="hl-string">"[Order Laptop and Equipment]",
    class="hl-string">"Equipment Delivered": class="hl-string">"[Confirm Equipment Delivery]",
    class="hl-string">"Workspace Setup Completed": class="hl-string">"[Complete Workspace Setup]",
    class="hl-string">"First Day Orientation Conducted": class="hl-string">"[Complete First Day Orientation]",
    class="hl-string">"Mandatory Training Assigned": class="hl-string">"[Assign Mandatory Training]",
    class="hl-string">"Mandatory Training Completed": class="hl-string">"[Confirm Mandatory Training Completion]",
    class="hl-string">"Team Introduction Completed": class="hl-string">"[Introduce New Hire to Team]",
    class="hl-string">"Onboarding Plan Completed": class="hl-string">"[Complete Full Onboarding Plan]",
    class="hl-string">"30-Day Check-in Performed": class="hl-string">"[Conduct 30-Day Check-in]"
}

class=class="hl-string">"hl-comment"># --- AUTHENTICATION ---
def get_access_token():
    authority = fclass="hl-string">"https://login.microsoftonline.com/{TENANT_ID}"
    app = msal.ConfidentialClientApplication(
        CLIENT_ID,
        authority=authority,
        client_credential=CLIENT_SECRET
    )
    result = app.acquire_token_for_client(scopes=[fclass="hl-string">"{RESOURCE_URL}/.default"])
    if class="hl-string">"access_token" in result:
        return result[class="hl-string">'access_token']
    else:
        print(result.get(class="hl-string">"error"))
        print(result.get(class="hl-string">"error_description"))
        raise Exception(class="hl-string">"Could not obtain access token")

class=class="hl-string">"hl-comment"># --- DATA FETCHING AND PROCESSING ---
def fetch_data(access_token, entity_url):
    headers = {
        class="hl-string">'Authorization': fclass="hl-string">'Bearer {access_token}',
        class="hl-string">'Content-Type': class="hl-string">'application/json'
    }
    full_url = fclass="hl-string">"{API_ENDPOINT}/{entity_url}"
    response = requests.get(full_url, headers=headers)
    if response.status_code == 200:
        return response.json()[class="hl-string">'value']
    else:
        print(fclass="hl-string">"Error fetching {entity_url}: {response.status_code} - {response.text}")
        return []

def main():
    print(class="hl-string">"Acquiring access token...")
    token = get_access_token()
    all_events = []

    class=class="hl-string">"hl-comment"># Fetch base worker and onboarding guide data for enrichment
    print(class="hl-string">"Fetching base worker and onboarding data...")
    worker_details_url = fclass="hl-string">"Workers?$select=PersonnelNumber,Name,PrimaryContactEmail,PersonBirthDate&$expand=Employments($select=DepartmentNumber,HiringManagerPersonnelNumber,PositionId),Positions($select=PositionId,Title)"
    workers_data = fetch_data(token, worker_details_url)
    workers_df = pd.json_normalize(workers_data)

    class=class="hl-string">"hl-comment"># A simplified enrichment lookup dictionary
    enrichment_map = {}
    for _, row in workers_df.iterrows():
        enrichment_map[row[class="hl-string">'PersonnelNumber']] = {
            class="hl-string">'DepartmentName': row.get(class="hl-string">'Employments.DepartmentNumber', None),
            class="hl-string">'HiringManagerName': row.get(class="hl-string">'Employments.HiringManagerPersonnelNumber', None),
            class="hl-string">'PositionTitle': row.get(class="hl-string">'Positions.Title', None)
        }

    print(class="hl-string">"Processing activities...")
    
    class=class="hl-string">"hl-comment"># 1. Offer Accepted / HR Profile Created (approximated by worker creation date)
    print(class="hl-string">"Extracting 'Offer Accepted' and 'HR Profile Created'...")
    offer_accepted_url = fclass="hl-string">"Workers?$filter=createdDateTime ge {start_date_str}T00:00:00Z and createdDateTime le {end_date_str}T23:59:59Z&$select=PersonnelNumber,createdDateTime"
    offer_data = fetch_data(token, offer_accepted_url)
    for item in offer_data:
        personnel_number = item.get(class="hl-string">'PersonnelNumber')
        event_time = item.get(class="hl-string">'createdDateTime')
        enrich_data = enrichment_map.get(personnel_number, {})
        all_events.append({class="hl-string">'OnboardingCase': personnel_number, class="hl-string">'ActivityName': class="hl-string">'Offer Accepted', class="hl-string">'EventTime': event_time, **enrich_data})
        all_events.append({class="hl-string">'OnboardingCase': personnel_number, class="hl-string">'ActivityName': class="hl-string">'HR Profile Created', class="hl-string">'EventTime': event_time, **enrich_data})

    class=class="hl-string">"hl-comment"># 2. Checklist-based activities
    for activity_name, task_name in activity_task_mapping.items():
        print(fclass="hl-string">"Extracting '{activity_name}'...")
        checklist_items_url = fclass="hl-string">"OnboardingChecklistItems?$filter=Task eq '{task_name}' and CompletedDateTime ge {start_date_str}T00:00:00Z and CompletedDateTime le {end_date_str}T23:59:59Z&$select=OnboardingGuidePersonnelNumber,CompletedDateTime,DueDate&$expand=OnboardingGuide($select=OverallStatus)"
        checklist_data = fetch_data(token, checklist_items_url)
        for item in checklist_data:
            personnel_number = item.get(class="hl-string">'OnboardingGuidePersonnelNumber')
            event_time = item.get(class="hl-string">'CompletedDateTime')
            enrich_data = enrichment_map.get(personnel_number, {})
            all_events.append({
                class="hl-string">'OnboardingCase': personnel_number,
                class="hl-string">'ActivityName': activity_name,
                class="hl-string">'EventTime': event_time,
                class="hl-string">'EventEndTime': event_time,
                class="hl-string">'ComplianceDueDate': item.get(class="hl-string">'DueDate'),
                class="hl-string">'OnboardingStatus': item.get(class="hl-string">'OnboardingGuide', {}).get(class="hl-string">'OverallStatus'),
                **enrich_data
            })

    class=class="hl-string">"hl-comment"># Convert to DataFrame
    if not all_events:
        print(class="hl-string">"No events found for the specified period.")
        return

    event_log_df = pd.DataFrame(all_events)

    class=class="hl-string">"hl-comment"># Final data transformation
    event_log_df[class="hl-string">'EventTime'] = pd.to_datetime(event_log_df[class="hl-string">'EventTime'], errors=class="hl-string">'coerce')
    event_log_df = event_log_df.dropna(subset=[class="hl-string">'OnboardingCase', class="hl-string">'EventTime'])
    event_log_df = event_log_df.sort_values(by=[class="hl-string">'OnboardingCase', class="hl-string">'EventTime'], ascending=[True, True])
    
    class=class="hl-string">"hl-comment"># Ensure all required and recommended columns exist
    final_columns = [
        class="hl-string">'OnboardingCase', class="hl-string">'ActivityName', class="hl-string">'EventTime', class="hl-string">'EventEndTime',
        class="hl-string">'DepartmentName', class="hl-string">'HiringManagerName', class="hl-string">'PositionTitle',
        class="hl-string">'OnboardingStatus', class="hl-string">'ComplianceDueDate'
    ]
    for col in final_columns:
        if col not in event_log_df.columns:
            event_log_df[col] = None
    
    event_log_df = event_log_df[final_columns]

    class=class="hl-string">"hl-comment"># Export to CSV
    output_filename = class="hl-string">'d365_onboarding_event_log.csv'
    event_log_df.to_csv(output_filename, index=False, date_format=class="hl-string">'%Y-%m-%dT%H:%M:%S.%fZ')
    print(fclass="hl-string">"Extraction complete. Event log saved to {output_filename}")

if __name__ == class="hl-string">"__main__":
    main()

ステップ

Microsoft DataverseコネクタをPower Automateで利用できること、および接続に使用するIDに、Dynamics 365 Human Resources環境で使われているオンボーディング、採用、従業員、チェックリスト、タスク、学習関連などのテーブルへの読み取り権限があることを確認します。テーブル名や列名は環境によって異なるため、フローを作成する前に設定セクションへマッピングを記録してください。
必須の16アクティビティについて、ソーステーブルと列を特定します。マッピングが確定するまでは、[Your table name]と[Your column name]のプレースホルダーを使ってください。各アクティビティには、明示的なイベント条件とイベントのタイムスタンプが必要です。ProcessMindがステータス変更やその他の属性からアクティビティを推測することを前提にしないでください。
Power Automateでスケジュール済みクラウドフローを作成します。必要なデータ取得の遅延に応じて、1時間ごとや1日ごとなどの繰り返し間隔を設定し、[Start date and time]と[End date and time]のパラメーターを指定します。各ソースエンティティにDataverseコネクタの「行を一覧表示」アクションを使い、設定した期間と、該当する場合は会社、法人、事業部門でレコードを絞り込みます。
各ソースレコードからケース識別子と推奨属性を取得します。一意のオンボーディング識別子をOnboardingCase、イベント名をActivityName、ソースでの発生時刻をEventTimeに割り当てます。完了時刻がある場合はEventEndTimeに割り当てます。部門、採用マネージャー、職位、オンボーディング状況、コンプライアンス期限も、それぞれ対応する出力属性に割り当ててください。
必須アクティビティごとに、明示的な抽出分岐を1つずつ追加します。対象は、内定承諾、人事プロファイル作成、バックグラウンドチェック開始、バックグラウンドチェック完了、新入社員への書類送付、新入社員による書類記入完了、ITアカウントのプロビジョニング開始、備品の発注、備品の納品、ワークスペースの準備完了、初日のオリエンテーション実施、必須研修の割り当て、必須研修の完了、チーム紹介の完了、オンボーディング計画の完了、30日目のチェックイン実施です。各分岐では、条件に合うソース上の発生ごとにイベント行を1行出力してください。
分岐の出力を、次の列を含む共通スキーマに統一します：OnboardingCase、ActivityName、EventTime、EventEndTime、DepartmentName、HiringManagerName、PositionTitle、OnboardingStatus、ComplianceDueDate。すべてのタイムスタンプを、できればUTCなど、合意した1つのタイムゾーンに変換し、ISO 8601形式を使います。重複排除に必要な場合は、追加の技術列にソース識別子を保持します。ただし、OnboardingCaseの代わりに使わないでください。
OnboardingCase、ActivityName、ソースレコード識別子、EventTimeなど、文書化した業務キーを使って重複行を削除します。プロセス定義でケースごとに各アクティビティが1回のみと明示されていない限り、正当な繰り返しイベントをまとめないでください。有効なOnboardingCaseまたはEventTimeがないレコードはProcessMindの出力から除外し、修正用の別の例外ファイルに出力します。
正規化した行を、[Container]/[Process name]/[Year]/[Month]/onboarding_events_[Run identifier].csvなど、一定のフォルダーおよびファイル名の規則に従ってAzure Blob Storageに書き込みます。ヘッダー行、UTF-8エンコード、一貫した引用符の形式、ISO 8601形式のタイムスタンプを使用してください。差分抽出を行う場合は、最後に成功したウォーターマークを保存し、遅れて届く更新を取り込めるよう、次回の抽出期間に重複期間を設けます。
アクティビティの網羅性、必須フィールドの充足、タイムスタンプの妥当性、重複の有無、ケース単位の順序など、以下のチェック項目に照らして生成ファイルを検証します。ProcessMindに公開する前に、ソースのマッピングやフローフィルターを修正してください。
検証済みのCSVをイベントログとしてProcessMindにアップロードします。OnboardingCaseをケース識別子、ActivityNameをアクティビティ、EventTimeをイベントのタイムスタンプとして割り当て、残りの列はイベント属性またはケース属性として設定します。ProcessMindが提供された行をそのまま読み込み、追加のイベントを推定しないことを確認してください。

設定

ソースのマッピング：すべてのプレースホルダーを、Dynamics 365 Human Resources環境で実際に使われているDataverseのテーブル名と列名に置き換えてください。すべての環境に標準テーブル、論理名、ステータス値、リレーションシップが存在するとは限りません。
必須の出力項目：すべての行にOnboardingCase、ActivityName、EventTimeを含めてください。ActivityNameには必須の16種類のアクティビティ名のいずれかを指定し、表記と大文字・小文字を統一してください。
推奨する出力項目：ソースデータに含まれている場合は、EventEndTime、DepartmentName、HiringManagerName、PositionTitle、OnboardingStatus、ComplianceDueDateも含めてください。
期間：まずは直近3～6か月の期間を指定してください。オンボーディング案件が6か月を超えて継続する場合や、過去のデータを漏れなく取得する必要がある場合は、期間を延長します。定期実行ではウォーターマークを使ってください。
フィルター：[Company or legal entity filter]、[Business unit filter]、[Onboarding status filter]は、対応するソース列と使用可能な値を確認してから適用してください。アクティビティの発生時点を記録する場合は、レコード作成時刻ではなく、ソース上のイベントタイムスタンプで絞り込みます。
アクティビティの条件：各アクティビティに明示的な条件を設定してください。汎用のステータスフィールドを使えるのは、その値でアクティビティを明確に識別でき、遷移時刻も取得できる場合に限ります。過去の遷移データがない場合、現在のステータスから過去のイベントを正確に再構成することはできません。
タイムゾーン：ソースのタイムスタンプをUTCなど、合意した1つのタイムゾーンに変換します。ソースの値が現地時間で保存されている場合は特に、変換ルールを抽出に関する文書に記録してください。
差分処理：最後に成功したEventTimeまたはソースの更新日時をウォーターマークとして保存します。遅れて届く変更を取り込むため、短い重複期間を設けたうえで、文書化したソースキーを使って重複を排除してください。
パフォーマンス：必要な列だけを選択し、Dataverseのクエリ段階で絞り込み、ページネーションを使います。スロットリングが発生する場合は同時実行数を制限し、大きな期間は小分けにしてください。イベントや属性に必要なフィールドだけを取得し、エンティティ全体の取得は避けてください。
ページネーションと上限：テナントの上限に合わせて、Dataverseの「行を一覧表示」のページネーションとページサイズを設定します。フローの実行時間、コネクタのスロットリング、ページの失敗、書き込みの一部欠落を監視してください。
前提条件：環境でPower Automateが有効になっていること、Dataverse接続があること、関連するDynamics 365 Human Resourcesのデータにアクセスできること、マッピングしたすべてのテーブルと列の読み取り権限があること、選択したAzure Blob Storageの保存先への書き込み権限があることが必要です。必要なライセンスと環境ポリシーはシステム管理者に確認してください。
データガバナンス：組織の保持、プライバシー、アクセス制御のルールを適用してください。従業員名、採用情報、コンプライアンス期限、オンボーディング記録には、個人情報や機微情報が含まれる場合があります。

クエリの例 config

const CONFIG = {
  startDate: '[Start date and time]',
  endDate: '[End date and time]',
  companyFilter: '[Company or legal entity filter]',
  sourceTimeZone: '[Source time zone]',
  targetTimeZone: 'UTC'
};

const ACTIVITIES = [
  'Offer Accepted',
  'HR Profile Created',
  'Background Check Initiated',
  'Background Check Completed',
  'Paperwork Sent To New Hire',
  'Paperwork Completed By New Hire',
  'IT Account Provisioning Initiated',
  'Equipment Ordered',
  'Equipment Delivered',
  'Workspace Setup Completed',
  'First Day Orientation Conducted',
  'Mandatory Training Assigned',
  'Mandatory Training Completed',
  'Team Introduction Completed',
  'Onboarding Plan Completed',
  '30-Day Check-in Performed'
];

const SOURCE_MAPPINGS = {
  offerAccepted: {
    table: '[Your table name]',
    caseColumn: '[Your onboarding case column]',
    eventColumn: '[Your offer accepted timestamp column]',
    endColumn: '[Your offer accepted end timestamp column]',
    departmentColumn: '[Your department column]',
    managerColumn: '[Your hiring manager column]',
    positionColumn: '[Your position title column]',
    statusColumn: '[Your onboarding status column]',
    complianceColumn: '[Your compliance due date column]',
    companyColumn: '[Your company or legal entity column]'
  },
  hrProfileCreated: {
    table: '[Your table name]',
    caseColumn: '[Your onboarding case column]',
    eventColumn: '[Your HR profile created timestamp column]',
    endColumn: '[Your HR profile created end timestamp column]',
    departmentColumn: '[Your department column]',
    managerColumn: '[Your hiring manager column]',
    positionColumn: '[Your position title column]',
    statusColumn: '[Your onboarding status column]',
    complianceColumn: '[Your compliance due date column]',
    companyColumn: '[Your company or legal entity column]'
  },
  backgroundCheckInitiated: {
    table: '[Your table name]',
    caseColumn: '[Your onboarding case column]',
    eventColumn: '[Your background check initiated timestamp column]',
    endColumn: '[Your background check initiated end timestamp column]',
    departmentColumn: '[Your department column]',
    managerColumn: '[Your hiring manager column]',
    positionColumn: '[Your position title column]',
    statusColumn: '[Your onboarding status column]',
    complianceColumn: '[Your compliance due date column]',
    companyColumn: '[Your company or legal entity column]'
  },
  backgroundCheckCompleted: {
    table: '[Your table name]',
    caseColumn: '[Your onboarding case column]',
    eventColumn: '[Your background check completed timestamp column]',
    endColumn: '[Your background check completed end timestamp column]',
    departmentColumn: '[Your department column]',
    managerColumn: '[Your hiring manager column]',
    positionColumn: '[Your position title column]',
    statusColumn: '[Your onboarding status column]',
    complianceColumn: '[Your compliance due date column]',
    companyColumn: '[Your company or legal entity column]'
  },
  paperworkSent: {
    table: '[Your table name]',
    caseColumn: '[Your onboarding case column]',
    eventColumn: '[Your paperwork sent timestamp column]',
    endColumn: '[Your paperwork sent end timestamp column]',
    departmentColumn: '[Your department column]',
    managerColumn: '[Your hiring manager column]',
    positionColumn: '[Your position title column]',
    statusColumn: '[Your onboarding status column]',
    complianceColumn: '[Your compliance due date column]',
    companyColumn: '[Your company or legal entity column]'
  },
  paperworkCompleted: {
    table: '[Your table name]',
    caseColumn: '[Your onboarding case column]',
    eventColumn: '[Your paperwork completed timestamp column]',
    endColumn: '[Your paperwork completed end timestamp column]',
    departmentColumn: '[Your department column]',
    managerColumn: '[Your hiring manager column]',
    positionColumn: '[Your position title column]',
    statusColumn: '[Your onboarding status column]',
    complianceColumn: '[Your compliance due date column]',
    companyColumn: '[Your company or legal entity column]'
  },
  itProvisioningInitiated: {
    table: '[Your table name]',
    caseColumn: '[Your onboarding case column]',
    eventColumn: '[Your IT provisioning initiated timestamp column]',
    endColumn: '[Your IT provisioning initiated end timestamp column]',
    departmentColumn: '[Your department column]',
    managerColumn: '[Your hiring manager column]',
    positionColumn: '[Your position title column]',
    statusColumn: '[Your onboarding status column]',
    complianceColumn: '[Your compliance due date column]',
    companyColumn: '[Your company or legal entity column]'
  },
  equipmentOrdered: {
    table: '[Your table name]',
    caseColumn: '[Your onboarding case column]',
    eventColumn: '[Your equipment ordered timestamp column]',
    endColumn: '[Your equipment ordered end timestamp column]',
    departmentColumn: '[Your department column]',
    managerColumn: '[Your hiring manager column]',
    positionColumn: '[Your position title column]',
    statusColumn: '[Your onboarding status column]',
    complianceColumn: '[Your compliance due date column]',
    companyColumn: '[Your company or legal entity column]'
  },
  equipmentDelivered: {
    table: '[Your table name]',
    caseColumn: '[Your onboarding case column]',
    eventColumn: '[Your equipment delivered timestamp column]',
    endColumn: '[Your equipment delivered end timestamp column]',
    departmentColumn: '[Your department column]',
    managerColumn: '[Your hiring manager column]',
    positionColumn: '[Your position title column]',
    statusColumn: '[Your onboarding status column]',
    complianceColumn: '[Your compliance due date column]',
    companyColumn: '[Your company or legal entity column]'
  },
  workspaceSetupCompleted: {
    table: '[Your table name]',
    caseColumn: '[Your onboarding case column]',
    eventColumn: '[Your workspace setup completed timestamp column]',
    endColumn: '[Your workspace setup completed end timestamp column]',
    departmentColumn: '[Your department column]',
    managerColumn: '[Your hiring manager column]',
    positionColumn: '[Your position title column]',
    statusColumn: '[Your onboarding status column]',
    complianceColumn: '[Your compliance due date column]',
    companyColumn: '[Your company or legal entity column]'
  },
  orientationConducted: {
    table: '[Your table name]',
    caseColumn: '[Your onboarding case column]',
    eventColumn: '[Your orientation conducted timestamp column]',
    endColumn: '[Your orientation conducted end timestamp column]',
    departmentColumn: '[Your department column]',
    managerColumn: '[Your hiring manager column]',
    positionColumn: '[Your position title column]',
    statusColumn: '[Your onboarding status column]',
    complianceColumn: '[Your compliance due date column]',
    companyColumn: '[Your company or legal entity column]'
  },
  trainingAssigned: {
    table: '[Your table name]',
    caseColumn: '[Your onboarding case column]',
    eventColumn: '[Your mandatory training assigned timestamp column]',
    endColumn: '[Your mandatory training assigned end timestamp column]',
    departmentColumn: '[Your department column]',
    managerColumn: '[Your hiring manager column]',
    positionColumn: '[Your position title column]',
    statusColumn: '[Your onboarding status column]',
    complianceColumn: '[Your compliance due date column]',
    companyColumn: '[Your company or legal entity column]'
  },
  trainingCompleted: {
    table: '[Your table name]',
    caseColumn: '[Your onboarding case column]',
    eventColumn: '[Your mandatory training completed timestamp column]',
    endColumn: '[Your mandatory training completed end timestamp column]',
    departmentColumn: '[Your department column]',
    managerColumn: '[Your hiring manager column]',
    positionColumn: '[Your position title column]',
    statusColumn: '[Your onboarding status column]',
    complianceColumn: '[Your compliance due date column]',
    companyColumn: '[Your company or legal entity column]'
  },
  teamIntroductionCompleted: {
    table: '[Your table name]',
    caseColumn: '[Your onboarding case column]',
    eventColumn: '[Your team introduction completed timestamp column]',
    endColumn: '[Your team introduction completed end timestamp column]',
    departmentColumn: '[Your department column]',
    managerColumn: '[Your hiring manager column]',
    positionColumn: '[Your position title column]',
    statusColumn: '[Your onboarding status column]',
    complianceColumn: '[Your compliance due date column]',
    companyColumn: '[Your company or legal entity column]'
  },
  onboardingPlanCompleted: {
    table: '[Your table name]',
    caseColumn: '[Your onboarding case column]',
    eventColumn: '[Your onboarding plan completed timestamp column]',
    endColumn: '[Your onboarding plan completed end timestamp column]',
    departmentColumn: '[Your department column]',
    managerColumn: '[Your hiring manager column]',
    positionColumn: '[Your position title column]',
    statusColumn: '[Your onboarding status column]',
    complianceColumn: '[Your compliance due date column]',
    companyColumn: '[Your company or legal entity column]'
  },
  checkIn30Day: {
    table: '[Your table name]',
    caseColumn: '[Your onboarding case column]',
    eventColumn: '[Your 30-day check-in timestamp column]',
    endColumn: '[Your 30-day check-in end timestamp column]',
    departmentColumn: '[Your department column]',
    managerColumn: '[Your hiring manager column]',
    positionColumn: '[Your position title column]',
    statusColumn: '[Your onboarding status column]',
    complianceColumn: '[Your compliance due date column]',
    companyColumn: '[Your company or legal entity column]'
  }
};

function toUtc(value) {
  if (value === null || value === undefined || value === '') return null;
  const date = new Date(value);
  if (Number.isNaN(date.getTime())) return null;
  return date.toISOString();
}

function inRange(value) {
  const timestamp = toUtc(value);
  if (!timestamp) return false;
  return timestamp >= toUtc(CONFIG.startDate) && timestamp <= toUtc(CONFIG.endDate);
}

function getValue(record, column) {
  if (!column || column.startsWith('[')) return null;
  return record[column] ?? null;
}

function createEvent(record, mapping, activity) {
  const eventTime = getValue(record, mapping.eventColumn);
  const onboardingCase = getValue(record, mapping.caseColumn);
  if (!onboardingCase || !inRange(eventTime)) return null;
  return {
    OnboardingCase: String(onboardingCase),
    ActivityName: activity,
    EventTime: toUtc(eventTime),
    EventEndTime: toUtc(getValue(record, mapping.endColumn)) || toUtc(eventTime),
    DepartmentName: getValue(record, mapping.departmentColumn),
    HiringManagerName: getValue(record, mapping.managerColumn),
    PositionTitle: getValue(record, mapping.positionColumn),
    OnboardingStatus: getValue(record, mapping.statusColumn),
    ComplianceDueDate: toUtc(getValue(record, mapping.complianceColumn)),
    SourceRecordId: record.id || record[`${mapping.table}id`] || null
  };
}

async function listRows(dataverse, mapping) {
  const select = [
    mapping.caseColumn,
    mapping.eventColumn,
    mapping.endColumn,
    mapping.departmentColumn,
    mapping.managerColumn,
    mapping.positionColumn,
    mapping.statusColumn,
    mapping.complianceColumn,
    mapping.companyColumn
  ].filter(column => column && !column.startsWith('['));
  const filter = {
    startDate: CONFIG.startDate,
    endDate: CONFIG.endDate,
    companyFilter: CONFIG.companyFilter,
    eventColumn: mapping.eventColumn,
    companyColumn: mapping.companyColumn
  };
  return dataverse.listRows({
    table: mapping.table,
    select,
    filter,
    pagination: true
  });
}

async function extractOnboardingEvents(dataverse) {
  const events = [];
  const offerAcceptedRows = await listRows(dataverse, SOURCE_MAPPINGS.offerAccepted);
  for (const record of offerAcceptedRows) {
    const event = createEvent(record, SOURCE_MAPPINGS.offerAccepted, 'Offer Accepted');
    if (event) events.push(event);
  }
  const hrProfileCreatedRows = await listRows(dataverse, SOURCE_MAPPINGS.hrProfileCreated);
  for (const record of hrProfileCreatedRows) {
    const event = createEvent(record, SOURCE_MAPPINGS.hrProfileCreated, 'HR Profile Created');
    if (event) events.push(event);
  }
  const backgroundCheckInitiatedRows = await listRows(dataverse, SOURCE_MAPPINGS.backgroundCheckInitiated);
  for (const record of backgroundCheckInitiatedRows) {
    const event = createEvent(record, SOURCE_MAPPINGS.backgroundCheckInitiated, 'Background Check Initiated');
    if (event) events.push(event);
  }
  const backgroundCheckCompletedRows = await listRows(dataverse, SOURCE_MAPPINGS.backgroundCheckCompleted);
  for (const record of backgroundCheckCompletedRows) {
    const event = createEvent(record, SOURCE_MAPPINGS.backgroundCheckCompleted, 'Background Check Completed');
    if (event) events.push(event);
  }
  const paperworkSentRows = await listRows(dataverse, SOURCE_MAPPINGS.paperworkSent);
  for (const record of paperworkSentRows) {
    const event = createEvent(record, SOURCE_MAPPINGS.paperworkSent, 'Paperwork Sent To New Hire');
    if (event) events.push(event);
  }
  const paperworkCompletedRows = await listRows(dataverse, SOURCE_MAPPINGS.paperworkCompleted);
  for (const record of paperworkCompletedRows) {
    const event = createEvent(record, SOURCE_MAPPINGS.paperworkCompleted, 'Paperwork Completed By New Hire');
    if (event) events.push(event);
  }
  const itProvisioningInitiatedRows = await listRows(dataverse, SOURCE_MAPPINGS.itProvisioningInitiated);
  for (const record of itProvisioningInitiatedRows) {
    const event = createEvent(record, SOURCE_MAPPINGS.itProvisioningInitiated, 'IT Account Provisioning Initiated');
    if (event) events.push(event);
  }
  const equipmentOrderedRows = await listRows(dataverse, SOURCE_MAPPINGS.equipmentOrdered);
  for (const record of equipmentOrderedRows) {
    const event = createEvent(record, SOURCE_MAPPINGS.equipmentOrdered, 'Equipment Ordered');
    if (event) events.push(event);
  }
  const equipmentDeliveredRows = await listRows(dataverse, SOURCE_MAPPINGS.equipmentDelivered);
  for (const record of equipmentDeliveredRows) {
    const event = createEvent(record, SOURCE_MAPPINGS.equipmentDelivered, 'Equipment Delivered');
    if (event) events.push(event);
  }
  const workspaceSetupCompletedRows = await listRows(dataverse, SOURCE_MAPPINGS.workspaceSetupCompleted);
  for (const record of workspaceSetupCompletedRows) {
    const event = createEvent(record, SOURCE_MAPPINGS.workspaceSetupCompleted, 'Workspace Setup Completed');
    if (event) events.push(event);
  }
  const orientationConductedRows = await listRows(dataverse, SOURCE_MAPPINGS.orientationConducted);
  for (const record of orientationConductedRows) {
    const event = createEvent(record, SOURCE_MAPPINGS.orientationConducted, 'First Day Orientation Conducted');
    if (event) events.push(event);
  }
  const trainingAssignedRows = await listRows(dataverse, SOURCE_MAPPINGS.trainingAssigned);
  for (const record of trainingAssignedRows) {
    const event = createEvent(record, SOURCE_MAPPINGS.trainingAssigned, 'Mandatory Training Assigned');
    if (event) events.push(event);
  }
  const trainingCompletedRows = await listRows(dataverse, SOURCE_MAPPINGS.trainingCompleted);
  for (const record of trainingCompletedRows) {
    const event = createEvent(record, SOURCE_MAPPINGS.trainingCompleted, 'Mandatory Training Completed');
    if (event) events.push(event);
  }
  const teamIntroductionCompletedRows = await listRows(dataverse, SOURCE_MAPPINGS.teamIntroductionCompleted);
  for (const record of teamIntroductionCompletedRows) {
    const event = createEvent(record, SOURCE_MAPPINGS.teamIntroductionCompleted, 'Team Introduction Completed');
    if (event) events.push(event);
  }
  const onboardingPlanCompletedRows = await listRows(dataverse, SOURCE_MAPPINGS.onboardingPlanCompleted);
  for (const record of onboardingPlanCompletedRows) {
    const event = createEvent(record, SOURCE_MAPPINGS.onboardingPlanCompleted, 'Onboarding Plan Completed');
    if (event) events.push(event);
  }
  const checkIn30DayRows = await listRows(dataverse, SOURCE_MAPPINGS.checkIn30Day);
  for (const record of checkIn30DayRows) {
    const event = createEvent(record, SOURCE_MAPPINGS.checkIn30Day, '30-Day Check-in Performed');
    if (event) events.push(event);
  }
  const unique = new Map();
  for (const event of events) {
    const key = [event.OnboardingCase, event.ActivityName, event.SourceRecordId, event.EventTime].join('|');
    if (!unique.has(key)) unique.set(key, event);
  }
  return Array.from(unique.values()).sort((a, b) => {
    const caseOrder = a.OnboardingCase.localeCompare(b.OnboardingCase);
    return caseOrder || a.EventTime.localeCompare(b.EventTime) || a.ActivityName.localeCompare(b.ActivityName);
  });
}

function toCsv(rows) {
  const columns = [
    'OnboardingCase',
    'ActivityName',
    'EventTime',
    'EventEndTime',
    'DepartmentName',
    'HiringManagerName',
    'PositionTitle',
    'OnboardingStatus',
    'ComplianceDueDate'
  ];
  const escape = value => {
    if (value === null || value === undefined) return '';
    const text = String(value);
    return /[",\n\r]/.test(text) ? `"${text.replace(/"/g, '""')}"` : text;
  };
  return [columns.join(','), ...rows.map(row => columns.map(column => escape(row[column])).join(','))].join('\n');
}

async function run(dataverse, blobStorage) {
  const rows = await extractOnboardingEvents(dataverse);
  const missingRequired = rows.filter(row => !row.OnboardingCase || !row.ActivityName || !row.EventTime);
  if (missingRequired.length > 0) throw new Error('Required event attributes are missing.');
  const invalidActivities = rows.filter(row => !ACTIVITIES.includes(row.ActivityName));
  if (invalidActivities.length > 0) throw new Error('An activity outside the approved activity list was produced.');
  const csv = toCsv(rows);
  const path = `[Your container]/Employee Onboarding/${new Date().toISOString().slice(0, 7)}/onboarding_events_${Date.now()}.csv`;
  await blobStorage.writeText(path, csv, { contentType: 'text/csv', encoding: 'utf-8' });
  return { path, rowCount: rows.length, activities: ACTIVITIES };
}

module.exports = { run, extractOnboardingEvents, toCsv };

始める準備はできていますか？

このテンプレートを使うと、データ収集を効率よく進め、従業員のオンボーディングプロセスに関するインサイトを得られます。今すぐワークフローの効率化に取り組み、新入社員にとってより良い受け入れ体験を実現しましょう。

改善ガイドに戻る

テンプレートをダウンロード

従業員のオンボーディングを最適化し、効率を高めましょう

今すぐ、コンプライアンス達成率95％とスムーズな新入社員の受け入れを目指しましょう。

無料トライアルを開始しましょう

クレジットカードは不要です。設定は数分で完了します。

従業員のオンボーディング用データテンプレート

従業員のオンボーディング用データテンプレート

従業員のオンボーディングの属性

従業員のオンボーディングのアクティビティ

データ抽出ガイド

Dynamics 365 HRのデータ管理フレームワークからのエクスポート

ステップ

設定

クエリの例 config

Dataverse TDSエンドポイント経由での直接SQLクエリ

ステップ

設定

クエリの例 sql

Dynamics 365 Web APIを使ったPythonスクリプト

ステップ

設定

クエリの例 python

Dataverseコネクタを使ったPower Automateフロー

ステップ

設定

クエリの例 config

始める準備はできていますか？

従業員のオンボーディングを最適化し、効率を高めましょう