> 継続的なプロセス改善 > 採用から退職まで：従業員ライフサイクル > UKG Pro > データテンプレート

採用から退職まで：従業員ライフサイクルのデータテンプレート

UKG Pro

採用から退職まで：従業員ライフサイクルの属性 (21) 採用から退職まで：従業員ライフサイクルのアクティビティ (15) 抽出ガイド (1)

採用から退職まで：従業員ライフサイクルのデータテンプレート

このテンプレートでは、採用から退職までのプロセスを効果的に分析するために必要なデータ項目を整理しています。収集すべき属性、追跡すべき主要なアクティビティ、UKG Proからデータを抽出する方法を確認できます。データ準備を効率化し、プロセスマイニングをスムーズに始めるためにご利用ください。

収集を推奨する属性
追跡すべき主要なアクティビティ
UKG Proからの抽出方法

イベントログを初めて扱いますか。学ぶプロセスマイニングのイベントログを作成する方法.

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

採用から退職まで：従業員ライフサイクルの属性

採用から退職までの従業員ライフサイクルを詳細に分析し、インサイトを得るために、イベントログに含める推奨データ項目です。

5 必須 7 推奨 9 任意

	名前	説明
	イベント日時 EventTimestamp	特定のライフサイクルイベントが発生した正確な日時です。
説明イベント日時は各アクティビティの時系列を示し、プロセスフローの基盤となります。「オファー承諾」や「昇進承認」などのイベントがシステムに記録された正確な時点を保持します。分析では、アクティビティ間の所要時間の計算、遅延の特定、採用やオンボーディングなどの主要なサブプロセスのサイクルタイム測定に使用します。正確な日時は、時間ベースのKPIやパフォーマンス分析に欠かせません。重要な理由この属性はイベントを時系列に並べ、サイクルタイムや所要時間など、時間に基づくすべての指標を計算するために欠かせません。入手先 UKG Proで特定のイベントに関連付けられた日付またはタイムスタンプ項目から取得します。「HireDate」や「TerminationDate」、ワークフローモジュールのステータス変更日時などが該当します。例 2023-01-15T09:00:00Z2023-06-20T14:35:10Z2024-02-01T11:00:00Z
	従業員ID EmployeeId	各従業員に割り当てられる一意の識別子であり、組織内の従業員ライフサイクル全体における主要なケースIDとして機能します。
説明従業員IDは、最初の応募から最終的な退職手続きまで、従業員に関連するすべてのイベントをつなぐ中心的な識別子です。個人の経路を最初から最後まで把握するプロセスビューを構築するうえで欠かせません。プロセスマイニング分析では、「従業員の採用完了」「昇進の承認」「退職手続きの開始」など、すべてのアクティビティがこの一意のIDに関連付けられます。これにより、従業員ごとの経路分析、従業員の属性に基づくコホート分析、ライフサイクルの所要時間の正確な計算が可能になります。重要な理由従業員に関連するすべてのイベントを結び付ける基本的なケース識別子です。個々の従業員について、採用から退職までのプロセスを最初から最後まで分析できます。入手先 UKG Proの中核項目で、通常は従業員プロフィールまたはマスターデータのレコードにあります。具体的なテーブル名と項目名については、UKG Proのドキュメントをご確認ください。多くの場合、「従業員番号」または「Person ID」として表示されます。例 10052198345210047
	アクティビティ名 ActivityName	従業員のライフサイクルで発生した特定のイベントまたはマイルストーンの名称です。たとえば、「従業員の採用」や「パフォーマンスレビューの実施」などがあります。
説明アクティビティ名は、採用から退職までのプロセスにおける個々のステップまたはタスクを表します。これらのイベントには日時が記録され、プロセスマイニングで可視化・分析するプロセスフローが構成されます。アクティビティの順序と頻度を分析すると、実際のプロセスの実行状況が明らかになります。一般的な経路、標準プロセスからの逸脱、「オンボーディング開始」から「給与設定完了」までの主要なアクティビティ間にあるボトルネックを特定できます。重要な理由この属性はプロセスマップ上のステップを定義し、従業員のライフサイクルフローを可視化・分析できるようにします。入手先通常は、イベントログ、ワークフローのステータス変更、またはUKG Proの各種モジュール（採用、オンボーディング、パフォーマンス管理など）にある特定の日付項目から生成されます。標準化されたアクティビティ名を作成するには、通常、マッピングロジックが必要です。例従業員の採用完了パフォーマンスレビューの実施退職手続きの開始
	ソースシステム SourceSystem	データを抽出したシステムを示します。この場合はUKG Proです。
説明この属性は、プロセスデータの取得元を示します。この例では主にUKG Proですが、採用から退職までのプロセスでは、応募者追跡システム（ATS）や学習管理システム（LMS）など、他のシステムのデータが含まれる場合もあります。複数のシステムが関係する場合、分析でデータソースを区別するのに役立ち、データガバナンスや問題の調査にも欠かせません。単一のソースに絞って表示する場合も、データの取得元を理解するための重要な情報になります。重要な理由イベントデータの取得元を特定し、データガバナンス、品質保証、追跡可能性を支える重要な情報を提供します。入手先通常は「UKG Pro」という固定値で、データの変換・抽出処理中に追加されます。例 UKG ProUKGPro_CoreHRUKG
	最終データ更新日時 LastDataUpdate	このイベントのデータがソースシステムから最後に更新または抽出された日時を示すタイムスタンプです。
説明この属性は、UKG Proから最後にデータを抽出した日時を示します。業務イベントが発生した時刻ではなく、レコードがプロセスマイニングツールに取り込まれた時刻です。分析対象データの鮮度を把握するうえで重要な情報です。アナリストや業務担当者は、プロセスの表示内容がどの時点まで更新されているかを確認でき、データ更新スケジュールの管理や分析結果の新しさの検証にも役立てられます。重要な理由データの鮮度を示すため、分析結果を信頼し、適切なタイミングで業務上の判断を行ううえで欠かせません。入手先このタイムスタンプは、データの抽出、変換、ロード（ETL）処理中に各レコードへ生成・追加されます。例 2024-03-15T02:00:00Z2024-03-16T02:00:00Z2024-03-17T02:00:00Z
	マネージャー名 ManagerName	従業員の直属のマネージャーまたは上司の氏名です。
説明この属性は、従業員の直属のマネージャーを特定します。マネージャーは、パフォーマンスレビュー、昇進、トレーニングの割り当てなど、多くのライフサイクルイベントに関わります。マネージャー別に分析すると、チーム単位での実行状況の違いやマネージャーの有効性を把握できます。たとえば、「マネージャー変更の影響分析」ダッシュボードでは、この属性を使ってマネージャーの変更がその後のアクティビティに与える影響を確認します。「マネージャーによる再関与までの時間」KPIにも欠かせません。重要な理由チーム単位でプロセスパフォーマンスを分析し、マネージャーが従業員のライフサイクルイベントに与える影響を評価できます。入手先 UKG ProのCore HRモジュールにある従業員のレポートライン構造データの一部です。例 John SmithMaria GarciaChen Wei
	入社日 HireDate	従業員が組織で勤務を開始した正式な日付です。
説明入社日は、従業員の在籍期間の起点となります。従業員のライフサイクルに関する多くの時間ベースの計算や分析で基準となる、基本的な日付項目です。この属性は在籍期間の計算に使用され、「入社後早期離職率」の分析に欠かせません。また、コホート分析にも役立ち、異なる時期に入社した従業員のライフサイクルパターンを比較できます。重要な理由従業員の在籍期間を計算する基準となり、コホート分析や離職率KPIに欠かせません。入手先 UKG ProのCore HRモジュールにある従業員の主要レコードの標準必須項目です。例 2022-08-152023-01-202021-05-10
	実行ユーザー ActioningUser	UKG Proでアクティビティを実行したユーザーの氏名またはIDです。通常は人事担当者またはマネージャーが該当します。
説明この属性は、オファーを提示した採用担当者や昇進を承認したマネージャーなど、特定のプロセスステップを実行した担当者を特定します。プロセス上のアクティビティと実行者を関連付ける情報です。分析では、業務量の分布、トレーニングの必要性、ユーザーごとのパフォーマンスを把握するうえで非常に役立ちます。たとえば、「給与設定完了」後のデータ入力ミスが特定のユーザーに集中しているかを確認し、「オンボーディング後のデータ再作業率」KPIの分析に役立てられます。重要な理由プロセス上のアクティビティを特定のユーザーに関連付け、業務量の分析、パフォーマンスの比較、再作業やエラーの調査を可能にします。入手先通常は、UKG Proの各モジュールにある監査証跡ログまたは「Last Modified By」項目に記録されています。正確な項目名はモジュールによって異なります。例 j.does.smithhr_admin
	求人依頼ID JobRequisitionId	採用プロセスを開始した求人依頼を一意に識別するIDです。
説明求人依頼IDは、特定の求人を識別する一意の参照番号です。求人の作成・承認から候補者の募集、オファーの提示まで、採用初期段階のすべてのアクティビティを関連付けます。このIDは、採用プロセスの実質的な開始点を示すため、「採用サイクルタイム」KPIの分析に欠かせません。1件の求人について採用ファネル全体を追跡でき、進捗しない求人依頼を特定して「未稼働求人依頼率」などの指標を分析できます。重要な理由採用プロセスの明確な開始点となり、採用サイクルタイムと求人依頼の有効性を正確に測定できます。入手先 UKG Proの採用モジュールまたは接続された応募者追跡システム（ATS）にあります。例 REQ-2023-015REQ-2024-112REQ-2023-504
	職種名 JobTitle	従業員の正式な職種名です。「ソフトウェアエンジニア」や「営業マネージャー」などがあります。
説明職種名は、組織内での従業員の役割またはポジションを表します。さまざまな職種や職位によってプロセスがどのように異なるかを分析するための重要な切り口です。分析では、職種ごとのオンボーディング期間の比較、昇進の進行速度の評価、特定の職種で早期離職率が高いかどうかの確認に利用できます。異なる従業員グループのニーズに合わせて、人事プロセスや支援プログラムを調整するのに役立ちます。重要な理由職務や職位ごとにライフサイクルプロセスがどのように異なるかを把握する、役割別の分析を可能にします。入手先 UKG ProのCore HRモジュールにある従業員のポジションまたは職務レコードに関連付けられた標準項目です。例ソフトウェアエンジニアⅡシニアプロダクトマネージャーHRビジネスパートナー
	部門 EmployeeDepartment	従業員が所属する部門または組織単位です。
説明この属性には、従業員が所属する部門名が入ります。たとえば、「営業」、「エンジニアリング」、「財務」などです。プロセスパフォーマンスを分類・比較するための重要な組織上の切り口になります。部門別に分析すると、異なる事業部門間でプロセスの実行状況を比較できます。たとえば、「採用サイクルタイム」が技術部門で長くなっているか、「パフォーマンスレビュー遵守率」が営業とオペレーションで大きく異なるかを確認し、対象を絞った改善案につなげられます。重要な理由組織構造に基づいてプロセスをフィルタリング・分類できるため、部門ごとの違いを明らかにする比較分析に役立ちます。入手先 UKG ProのCore HRモジュールにある従業員の職務またはポジションレコードの標準項目です。例エンジニアリング営業人事
	雇用ステータス EmploymentStatus	従業員の現在または過去の雇用ステータスです。「在職中」、「退職」、「休職中」などがあります。
説明この属性は、ある時点における従業員の会社内での正式なステータスを示します。従業員全体の状態を把握し、特定の従業員集団に絞って分析するための重要な切り口です。雇用ステータスの変化を分析すると、たとえば一時的な休職と正式な退職を区別してプロセスを正しくモデル化できます。離職率の計算や、ライフサイクル上の経路ごとの結果を理解するための基礎となります。重要な理由従業員の在籍状況を理解するための重要な情報を提供し、正確な離職分析と従業員構成の分類を可能にします。入手先 UKG ProのCore HRモジュールにある従業員マスターレコードの中核項目です。例在籍中退職完了休職
	イベント終了時刻 EventEndTime	所要時間を測定できるアクティビティが完了した時点を示すタイムスタンプです。
説明瞬時に完了しないアクティビティの場合、イベント終了時刻はそのアクティビティが完了した時点を記録します。開始時点を示すイベント日時（StartTime）とは異なります。開始時刻と終了時刻の両方があると、「バックグラウンドチェック」や「オンボーディングタスク」など、個々のアクティビティの処理時間を正確に計算できます。プロセスのどの部分に時間がかかっているかを、より詳細に分析できます。重要な理由個々のアクティビティの処理時間を正確に計算し、プロセス内で最も時間のかかるステップを特定できます。入手先 UKG Proの完了日項目から取得します。通常は、ソースデータにある開始イベントと対応する完了イベントを組み合わせる必要があります。例 2023-01-15T17:30:00Z2023-06-21T10:00:00Z2024-02-01T11:05:00Z
	トレーニング名 TrainingName	従業員に割り当てられたトレーニングコースの名称またはタイトルです。
説明この属性は、従業員に割り当てられた特定のトレーニングまたは学習モジュールを識別します。必須のコンプライアンストレーニングから、職務に応じたスキル開発まで、さまざまな内容が含まれます。「トレーニング割り当て・完了」ダッシュボードと「トレーニング完了率」KPIの重要な属性です。特定のトレーニングプログラムの進捗と効果を追跡し、コースごとの完了時間を分析できます。重要な理由特定のトレーニングプログラムを追跡・分析し、コンプライアンスと人材育成の効果を測定できます。入手先 UKG Proの学習モジュールまたは接続された学習管理システム（LMS）から取得します。例行動規範2024高度なマネジメントスキルサイバーセキュリティ意識
	パフォーマンス評価 PerformanceRating	パフォーマンスレビューのサイクル中に従業員へ付与された評価です。
説明パフォーマンス評価は、「パフォーマンスレビューの実施」アクティビティの結果です。通常は1～5などの尺度、または「期待を上回る」などの説明的なラベルで表します。従業員のパフォーマンス評価を数値化したものです。この属性は、プロセス上のイベントとパフォーマンス結果を関連付けるのに役立ちます。たとえば、高い評価を得た従業員のほうが早く昇進するか、パフォーマンス評価と従業員の離職に関連性があるかを分析できます。「パフォーマンスレビューサイクル遵守率」ダッシュボードの中心となる属性です。重要な理由プロセス上のイベントとパフォーマンス結果を関連付け、人材マネジメントの有効性と定着への影響を分析できます。入手先 UKG Proのパフォーマンス管理モジュールにあり、特定のレビューサイクルに関連付けられています。例期待を上回る期待どおり改善が必要5
	勤務地 Location	従業員が勤務する地理的な場所またはオフィスです。
説明この属性は、従業員の主な勤務場所を示します。都市、国、特定のオフィスビルなどが該当します。人事プロセスを地理的に分析するための重要な切り口です。勤務地別にプロセスパフォーマンスを分析すると、採用効率、オンボーディングの方法、離職率における地域差を見つけられます。たとえば、「ニューヨーク」オフィスと「ロンドン」オフィスの「採用サイクルタイム」を比較し、優れた方法や地域特有のボトルネックを特定できます。重要な理由プロセスを地域別に分類し、パフォーマンスとコンプライアンスの地域差を明らかにします。入手先 UKG ProのCore HRモジュールにある従業員の職務または個人データの一部です。例米国ニューヨーク州ニューヨーク市英国ロンドンリモート
	役割変更理由 RoleChangeReason	従業員の役割が変更された理由です。「昇進」、「水平異動」、「組織再編」などがあります。
説明この属性は、社内異動に関するイベントの背景を示します。組織内で従業員の役割またはポジションが変更された理由を説明するものです。昇進とその他の異動を区別できるため、「社内異動サイクルタイム」ダッシュボードとKPIに欠かせません。理由別にプロセスを分析すると、昇進プロセスが水平異動より遅いかどうかを確認でき、キャリア開発の経路を効率化するのに役立ちます。重要な理由社内異動の背景を明らかにし、昇進と水平異動など、社内異動プロセスをより詳細に分析できます。入手先通常は、UKG ProのCore HRモジュールで職務変更または異動のトランザクションの一部として記録されます。例昇進横異動組織再編
	早期離職フラグ IsEarlyChurn	従業員の退職が、90日や180日など、あらかじめ定めた在籍初期の期間内に発生したかどうかを示すブール値のフラグです。
説明この計算属性は、入社後まもなく組織を離れた従業員にフラグを付けます。「早期」の基準は通常、業務上の定義に基づき、たとえば入社後1年以内とします。このフラグにより、「入社後早期在籍期間の離職インサイト」ダッシュボードと「入社後早期離職率」KPIに必要な分析を簡単に行えます。フィルタリングや分類によってこの注目度の高いグループをすぐに抽出し、特徴やライフサイクルパターンを分析できるため、採用やオンボーディングの問題を特定するのに役立ちます。重要な理由早期離職の対象となるケースにフラグを付け、早期退職の根本原因を特定する分析を直接支援します。入手先この属性はデータ準備中に計算されます。「TerminationDate」と「HireDate」の差を、あらかじめ定めた基準（例：365日）と比較します。例 truefalse
	給与等級 SalaryGrade	従業員の職務に関連付けられた報酬の等級またはレンジです。
説明給与等級は、特定の職務における報酬水準を表します。報酬に関するアクティビティや傾向を分析するための重要な属性です。「報酬変更」イベントなどの分析に役立ち、給与等級の修正が頻繁に発生している場合は、「オンボーディング後のデータ再作業率」KPIの追跡にも利用できます。また、報酬水準別に分類し、昇進サイクルタイムや離職率に違いがあるかを確認できます。重要な理由報酬に関するアクティビティの背景を示し、給与水準によるプロセスの分類を可能にします。入手先 UKG ProのCore HRモジュールにある従業員の報酬または職務プロフィールで確認できます。例 IC3M2D1
	退職日 TerminationDate	従業員の雇用が正式に終了した日付です。
説明退職日は、従業員の在籍期間の終了を示します。組織における従業員のライフサイクルの終点です。この属性は最終的な在籍期間の計算に必要で、離職分析の主要な要素となります。入社日から退職日までの期間が、「入社後早期在籍期間の離職インサイト」ダッシュボードと関連KPIの基礎になります。重要な理由従業員のライフサイクルの終了点を定義し、在籍期間の合計を計算するとともに、離職に関するすべての分析を支えます。入手先 UKG Proの従業員主要レコードにある標準項目で、退職プロセスが完了すると入力されます。例 2023-11-302024-02-152022-12-31
	退職理由 TerminationReason	従業員の退職理由として記録された内容です。「本人都合：辞職」や「会社都合：パフォーマンス」などがあります。
説明この属性は、従業員の雇用が終了した理由を記録します。通常は本人都合と会社都合に分類され、さらに詳細な下位分類が設けられます。定着率や離職の分析に欠かせない属性です。退職理由で退職者を分類すると、離職の根本原因を詳しく把握できます。たとえば、「入社後早期離職率」を退職理由別に分析することで、採用判断の問題と競合他社からのオファーによる離職を区別できます。重要な理由従業員の離職要因を把握するための重要な情報を提供し、対象を絞った定着施策につなげられます。入手先通常は、UKG ProのCore HRモジュールで退職またはオフボーディングのプロセス中に記録されます。例本人都合：他社への転職会社都合：業績不振定年退職

必須推奨任意

採用から退職まで：従業員ライフサイクルのアクティビティ

正確なプロセスディスカバリーと最適化のために、イベントログに記録する主要なプロセス手順とマイルストーンです。

6 推奨 9 任意

	アクティビティ	説明
	パフォーマンスレビューの実施	従業員の正式なパフォーマンスレビューサイクルが完了したことを示します。通常、マネージャーまたは人事部門がレビュー用フォームを確定して提出した時点で記録されます。
重要な理由従業員ライフサイクルにおける、定期的に発生する重要なマイルストーンです。頻度と適時性を追跡することで、パフォーマンス管理のコンプライアンスとキャリア形成への影響を評価できます。入手先 UKG Proのパフォーマンス管理モジュールで確認できます。パフォーマンスレビュー用フォームの完了日、またはレビューサイクルのステータスが「完了」に変わった時点から特定できます。取得パフォーマンスレビューのワークフローインスタンスの完了時刻から取得します。イベントタイプ explicit
	従業員のオンボーディング完了	初回オンボーディングのチェックリストまたはワークフローが正常に完了したことを示す重要なマイルストーンです。通常は、新入社員に必要な書類、システムアクセス申請、初期の管理タスクがすべて完了した状態を指します。
重要な理由初期の管理設定が終了したことを示し、オンボーディング全体の所要時間を分析できるようにします。従業員が担当業務を開始するための管理上の準備が整った時点です。入手先オンボーディングモジュールで確認できます。オンボーディングワークフロー全体の完了時刻、または最後の必須オンボーディングタスクが完了として記録された時点から推定します。取得従業員のオンボーディングマスターチェックリストの完了時刻から推定します。イベントタイプ inferred
	従業員の採用完了	UKG Proで従業員レコードが正式に作成され、従業員IDが割り当てられたことを示します。通常、人事管理者が候補者の採用手続きを完了し、システム上で在籍中の従業員へ移行した時点で記録されます。
重要な理由採用から退職までのプロセス分析における、明確な開始イベントです。生産性を発揮できるまでの時間、オンボーディングの効率、従業員の在籍期間全体を測定する基準になります。入手先通常は、人事コアまたは人事管理モジュールに記録されます。従業員の主要な雇用レコードの作成日、または職務データ履歴にある特定の「採用」アクションレコードから特定できます。取得従業員の職務履歴テーブルにある「採用」アクションの発効日から取得します。イベントタイプ explicit
	従業員の退職完了	従業員ライフサイクルの最終イベントであり、雇用が正式に終了したことを示します。退職の発効日に、システム上の従業員レコードが非アクティブになります。
重要な理由プロセスの明確な終了イベントです。最終的な在籍期間の計算や離職分析に欠かせません。会社における従業員の一連の経路を完了させます。入手先人事コアモジュールの従業員職務データ履歴にある最終的な「退職」アクションの発効日です。通常、この日にシステム上の従業員ステータスがアクティブから非アクティブに変わります。取得従業員の職務履歴にある「退職」アクションの発効日から取得します。イベントタイプ explicit
	昇進の承認	従業員の昇進が正式に承認されたことを示します。通常は役職名が変更され、給与などの報酬も変更されます。変更の発効日に先立って発生する、独立したイベントです。
重要な理由このアクティビティは、社内異動とキャリア形成を分析するうえで重要です。昇進の承認から発効日までの時間を確認すると、システム内の管理上のボトルネックを明らかにできます。入手先人事コアモジュールの従業員職務データ履歴に、「昇進」などの特定の職務アクションとして記録されます。承認日と発効日はそれぞれ記録されます。取得従業員の職務履歴にある「昇進」アクションの記録日から取得します。イベントタイプ explicit
	退職手続きの開始	将来の退職日がシステムに入力され、退職手続きが開始されたことを示します。このイベントを起点に、退職手続きのチェックリストとワークフローが開始されます。
重要な理由従業員の退職プロセスを開始する重要なマイルストーンです。このイベントから最終的な退職処理までの時間を分析することで、退職手続きの効率と網羅性を評価できます。入手先通常は、将来の発効日を持つ「退職」アクションレコードが従業員の職務データに作成された時点です。特定のモジュールで退職ワークフローが開始された時点を指す場合もあります。取得将来の日付を設定した退職トランザクションが送信された時点で記録します。イベントタイプ explicit
	オンボーディング開始	UKG Pro内で新入社員のオンボーディングプロセスまたはワークフローが開始されたことを示します。通常は自動または手動で起動され、新入社員、マネージャー、人事部門にタスクのチェックリストを割り当てます。
重要な理由このアクティビティを追跡すると、正式な採用日から管理面および組織文化への適応が始まるまでの時間を測定できます。オンボーディングプロセスの効率を分析し、遅延を特定するための起点になります。入手先 UKG Proのオンボーディングモジュールで確認できます。従業員に関連付けられたオンボーディングチェックリストまたはワークフローインスタンスの作成日から推定できます。取得従業員のオンボーディングワークフローまたはタスクリストの作成時刻から推定します。イベントタイプ inferred
	マネージャーの変更	従業員の「直属の上司」または「マネージャーID」フィールドが更新されたときに生成されます。従業員の直属の報告先が変更されたことを示します。
重要な理由マネージャーの変更は、従業員のエンゲージメントとパフォーマンスに大きな影響を与える可能性があります。このイベントを追跡することで、パフォーマンスレビューや定着率など、その後のアクティビティへの影響を分析できます。入手先従業員の職務データを時系列で確認し、マネージャーまたは上司のフィールドの変更を追跡して推定する必要があります。同じ従業員について連続するレコード間でマネージャーIDを比較します。取得従業員の職務データ履歴にある「直属の上司」フィールドの変更を検出して推定します。イベントタイプ inferred
	休職の開始	療養や私的な事情など、承認された従業員の休職が始まったことを示します。従業員のステータスが非アクティブまたは休職中に変わった時点で記録されます。
重要な理由従業員ライフサイクルにおける非稼働期間を特定します。実働在籍期間を正確に計算し、休職がキャリア形成に与える影響を理解するうえで欠かせません。入手先人事コアモジュールの従業員職務データ履歴で確認できます。特定の発効開始日を持つ「休職」などの職務アクションに対応します。取得職務履歴にある「休職開始」アクションの発効日から取得します。イベントタイプ explicit
	報酬の変更	従業員の基本給、賞与体系、その他の報酬項目に変更があったことを記録します。昇進、昇給、市場調整の一部として発生する場合があります。
重要な理由報酬の変更を追跡することは、キャリアと給与の推移を把握するうえで重要です。採用後に頻繁な変更が発生している場合、データ入力エラーや初期給与設定の問題を示している可能性があります。入手先人事コアまたは給与モジュール内の従業員報酬履歴テーブルで確認できます。通常、各変更には発効日と理由コードが記録されます。取得従業員の報酬履歴レコードに新しい項目が追加された際の発効日から記録します。イベントタイプ explicit
	役割変更の処理完了	昇進ではない従業員の職務またはポジションの変更を示します。横方向の異動や部門異動などが該当し、関連する職務データがシステムで更新された時点で記録されます。
重要な理由役割変更を分析すると、社内異動、人材配置、組織再編に関する情報を得られます。従業員が組織内をどのように移動しているかを把握できます。入手先人事コアモジュールの従業員職務データ履歴から取得します。「異動」「再配置」「ポジション変更」などの職務アクションと、それぞれの発効日から特定できます。取得従業員の職務履歴データにある「異動」または同様のアクションコードから特定します。イベントタイプ explicit
	研修の割り当て	特定の研修コースまたは学習プランが従業員に割り当てられた時点を記録します。通常は、システムの学習管理モジュールに記録されます。
重要な理由このアクティビティにより、必須研修へのコンプライアンスと従業員の成長を追跡できます。割り当てから修了までの時間を分析すると、受講状況の問題や研修の効果を明らかにできます。入手先 UKG Proの学習管理モジュールまたはタレントマネジメントモジュールに記録されます。各割り当てには、割り当て日と従業員IDを含む対応レコードが必要です。取得コースまたはカリキュラムが従業員の学習プランに割り当てられた時点で記録します。イベントタイプ explicit
	給与設定完了	銀行口座情報や税務フォームなど、従業員の給与計算に必要な情報がすべて入力され、確認済みであることを示します。従業員に正確かつ期限どおりに給与を支払うための重要なステップです。
重要な理由このマイルストーンは、新入社員が業務を開始できる状態を測定するうえで重要です。給与設定の遅延は、従業員の不満や管理業務の手戻りにつながるため、オンボーディングの主要なパフォーマンス指標になります。入手先 UKG Proの給与モジュールから推定できます。給与準備チェックリストの完了日、または従業員のステータスが「給与計算準備完了」に変わった日から導出できます。取得従業員の給与プロファイルにおけるステータス変更または完了時刻から導出します。イベントタイプ inferred
	退職手続きの完了	退職手続きに必要なすべてのタスクが完了したことを示すマイルストーンです。資産の返却、最終給与計算、システムアクセスの無効化などが含まれます。
重要な理由従業員の退職に必要なすべての手続きが、安全かつコンプライアンスに沿って実施されたことを確認します。退職手続きの所要時間を測定し、コンプライアンス上の不足を特定するのに役立ちます。入手先退職手続き全体のチェックリストまたはワークフローの完了時刻から推定します。従業員のオンボーディング完了イベントと同様に、退職プロセスの完了を示します。取得従業員の退職手続きマスターチェックリストの完了時刻から推定します。イベントタイプ inferred
	退職面談の実施	退職する従業員との退職面談が完了したことを示します。通常は、退職手続きのチェックリスト内で完了したタスクとして記録されます。
重要な理由退職面談の完了を追跡することは、人事コンプライアンスを確保し、価値あるフィードバックを収集するうえで重要です。退職手続きでこの重要なステップが省略されていないかを確認できます。入手先通常は、UKG Proのオンボーディングまたは人事ヘルプデスクモジュールで、退職ワークフロー内の特定のタスクとして確認できます。人事担当者がタスクを完了として手動で記録した場合に取得されます。取得従業員の退職手続きチェックリスト内で、完了したタスクとして記録します。イベントタイプ explicit

推奨任意

抽出ガイド

UKG Proからデータを取得する方法

ステップ

**前提条件：**Python 3.6以降とrequestsおよびpandasライブラリがインストールされていることを確認します。pip install requests pandasでインストールできます。
**APIアクセスと認証：**UKG Pro管理者に依頼してサービスアカウントを作成します。API Key、User Name、Passwordが必要です。サービスアカウントには、人事、給与、オンボーディング、評価、学習など、必要なすべてのAPIエンドポイントへアクセスする権限を付与してください。
**スクリプトを設定：**提供されたPythonスクリプトをテキストエディターまたはIDEで開きます。スクリプト上部の設定セクションで、UKG_BASE_URL、API_KEY、USERNAME、PASSWORD、COMPANY_IDのプレースホルダーを、実際の認証情報と環境情報に置き換えます。
**抽出期間を設定：**設定セクションでSTART_DATEとEND_DATEの変数を定義します。これにより、従業員の変更とイベントを抽出する期間が決まります。スクリプトのテストでは、まず3～6か月など短い期間から始めることを推奨します。
**スクリプトを実行：**コマンドラインでpython your_script_name.pyを実行します。スクリプトが認証を行い、各アクティビティに対応するUKG ProのAPIエンドポイントからデータを取得し、コンソールに進捗を表示します。
**APIのスロットリングに対応：**スクリプトには、APIのレート制限を守るための基本的なtime.sleep()が含まれています。スロットリングエラー（HTTP 429）が発生した場合は、API呼び出し間の待機時間を長くしてください。
**データを変換して標準化：**スクリプト内の各関数は、特定のアクティビティの生のデータを取得し、必要な項目を選択して、標準的なイベントログ形式（EmployeeId、ActivityName、EventTimestampなど）に名称を変更します。
**イベントデータを統合：**スクリプトの主要部分で各アクティビティ用の関数を呼び出し、結果のデータを1つのマスターイベントリストに追加します。
**イベントログを生成：**すべてのアクティビティの処理後、データをpandas DataFrameにまとめ、従業員IDとタイムスタンプで並べ替え、ukg_hire_to_retire_event_log.csvという名前のCSVファイルに保存します。
**確認してアップロード：**生成されたCSVファイルを開き、データが完全で形式どおりであることを確認します。このファイルをプロセスマイニングツールへアップロードできます。

設定

認証情報：API認証には、サービスアカウントのAPI Key、User Name、Passwordが必要です。
ベースURL：UKG ProインスタンスのUKG_BASE_URL（例：https://service[##].ultipro.com/api）です。
Company ID：UKG Pro内で組織を識別する一意のCOMPANY_IDが、多くのAPI呼び出しで必要です。
日付範囲：START_DATEとEND_DATEのパラメーター（形式は「YYYY-MM-DD」）で抽出期間を指定します。初回実行では、データ量を抑え、結果を確認できるよう、3～6か月を推奨します。
APIエンドポイントのバージョン：スクリプトでは、特定バージョンのREST API（例：/personnel/v1/）を使用します。UKG Proインスタンスがこれらのバージョンに対応していることを確認してください。
モジュールの依存関係：一部のアクティビティを抽出するには、組織で該当するUKG Proモジュール（オンボーディング、学習、パフォーマンス管理など）のライセンスを保有し、実際に利用している必要があります。モジュールを利用していない場合、対応するアクティビティは抽出されません。

a サンプルクエリ python

import requests
import pandas as pd
import datetime
import time
import json

class=class="hl-string">"hl-comment"># --- CONFIGURATION --- #
UKG_BASE_URL = class="hl-string">"https://service[YourServiceNumber].ultipro.com/api"
API_KEY = class="hl-string">"[Your_API_Key]"
USERNAME = class="hl-string">"[Your_Service_Account_Username]"
PASSWORD = class="hl-string">"[Your_Service_Account_Password]"
COMPANY_ID = class="hl-string">"[Your_Company_ID]"
START_DATE = (datetime.date.today() - datetime.timedelta(days=180)).strftime(class="hl-string">'%Y-%m-%d')
END_DATE = datetime.date.today().strftime(class="hl-string">'%Y-%m-%d')

class=class="hl-string">"hl-comment"># --- API HELPER FUNCTION --- #

def get_ukg_data(endpoint, params=None):
    class="hl-string">"""Helper function to handle authentication and pagination for UKG API calls."""
    auth_data = json.dumps({
        class="hl-string">"username": USERNAME,
        class="hl-string">"password": PASSWORD,
        class="hl-string">"apiKey": API_KEY
    })
    headers = {class="hl-string">'Content-Type': class="hl-string">'application/json'}
    
    class=class="hl-string">"hl-comment"># Authenticate and get token
    try:
        auth_response = requests.post(fclass="hl-string">"{UKG_BASE_URL}/v1/login", data=auth_data, headers=headers)
        auth_response.raise_for_status()
        token = auth_response.json().get(class="hl-string">'token')
    except requests.exceptions.RequestException as e:
        print(fclass="hl-string">"Authentication failed: {e}")
        return []

    all_records = []
    page = 1
    per_page = 100
    
    api_headers = {class="hl-string">'Authorization': fclass="hl-string">'Bearer {token}'}
    
    while True:
        if params is None:
            params = {}
        params.update({class="hl-string">'page': page, class="hl-string">'per_page': per_page})
        
        try:
            response = requests.get(fclass="hl-string">"{UKG_BASE_URL}{endpoint}", headers=api_headers, params=params)
            response.raise_for_status()
            data = response.json()
            
            if isinstance(data, list) and data:
                all_records.extend(data)
                if len(data) < per_page:
                    break class=class="hl-string">"hl-comment"># Last page
                page += 1
            elif isinstance(data, dict) and class="hl-string">'results' in data:
                all_records.extend(data[class="hl-string">'results'])
                if len(data[class="hl-string">'results']) < per_page:
                    break class=class="hl-string">"hl-comment"># Last page
                page += 1
            else:
                 break class=class="hl-string">"hl-comment"># No more data

            time.sleep(1) class=class="hl-string">"hl-comment"># Respect rate limits

        except requests.exceptions.RequestException as e:
            print(fclass="hl-string">"Error fetching data from {endpoint}: {e}")
            break
            
    return all_records

class=class="hl-string">"hl-comment"># --- ACTIVITY EXTRACTION FUNCTIONS --- #

def get_employee_hired_events():
    print(class="hl-string">"Fetching 'Employee Hired' events...")
    events = []
    class=class="hl-string">"hl-comment"># Use employee changes API to find hire events
    params = {class="hl-string">'action': class="hl-string">'HIRE', class="hl-string">'effectiveDate': fclass="hl-string">'ge {START_DATE}'}
    data = get_ukg_data(class="hl-string">'/personnel/v1/employee-changes', params=params)
    for record in data:
        if record.get(class="hl-string">'effectiveDate') and record.get(class="hl-string">'effectiveDate') <= END_DATE:
            events.append({
                class="hl-string">'EmployeeId': record.get(class="hl-string">'employeeId'),
                class="hl-string">'ActivityName': class="hl-string">'Employee Hired',
                class="hl-string">'EventTimestamp': record.get(class="hl-string">'effectiveDate'),
                class="hl-string">'ActioningUser': record.get(class="hl-string">'changedByUserName'),
                class="hl-string">'EmployeeDepartment': record.get(class="hl-string">'department'),
                class="hl-string">'JobRequisitionId': record.get(class="hl-string">'jobRequisitionId'),
                class="hl-string">'EmploymentStatus': record.get(class="hl-string">'employmentStatus'),
                class="hl-string">'JobTitle': record.get(class="hl-string">'jobTitle'),
                class="hl-string">'ManagerName': record.get(class="hl-string">'supervisorName'),
                class="hl-string">'HireDate': record.get(class="hl-string">'hireDate')
            })
    return events

def get_onboarding_events():
    print(class="hl-string">"Fetching 'Onboarding' events...")
    events = []
    class=class="hl-string">"hl-comment"># Note: Requires Onboarding module. This is a conceptual endpoint.
    class=class="hl-string">"hl-comment"># You may need to adjust the endpoint based on your UKG configuration.
    data = get_ukg_data(fclass="hl-string">'/onboarding/v1/employee-onboarding-activities?start-date={START_DATE}&end-date={END_DATE}')
    for record in data:
        if record.get(class="hl-string">'workflow') == class="hl-string">'New Hire Onboarding':
            if record.get(class="hl-string">'dateAssigned'):
                events.append({
                    class="hl-string">'EmployeeId': record.get(class="hl-string">'employeeId'),
                    class="hl-string">'ActivityName': class="hl-string">'Onboarding Initiated',
                    class="hl-string">'EventTimestamp': record.get(class="hl-string">'dateAssigned'),
                    class="hl-string">'ActioningUser': record.get(class="hl-string">'assignedBy'),
                    class="hl-string">'EmployeeDepartment': record.get(class="hl-string">'department'),
                    class="hl-string">'JobTitle': record.get(class="hl-string">'jobTitle'),
                    class="hl-string">'ManagerName': record.get(class="hl-string">'managerName'),
                    class="hl-string">'HireDate': record.get(class="hl-string">'hireDate')
                })
            if record.get(class="hl-string">'dateCompleted'):
                events.append({
                    class="hl-string">'EmployeeId': record.get(class="hl-string">'employeeId'),
                    class="hl-string">'ActivityName': class="hl-string">'Employee Onboarded',
                    class="hl-string">'EventTimestamp': record.get(class="hl-string">'dateCompleted'),
                    class="hl-string">'ActioningUser': None,
                    class="hl-string">'EmployeeDepartment': record.get(class="hl-string">'department'),
                    class="hl-string">'JobTitle': record.get(class="hl-string">'jobTitle'),
                    class="hl-string">'ManagerName': record.get(class="hl-string">'managerName'),
                    class="hl-string">'HireDate': record.get(class="hl-string">'hireDate')
                })
    return events

def get_payroll_setup_events():
    print(class="hl-string">"Fetching 'Payroll Setup Completed' events...")
    events = []
    class=class="hl-string">"hl-comment"># Inferring this from direct deposit creation date
    params = {class="hl-string">'dateTimeCreated': fclass="hl-string">'ge {START_DATE}'}
    data = get_ukg_data(class="hl-string">'/personnel/v1/employees/direct-deposit', params=params)
    processed_employees = set()
    for record in data:
        if record.get(class="hl-string">'employeeId') not in processed_employees and record.get(class="hl-string">'dateTimeCreated') <= END_DATE:
            events.append({
                class="hl-string">'EmployeeId': record.get(class="hl-string">'employeeId'),
                class="hl-string">'ActivityName': class="hl-string">'Payroll Setup Completed',
                class="hl-string">'EventTimestamp': record.get(class="hl-string">'dateTimeCreated'),
                class="hl-string">'ActioningUser': record.get(class="hl-string">'userWhoModified'),
                class="hl-string">'EmploymentStatus': record.get(class="hl-string">'employeeStatus')
            })
            processed_employees.add(record.get(class="hl-string">'employeeId'))
    return events

def get_training_assigned_events():
    print(class="hl-string">"Fetching 'Training Assigned' events...")
    events = []
    class=class="hl-string">"hl-comment"># Note: Requires Learning module.
    params = {class="hl-string">'assignmentDate': fclass="hl-string">'ge {START_DATE}'}
    data = get_ukg_data(class="hl-string">'/learning/v1/enrollments', params=params)
    for record in data:
        if record.get(class="hl-string">'assignmentDate') <= END_DATE:
            events.append({
                class="hl-string">'EmployeeId': record.get(class="hl-string">'employee').get(class="hl-string">'id'),
                class="hl-string">'ActivityName': class="hl-string">'Training Assigned',
                class="hl-string">'EventTimestamp': record.get(class="hl-string">'assignmentDate'),
                class="hl-string">'ActioningUser': record.get(class="hl-string">'assignedBy').get(class="hl-string">'name'),
                class="hl-string">'JobTitle': record.get(class="hl-string">'employee').get(class="hl-string">'jobTitle')
            })
    return events

def get_performance_review_events():
    print(class="hl-string">"Fetching 'Performance Review' events...")
    events = []
    class=class="hl-string">"hl-comment"># Note: Requires Performance Management module.
    params = {class="hl-string">'completionDate': fclass="hl-string">'ge {START_DATE}'}
    data = get_ukg_data(class="hl-string">'/performance/v1/reviews', params=params)
    for record in data:
        if record.get(class="hl-string">'completionDate') <= END_DATE:
            events.append({
                class="hl-string">'EmployeeId': record.get(class="hl-string">'employee').get(class="hl-string">'id'),
                class="hl-string">'ActivityName': class="hl-string">'Performance Review Conducted',
                class="hl-string">'EventTimestamp': record.get(class="hl-string">'completionDate'),
                class="hl-string">'ActioningUser': record.get(class="hl-string">'manager').get(class="hl-string">'name'),
                class="hl-string">'ManagerName': record.get(class="hl-string">'manager').get(class="hl-string">'name')
            })
    return events

def get_job_change_events():
    print(class="hl-string">"Fetching job and compensation change events...")
    events = []
    params = {class="hl-string">'effectiveDate': fclass="hl-string">'ge {START_DATE}'}
    data = get_ukg_data(class="hl-string">'/personnel/v1/employee-changes', params=params)
    for record in data:
        if record.get(class="hl-string">'effectiveDate') > END_DATE: continue

        action = record.get(class="hl-string">'action', class="hl-string">'').upper()
        reason = record.get(class="hl-string">'reason', class="hl-string">'').upper()
        
        if action == class="hl-string">'PROMOTION' or reason == class="hl-string">'PROMOTION':
            events.append({
                class="hl-string">'EmployeeId': record.get(class="hl-string">'employeeId'),
                class="hl-string">'ActivityName': class="hl-string">'Promotion Approved',
                class="hl-string">'EventTimestamp': record.get(class="hl-string">'effectiveDate'),
                class="hl-string">'ActioningUser': record.get(class="hl-string">'changedByUserName'),
                class="hl-string">'JobTitle': record.get(class="hl-string">'jobTitle'),
                class="hl-string">'ManagerName': record.get(class="hl-string">'supervisorName')
            })

        if action == class="hl-string">'TRANSFER' or reason == class="hl-string">'TRANSFER' or reason == class="hl-string">'REASSIGNMENT':
            events.append({
                class="hl-string">'EmployeeId': record.get(class="hl-string">'employeeId'),
                class="hl-string">'ActivityName': class="hl-string">'Role Change Processed',
                class="hl-string">'EventTimestamp': record.get(class="hl-string">'effectiveDate'),
                class="hl-string">'ActioningUser': record.get(class="hl-string">'changedByUserName'),
                class="hl-string">'EmployeeDepartment': record.get(class="hl-string">'department'),
                class="hl-string">'JobTitle': record.get(class="hl-string">'jobTitle')
            })

        if record.get(class="hl-string">'isPayRateChanged') == class="hl-string">'true':
            events.append({
                class="hl-string">'EmployeeId': record.get(class="hl-string">'employeeId'),
                class="hl-string">'ActivityName': class="hl-string">'Compensation Changed',
                class="hl-string">'EventTimestamp': record.get(class="hl-string">'effectiveDate'),
                class="hl-string">'ActioningUser': record.get(class="hl-string">'changedByUserName'),
                class="hl-string">'EmploymentStatus': record.get(class="hl-string">'employmentStatus')
            })

        if record.get(class="hl-string">'isSupervisorChanged') == class="hl-string">'true':
            events.append({
                class="hl-string">'EmployeeId': record.get(class="hl-string">'employeeId'),
                class="hl-string">'ActivityName': class="hl-string">'Manager Changed',
                class="hl-string">'EventTimestamp': record.get(class="hl-string">'effectiveDate'),
                class="hl-string">'ActioningUser': record.get(class="hl-string">'changedByUserName'),
                class="hl-string">'ManagerName': record.get(class="hl-string">'supervisorName')
            })
    return events

def get_leave_events():
    print(class="hl-string">"Fetching 'Leave of Absence' events...")
    events = []
    params = {class="hl-string">'action': class="hl-string">'LEAVE', class="hl-string">'effectiveDate': fclass="hl-string">'ge {START_DATE}'}
    data = get_ukg_data(class="hl-string">'/personnel/v1/employee-changes', params=params)
    for record in data:
        if record.get(class="hl-string">'effectiveDate') and record.get(class="hl-string">'effectiveDate') <= END_DATE:
            events.append({
                class="hl-string">'EmployeeId': record.get(class="hl-string">'employeeId'),
                class="hl-string">'ActivityName': class="hl-string">'Leave of Absence Started',
                class="hl-string">'EventTimestamp': record.get(class="hl-string">'effectiveDate'),
                class="hl-string">'ActioningUser': record.get(class="hl-string">'changedByUserName'),
                class="hl-string">'EmploymentStatus': record.get(class="hl-string">'employmentStatus'),
                class="hl-string">'HireDate': record.get(class="hl-string">'hireDate')
            })
    return events

def get_termination_events():
    print(class="hl-string">"Fetching 'Termination' events...")
    events = []
    params = {class="hl-string">'action': class="hl-string">'TERM', class="hl-string">'effectiveDate': fclass="hl-string">'ge {START_DATE}'}
    data = get_ukg_data(class="hl-string">'/personnel/v1/employee-changes', params=params)
    for record in data:
        if record.get(class="hl-string">'effectiveDate') and record.get(class="hl-string">'effectiveDate') <= END_DATE:
            class=class="hl-string">"hl-comment"># Termination Initiated is when the record is created, Terminated is the effective date
            events.append({
                class="hl-string">'EmployeeId': record.get(class="hl-string">'employeeId'),
                class="hl-string">'ActivityName': class="hl-string">'Termination Initiated',
                class="hl-string">'EventTimestamp': record.get(class="hl-string">'dateCreated'),
                class="hl-string">'ActioningUser': record.get(class="hl-string">'changedByUserName'),
                class="hl-string">'EmploymentStatus': record.get(class="hl-string">'employmentStatus'),
                class="hl-string">'HireDate': record.get(class="hl-string">'hireDate')
            })
            events.append({
                class="hl-string">'EmployeeId': record.get(class="hl-string">'employeeId'),
                class="hl-string">'ActivityName': class="hl-string">'Employee Terminated',
                class="hl-string">'EventTimestamp': record.get(class="hl-string">'effectiveDate'),
                class="hl-string">'ActioningUser': record.get(class="hl-string">'changedByUserName'),
                class="hl-string">'EmploymentStatus': class="hl-string">'Terminated',
                class="hl-string">'HireDate': record.get(class="hl-string">'hireDate')
            })
    return events

def get_offboarding_events():
    print(class="hl-string">"Fetching 'Offboarding' events...")
    events = []
    class=class="hl-string">"hl-comment"># Note: Requires Onboarding module for offboarding checklists.
    class=class="hl-string">"hl-comment"># Conceptual endpoint, may need adjustment.
    data = get_ukg_data(fclass="hl-string">'/onboarding/v1/employee-onboarding-activities?start-date={START_DATE}&end-date={END_DATE}')
    for record in data:
        if record.get(class="hl-string">'workflow') == class="hl-string">'Employee Offboarding':
            if record.get(class="hl-string">'stepName') == class="hl-string">'Exit Interview' and record.get(class="hl-string">'dateCompleted'):
                events.append({
                    class="hl-string">'EmployeeId': record.get(class="hl-string">'employeeId'),
                    class="hl-string">'ActivityName': class="hl-string">'Exit Interview Conducted',
                    class="hl-string">'EventTimestamp': record.get(class="hl-string">'dateCompleted'),
                    class="hl-string">'ActioningUser': record.get(class="hl-string">'completedBy')
                })
            if record.get(class="hl-string">'dateCompleted') and record.get(class="hl-string">'isWorkflowComplete'):
                events.append({
                    class="hl-string">'EmployeeId': record.get(class="hl-string">'employeeId'),
                    class="hl-string">'ActivityName': class="hl-string">'Offboarding Completed',
                    class="hl-string">'EventTimestamp': record.get(class="hl-string">'dateCompleted'),
                    class="hl-string">'ActioningUser': None
                })
    return events

class=class="hl-string">"hl-comment"># --- MAIN EXECUTION --- #
if __name__ == class="hl-string">"__main__":
    all_events = []
    last_data_update = datetime.datetime.utcnow().isoformat() + class="hl-string">'Z'

    class=class="hl-string">"hl-comment"># Collect events from all functions
    all_events.extend(get_employee_hired_events())
    all_events.extend(get_onboarding_events())
    all_events.extend(get_payroll_setup_events())
    all_events.extend(get_training_assigned_events())
    all_events.extend(get_performance_review_events())
    all_events.extend(get_job_change_events())
    all_events.extend(get_leave_events())
    all_events.extend(get_termination_events())
    all_events.extend(get_offboarding_events())

    if not all_events:
        print(class="hl-string">"No events found for the specified period. Exiting.")
    else:
        class=class="hl-string">"hl-comment"># Create DataFrame
        df = pd.DataFrame(all_events)
        
        class=class="hl-string">"hl-comment"># Add required static columns
        df[class="hl-string">'SourceSystem'] = class="hl-string">'UKG Pro'
        df[class="hl-string">'LastDataUpdate'] = last_data_update
        
        class=class="hl-string">"hl-comment"># Standardize and clean up
        df = df.rename(columns={class="hl-string">'employeeId': class="hl-string">'EmployeeId', class="hl-string">'activityName': class="hl-string">'ActivityName', class="hl-string">'eventTimestamp': class="hl-string">'EventTimestamp'})
        df[class="hl-string">'EventTimestamp'] = pd.to_datetime(df[class="hl-string">'EventTimestamp']).dt.strftime(class="hl-string">'%Y-%m-%dT%H:%M:%S.%f')[:-3] + class="hl-string">'Z'
        df = df.sort_values(by=[class="hl-string">'EmployeeId', class="hl-string">'EventTimestamp'])
        
        class=class="hl-string">"hl-comment"># Reorder columns for clarity
        column_order = [
            class="hl-string">'EmployeeId', class="hl-string">'ActivityName', class="hl-string">'EventTimestamp', class="hl-string">'SourceSystem', class="hl-string">'LastDataUpdate',
            class="hl-string">'ActioningUser', class="hl-string">'EmployeeDepartment', class="hl-string">'JobRequisitionId', class="hl-string">'EmploymentStatus',
            class="hl-string">'JobTitle', class="hl-string">'ManagerName', class="hl-string">'HireDate'
        ]
        df = df.reindex(columns=column_axist)

        class=class="hl-string">"hl-comment"># Save to CSV
        output_filename = class="hl-string">'ukg_hire_to_retire_event_log.csv'
        df.to_csv(output_filename, index=False)
        print(fclass="hl-string">"\nExtraction complete. Event log saved to {output_filename}")

準備はできましたか？

このテンプレートを使ってデータを確実に準備し、人事プロセスの重要な改善点を見つけてください。今日から採用から退職までの流れを最適化しましょう。

改善ガイドに戻るテンプレートをダウンロード

今日から採用から退職までの従業員ライフサイクルを最適化

採用から退職までの所要時間を30％短縮し、人事業務の効率を高めます。

無料トライアルを開始

クレジットカードは不要です。すぐに設定できます。

採用から退職まで：従業員ライフサイクルのデータテンプレート

採用から退職まで：従業員ライフサイクルのデータテンプレート

採用から退職まで：従業員ライフサイクルの属性

採用から退職まで：従業員ライフサイクルのアクティビティ

抽出ガイド

UKG Pro REST APIを利用したPythonスクリプトによる抽出

ステップ

設定

a サンプルクエリ python

準備はできましたか？

今日から採用から退職までの従業員ライフサイクルを最適化

プライバシーを大切にしています