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

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

UKG Pro

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

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

このテンプレートは、「採用から退職まで」のプロセスを効果的に分析するために必要な重要なデータ要素の包括的な概要を示します。収集すべき重要な属性、追跡すべき主要なアクティビティ、そしてUKG Proからこのデータを抽出するための実践的なガイダンスを説明しています。このリソースを活用してデータ準備を合理化し、プロセスマイニングの取り組みをスムーズに開始できるよう支援します。

収集を推奨する項目
追跡すべき主要アクティビティ
UKG Pro用抽出ガイド

イベントログについて初めての方へ：プロセスマイニングのイベントログ作成方法.

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

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

これらは、包括的な採用から退職までの従業員ライフサイクルの分析と洞察を得るために、イベントログに含めることを推奨するデータフィールドです。

5 必須 7 推奨 10 任意

	名前	説明
	イベントのタイムスタンプ EventTimestamp	特定のライフサイクルイベントが発生した正確な日時です。
説明イベントのタイムスタンプは、各アクティビティの時系列コンテキストを提供し、プロセスフローの根幹を成します。これは、「オファー承認」や「昇進承認」といったイベントがシステムに登録された正確な時刻を記録します。分析では、これらのタイムスタンプを用いてアクティビティ間の期間を算出し、遅延を特定し、採用やオンボーディングなどの主要なサブプロセスにおけるサイクルタイムを測定します。正確なタイムスタンプは、すべての時間ベースのKPIとパフォーマンス分析にとって不可欠です。その重要性この属性は、イベントを時系列で並べ替え、サイクルタイムや期間など、すべての時間ベースのメトリクスを計算するために不可欠です。取得元 UKG Proの特定イベントに関連付けられた日付またはタイムスタンプフィールド（例：'HireDate'、'TerminationDate'、ワークフローモジュール内のステータス変更タイムスタンプなど）から取得されます。例 2023-01-15T09:00:00Z2023-06-20T14:35:10Z2024-02-01T11:00:00Z
	従業員ID EmployeeId	各従業員に割り当てられる固有の識別子で、組織内での従業員のライフサイクル全体の主要なケースIDとして機能`します。
説明従業員IDは、従業員の最初の応募から最終的な退職まで、その従業員に関連するすべてのイベントを結びつける中心的な識別子として機能します。このIDは、個人のジャーニーにおけるエンドツーエンドのプロセス全体像を構築するために不可欠です。プロセスマイニング分析では、「従業員採用」、「昇進承認」、「退職開始」など、すべてのアクティビティがこの固有のIDにリンクされます。これにより、個々の従業員の経路分析、従業員の属性に基づいたコホート分析、そしてライフサイクル期間の正確な算出`が可能になります。その重要性これは、従業員関連のすべてのイベントを連携させる不可欠なケース識別子であり、各個人の「採用から退職まで」のエンドツーエンドプロセスを分析することを可能にします。取得元これはUKG Proの主要なフィールドであり、通常、従業員プロファイルまたはマスターデータレコードで確認できます。特定のテーブル名やフィールド名についてはUKG Proのドキュメントを参照してください。多くの場合、「従業員番号」または「個人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のコアHRモジュール内の従業員の報告構造データの一部です。例 John SmithMaria Garciaチェン・ウェイ
	実行ユーザー ActioningUser	UKG Proでアクティビティを実行したユーザーの名前またはIDで、通常はHR担当者またはマネージャーです。
説明この属性は、オファーを提示した採用担当者や昇進を承認したマネージャーなど、特定のプロセスステップの実行を担当する個人を特定します。これは、プロセス活動と人間アクターを結びつけます。分析において、この属性はワークロードの配分を理解し、トレーニングのニーズを特定し、ユーザー固有のパフォーマンスを分析する上で非常に価値があります。例えば、「給与設定完了」後のデータ入力のエラーが特定のユーザーに集中しているかを特定するのに役立ち、「オンボーディング後データ手直し率」のKPIをサポートします。その重要性プロセス活動を特定のユーザーに紐づけることで、ワークロード分析、パフォーマンス比較、手戻りやエラーの調査が可能になります。取得元通常、UKG Proモジュール内の監査トレイルログまたは「最終更新者」フィールドで確認できます。正確なフィールド名はモジュールによって異なります。例 j.does.smithhr_admin
	役職 JobTitle	従業員の正式な役職です。「ソフトウェアエンジニア」や「セールスマネージャー」などが含まれます。
説明役職は、組織内における従業員の役割や職位を示します。この属性は、さまざまな役割や役職の階層間でプロセスがどのように異なるかを分析する上で重要な側面です。分析では、役職を使用して、異なる役割のオンボーディング期間を比較したり、昇進の速度を評価したり、特定の役職で早期の離職率が高いかどうかを特定したりできます。これにより、HRプロセスとサポートプログラムを、異なる従業員グループの特定のニーズに合わせて調整するのに役立ちます。その重要性ロールベース分析により、ライフサイクルプロセスが職務や役職レベル間でどのように異なるかを理解できます。取得元これは、UKG ProのコアHRモジュール内の従業員の役職または職務レコードに関連付けられた標準フィールドです。例ソフトウェアエンジニアIIシニアプロダクトマネージャーHRビジネスパートナー
	採用日 HireDate	組織における従業員の雇用の正式な開始日です。
説明入社日は、従業員の在職期間の始まりを示すものです。これは、従業員のライフサイクルに関連する多くの時間ベースの計算や分析の基準となる基本的な日付フィールドです。この属性は、従業員の在職期間を算出するために使用され、「早期従業員離職率」分析において不可欠です。また、コホート分析にも役立ち、異なる期間に採用された従業員のライフサイクルパターンの比較`を可能にします。その重要性従業員の勤続年数を計算するためのベースラインとして機能し、コホート分析や離職率KPIに不可欠です。取得元これは、UKG ProのコアHRモジュール内の従業員の主要レコードにおける、標準かつ必須のフィールドです。例 2022-08-152023-01-202021-05-10
	求人依頼ID JobRequisitionId	採用プロセスを開始した求人票の固有のIDです。
説明求人申請IDは、特定の求人に対する固有の識別子です。これは、求人の作成から承認、候補者のソーシング、オファーの提示まで、すべての初期段階の採用活動を結びつけます。このIDは、採用プロセスの真の開始を示すため、「採用サイクルタイム」KPIの分析に不可欠です。単一の求人に対するファネル全体を追跡し、進行しない申請を特定することで、「非アクティブな求人申請率」などのメトリクスを分析`することが可能になります。その重要性採用プロセスの明確な開始点を提供し、採用サイクルタイムや募集の有効性を正確に測定できます。取得元 UKG Proの採用モジュールまたは接続されている応募者追跡システム (ATS)内で確認されます。例 REQ-2023-015REQ-2024-112REQ-2023-504
	部署 EmployeeDepartment	従業員が配属されている部門または組織単位です。
説明この属性には、「営業」、「エンジニアリング」、「財務」など、従業員が配属されている部署の名称が含まれます。これは、プロセスパフォーマンスをセグメント化し、比較するための主要な組織の分類軸です。部署を用いた分析により、異なる事業部門間のプロセス実行を比較できます。例えば、技術部門で採用サイクルタイムが長くなる傾向があるか、あるいは営業と運用の間でパフォーマンスレビューの遵守状況が大きく異なるかを分析し、改善のための的を絞った洞察を得ることが可能です。その重要性組織構造に基づいてプロセスをフィルタリングおよびセグメント化することで、強力な比較分析を可能にし、部署ごとの差異を明らかにします。取得元これは、UKG ProのコアHRモジュール内の従業員の職務または役職レコードにおける標準フィールドです。例エンジニアリング営業人事
	雇用ステータス EmploymentStatus	従業員の現在または過去の雇用ステータスです。「現職」、「退職済み」、「休職中」などが含まれます。
説明この属性は、特定の時点における従業員の会社内での公式ステータスを示します。これは、労働力全体の状況を理解し、分析を特定の従業員集団に絞り込むための重要な切り口です。雇用ステータスの変更を分析することは、例えば一時的な休職と永続的な退職を区別するなど、プロセスを正確にモデル化するのに役立ちます。これは、チャーン率を計算し、異なるライフサイクルパスの結果を理解するために不可欠です。その重要性従業員の状況に関する不可欠なコンテキストを提供し、正確な離職分析や人員のセグメント化を可能にします。取得元これは、UKG ProのコアHRモジュール内の従業員マスターレコードにおける主要なフィールドです。例アクティブ終了済み休職
	イベントの終了時刻 EventEndTime	測定可能な期間を持つアクティビティの完了を示すタイムスタンプ`です。
説明瞬時に完了しないアクティビティでは、イベント終了時刻がそのアクティビティの完了時点を記録します。これは、アクティビティの開始を示すイベントタイムスタンプ（開始時刻）とは対照的です。開始時刻と終了時刻の両方を把握することで、「バックグラウンドチェック」や「オンボーディングタスク」といった個々のアクティビティにかかる処理時間を正確に計算できます。これにより、プロセス内で時間がどのように使われているかをより詳細に分析できるようになります。その重要性個々のアクティビティの正確な処理時間の計算を可能にし、プロセス内で最も時間のかかるステップを特定するのに役立ちます。取得元 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
	処理時間 ProcessingTime	単一のアクティビティの開始から終了までの期間です。
説明 Processing Timeは、特定のタスクに費やされた時間を計測します。これはEvent End TimeとEvent Timestamp (StartTime)の差として計算され、アクティビティの「サービス時間」を表します。この指標は、プロセス内でどの特定のアクティビティが最も時間を消費しているかを特定する上で重要です。例えば、'Background Check Initiated'アクティビティが平均で完了までに5日かかっていることを浮き彫りにし、最適化の明確なターゲットとして示すことができます。その重要性個々のタスクの期間を定量化し、プロセス内で最も時間のかかるアクティビティを対象とした最適化を支援します。取得元この属性は、データ準備の際に、イベント終了時間からイベントタイムスタンプを差し引いて計算されます。例 28800086400604800
	場所 Location	従業員が勤務する地理的な場所またはオフィスです。
説明この属性は、従業員の主要な勤務地（都市、国、特定のオフィスビルなど）を指定します。これはHRプロセスの地理的分析における重要な切り口です。場所別にプロセスパフォーマンスを分析することで、採用効率、オンボーディングの慣行、または離職率における地域差を明らかにできます。例えば、「ニューヨーク」と「ロンドン」のオフィス間で「採用サイクルタイム」を比較し、ベストプラクティスや地域固有のボトルネックを特定することができます。その重要性プロセスの地理的セグメンテーションを可能にし、パフォーマンスとコンプライアンスにおける地域差を明らかにします。取得元この情報は、UKG ProのコアHRモジュール内の従業員の職務データまたは個人データの一部です。例ニューヨーク、NYロンドン、英国リモート
	役割変更理由 RoleChangeReason	従業員の役割の変更の理由です。「昇進」、「横断的な異動」、「組織再編`」などが含まれます。
説明この属性は、社内異動イベントにコンテキストを提供します。従業員の役割や役職が組織内で変更された理由を説明するものです。これは「社内異動サイクルタイム」のダッシュボードとKPIにとって不可欠です。これにより、昇進とその他の異動を区別することができます。理由別にプロセスを分析することで、昇進プロセスが横方向の異動よりも遅いかどうかを明らかにし、キャリア開発パスの効率化に役立ちます。その重要性社内異動の背景にあるコンテキストを説明し、昇進と水平異動のような社内異動プロセスのより詳細な分析を可能にします。取得元この情報は通常、UKG ProのコアHRモジュール内で、職務変更または異動トランザクションの一部として捕捉されます。例昇進水平転勤組織再編
	早期離職 IsEarlyChurn	従業員の退職が、90日や180日といった所定の早期在職期間内に発生したかどうかを示すブールフラグ。
説明この計算属性は、入社後まもなく組織を離れる従業員にフラグを立てます。「早期」のしきい値は、通常、ビジネスによって定義されます（例：入社後1年以内）。このフラグは、「早期定着率チャーン洞察」のダッシュボードや「早期従業員チャーン率」のKPIに必要な分析を簡素化します。これにより、この注目グループを迅速にフィルタリングおよびセグメント化して抽出し、彼らの特性やライフサイクルパターンを分析することができ、採用やオンボーディングにおける問題の特定に役立ちます。その重要性リスクのあるケースにフラグを立てることで早期離職分析を直接支援し、早期従業員離職の根本原因特定に役立ちます。取得元この属性は、データ準備の際に計算されます。「TerminationDate」と「HireDate」の差を、事前に定義されたしきい値（例：365日）と比較して算出されます。例 truefalse
	給与等級 SalaryGrade	従業員の役割に関連付けられた報酬グレードまたはバンドです。
説明 Salary Gradeは、特定の職務に対する報酬レベルを表します。これは、報酬関連のアクティビティや傾向を分析するための重要な属性です。この属性は、「Compensation Changed」イベントなどの分析において重要であり、給与等級に頻繁な修正が見られる場合には、「Post-Onboarding Data Rework Rate」 KPI を追跡するために使用できます。また、給与レベルによって昇進サイクルタイムや離職率が異なるかどうかを確認するためのセグメンテーションも可能です。その重要性報酬関連のアクティビティに文脈を提供し、報酬レベルに応じたプロセス分析を可能にします。取得元 UKG ProのCore HRモジュール内の従業員の報酬または職務プロフィールから利用できます。例 IC3M2D1
	退職日 TerminationDate	従業員の雇用の正式な終了日です。
説明退職日は、従業員の在職期間の終了を示すものです。これは組織内における従業員のライフサイクルの終点にあたります。この属性は、従業員の最終的な在職期間を算出する上で必要であり、離職分析の主要な構成要素です。入社日と退職日の間の期間は、「早期在職期間離職インサイト」ダッシュボードおよび関連KPIの基礎`となります。その重要性従業員ライフサイクルの終点を示し、在籍期間の計算や離職関連のあらゆる分析を可能にします。取得元これは、UKG Proの従業員の主要レコードにおける標準フィールドであり、退職プロセスが完了した際にデータが入力されます。例 2023-11-302024-02-152022-12-31
	退職理由 TerminationReason	従業員の退職理由を文書化したものです。「自己都合退職」や「会社都合退職（業績不振）」などが含まれます。
説明この属性は、従業員の雇用が終了した理由を記録します。理由は通常、自己都合または会社都合に分類され、さらに詳細なサブカテゴリがあります。これは定着率とチャーン分析にとって重要な属性です。退職理由別に退職従業員をセグメント化することで、組織は離職の根本原因について深い洞察を得ることができます。例えば、早期離職率を退職理由別に分析することで、採用の失敗と競合他社からのオファーを区別することができます。その重要性従業員離職の要因に関する重要な洞察を提供し、ターゲットを絞った定着戦略の立案を支援します。取得元このフィールドは通常、UKG ProのコアHRモジュール内で、退職またはオフボーディングのプロセス中に記録されます。例自己都合退職 - 新たな機会非自発的退職 - パフォーマンス定年退職

必須推奨任意

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

これらは、正確なプロセスディスカバリと最適化のために、イベントログに記録すべき主要なプロセスステップとマイルストーンです。

6 推奨 9 任意

	アクティビティ	説明
	パフォーマンスレビュー実施済み	従業員に対する正式な人事評価サイクルの完了を表します。このイベントは、評価フォームが最終化され、上司または人事によって提出された際に記録されます。
その重要性これは、従業員ライフサイクルにおける重要な定期的な節目です。その頻度と適時性を追跡することは、パフォーマンス管理のコンプライアンスとキャリア進捗に与える影響を評価するのに役立ちます。取得元 UKG Proのパフォーマンス管理モジュール内で確認されます。パフォーマンスレビューフォームの完了日、または評価サイクルのステータスが「完了」に変更されたことから特定できます。取得人事評価ワークフローインスタンスの完了タイムスタンプから取得されます。イベントタイプ explicit
	従業員オンボーディング完了	初期オンボーディングチェックリストまたはワークフローが正常に完了したことを示す重要なマイルストーンです。通常、新規採用者の必要書類、システムアクセスリクエスト、および初期管理業務がすべて完了したことを示します。
その重要性初期の管理セットアップの完了を示し、全体のオンボーディングサイクルタイムの分析を可能にします。これは、従業員がその役割固有の職務を開始する準備が管理上整った時点を示します。取得元オンボーディングモジュール内にあります。これは通常、全体のオンボーディングワークフローの完了タイムスタンプ、あるいは最後の必須オンボーディングタスクが完了とマークされた時点から推測されます。取得従業員向けのマスターオンボーディングチェックリストの完了タイムスタンプから推測されます。イベントタイプ inferred
	従業員採用済	UKG Proにおける従業員記録の公式な作成を示し、従業員IDが正式に割り当てられます。このイベントは通常、HR管理者が候補者の採用プロセスを完了し、システム内でアクティブな従業員に移行させたときにキャプチャされます。
その重要性これは、「採用から退職まで」のプロセス分析における決定的な開始イベントです。生産性が発揮されるまでの時間、オンボーディングの効率性、および全体的な従業員在籍期間を測定するための基準を提供します。取得元このイベントは、HRコアまたは人事管理モジュールに記録されている可能性があります。従業員の主要な雇用記録の作成日、または従業員の職務データ履歴にある特定の「Hire」アクション記録によって識別できます。取得従業員の職務履歴テーブルにおける「採用」アクションの発効日から取得されます。イベントタイプ explicit
	従業員解雇済	従業員のライフサイクルにおける最後のイベントであり、正式な雇用の終了を表します。これは、退職有効日をもって従業員の記録がシステム内で非アクティブになる時点です。
その重要性これはプロセスの決定的な終了イベントであり、最終的な従業員在籍期間の計算や離職率の分析に不可欠です。これにより、従業員の会社における道のりが完結します。取得元これは、HRコアモジュール内の従業員の職務データ履歴における最終的な「退職」アクションの有効日です。システムは通常、この日付で従業員のステータスをアクティブから非アクティブに変更します。取得従業員の職務履歴における「退職」アクションの発効日から取得されます。イベントタイプ explicit
	昇進承認済み	従業員の昇進が正式に承認されたことを示します。これは通常、役職変更、多くの場合報酬の変更を伴います。変更の発効日よりも前に発生する、明確なイベントです。
その重要性この活動は、社内異動やキャリアアップを分析する上で重要です。昇進承認から発効日までの時間は、システムにおける管理上のボトルネックを浮き彫りにする可能性があります。取得元 HRコアモジュール内の従業員のジョブデータ履歴に、「昇進」などの特定のジョブアクションとして記録されます。この記録には、独自の承認日と発効日があります。取得従業員の職務履歴における「昇進」アクションのログ日付から取得されます。イベントタイプ explicit
	退職手続き開始	将来の退職日がシステムに入力された際に記録される、オフボーディングプロセスの開始を表します。このイベントにより、オフボーディングのチェックリストとワークフローがトリガーされます。
その重要性これは、従業員の退職プロセスを開始する重要な節目です。このイベントから最終的な退職までの時間を分析することで、オフボーディング手続きの効率性と完全性を評価するのに役立ちます。取得元これは通常、従業員の職務データに将来の有効日を持つ「退職」アクションレコードが作成されることです。特定のモジュールにおけるオフボーディングワークフローの開始となる場合もあります。取得将来の日付を持つ退職トランザクションが提出されたときに取得されます。イベントタイプ explicit
	オフボーディング完了	すべての必須オフボーディングタスクが完了したことを示すマイルストーンです。これには、資産返却、最終給与計算、システムアクセス権の取り消しといったアクティビティが含まれます。
その重要性このイベントは、従業員の退職手続きが安全かつコンプライアンスに準拠して完了したことを確認します。これはオフボーディングサイクルタイムを測定し、コンプライアンスのギャップを特定するのに役立ちます。取得元これは、全体のオフボーディングチェックリストまたはワークフローの完了タイムスタンプから推測されます。「従業員オンボーディング完了」イベントと同様ですが、退職プロセスで用いられます。取得従業員向けのマスターオフボーディングチェックリストの完了タイムスタンプから推測されます。イベントタイプ inferred
	オンボーディング開始	UKG Pro内での新入社員オンボーディングプロセスまたはワークフローの開始を表します。これは通常、新入社員、その上司、および人事担当者にタスクのチェックリストを割り当てる、自動または手動でトリガーされるイベントです。
その重要性このアクティビティを追跡することは、正式な採用日と管理上および文化的な統合が開始されるまでの時間を測定するのに役立ちます。これは、オンボーディングプロセスの効率性を分析し、遅延を特定するための出発点となります。取得元 UKG Proのオンボーディングモジュール内で確認されます。このイベントは、従業員に関連付けられたオンボーディングチェックリストまたはワークフローインスタンスの作成日から推測できます。取得従業員のオンボーディングワークフローまたはタスクリストの作成タイムスタンプから推測されます。イベントタイプ inferred
	トレーニング割り当て済み	特定の研修コースや学習プランが従業員に割り当てられた時点を記録します。これは通常、システムの学習管理モジュールに記録されます。
その重要性この活動は、義務付けられたトレーニングの遵守状況を追跡し、従業員の育成状況を監視するのに役立ちます。割り当てから完了までの時間を分析することで、従業員のエンゲージメントの課題やトレーニングの有効性を明確にできます。取得元 UKG Proの学習管理モジュールまたはタレント管理モジュールに記録されます。各課題には、課題日と従業員IDを含む対応する記録が必要です。取得コースまたはカリキュラムが従業員の学習計画に割り当てられた際に記録されます。イベントタイプ explicit
	マネージャー変更	このイベントは、従業員の「Reports To」または「Manager ID」フィールドが更新されたときに生成されます。これは従業員の直属の報告ラインの変更を表します。
その重要性マネージャーの交代は、従業員のエンゲージメントとパフォーマンスに大きな影響を与える可能性があります。このイベントをトラッキングすることで、パフォーマンスレビューや定着率などのその後の活動への影響を分析できます。取得元このイベントは、従業員の職務データにおけるマネージャーまたはスーパーバイザーフィールドの経時的な変更を追跡することで推測されます。これは、同じ従業員の連続する記録間でマネージャーIDを比較することで特定されます。取得従業員の職務データ履歴にある「レポート先」フィールドの変更を検出することで推測されます。イベントタイプ inferred
	休職開始	従業員の承認された休職（病気休暇や私的理由など）の開始を記録します。これは、従業員のステータスが非アクティブな休職状態に変更されたときに記録されます。
その重要性従業員ライフサイクルにおける非アクティブ期間を特定します。これは、アクティブな在職期間を正確に計算し、休職がキャリア形成に与える影響を理解する上で不可欠です。取得元従業員の職務データ履歴は、HRコアモジュール内で確認できます。これは、特定の有効開始日を持つ「休職」のような職務アクションに対応します。取得職務履歴における「休職開始」アクションの発効日から取得されます。イベントタイプ explicit
	報酬変更済	このイベントは、従業員の基本給、ボーナス構造、またはその他の報酬要素に対するあらゆる変更を捕捉します。これは昇進、業績給、または市場調整の一環として発生する可能性があります。
その重要性報酬の変更を追跡することは、キャリアと給与の進捗を理解するために不可欠です。入社後の頻繁な調整は、データ入力エラーや初期給与設定の問題を示している可能性があります。取得元従業員の報酬履歴テーブルは、HRコアまたは給与モジュール内で確認できます。各変更は通常、発効日と理由コードとともに記録されます。取得従業員の報酬履歴記録における新しいエントリの発効日から記録されます。イベントタイプ explicit
	役割変更処理済み	従業員の役職や職務の変更（昇進ではない、例えば部門内異動や他部署への異動など）を表します。これは、関連する職務データがシステム内で更新された際に記録されます。
その重要性役割変更を分析することで、社内異動、人材配置、組織再編に関する洞察が得られます。従業員が組織内をどのように移動しているかを特定するのに役立ちます。取得元 HR Coreモジュールの従業員職務データ履歴から取得されます。「異動」、「再割り当て」、または「役職変更」といった職務アクションと、それらの発効日によって特定可能です。取得従業員の職務履歴データにおける「転勤」または類似のアクションコードによって識別されます。イベントタイプ explicit
	給与セットアップ完了	従業員の給与処理に必要なすべての情報（銀行口座情報、税務書類など）が入力・検証済みであることを示します。これは、従業員に正確かつタイムリーに給与が支払われることを確実にするための重要なステップです。
その重要性この節目は、新入社員の準備状況を測定する上で極めて重要です。給与設定の遅れは従業員の不満や管理上の手戻りを引き起こす可能性があり、オンボーディングにおける主要なKPIとなります。取得元このイベントは、UKG Proの給与モジュールから推測される可能性があります。給与準備チェックリストの完了日、または従業員のステータスが「Ready for Payroll」に変更された日付から導き出すことができます。取得従業員の給与プロファイルにおけるステータス変更または完了タイムスタンプから導出されます。イベントタイプ inferred
	退職面談実施済	このイベントは、退職する従業員との退職面談の完了を示します。これは通常、オフボーディングチェックリスト内の完了済みタスクとして記録されます。
その重要性退職面談の完了を追跡することは、HRコンプライアンスの確保と貴重なフィードバック収集のために重要です。これにより、この重要なステップがオフボーディングプロセスでスキップされていないかを確認できます。取得元 UKG ProのオンボーディングモジュールまたはHRヘルプデスクモジュール内における、退職関連ワークフローの特定タスクとして、このイベントは発生すると考えられます。その捕捉は、HRがタスクを手動で完了としてマークすることに依存します。取得従業員のオフボーディングチェックリスト内で、完了したタスクとして記録されます。イベントタイプ explicit

推奨任意

抽出ガイド

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

ステップ

前提条件: Python 3.6+ と requests および pandas ライブラリがインストールされていることを確認してください。これらは pip install requests pandas を使用してインストールできます。
APIアクセスと認証: UKG Proの管理者にお問い合わせいただき、サービスアカウントを作成してください。APIキー、ユーザー名、パスワードが必要となります。サービスアカウントには、人事、給与、オンボーディング、パフォーマンス、学習データといった必要な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 など）に合わせて名前を変更するよう設計されています。
イベントデータの結合: スクリプトのメイン処理では、各アクティビティ固有の関数を呼び出し、各関数が返すデータを単一のマスターイベントリストに追加していきます。
イベントログの生成: すべてのアクティビティの処理後、スクリプトはデータを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）。
企業ID: 多くのAPI呼び出しには、UKG Proにおける貴社の固有のCOMPANY_IDが必須です。
期間: START_DATEおよびEND_DATEパラメータ（'YYYY-MM-DD'形式）は、データ抽出期間を制御します。初回実行時は、データ量の管理と結果検証のため、3〜6ヶ月程度の期間を推奨します。
APIエンドポイントのバージョン: スクリプトは、特定のバージョンのREST API（例：/personnel/v1/）を使用します。お使いのUKG Proインスタンスがこれらのバージョンをサポートしていることを確認してください。
モジュールの依存関係: 特定のアクティビティを抽出するには、貴社がOnboarding、Learning、Performance Managementなどの対応する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}")

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

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

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

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

抽出ガイド

UKG Pro REST API経由のPythonスクリプトによるデータ抽出

ステップ

設定

a クエリ例 python

今すぐ始めますか？

今日から「採用から退職まで」の従業員ライフサイクルの最適化を始めましょう！

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

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

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

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

抽出ガイド

UKG Pro REST API経由のPythonスクリプトによるデータ抽出

ステップ

設定

a クエリ例 python

今すぐ始めますか？

今日から「採用から退職まで」の従業員ライフサイクルの最適化を始めましょう！

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

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

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