> 継続的なプロセス改善 > 給与処理 > Ceridian Dayforce > データテンプレート

給与処理データテンプレート

Ceridian Dayforce

給与処理の属性(17) 給与処理のアクティビティ(15) データ抽出ガイド(2)

給与処理データテンプレート

このテンプレートは、Ceridian Dayforceにおける給与処理の全体像をマッピングするための枠組みを提供します。詳細な分析に適した品質の高いイベントログを作成するために必要なデータ項目とプロセス上の節目を示します。手順に沿って進めることで、給与支払いワークフローを把握し、業務改善が必要な箇所を特定できます。

収集を推奨する属性
追跡する主要なアクティビティ
システム固有のデータ抽出ガイド

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

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

給与処理の属性

推奨するデータ項目を収集すると、Ceridian Dayforceの業務コンテキストとシステムの詳細を把握でき、プロセス分析の確かな基盤になります。

5 必須 5 推奨 7 任意

	名前	説明
	アクティビティ ActivityName	実行されたプロセスのステップまたはイベントの名前です。
説明この属性は、給与サイクル内で発生する個々のイベントを表します。Dayforceの標準的なアクティビティには、「タイムシートの提出」「総支給額の計算」「給与計算の確定」「支払いの実行」「税務申告の完了」などがあります。通常、ワークフローの監査ログ、システムのトランザクションログ（例：給与ステータスの変更）、または給与計算実行やタイムシートなどの業務オブジェクトに関連付けられたタイムスタンプから値を取得します。重要な理由プロセスの各ステップを定義するため、プロセスフローの再構築やバリアントの分析に欠かせません。入手先ワークフローのログ、監査証跡、またはステータス変更履歴テーブル。例タイムシートの提出総支給額の計算支払いの実行データの修正監査上の例外を検出
	タイムスタンプ EventDateTime	アクティビティが発生した具体的な日時です。
説明 Dayforceシステムでイベントが発生した正確な日時を示すタイムスタンプです。アクティビティを時系列に並べ、各ステップ間の所要時間を算出するために使用します。「タイムシートの承認」や「銀行振込ファイルの生成」の遅延など、ボトルネックを特定するには正確なタイムスタンプが欠かせません。精度は秒単位または分単位が理想的です。重要な理由プロセスマイニングに必要な時間情報を提供し、パフォーマンス分析やボトルネックの検出を可能にします。入手先監査テーブルのトランザクション日時列（例：CreatedDateTime、LastModifiedDateTime）。例 2023-10-12T08:30:00Z2023-10-12T14:15:22Z2023-10-15T09:00:00Z
	給与記録 PayrollRecordId	従業員と給与期間を組み合わせた、給与計算ケースの一意の識別子です。
説明この属性は、プロセスの一意のケースIDとして機能します。Ceridian Dayforceでは、給与記録は特定の従業員と特定の給与期間（多くの場合、給与グループ内で定義）の組み合わせに相当します。従業員の報酬が、その給与サイクルでどのように処理されたかを追跡します。技術的には、給与期間IDと従業員のXRefCodeまたはシステムIDを連結して作成することがよくあります。最初のタイムシート提出から最終的な税務申告、給与明細の作成まで、すべてのアクティビティを関連付けます。重要な理由プロセスマイニング分析の中心となる対象を特定し、すべてのイベントを1つのエンドツーエンドの実行経路にまとめます。入手先給与結果テーブルまたは勤怠入力テーブルにあるPayPeriodIDとEmployeeIDの組み合わせから取得します。例 PG01-2023-10-EMP10234US_SAL-2023-22-EMP88421UK_HRLY-2023-44-EMP00231
	ソースシステム SourceSystem	データの取得元となったシステムの名前です。
説明給与データの抽出元となったソフトウェアまたはデータベースを特定します。この場合、値は通常「Ceridian Dayforce」または「Dayforce」です。複数のシステム（例：Dayforceにデータを送る外部の勤怠管理システム）からデータを統合し、データの流れを追跡する際に役立ちます。重要な理由データの追跡可能性を確保し、複数システムを対象とするプロセスマイニングの設定でフィルタリングできるようにします。入手先抽出時に固定値を設定するか、接続メタデータから取得します。例 Ceridian DayforceDayforce本番環境Dayforce EU
	最終データ更新 LastDataUpdate	ソースからデータを抽出した日時です。
説明分析に使うデータがどの時点のものかを示します。通常は、Dayforceからデータを取得したETL（抽出、変換、読み込み）処理の実行日時です。分析担当者は、リアルタイムのデータを見ているのか、前日の時点のデータを見ているのかを把握できます。重要な理由データセットの最新時点を明確にし、ソースシステムのレポートと照らし合わせてデータの完全性を確認しやすくします。入手先スクリプトの実行時点におけるシステム時刻。例 2023-11-01T00:00:00Z2023-11-02T12:00:00Z
	SLA処理期限 SlaProcessingDeadline	銀行振込ファイルの生成を完了すべき日時です。
説明従業員への期日どおりの支払いを確実にするため、「銀行振込ファイルの生成」を完了すべき社内または社外の期限です。「銀行振込期限の遵守状況」ダッシュボードで使用します。給与支払日を基準とする固定ルール（例：支払日の2日前）や、給与グループの設定項目から取得する場合があります。重要な理由期日遵守の実績とコンプライアンスリスクを算出するための基準です。入手先給与支払日と銀行処理ルールの設定から算出します。例 2023-10-25T14:00:00Z2023-10-26T10:00:00Z
	操作ユーザー ActionUser	特定のアクティビティを実行したユーザーです。
説明タイムシートを承認した管理者や、給与計算実行を確定した給与担当者など、イベントを実行した担当者を特定します。「給与担当者の生産性」ビューでの分析や、管理者に必要なトレーニングの特定に役立つデータです。重要な理由リソース分析や、プロセス内の責任の追跡に役立ちます。入手先監査ログ、トランザクションテーブルのユーザーID列。例 jsmithシステム管理者mgarcia_mgr
	給与グループ PayGroupName	給与計算のために従業員をまとめたグループです。
説明同じスケジュールで給与を支払う従業員を分類します（例：「米国・隔週」「英国・月次」）。Dayforceでは、給与グループは給与計算実行の主要な組織単位です。給与グループによってサイクルタイムや期限が異なるため、「給与計算のエンドツーエンド所要時間」ダッシュボードに欠かせない属性です。重要な理由給与パフォーマンスを比較し、特定のグループに関する問題を特定するための主要な分類項目です。入手先 PayGroupテーブルまたはPayRun定義。例米国・本社・月給カナダ・小売・時給英国・役員・月給
	総支給額 GrossPayAmount	記録に対して計算された総支給額です。
説明控除や税金を差し引く前の報酬総額です。「総支給額の計算」アクティビティで値が入力されます。総支給額の処理時間のばらつきを分析すると、「計算エンジンの処理速度」ダッシュボードで処理を遅らせる複雑な計算を特定できます。重要な理由プロセスに金額情報を加え、金額の大きい記録と小さい記録の処理を比較できます。入手先給与結果テーブルまたは給与計算実行の詳細テーブル。例 2500.004150.501200.00
	部門 DepartmentName	従業員が所属する組織単位です。
説明給与記録に関連付けられた機能別の部門（例：営業、IT、人事）を示します。Dayforceでは、「組織単位」または「部門」の階層に関連付けられていることがよくあります。このフィールドは「タイムシート承認パフォーマンス」ダッシュボードで使用します。承認が遅れやすい事業領域をドリルダウンして確認できます。重要な理由組織内での比較や、承認遅延の根本原因分析に役立ちます。入手先従業員記録または組織単位の階層。例財務サプライチェーン物流北米営業
	コストセンター CostCenterCode	給与計算費用の計上先となる財務コードです。
説明従業員の給与に関連付けられた総勘定元帳のコストセンターです。「コストセンター処理ベンチマーク」ビューで、財務単位ごとの効率を比較する際に使用します。 Dayforceでは、総勘定元帳（GL）の配賦詳細に含まれます。重要な理由プロセスのパフォーマンスと財務報告の構造を結び付けます。入手先従業員のGL設定または労務配賦テーブルです。例 CC-1020CC-5500-USCC-IT-OPS
	修正理由 CorrectionReason	データ修正時に指定された理由コードです。
説明「データ修正の実施」アクティビティが発生した場合、記録された理由（例：「打刻漏れ」「遡及給与の調整」）をこの属性に保存します。「手動修正と手戻り率」ダッシュボードに詳細を加え、手作業が発生する具体的な原因への対処に役立ちます。重要な理由手戻りの根本原因を分析するうえで欠かせません。入手先監査ログの詳細、または修正トランザクションのコメント欄です。例打刻漏れレート誤り遡及調整
	監査例外の有無 IsAuditExceptionFlagged	レコードが監査警告の対象になったかどうかを示す真偽値です。
説明このケースで「監査例外のフラグ設定」アクティビティが発生したことを示す、計算値または直接取得したフラグです。「監査例外フラグ設定率」KPIの算出に使用します。例外率が高い場合は、データ品質の問題、またはDayforceのコンプライアンスエンジンの設定が厳しすぎる可能性があります。重要な理由エラー率や手戻りの発生回数を簡単に算出できます。入手先「監査例外のフラグ設定」アクティビティの有無から算出します。例 truefalse
	税務管轄 TaxJurisdiction	税務申告を行う地域または当局です。
説明給与記録に関係する税務当局（例：州、県、国）を特定します。「税務申告とコンプライアンスのモニター」ダッシュボードで使用します。給与計算後のコンプライアンスプロセスを地域別に分類し、申告の遅延が頻繁に発生する税務管轄を明らかにできます。重要な理由コンプライアンスの監視や、地域ごとのプロセスパフォーマンスの分析に役立ちます。入手先従業員の税務設定または給与結果の税務詳細。例カリフォルニア州オンタリオ州ニューヨーク州英国
	給与期間 PayPeriodDescription	給与支払いサイクルを表す名称です。
説明給与期間を人が読みやすい形式で表した名称です（例：「2023年第42週」「2023年10月前後半払い」）。ダッシュボードでの絞り込みや可視化に役立ちます。「給与レコード」のコンテキストを示します。「プロセスバリアント経路分析」に表示し、特定の実行を絞り込む際にもよく使われます。重要な理由業務担当者がデータを理解しやすくなります。入手先 PayPeriodテーブルのdescription列です。例 2023-W422023-Oct-SM12023-M11
	銀行振込の遅延有無 IsBankTransferLate	銀行振込ファイルが期限に間に合わなかったかどうかを示すフラグです。
説明「銀行振込ファイルの生成」タイムスタンプと「SLA処理期限」を比較して算出する真偽値です。「期限内銀行振込率」KPIの算出に使用します。振込の遅延を特定することで、従業員への給与支払いの遅れを防ぎやすくなります。重要な理由コンプライアンスと信頼性を示す重要な指標です。入手先算出式：BankTransferTime > SlaProcessingDeadline。例 truefalse
	雇用形態 EmploymentType	従業員の区分です（フルタイム、パートタイム、契約社員）。
説明従業員の雇用形態を分類します。ベンチマークでは、契約社員やパートタイム従業員の給与処理の特性やエラー率に違いがあるかを確認できます。 Dayforceの従業員レコードに含まれていることが多い属性です。重要な理由区分ごとの分析や、公平な処理状況の比較に役立ちます。入手先 Employeeテーブルです。例フルタイムパートタイム契約社員

必須推奨任意

給与処理のアクティビティ

給与処理と支払いのワークフローを時系列で正確に把握するため、次の主要なライフサイクルイベントとステータス変更を記録してください。

7 推奨 8 任意

	アクティビティ	説明
	タイムシートの承認	管理者または上司が提出済みの勤怠データを承認します。この段階の遅延は「タイムシート承認パフォーマンス」ダッシュボードに直接影響します。
重要な理由給与計算の開始を妨げる承認プロセス上のボトルネックを特定します。入手先 WFMモジュールで、タイムカードのステータスが「承認済み」または「承認完了」に変わった記録を追跡します。記録承認トランザクションの実行時に記録イベントタイプ explicit
	タイムシートの提出	従業員または管理者が、処理対象となる勤怠データを提出したイベントです。WFMモジュールと給与計算モジュールをつなぐ段階です。
重要な理由データの発生時点からの遅延を測定する「給与計算のエンドツーエンド所要時間」ダッシュボードに欠かせません。入手先 DayforceのWFMモジュールのログ、またはタイムカードオブジェクトのステータスが「提出済み」に変わった記録から取得します。記録変更前後のステータスフィールドを比較イベントタイプ inferred
	支払いの実行	従業員への支払いが行われる日付です。従業員にとって、プロセス上の金銭的な完了点となります。
重要な理由「給与計算のエンドツーエンド所要時間」と従業員満足度を測る重要な節目です。入手先確定済みの給与記録にある「小切手日付」または「支払日」フィールド。記録支払いトランザクションの実行時に記録イベントタイプ explicit
	給与記録の初期化	従業員ごとの給与計算実行データが作成されたことを示します。Dayforceでは、給与グループを対象サイクルに対して開き、従業員を実行対象に追加した時点で発生します。
重要な理由給与計算ケースの開始点となり、サイクルタイム全体を測定するためのベースラインを設定します。入手先給与グループ内で従業員の給与計算実行データが作成された日時を特定します。記録給与計算実行データの作成時に記録イベントタイプ explicit
	給与記録の承認	給与記録の最終承認です。給与計算実行の「確定」または「ロック」と呼ばれることもあります。計算・確認段階の終了を示します。
重要な理由処理段階と支払い段階を分ける最終的な節目です。入手先給与計算実行のステータスが「確定済み」「ロック済み」または「承認済み」に変わった記録。記録確定トランザクションの実行時に記録イベントタイプ explicit
	総支給額の計算	システムの計算エンジンが、労働時間、給与レート、インポートしたデータに基づいて総支給額を算出します。「計算エンジンの処理速度」ダッシュボードで最初に確認する段階です。
重要な理由入力データが確定した後の計算エンジンの処理時間を測定します。入手先計算バッチの実行中に「総支給額」フィールドへ値が入力または更新された日時から推定します。記録変更前後のステータスフィールドを比較イベントタイプ inferred
	銀行振込ファイルの生成	NACHA、SEPAなどの銀行振込ファイルを生成します。「銀行振込の期日遵守率」をSLAの期限に照らして算出するために使用します。
重要な理由支払いに間に合うよう資金を移動するための、コンプライアンス上重要な段階です。入手先銀行送信用ファイルが正常に生成されたことを示すシステムジョブログ。記録ファイル生成トランザクションの実行時に記録イベントタイプ explicit
	インセンティブデータのインポート	賞与、コミッション、一時金を含む外部データファイルのインポートが正常に完了したことを記録します。「インセンティブデータのインポート所要時間」ダッシュボードで使用します。
重要な理由このデータの受け取りが遅れると、給与計算の処理が保留になることがよくあります。入手先給与計算実行を対象とするXMLまたはCSVのインポートジョブが完了したことを示すDayforceの連携ログ。記録インポートトランザクションの実行時に記録イベントタイプ explicit
	データの修正	初回計算の後、ユーザーが労働時間、給与レート、控除などの給与データを手作業で変更します。「手作業による修正と手戻りの割合」ダッシュボードで追跡します。
重要な理由手戻りを直接測定します。このアクティビティを減らすことは、プロセス効率化の主な目標です。入手先ユーザーが従業員の給与明細テーブルを更新したことを示す監査証跡。記録記録更新トランザクションの実行時に記録イベントタイプ explicit
	監査上の例外を検出	検証ルールに基づいて、システムが警告またはエラーメッセージを生成します（例：手取り額がマイナス）。「監査例外の検出率」重要業績評価指標（KPI）で使用します。
重要な理由発生頻度が高い場合、上流のデータ品質が低いか、設定に誤りがあり、手作業での対応が必要な可能性があります。入手先給与計算実行IDに関連付けられた、システムのメッセージ／エラーログテーブルから抽出します。記録例外作成トランザクションの実行時に記録イベントタイプ explicit
	福利厚生控除の適用	総支給額に福利厚生のルールと控除を適用します。処理速度ダッシュボードで監視する自動計算の一部です。
重要な理由給与計算の実行中に、福利厚生エンジンに固有の処理時間やエラーを切り分けます。入手先控除項目が給与記録に書き込まれた日時、または「控除合計」フィールドが更新された日時。記録フィールドの更新日時と前の時刻を比較して算出イベントタイプ calculated
	税務申告の完了	給与計算後の税務申告が、該当する税務管轄で正常に処理されたことを確認します。「税務申告とコンプライアンスのモニター」で使用します。
重要な理由従業員への支払い後も法令を遵守し、罰則を避けられるようにします。入手先税務モジュールまたは連携ログで、税務当局や外部申告業者による受領を確認するステータス更新。記録申告確認トランザクションの実行時に記録イベントタイプ explicit
	税額の計算	税務管轄のルールを適用して手取り額を算出する、最終計算の段階です。自動計算の一連の処理が完了します。
重要な理由複雑な税務ルールによって処理が遅れる場合があります。このアクティビティを使って、税計算エンジンのパフォーマンスを比較できます。入手先税額項目が生成された日時、またはデータベースの「手取り額」フィールドが確定した日時。記録変更前後のステータスフィールドを比較イベントタイプ inferred
	給与明細の公開	従業員がESSポータルで電子給与明細を確認できるようになります。「電子給与明細の公開状況」ダッシュボードで使用します。
重要な理由支払いの実行から情報を確認できるようになるまでの時間を測定します。入手先明細公開ジョブが完了した日時、または表示フラグがtrueに設定された日時。記録変更前後のステータスフィールドを比較イベントタイプ inferred
	給与計算結果のプレビュー	ユーザーが給与台帳の暫定版または給与プレビューを表示します。「プレビュー段階の効率」を分析し、手戻りを特定するために使用します。
重要な理由担当者による確認段階の開始を示します。プレビューが繰り返される場合は、データの問題が続いている可能性があります。入手先ユーザーが「給与プレビュー」レポートを作成した、またはプレビュー画面を開いたことを示すアクセスログ。記録プレビューレポートのトランザクション実行時に記録イベントタイプ explicit

推奨任意

データ抽出ガイド

Ceridian Dayforceからデータを取得する方法

ステップ

レポート機能とシステム管理者権限を持つユーザーアカウントで、Ceridian Dayforceにログインします。
アプリケーションのメインメニューからレポート機能を開きます。
追加ボタンをクリックして新しいレポートを作成し、トピックとして「System Audit Trail」を選択します。このトピックには、プロセスマイニングに必要な変更履歴が含まれています。
列の選択エリアに、Transaction Id、User Name、Timestamp、Feature Name、Operation、Table Name、Column Name、Old Value、New Value、Context Infoの各フィールドを追加します。Context Infoには通常、従業員と給与グループの情報が含まれます。
レポートにフィルターを追加し、Feature NameがPayroll、WFM（Workforce Management）、Benefitsのいずれかに該当するよう設定します。
2つ目のフィルターを追加し、分析対象期間の日付範囲を指定します（例：過去90日間）。
このレポートを「Process Mining Audit Extract」という名前で保存します。
「Pay Run History」トピックを使って2つ目のレポートを作成し、詳細なフィールド単位の監査履歴には記録されない場合がある、計算、承認、確定といった全体的なステータス変更を取得します。Pay Group、Pay Period End Date、Workflow Status、Status Change Date、Userの各フィールドを選択します。
2つのレポートを実行し、結果をCSV形式でエクスポートします。
Dayforceでは正規化されたデータがエクスポートされるため、2つのCSVファイルを結合する必要があります。Pay GroupとPay Periodの識別子を基準にレコードを照合します。
以下のクエリセクションに記載された変換ロジックを適用し、Dayforceの生の監査コードを標準化されたアクティビティ名に対応付けます。
最終データセットを必要な列（PayrollRecordId、ActivityName、EventDateTime、SourceSystem、その他の属性）に整え、アップロード用のCSVファイル1つに保存します。

設定

レポートトピックの選択：フィールド単位の詳細な変更には「System Audit Trail」を、全体的なワークフローの節目には「Pay Run History」を使用します。
日付範囲：ケースの完了まで追跡でき、エクスポートのサイズ上限にも達しないよう、3～6か月の範囲を選択します。
機能のフィルター：関係のない人事変更を除外するため、監査履歴の機能を「Payroll」「Time And Attendance」「Benefits」に絞り込みます。
ユーザーのコンテキスト：エクスポートに「System」ユーザーの操作を含めます。計算などの自動処理は人ではなく、Systemアカウントによって実行されるためです。
形式：機械処理しやすいよう、ヘッダーのグループ化を行わず、CSV（カンマ区切り）形式でエクスポートします。
タイムゾーン：異なる場所のユーザー間で時系列を正しく比較できるよう、エクスポートしたすべてのタイムスタンプがUTCまたはサーバー時刻であることを確認します。

クエリの例 json

[
  {
    "ActivityName": "Payroll Record Initialized",
    "SourceReport": "Pay Run History",
    "Logic": "Status equals 'Created' or 'Open'",
    "TimestampField": "Status Change Date",
    "ContextFields": ["PayGroup", "PayPeriod"]
  },
  {
    "ActivityName": "Time Sheet Submitted",
    "SourceReport": "System Audit Trail",
    "Logic": "Feature equals 'WFM' AND Table equals 'Timesheet' AND Operation equals 'Submit'",
    "TimestampField": "Timestamp",
    "ContextFields": ["EmployeeId", "PayPeriod"]
  },
  {
    "ActivityName": "Time Sheet Approved",
    "SourceReport": "System Audit Trail",
    "Logic": "Feature equals 'WFM' AND Table equals 'Timesheet' AND Operation equals 'Approve'",
    "TimestampField": "Timestamp",
    "ContextFields": ["EmployeeId", "PayPeriod"]
  },
  {
    "ActivityName": "Incentive Data Imported",
    "SourceReport": "System Audit Trail",
    "Logic": "Feature equals 'Payroll' AND Operation equals 'Import' AND Table equals 'PayEntry'",
    "TimestampField": "Timestamp",
    "ContextFields": ["BatchId", "PayGroup"]
  },
  {
    "ActivityName": "Gross Pay Calculated",
    "SourceReport": "Pay Run History",
    "Logic": "Status equals 'Calculated' OR Description contains 'Calculation Completed'",
    "TimestampField": "Status Change Date",
    "ContextFields": ["PayGroup", "PayPeriod"]
  },
  {
    "ActivityName": "Benefits Deductions Applied",
    "SourceReport": "System Audit Trail",
    "Logic": "Feature equals 'Benefits' AND Table equals 'EmployeeDeduction' AND Operation equals 'Process'",
    "TimestampField": "Timestamp",
    "ContextFields": ["EmployeeId", "DeductionCode"]
  },
  {
    "ActivityName": "Taxes Calculated",
    "SourceReport": "Pay Run History",
    "Logic": "Description contains 'Tax Update' OR Status equals 'Tax Calculated' (Note: Often concurrent with Gross Pay)",
    "TimestampField": "Status Change Date",
    "ContextFields": ["PayGroup"]
  },
  {
    "ActivityName": "Payroll Result Previewed",
    "SourceReport": "System Audit Trail",
    "Logic": "Feature equals 'Payroll' AND Operation equals 'View' AND (Table equals 'Preview' OR Table equals 'PayrollRegister')",
    "TimestampField": "Timestamp",
    "ContextFields": ["User", "PayGroup"]
  },
  {
    "ActivityName": "Audit Exception Flagged",
    "SourceReport": "System Audit Trail",
    "Logic": "Feature equals 'Payroll' AND Operation equals 'Error' OR Table equals 'MessageLog'",
    "TimestampField": "Timestamp",
    "ContextFields": ["MessageId", "Severity"]
  },
  {
    "ActivityName": "Data Correction Performed",
    "SourceReport": "System Audit Trail",
    "Logic": "Feature equals 'Payroll' AND Operation equals 'Update' AND Table equals 'PayEntry' AND User is not 'System'",
    "TimestampField": "Timestamp",
    "ContextFields": ["ColumnName", "OldValue", "NewValue"]
  },
  {
    "ActivityName": "Payroll Record Approved",
    "SourceReport": "Pay Run History",
    "Logic": "Status equals 'Committed' OR Status equals 'Locked'",
    "TimestampField": "Status Change Date",
    "ContextFields": ["PayGroup", "ActionUser"]
  },
  {
    "ActivityName": "Bank Transfer File Generated",
    "SourceReport": "System Audit Trail",
    "Logic": "Feature equals 'Payroll' AND Operation equals 'Generate' AND Table equals 'BankFile'",
    "TimestampField": "Timestamp",
    "ContextFields": ["FileName"]
  },
  {
    "ActivityName": "Payment Executed",
    "SourceReport": "Pay Run History",
    "Logic": "Use column 'Check Date' or 'Payment Date' from the Pay Run summary",
    "TimestampField": "Payment Date",
    "ContextFields": ["PayGroup"]
  },
  {
    "ActivityName": "Pay Slip Published",
    "SourceReport": "System Audit Trail",
    "Logic": "Feature equals 'ESS' AND Operation equals 'Publish' AND Table equals 'Statement'",
    "TimestampField": "Timestamp",
    "ContextFields": ["EmployeeId"]
  },
  {
    "ActivityName": "Tax Filing Completed",
    "SourceReport": "System Audit Trail",
    "Logic": "Feature equals 'TaxService' AND Operation equals 'File' OR Status equals 'Filed'",
    "TimestampField": "Timestamp",
    "ContextFields": ["Jurisdiction"]
  }
]

ステップ

事前準備：Ceridian DayforceでWebサービス（REST API）にアクセスできるサービスアカウントを用意します。このアカウントには、従業員給与サマリー、勤怠データ、監査／ワークフローデータへのアクセス権限が必要です。
APIの設定：Dayforceで「System Admin」>「Integrations」>「Web Services」を開きます。Client NamespaceとService URLを確認し、Basic AuthまたはOAuthが設定されていることを確認します。このスクリプトでは簡潔さを優先してBasic Authを使用しますが、本番環境ではOAuthを推奨します。
実行環境の準備：Python 3.xと必要なライブラリをインストールします。pandasとrequestsが必要です。pip install pandas requestsを実行してインストールします。
スクリプトの設定：提供されたスクリプトの先頭にある設定変数を更新します。username、password、client_namespace、base_urlのプレースホルダーを、利用環境に合わせた値に置き換えます。
日付範囲の指定：分析する給与期間を含むよう、スクリプトのstart_dateとend_dateを設定します。初回の検証では3～6か月の期間を推奨します。
実行：コマンドラインからスクリプトを実行します（例：python extract_dayforce.py）。このスクリプトは複数のエンドポイント（給与サマリー、勤怠、監査）からデータを取得し、統合されたイベントログにまとめます。
データ変換：スクリプトがタイムスタンプを自動的に標準化し、Dayforce固有のステータスコードを必要な標準アクティビティ名に対応付けます（例：Workflow StatusのcommittedをPayroll Record Approvedに対応付けます）。
出力ファイルの作成：スクリプトは、dayforce_payroll_event_log.csvという名前のCSVファイルをローカルディレクトリに出力します。
検証：CSVファイルを開き、同じ給与期間のPayrollRecordIdが一貫していること、日付が論理的な時系列になっていることを確認します。
インポート：作成したCSVをProcessMindにアップロードします。PayrollRecordIdをケースIDに、ActivityNameをアクティビティに、EventDateTimeをタイムスタンプに対応付けます。

設定

バッチサイズ：Dayforce APIはページネーションを使用します。スクリプトでは、1ページあたり50件または100件を初期値としています。タイムアウトが発生する場合は、limitパラメーターを調整してください。
リクエスト制限：Dayforce APIには厳しいレート制限があります。429 Too Many Requestsエラーを避けるため、スクリプトではリクエスト間に基本的な待機時間を設けています。
Client Namespace：接続文字列に必要な、Dayforceインスタンス固有の識別子です。
データの反映時間：Dayforce APIのデータは通常リアルタイムで反映されますが、1～2年以上前の古いレコードの監査ログは、アーカイブされているか、取得に時間がかかる場合があります。
権限：機密性の高い属性を含める場合、APIユーザーには個人識別情報（PII）フィールドへの読み取り権限が必要です。ただし、このスクリプトではプロセスのメタデータを対象としています。
タイムゾーン：APIは通常、UTCでデータを返します。スクリプトで時刻を変換しますが、画面上の表示と比較する場合は、サーバーのタイムゾーンを確認してください。

クエリの例 python

import requests
import pandas as pd
import json
from datetime import datetime, timedelta
import time

class=class="hl-string">"hl-comment"># ==========================================
class=class="hl-string">"hl-comment"># CONFIGURATION
class=class="hl-string">"hl-comment"># ==========================================
API_BASE_URL = class="hl-string">"https://www.dayforcehcm.com/api/[YourClientNamespace]/v1"
USERNAME = class="hl-string">"[YourServiceAccount]"
PASSWORD = class="hl-string">"[YourPassword]"
CLIENT_NAMESPACE = class="hl-string">"[YourClientNamespace]"

class=class="hl-string">"hl-comment"># Date range for extraction (YYYY-MM-DD)
START_DATE = class="hl-string">"2023-01-01"
END_DATE = class="hl-string">"2023-04-01"

class=class="hl-string">"hl-comment"># Output file
OUTPUT_FILE = class="hl-string">"dayforce_payroll_event_log.csv"

class=class="hl-string">"hl-comment"># ==========================================
class=class="hl-string">"hl-comment"># HELPER FUNCTIONS
class=class="hl-string">"hl-comment"># ==========================================

def get_auth_session():
    session = requests.Session()
    session.auth = (USERNAME, PASSWORD)
    session.headers.update({class="hl-string">"Content-Type": class="hl-string">"application/json"})
    return session

def fetch_paginated_data(session, endpoint, params=None):
    all_records = []
    url = fclass="hl-string">"{API_BASE_URL}/{endpoint}"
    
    while url:
        try:
            response = session.get(url, params=params)
            if response.status_code == 429:
                time.sleep(2)  class=class="hl-string">"hl-comment"># Simple backoff
                continue
            
            response.raise_for_status()
            data = response.json()
            
            if class="hl-string">'Data' in data:
                all_records.extend(data[class="hl-string">'Data'])
            
            class=class="hl-string">"hl-comment"># Handle Pagination (Paging.Next is typical Dayforce pattern)
            url = data.get(class="hl-string">'Paging', {}).get(class="hl-string">'Next')
            if url and not url.startswith(class="hl-string">'http'):
                class=class="hl-string">"hl-comment"># Sometimes generic Next link needs base url reconstruction
                pass 
            elif not url:
                break
                
        except Exception as e:
            print(fclass="hl-string">"Error fetching {url}: {e}")
            break
            
    return all_records

class=class="hl-string">"hl-comment"># ==========================================
class=class="hl-string">"hl-comment"># EXTRACTION LOGIC
class=class="hl-string">"hl-comment"># ==========================================

def extract_payroll_process():
    session = get_auth_session()
    event_log = []

    print(class="hl-string">"Fetching Pay Summaries...")
    class=class="hl-string">"hl-comment"># In Dayforce, EmployeePaySummary contains the core payroll results
    pay_params = {
        class="hl-string">"filterUpdateStart": START_DATE,
        class="hl-string">"filterUpdateEnd": END_DATE
    }
    pay_records = fetch_paginated_data(session, class="hl-string">"EmployeePaySummary", params=pay_params)

    print(fclass="hl-string">"Processing {len(pay_records)} pay records...")

    for record in pay_records:
        class=class="hl-string">"hl-comment"># Identify the Case
        emp_id = record.get(class="hl-string">'EmployeeXRefCode', class="hl-string">'Unknown')
        pay_period = record.get(class="hl-string">'PayPeriodStartDate', class="hl-string">'').split(class="hl-string">'T')[0]
        case_id = fclass="hl-string">"{emp_id}_{pay_period}"
        
        class=class="hl-string">"hl-comment"># Common Attributes
        common_attrs = {
            class="hl-string">"PayrollRecordId": case_id,
            class="hl-string">"SourceSystem": class="hl-string">"Ceridian Dayforce",
            class="hl-string">"PayGroupName": record.get(class="hl-string">'PayGroupXRefCode', class="hl-string">''),
            class="hl-string">"DepartmentName": record.get(class="hl-string">'OrgUnitXRefCode', class="hl-string">''),
            class="hl-string">"GrossPayAmount": record.get(class="hl-string">'GrossPay', 0.0),
            class="hl-string">"LastDataUpdate": datetime.now().isoformat()
        }

        class=class="hl-string">"hl-comment"># --------------------------------------
        class=class="hl-string">"hl-comment"># 1. Payroll Record Initialized
        class=class="hl-string">"hl-comment"># --------------------------------------
        class=class="hl-string">"hl-comment"># Based on Pay Period Start as a proxy for initialization in system
        if record.get(class="hl-string">'PayPeriodStartDate'):
            event_log.append({
                **common_attrs,
                class="hl-string">"ActivityName": class="hl-string">"Payroll Record Initialized",
                class="hl-string">"EventDateTime": record[class="hl-string">'PayPeriodStartDate'],
                class="hl-string">"ActionUser": class="hl-string">"System Scheduler"
            })

        class=class="hl-string">"hl-comment"># --------------------------------------
        class=class="hl-string">"hl-comment"># 2. Time Sheet Activities (Simulated)
        class=class="hl-string">"hl-comment"># --------------------------------------
        class=class="hl-string">"hl-comment"># In a real scenario, you would query the EmployeeTimesheet endpoint.
        class=class="hl-string">"hl-comment"># Here we approximate based on the period end date.
        period_end = record.get(class="hl-string">'PayPeriodEndDate')
        if period_end:
            dt_end = datetime.strptime(period_end.split(class="hl-string">'T')[0], class="hl-string">"%Y-%m-%d")
            
            class=class="hl-string">"hl-comment"># Time Sheet Submitted (Usually day after period end)
            event_log.append({
                **common_attrs,
                class="hl-string">"ActivityName": class="hl-string">"Time Sheet Submitted",
                class="hl-string">"EventDateTime": (dt_end + timedelta(days=1)).isoformat() + class="hl-string">"T09:00:00",
                class="hl-string">"ActionUser": class="hl-string">"Employee"
            })

            class=class="hl-string">"hl-comment"># Time Sheet Approved (Usually 2 days after period end)
            event_log.append({
                **common_attrs,
                class="hl-string">"ActivityName": class="hl-string">"Time Sheet Approved",
                class="hl-string">"EventDateTime": (dt_end + timedelta(days=2)).isoformat() + class="hl-string">"T14:00:00",
                class="hl-string">"ActionUser": class="hl-string">"Manager"
            })

        class=class="hl-string">"hl-comment"># --------------------------------------
        class=class="hl-string">"hl-comment"># 3. Calculation Activities
        class=class="hl-string">"hl-comment"># --------------------------------------
        class=class="hl-string">"hl-comment"># Derived from the LastCalculated Timestamp in the record
        calc_time = record.get(class="hl-string">'LastCalculatedDateTime')
        if calc_time:
            class=class="hl-string">"hl-comment"># Gross Pay Calculated
            event_log.append({
                **common_attrs,
                class="hl-string">"ActivityName": class="hl-string">"Gross Pay Calculated",
                class="hl-string">"EventDateTime": calc_time,
                class="hl-string">"ActionUser": class="hl-string">"Calculation Engine"
            })
            
            class=class="hl-string">"hl-comment"># Benefits Deductions Applied (Sequence + 1 second)
            calc_dt = datetime.fromisoformat(calc_time.replace(class="hl-string">'Z', class="hl-string">'+00:00'))
            event_log.append({
                **common_attrs,
                class="hl-string">"ActivityName": class="hl-string">"Benefits Deductions Applied",
                class="hl-string">"EventDateTime": (calc_dt + timedelta(seconds=1)).isoformat(),
                class="hl-string">"ActionUser": class="hl-string">"Calculation Engine"
            })

            class=class="hl-string">"hl-comment"># Taxes Calculated (Sequence + 2 seconds)
            event_log.append({
                **common_attrs,
                class="hl-string">"ActivityName": class="hl-string">"Taxes Calculated",
                class="hl-string">"EventDateTime": (calc_dt + timedelta(seconds=2)).isoformat(),
                class="hl-string">"ActionUser": class="hl-string">"Calculation Engine"
            })
            
            class=class="hl-string">"hl-comment"># Payroll Result Previewed (Assume preview happens shortly after calc)
            event_log.append({
                **common_attrs,
                class="hl-string">"ActivityName": class="hl-string">"Payroll Result Previewed",
                class="hl-string">"EventDateTime": (calc_dt + timedelta(minutes=30)).isoformat(),
                class="hl-string">"ActionUser": class="hl-string">"Payroll Analyst"
            })

        class=class="hl-string">"hl-comment"># --------------------------------------
        class=class="hl-string">"hl-comment"># 4. Exceptions & Corrections
        class=class="hl-string">"hl-comment"># --------------------------------------
        class=class="hl-string">"hl-comment"># Check if Net Pay is negative or zero (simple logic)
        if record.get(class="hl-string">'NetPay', 0) <= 0:
            event_log.append({
                **common_attrs,
                class="hl-string">"ActivityName": class="hl-string">"Audit Exception Flagged",
                class="hl-string">"EventDateTime": calc_time if calc_time else period_end,
                class="hl-string">"ActionUser": class="hl-string">"System Validator"
            })

        class=class="hl-string">"hl-comment"># Check if record was recalculated multiple times (Logic: Calc Time > Commit Time)
        class=class="hl-string">"hl-comment"># Note: API might not expose revision count directly without deep audit log
        class=class="hl-string">"hl-comment"># We will simulate a class="hl-string">'Data Correction' if an class="hl-string">'Import' flag is present
        if record.get(class="hl-string">'IsImported', False):
             event_log.append({
                **common_attrs,
                class="hl-string">"ActivityName": class="hl-string">"Incentive Data Imported",
                class="hl-string">"EventDateTime": record.get(class="hl-string">'PayPeriodStartDate'), class=class="hl-string">"hl-comment"># Proxy
                class="hl-string">"ActionUser": class="hl-string">"Interface"
            })
             class=class="hl-string">"hl-comment"># Assume correction happened if imported data exists
             event_log.append({
                **common_attrs,
                class="hl-string">"ActivityName": class="hl-string">"Data Correction Performed",
                class="hl-string">"EventDateTime": (datetime.fromisoformat(record[class="hl-string">'PayPeriodEndDate'].split(class="hl-string">'T')[0]) + timedelta(days=3)).isoformat() + class="hl-string">"T10:00:00",
                class="hl-string">"ActionUser": class="hl-string">"Payroll Admin"
            })

        class=class="hl-string">"hl-comment"># --------------------------------------
        class=class="hl-string">"hl-comment"># 5. Finalization & Payment
        class=class="hl-string">"hl-comment"># --------------------------------------
        class=class="hl-string">"hl-comment"># Commit Timestamp (Approval)
        commit_time = record.get(class="hl-string">'CommitDateTime')
        if commit_time:
            event_log.append({
                **common_attrs,
                class="hl-string">"ActivityName": class="hl-string">"Payroll Record Approved",
                class="hl-string">"EventDateTime": commit_time,
                class="hl-string">"ActionUser": class="hl-string">"Payroll Manager"
            })
            
            class=class="hl-string">"hl-comment"># Bank Transfer File (Usually 2 hours after approval)
            commit_dt = datetime.fromisoformat(commit_time.replace(class="hl-string">'Z', class="hl-string">'+00:00'))
            event_log.append({
                **common_attrs,
                class="hl-string">"ActivityName": class="hl-string">"Bank Transfer File Generated",
                class="hl-string">"EventDateTime": (commit_dt + timedelta(hours=2)).isoformat(),
                class="hl-string">"SlaProcessingDeadline": (commit_dt + timedelta(hours=4)).isoformat(),
                class="hl-string">"ActionUser": class="hl-string">"System Batch"
            })

        class=class="hl-string">"hl-comment"># Payment Executed (Check Date)
        check_date = record.get(class="hl-string">'CheckDate')
        if check_date:
            event_log.append({
                **common_attrs,
                class="hl-string">"ActivityName": class="hl-string">"Payment Executed",
                class="hl-string">"EventDateTime": check_date + class="hl-string">"T12:00:00",
                class="hl-string">"ActionUser": class="hl-string">"System Payment"
            })
            
            class=class="hl-string">"hl-comment"># Pay Slip Published (Same as Check Date usually)
            event_log.append({
                **common_attrs,
                class="hl-string">"ActivityName": class="hl-string">"Pay Slip Published",
                class="hl-string">"EventDateTime": check_date + class="hl-string">"T08:00:00",
                class="hl-string">"ActionUser": class="hl-string">"ESS Portal"
            })

            class=class="hl-string">"hl-comment"># Tax Filing Completed (Usually 3 days after check date)
            check_dt = datetime.strptime(check_date.split(class="hl-string">'T')[0], class="hl-string">"%Y-%m-%d")
            event_log.append({
                **common_attrs,
                class="hl-string">"ActivityName": class="hl-string">"Tax Filing Completed",
                class="hl-string">"EventDateTime": (check_dt + timedelta(days=3)).isoformat() + class="hl-string">"T17:00:00",
                class="hl-string">"ActionUser": class="hl-string">"Compliance Job"
            })

    class=class="hl-string">"hl-comment"># ==========================================
    class=class="hl-string">"hl-comment"># EXPORT
    class=class="hl-string">"hl-comment"># ==========================================
    df = pd.DataFrame(event_log)
    if not df.empty:
        class=class="hl-string">"hl-comment"># Ensure columns are sorted and dates formatted
        df = df.sort_values(by=[class="hl-string">'PayrollRecordId', class="hl-string">'EventDateTime'])
        df.to_csv(OUTPUT_FILE, index=False)
        print(fclass="hl-string">"Successfully exported {len(df)} events to {OUTPUT_FILE}")
    else:
        print(class="hl-string">"No data found for the specified criteria.")

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

始めてみませんか？

このテンプレートを給与データに適用して、今日から改善に取り組みましょう。データ抽出の手順や、分析に適したデータの準備について、チームがサポートいたします。

改善ガイドに戻る

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

給与処理の遅延を防ぎ、今すぐ改善

給与処理のサイクル時間を30％短縮し、ボトルネックを解消します。

無料トライアルを開始

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

給与処理データテンプレート

給与処理データテンプレート

給与処理の属性

給与処理のアクティビティ

データ抽出ガイド

Dayforceのアドホックレポートから給与データをエクスポート

ステップ

設定

クエリの例 json

Dayforce REST APIを使ったPythonスクリプトによるデータ抽出

ステップ

設定

クエリの例 python

始めてみませんか？

給与処理の遅延を防ぎ、今すぐ改善