> 継続的なプロセス改善 > 採用から退職までのポジション管理 > SAP SuccessFactors Employee Central > データテンプレート

採用から退職までのポジション管理用データテンプレート

SAP SuccessFactors Employee Central

採用から退職までのポジション管理の属性(19) 採用から退職までのポジション管理のアクティビティ(13) データ抽出ガイド(3)

採用から退職までのポジション管理用データテンプレート

このテンプレートでは、採用から退職までのポジション管理プロセスを分析するために必要なデータの収集方法を説明します。収集する属性、追跡する主要なアクティビティ、データ抽出の手順をまとめています。プロセスマイニングを円滑に進めるために、必要な情報を漏れなく収集する際にお役立てください。

収集を推奨する属性
追跡する主要なアクティビティ
SAP SuccessFactors Employee Centralからのデータ抽出ガイド

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

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

採用から退職までのポジション管理の属性

採用から退職までのポジション管理を詳しく分析するために、イベントログに含めることを推奨するデータ項目です。

5 必須 5 推奨 9 任意

	名前	説明
	アクティビティ名 ActivityName	職位に関して特定の時点で発生した業務イベントの名称です。
説明この属性は、「職位申請の開始」「人事システムでの職位作成」「職位の無効化」など、職位管理のライフサイクルにおける特定のステップや節目を示します。各アクティビティは、プロセス内の個別のイベントを表します。アクティビティの順序や頻度の分析は、プロセスマイニングの中心となるものです。プロセスマップを可視化し、一般的なプロセス経路や別の経路（バリアント）を特定できます。また、ステップ間の遅延や手戻りが発生する箇所も把握できます。プロセスが実際にどのように進んでいるかを理解するうえで欠かせません。重要な理由プロセスの各ステップを定義し、プロセスマップの可視化やワークフロー、ボトルネック、逸脱の分析を可能にします。入手先通常は、SAP SuccessFactors Employee Central内のイベントログ、ステータス変更レコード、監査証跡から取得します。技術的なイベントコードやステータスの遷移を、ユーザーにわかりやすい名称に対応付ける必要がある場合があります。例職位申請の開始人事システムでの職位作成職位属性の変更職位の無効化
	イベント時刻 EventTime	特定のアクティビティが発生した時刻を示すタイムスタンプです。
説明イベント時刻には、アクティビティが実行またはシステムに記録された正確な日時が記録されます。職位のライフサイクルにおける各イベントの順序を把握できます。このタイムスタンプは、プロセスマイニングにおける時間ベースの分析に欠かせません。アクティビティ間のサイクルタイムやプロセス全体の所要時間の算出、ステップ間にかかった時間の分析によるボトルネックの特定、経時的なパフォーマンスの傾向把握に使います。正確なタイムスタンプがなければ、プロセスを分析できません。重要な理由イベントの時系列を示す属性です。サイクルタイムの算出、ボトルネックの特定、プロセスのパフォーマンス把握に欠かせません。入手先 SAP SuccessFactorsの職位管理に関する監査ログやトランザクションレコードにある、イベントまたはステータス変更の作成日や最終変更日に対応します。例 2023-04-15T09:00:00Z2023-04-15T14:30:15Z2023-05-01T11:20:00Z
	職位ID PositionId	組織内の職位を一意に識別するIDで、職位管理プロセスにおける主なケース識別子です。
説明職位IDは、1つの職位に関連するすべてのアクティビティとデータを結び付けます。最初の申請や作成から、変更、再分類、最終的な無効化や終了まで、職位のライフサイクル全体を追跡できます。プロセスマイニングでは、一意の職位IDが1つのケースに対応します。このIDを使ってプロセスを分析すると、職位の全体的な流れを把握し、ライフサイクル全体の所要時間を測定するとともに、開始から終了までに影響するパターンやボトルネックを特定できます。プロセスマップの作成やケース単位のKPIの算出に欠かせない属性です。重要な理由関連するすべてのイベントを結び付けるケース識別子です。職位のライフサイクル全体を追跡し、プロセスの流れを分析できます。入手先 SAP SuccessFactors Employee Centralの職位管理モジュールにおける主要な項目で、通常は職位オブジェクトにあります。例 POS-1002345POS-1002346POS-2039871
	ソースシステム SourceSystemId	データの抽出元となるシステムです。
説明イベントデータの発生元となるソースシステムを示す属性です。このプロセスでは、常にSAP SuccessFactors Employee Centralが該当します。単一のソースシステムを使う場合は不要に見えるかもしれませんが、データガバナンスやコンテキストの維持に欠かせない項目です。特に複数のシステムからデータを統合する環境では、データの出所を明確にできます。重要な理由データの出所を明確にします。データガバナンスやトラブルシューティングに欠かせず、複数のデータソースを扱う場合にも役立ちます。入手先通常は、データ変換の際にデータセットの出所を示す固定値として追加します。例 SAP SuccessFactors Employee Central
	最終データ更新日時 LastDataUpdateTime	ソースシステムからデータを最後に更新または抽出した時刻です。
説明プロセスマイニングツールで、プロセスのデータが最後に更新された時刻を示す属性です。分析対象データの鮮度を表します。分析がどの時点の情報に基づいているかを把握し、データの更新時期に関する認識をそろえるうえで重要です。ダッシュボードやレポートに欠かせないメタデータです。重要な理由データの鮮度を把握できます。分析や意思決定を最新の情報に基づいて行うために重要です。入手先データ抽出・変換パイプラインの実行時に生成されるタイムスタンプです。例 2023-10-27T08:00:00Z
	イベント終了時刻 EventEndTime	特定のアクティビティが完了した時刻を示すタイムスタンプです。
説明イベント終了時刻は、アクティビティの完了時刻を示します。多くのシステムでは、アクティビティを時点として記録するため、その場合は終了時刻と開始時刻が同じになります。一方、実際に作業を行う承認ステップなど、所要時間を測定できるアクティビティでは、このフィールドに完了時刻が記録されます。この属性は、個々のアクティビティの処理時間を算出するうえで欠かせません。アクティビティ間の待ち時間と、アクティビティ自体にかかる処理時間を区別できるため、プロセスの効率をより詳しく把握できます。重要な理由アクティビティの処理時間を算出し、Taskに取り組んでいる時間と次のステップを待つ時間を区別できます。入手先この情報は監査ログに記録されている場合がありますが、推定が必要なこともあります。単一の時点で発生するイベントでは、開始時刻と同じになることがよくあります。例 2023-04-15T09:05:12Z2023-04-15T14:45:00Z2023-05-01T11:20:00Z
	ユーザーID UserId	アクティビティを実行したユーザーの識別子です。
説明この属性には、職位申請を承認したマネージャーや、システムに職位を登録した人事管理者など、特定のイベントを実行した従業員またはシステムユーザーの一意のIDが記録されます。ユーザーIDで分析すると、業務負荷の分布や高い成果を上げているユーザーを把握し、研修が必要なユーザーを特定できます。また、リソース分析やコンプライアンスチェックにも役立ちます。システムアカウントやサービスアカウントが実行したアクティビティを特定すれば、自動化の有無も確認できます。重要な理由プロセスのアクティビティを特定のユーザーに関連付け、業務負荷やパフォーマンスの分析、自動化の特定に役立てられます。入手先通常は、SAP SuccessFactorsの職位オブジェクトに関する監査ログやトランザクションデータの「変更者」または「ユーザー」フィールドに記録されています。例 c.bakerj.smithSYSTEM_USER
	承認者ID ApproverId	承認アクティビティに関与したマネージャーまたは承認者の識別子です。
説明この属性は、「ポジション申請をマネージャーが承認」や「ポジション申請を人事が承認」など、承認ステップを実行したユーザーを特定します。承認タスクに固有の情報であり、一般的なユーザーIDとは異なります。承認者ごとの承認時間を分析すると、プロセスのボトルネックとなっている人や、優れた実践例となるほど迅速に承認している人を特定できます。また、「部門承認のボトルネック」ダッシュボードをより細かく分析できます。重要な理由承認者ごとに承認ステップを詳しく分析できるため、個々の承認者レベルでボトルネックや優れた実績を特定できます。入手先この情報は、ポジション申請のトランザクションに関連付けられたSAP SuccessFactorsのワークフローまたは承認ログのデータに保存されます。例 m.joness.patele.williams
	職位ステータス PositionStatus	イベント発生時点での職位のステータスです。
説明この属性は、「採用予定」「充足」「凍結」「廃止」など、職位の状態を示します。プロセス内の特定のアクティビティに伴って、ステータスが変わることがあります。職位のステータスが時間とともにどう変化するかを分析することは、職位のライフサイクルを理解し、ステータスが一貫して使われているか確認するうえで重要です。「職位ステータス遷移分析」ダッシュボードでは、この属性を使って標準外のプロセス経路を特定し、定められたステータスモデルへの適合性を確認します。職位が特定の状態にとどまる期間を把握する際にも役立ちます。重要な理由ステータスの変更を追跡すると、職位のライフサイクルやプロセスの適合性を分析し、各状態に職位がとどまる期間を把握できます。入手先 SAP SuccessFactors Employee Centralの職位オブジェクトにあるステータスフィールドに対応します。例採用予定充足凍結廃止
	部門 DepartmentName	職位が属する部門の名称です。
説明この属性は、職位が属する組織内の部門を示します。例として、「財務」「営業」「情報技術」などがあります。部門は比較分析の重要な切り口です。たとえば、部門間で職位の承認時間を比較するなど、組織内の各部門のプロセスパフォーマンスを比較できます。「部門別承認ボトルネック」ダッシュボードに欠かせない属性であり、特定の部門における非効率な点や優れた取り組みの特定にも役立ちます。重要な理由事業部門ごとのパフォーマンス比較やボトルネック分析ができ、特定の領域に固有の問題を把握できます。入手先 SAP SuccessFactors Employee Centralの職位オブジェクトに標準で用意されている属性です。例財務北米営業研究開発
	ポジション承認時間 PositionApprovalCycleTime	ポジション申請の開始から人事による承認までにかかる合計時間です。
説明新しいポジションの承認段階全体にかかる時間を測定する、算出済みのKPIです。ケース単位で、「ポジション申請を開始」と「ポジション申請を人事が承認」の各イベント間の時間差を算出します。この属性は「平均ポジション承認時間」KPIを直接測定し、「ポジション承認サイクルタイム」ダッシュボードの主要指標となります。組織の対応力と、採用プロセスの初期段階の効率を測る重要な指標です。重要な理由ポジション承認ワークフローの効率を直接測定する重要業績評価指標です。遅延の追跡と削減に役立ちます。入手先この指標は、プロセスマイニングプラットフォームまたはデータ変換レイヤーで、関連するアクティビティのタイムスタンプを使ってケース単位で算出します。例 P3D4H30MP10DP1DT12H
	予算承認状況 BudgetApprovalStatus	ポジション申請の予算承認状況です。
説明この属性は、新しいポジションの財務承認状況を記録します。「保留中」「承認済み」「却下」などの値が設定され、財務承認のステップを追跡するために使われます。この状況は、「予算承認サイクルタイム」のKPIの算出や、「ポジション予算承認期間」ダッシュボードに欠かせません。プロセスのうち財務承認にあたる部分を切り分けることで、ポジション作成の大きなボトルネックとなり得る予算関連の遅延を重点的に分析できます。重要な理由予算承認段階の分析に直接役立ち、新しいポジションの財務承認にかかる遅延の特定と削減につながります。入手先この情報はSAP SuccessFactorsのポジション申請ワークフローのデータに含まれ、特定の承認ステップの状況として記録されると考えられます。例財務部門の承認待ち承認済み却下
	事業部門 BusinessUnitName	ポジションに関連付けられた事業部門です。
説明この属性は、ポジションが属する上位の事業部門または組織単位を示します。部門より上位の階層にあたる場合があります。部門と同様に、事業部門は全社的な比較分析の切り口となります。経営層は、「消費財」と「エンタープライズソフトウェア」など、事業の主要な領域ごとにポジション管理の効率を比較できます。重要な理由部門をまたいだプロセスパフォーマンスの比較を可能にし、プロセス指標を戦略上の事業部門に関連付けるのに役立ちます。入手先 SAP SuccessFactorsのPositionオブジェクトで利用できる、標準的な組織構造の属性です。例消費財エンタープライズソフトウェアグローバルサービス
	初回で正しく完了したか IsFirstTimeRight	ポジションが作成直後に変更されることなく、最初から正しく作成されたかを示すフラグです。
説明この算出属性は、真偽値（true／false）のフラグです。「人事システムでポジションを作成」アクティビティの後、あらかじめ定めた短い期間（例：24時間以内）に「ポジション属性を変更」アクティビティが発生したかを確認します。変更がなければ「true」として記録されます。この属性は「初回正確作成率」KPIの測定に直接役立ちます。初回入力の誤りや不足によってすぐに手戻りが発生したケースを明らかにし、データ品質とプロセスの有効性を測定します。初回正確作成率が低い場合は、トレーニング、システムの使いやすさ、データ検証ルールに問題がある可能性があります。重要な理由ポジション作成プロセスの品質を測定し、入力時点での手戻りやデータ品質の問題を明らかにします。入手先 Position IDごとのイベント順序を分析し、データ変換時に算出する真偽値フラグです。例 truefalse
	国 CountryCode	ポジションが所在する国です。
説明この属性は、ポジションの所在地に関連付けられた国を示します。分析における重要な地理的切り口です。国別にプロセスを分析すると、効率、コンプライアンス要件、プロセスの実行状況における地域差を把握できます。たとえば、現地の労働規制や労使協議会の関与により、ある国ではポジションの承認に大幅な時間がかかる場合があります。こうした分析は、所在地に固有のプロセスの違いを理解し、対処するのに役立ちます。重要な理由地域ごとのプロセスパフォーマンスの違いを分析できます。地域差には、現地の規制や慣行が影響している場合があります。入手先 SAP SuccessFactorsのPositionオブジェクトに関連付けられた所在地情報の一部です。例 USADEUINDGBR
	変更された属性 ModifiedAttribute	変更されたポジションの属性またはフィールドです。
説明「ポジション属性を変更」アクティビティが発生したとき、このフィールドには変更された属性が記録されます。例：「部門」「職位名」「上司」などです。「ポジション属性変更頻度」ダッシュボードの分析に欠かせない詳細情報です。変更があったことだけでなく、どの項目が頻繁に変更されているかを分析できます。特定の属性の変更が多い場合、その定義が不明確であるか、そのフィールドの初期データが誤っていることが多い可能性があります。重要な理由変更イベントの詳細を補い、変動が大きい、またはエラーが発生しやすいデータ項目を特定できます。入手先この情報は、フィールド単位の変更を記録し、変更前後の値を示すSAP SuccessFactorsの詳細な監査ログから取得できます。例部門上司原価センター職位名
	変更理由 ChangeReason	職位の変更または再分類の理由です。
説明職位を変更または再分類する際、ユーザーが変更理由を入力することがあります。この属性には、「組織再編」「職務範囲の変更」「年次レビュー」などの理由が記録されます。根本原因の分析に欠かせない属性です。再分類や属性変更などのイベントが発生した理由を把握できます。変更理由の頻度を分析すると、当初の職務記述が不明確だった、組織変更が頻繁に行われているといった根本的な問題を特定できます。これは「職位再分類分析」ダッシュボードの主な目的の1つです。重要な理由再分類や変更が発生する理由を説明する業務上のコンテキストを示し、根本原因の分析に役立ちます。入手先通常は、SAP SuccessFactorsで職位オブジェクトを変更するトランザクションの「理由」または「コメント」フィールドに記録されます。例組織再編範囲変更年次レビュー
	職位名 PositionTitle	職位に設定された正式な役職名です。
説明この属性には、職位の役職名が記録されます。例として、「シニア財務アナリスト」「ソフトウェアエンジニアII」などがあります。職位名はプロセスの流れを左右する主な要因ではありませんが、重要な業務上のコンテキストを示します。特定の職種に絞った分析や、特定の役職名と作成サイクルタイムの長さ、変更頻度との関係の確認に利用できます。分析に業務上わかりやすい情報を加えられます。重要な理由業務上のコンテキストを把握でき、特定の職種や職位レベルで分析を絞り込んだり、分類したりできます。入手先 SAP SuccessFactors Employee Centralの職位オブジェクトに標準で用意されている属性で、多くの場合、職種分類と関連付けられています。例シニア財務アナリストソフトウェアエンジニアIIマーケティングコーディネーター
	職種ファミリー PositionJobFamily	職位が属する職種ファミリーまたは職能領域です。
説明職種ファミリーは、関連する職種を「エンジニアリング」「財務」「人事」などのグループに分類したものです。個々の職位名よりも大きな単位で職種をまとめます。この属性は、「職位再分類分析」ダッシュボードに欠かせません。職位が職種ファミリー間で再分類される頻度を追跡し、傾向を特定できます。たとえば、「ITサポート」から「サイバーセキュリティ」への再分類が多い場合、組織の戦略が変化している可能性があります。重要な理由再分類の傾向を分析し、職能レベルで組織構造の変化を把握するうえで重要な属性です。入手先 SAP SuccessFactorsの職位オブジェクトに関連付けられた職種分類構造の一部です。例エンジニアリング財務人事

必須推奨任意

採用から退職までのポジション管理のアクティビティ

正確にプロセスを把握するため、イベントログに記録する主要なプロセスステップとマイルストーンです。

6 推奨 7 任意

	アクティビティ	説明
	人事システムでの職位作成	SAP SuccessFactors Employee Centralに職位レコードが正式に作成されたことを示すアクティビティです。職位MDFオブジェクトの監査証跡または履歴から、作成時刻を使って明示的に取得します。
重要な理由職位が正式に登録されたことを示す基本的な節目です。「職位作成サイクルタイム」KPIでは、申請開始からこのイベントまでの時間を測定し、プロセス全体の効率を把握します。入手先対象の職位IDに対応する職位メタデータフレームワーク（MDF）オブジェクトの監査履歴にある「作成日時」または「作成日」システムフィールドから取得します。記録職位オブジェクトのレコードにある作成時刻から取得します。イベントタイプ explicit
	人事部門による職位申請の承認	人事部門が職位申請を承認したことを示すアクティビティです。承認ワークフローのステップが完了した時点で記録される、重要な節目です。
重要な理由人事部門による最終承認は、多くの場合、予算の割り当てやシステムへの登録に先立つ主要な承認段階の締めくくりです。この段階に到達するまでの時間は、「職位承認時間の平均」KPIを測定するうえで重要です。入手先職位申請に関連するワークフローログから取得します。人事担当者が割り当てられた承認ステップを完了した時刻が、このイベントに対応します。記録人事部門の承認者がワークフローのステップを完了したときに記録されます。イベントタイプ explicit
	職位の有効化	新しく作成された職位が有効になり、人員配置や採用に利用できる状態になったことを示します。通常、職位のステータスフィールドが「アクティブ」に変更されたことから判定します。
重要な理由有効化は、採用を開始する前の最終ステップです。作成から有効化までの時間を追跡すると、職位を募集可能な状態にするまでの遅れを特定できます。入手先職位MDFオブジェクトの履歴で「ステータス」または「有効ステータス」フィールドの変更を追跡して判定します。「アクティブ」への変更時刻がイベントの時刻となります。記録職位のステータスフィールドが「アクティブ」に変更されたことから判定します。イベントタイプ inferred
	職位の終了	職位のライフサイクルにおける最終イベントで、職位が恒久的に終了または廃止されたことを示します。通常、職位のステータスが「終了」や「廃止」などの最終状態に変更されたことから判定します。
重要な理由このアクティビティはプロセスの明確な終点となり、エンドツーエンドのサイクルタイムを正確に分析できます。職位が正式に廃止されたことを確認できます。入手先職位MDFオブジェクトの履歴で「ステータス」フィールドの変更を追跡して判定します。「終了」または「廃止」への変更時刻がイベントの時刻となります。記録職位のステータスが最終状態に変更されたことから判定します。イベントタイプ inferred
	職位申請の却下	承認ワークフローのどの段階で職位申請が却下されたかを示すイベントです。承認者が「却下」または「差し戻し」を選択すると、ワークフローエンジンに明示的に記録されます。
重要な理由却下は、申請データ、予算、申請理由などに問題があることを示す重要なプロセス逸脱です。却下理由を分析すると、今後の申請の質を高められます。入手先職位申請に関連するワークフローログデータから取得します。ワークフローステップが「却下」ステータスで完了したことを示します。記録承認者がワークフローのステップを却下したときに記録されます。イベントタイプ explicit
	職位申請の開始	このイベントは、ユーザーが新しい職位の作成を正式に申請した時点を示し、職位管理プロセスの開始となります。SAP SuccessFactorsで職位作成ワークフローが開始されると、明示的に記録されます。
重要な理由このイベントは、プロセスの主な開始イベントです。このアクティビティから職位の承認や作成などの後続イベントまでの時間を分析することで、プロセス全体の効率を測定できます。入手先職位申請に関連するワークフローインスタンスの開始時に、このイベントが記録されます。データは、職位オブジェクトに関連付けられたWfRequestなどのワークフロー申請テーブルで確認できます。記録新しい職位ワークフローの開始時に記録されます。イベントタイプ explicit
	コンプライアンスの職位レビュー	職位が社内方針や外部規制に準拠しているかを確認するため、定期的または特定の事象を契機に行うレビューです。このイベントの取得方法は、カスタムワークフローやMDFオブジェクトなど、お客様ごとの設定によって大きく異なります。
重要な理由このアクティビティは、組織のコンプライアンスを監視し、確保するうえで欠かせません。「職位レビューのコンプライアンス率」などのKPIに直接関係し、リスクの軽減にも役立ちます。入手先システムの分析が必要です。職位に関連付けられたカスタムMDFオブジェクト、カスタムワークフローのステータス更新、または添付ファイルのログから取得できる場合があります。記録カスタム実装に依存します。カスタムMDFオブジェクトのエントリから取得できる可能性があります。イベントタイプ explicit
	マネージャーによる職位申請の承認	通常は採用マネージャーまたはラインマネージャーが行う、最初の承認段階の完了を示します。職位管理ワークフローのステップが完了すると、明示的に記録されます。
重要な理由マネージャーの承認時間を追跡すると、特定の部門や管理職層におけるボトルネックを特定できます。承認サイクルの初期段階を把握するうえで重要な節目です。入手先対象の職位申請に関するワークフローログデータに、ステップ完了イベントとして記録されます。承認者のロールと、ワークフローステップの「承認済み」ステータスから特定できます。記録ユーザーがワークフローの承認ステップを完了したときに記録されます。イベントタイプ explicit
	職位の再分類	職位コードや職種ファミリーの変更など、職位の基本的な定義が大きく変わったことを示すアクティビティです。職位MDFオブジェクトの「職位コード」または「職種分類」フィールドの変更から判定します。
重要な理由再分類の頻度が高い場合、当初の職務設計に問題があるか、事業上のニーズが変化している可能性があります。再分類を追跡すると、組織構造の安定性を分析できます。入手先職位MDFオブジェクトの監査履歴を確認し、「jobCode」などの主要な分類フィールドの変更から判定します。変更時刻がイベントの時刻となります。記録職位オブジェクトの「jobCode」フィールドの変更から判定します。イベントタイプ inferred
	職位の凍結・一時停止	職位が一時的に保留され、人員配置に利用できない状態になったことを示します。職位のステータスフィールドが「凍結」や「一時停止」などに変更されたことから判定します。
重要な理由このアクティビティの後に、無効化や終了が行われることがよくあります。職位が凍結されたままの期間を分析すると、人員計画や人員数の管理を改善できます。入手先職位MDFオブジェクトの履歴で「ステータス」フィールドの変更を追跡して判定します。「凍結」または同様の値への変更時刻がイベントの時刻となります。記録職位のステータスフィールドが「凍結」に変更されたことから判定します。イベントタイプ inferred
	職位の無効化	職位が正式に無効化され、利用できなくなったことを示します。職位のステータスが「非アクティブ」または「無効化」に変更されたことから判定します。
重要な理由職位を廃止するプロセスの重要なステップです。一時停止から無効化までの時間を追跡することは、「職位無効化リードタイム」KPIの測定に欠かせません。入手先職位MDFオブジェクトの監査履歴を確認し、「ステータス」または「有効ステータス」フィールドが「非アクティブ」に変更された時点から判定します。記録職位のステータスフィールドが「非アクティブ」に変更されたことから判定します。イベントタイプ inferred
	職位予算の承認	財務部門または予算責任者が、新しい職位に関する予算を承認したことを示します。通常はワークフロー内の明示的なステップで、マネージャーと人事部門の承認後に行われます。
重要な理由予算承認の遅れは、採用プロセスを大きく停滞させることがあります。このアクティビティを切り分けて分析することで、職位管理における予算承認の段階を改善できます。入手先職位申請のワークフローログから取得します。財務部門の承認ステップが完了した時点に対応し、承認者は通常、「財務」または「予算責任者」のロールで特定されます。記録財務部門の承認者がワークフローのステップを完了したときに記録されます。イベントタイプ explicit
	職位属性の変更	既存の職位の役職名、部門、原価センターなどの属性が変更されたことを示します。職位MDFオブジェクトの監査ログから明示的に取得します。
重要な理由変更が頻繁に発生する場合、データ品質の問題や組織設計の不安定さが考えられます。こうしたイベントを分析すると、「職位属性変更率」や手戻りを測定できます。入手先職位MDFオブジェクトの監査履歴から取得します。「最終変更日」のタイムスタンプとユーザーが記録された各変更が、変更アクティビティを示します。記録職位オブジェクトの監査証跡に、フィールドの変更ごとに記録されます。イベントタイプ explicit

推奨任意

データ抽出ガイド

SAP SuccessFactors Employee Centralからデータを取得する方法

ステップ

Integration Centerを開く：SAP SuccessFactorsにログインします。検索バーでIntegration Centerを検索して開きます。
新しい連携を作成する：「My Integrations」をクリックします。「Create」を選択し、「More Integration Types」を選びます。
初期設定を選択する：
- 連携タイプ：「Scheduled」を選択します。
- ソースタイプ：「SuccessFactors」を選択します。
- 宛先タイプ：「SFTP」を選択します。
- 形式：「CSV」を選択し、「Create」をクリックします。
コアエンティティを設定する：「Configure Fields」タブで「Position」エンティティを検索し、開始エンティティとして選択します。「ProcessMind Position Management Log」など、連携内容がわかる名前を付けます。
「ポジションを作成」イベントを抽出する：これが最初のイベントです。基本のPositionエンティティからフィールドをマッピングします。ActivityNameフィールドには「Set Fixed Value」を選択し、「人事システムでポジションを作成」と入力します。PositionIdをcodeフィールドに、EventTimeをcreatedDateフィールドにマッピングします。
ワークフローイベント（開始、承認、却下）を抽出する：ワークフローイベントを取得するには、ワークフローのデータを結合します。Positionエンティティから「positionWorkOrder」ナビゲーションプロパティを探します。そこからwfRequestNav、続いてwfRequestStepsに移動します。
- エンティティツリーのルートノードを右クリックし、「Add Sibling Element」を選択します。
- 追加した要素で、上記の手順に従ってエンティティをたどります。
- 「ポジション申請を開始」「ポジション申請をマネージャーが承認」などのActivityNameを設定する計算フィールドを作成します。wfRequestStepsエンティティのstepNum（ステップ番号）とstatus（「APPROVED」「REJECTED」）に基づく条件ロジックを使います。
- EventTimeをワークフローステップのcompletedOnフィールドにマッピングします。
状況変更イベント（有効化、無効化など）を抽出する：多くのアクティビティは、有効期間が設定されたPositionレコードの変更から導き出されます。
- Positionエンティティを開始点として、別の兄弟要素を追加します。
- 時計アイコンの付いたレコードを選択して、エンティティの履歴に移動します。これにより、時間の経過に伴う変更を確認できます。
- 特定の状況変更を検出するには、たとえば現在のレコードのstatusが「A」（アクティブ）で、前のレコードの状況が異なる場合に絞り込みます。Integration Centerでは高度な絞り込みもできますが、判定用の計算フィールドが必要になる場合があります。
- 状況変更（有効化、凍結、無効化、終了）ごとに、適切なフィルターと固定値のActivityNameを設定した兄弟要素を作成します。
属性変更イベントを抽出する：Positionの有効期間付き履歴に基づいて、別の兄弟要素を追加します。lastModifiedDateTimeがレポート対象期間内にあるレコードを含める一方、作成や特定の状況変更など、すでに取得した別のイベントに該当するレコードを除外するフィルターを作成します。設定が複雑になる場合があります。ActivityNameには「ポジション属性を変更」を設定します。
宛先設定を行う：「Destination Settings」タブを開きます。ホストアドレス、ポート、ユーザー名、認証情報など、SFTPサーバーの詳細を入力します。ファイル名と出力フォルダーのパスも指定します。
フィルターと並べ替えを設定する：「Filter」タブで、抽出するデータを絞り込む期間フィルターを作成します。差分データを取得するには、PositionオブジェクトのlastModifiedDateTimeで絞り込むことを強く推奨します。初回実行時はcreatedDateで絞り込む方法もあります。時系列順になるよう、PositionId、続いてEventTimeでデータを並べ替えます。
連携をスケジュールする：「Scheduling」タブを開き、ジョブの実行頻度（毎日、毎週など）を指定します。これにより、プロセスマイニング用のデータを最新の状態に保てます。
確認して実行する：最後のタブですべての設定を確認します。テスト実行するか、連携を有効にできます。ジョブが実行されると、指定したSFTPサーバーにCSVファイルが配置され、ProcessMindにアップロードできる状態になります。

設定

連携タイプ：外部向けの定期実行CSVです。定期的にフラットファイルを作成します。
開始エンティティ：主エンティティはPositionです。必要なデータの多くは、Positionから関連エンティティに移動して取得します。対象には、有効期間付きの履歴、ワークフロー申請（wfRequestNav）、基礎オブジェクトなどがあります。
主なフィルター：パフォーマンスを保ち、運用しやすい差分データを作成するには、lastModifiedDateTimeによる絞り込みが欠かせません。初回の履歴データ取得では、過去6～12か月など、期間を定めてcreatedDateで絞り込みます。対象を組織内の関連領域に限定するには、companyまたはbusinessUnitでも絞り込みます。
ページング：データ量が多い場合は、タイムアウトを防ぐため、宛先設定で「Server Side Pagination」を有効にします。パフォーマンステストの結果に応じてページサイズを調整してください。
前提条件：SuccessFactorsインスタンスからアクセスできるSFTPサーバーを設定しておく必要があります。連携を設定するユーザーには、Integration Centerへのアクセス権と、照会するすべてのエンティティ（Position、WfRequest、Userなど）に対するOData APIの権限が必要です。

クエリの例 sql

/*
Integration Center is a UI-based tool. This script represents the logical configuration
of the entities, fields, and filters for each activity within a single integration job.
Each 'BLOCK' would be configured as a sibling element in the Integration Center UI.
*/

// BLOCK 1: Position Created in HR System
// This is the root element of the integration.
ENTITY: Position
FIELDS:
  PositionId = Position.code
  ActivityName = 'Position Created in HR System' (Fixed Value)
  EventTime = Position.createdDate
  SourceSystemId = '[Your SFTP Server Name]' (Fixed Value)
  LastDataUpdateTime = Current Execution Time (System Variable)
  EventEndTime = Position.createdDate
  UserId = Position.createdBy
  DepartmentName = Position.department.name
  PositionStatus = Position.status
  ApproverId = null (Fixed Value)
FILTERS:
  Position.createdDate >= [Start Date]

-- UNION ALL (Configured by adding a sibling element)

// BLOCK 2: Workflow Events (Initiated, Approved, Rejected)
// This single block uses calculated columns to generate multiple event types.
ENTITY: Position -> positionWorkOrder -> wfRequestNav
FIELDS:
  PositionId = Position.code
  ActivityName = Calculated Field:
    IF wfRequestNav.wfRequestSteps.stepNum = 1 AND wfRequestNav.status = 'PENDING' THEN 'Position Request Initiated'
    IF wfRequestNav.wfRequestSteps.stepNum = [Manager Approval Step Number] AND wfRequestNav.wfRequestSteps.status = 'APPROVED' THEN 'Position Request Approved by Manager'
    IF wfRequestNav.wfRequestSteps.stepNum = [HR Approval Step Number] AND wfRequestNav.wfRequestSteps.status = 'APPROVED' THEN 'Position Request Approved by HR'
    IF wfRequestNav.wfRequestSteps.stepNum = [Budget Approval Step Number] AND wfRequestNav.wfRequestSteps.status = 'APPROVED' THEN 'Position Budget Approved'
    IF wfRequestNav.wfRequestSteps.status = 'REJECTED' THEN 'Position Request Rejected'
    ELSE null
  EventTime = wfRequestNav.wfRequestSteps.completedOn
  SourceSystemId = '[Your SFTP Server Name]' (Fixed Value)
  LastDataUpdateTime = Current Execution Time (System Variable)
  EventEndTime = wfRequestNav.wfRequestSteps.completedOn
  UserId = wfRequestNav.wfRequestSteps.processedBy
  DepartmentName = Position.department.name
  PositionStatus = Position.status
  ApproverId = wfRequestNav.wfRequestSteps.approverId
FILTERS:
  ActivityName IS NOT null
  wfRequestNav.wfRequestSteps.lastModifiedDateTime >= [Start Date]

-- UNION ALL (Configured by adding a sibling element)

// BLOCK 3: Position Activated
ENTITY: Position (Effective Dated History)
FIELDS:
  PositionId = Position.code
  ActivityName = 'Position Activated' (Fixed Value)
  EventTime = Position.effectiveStartDate
  SourceSystemId = '[Your SFTP Server Name]' (Fixed Value)
  LastDataUpdateTime = Current Execution Time (System Variable)
  EventEndTime = Position.effectiveStartDate
  UserId = Position.lastModifiedBy
  DepartmentName = Position.department.name
  PositionStatus = Position.status
  ApproverId = null (Fixed Value)
FILTERS:
  Position.status = 'A' (Active)
  // This requires an advanced filter to check the status of the previous record, which can be complex in Integration Center.
  Position.lastModifiedDateTime >= [Start Date]

-- UNION ALL (Configured by adding a sibling element)

// BLOCK 4: Position Attributes Modified
ENTITY: Position (Effective Dated History)
FIELDS:
  PositionId = Position.code
  ActivityName = 'Position Attributes Modified' (Fixed Value)
  EventTime = Position.lastModifiedDateTime
  SourceSystemId = '[Your SFTP Server Name]' (Fixed Value)
  LastDataUpdateTime = Current Execution Time (System Variable)
  EventEndTime = Position.lastModifiedDateTime
  UserId = Position.lastModifiedBy
  DepartmentName = Position.department.name
  PositionStatus = Position.status
  ApproverId = null (Fixed Value)
FILTERS:
  // This filter should exclude records that are purely status changes captured in other blocks.
  Position.lastModifiedDateTime >= [Start Date]

-- UNION ALL (Configured by adding a sibling element)

// BLOCK 5: Position Reclassified
ENTITY: Position (Effective Dated History)
FIELDS:
  PositionId = Position.code
  ActivityName = 'Position Reclassified' (Fixed Value)
  EventTime = Position.effectiveStartDate
  SourceSystemId = '[Your SFTP Server Name]' (Fixed Value)
  LastDataUpdateTime = Current Execution Time (System Variable)
  EventEndTime = Position.effectiveStartDate
  UserId = Position.lastModifiedBy
  DepartmentName = Position.department.name
  PositionStatus = Position.status
  ApproverId = null (Fixed Value)
FILTERS:
  // Requires advanced filter to check if Position.jobCode has changed from the previous record.
  Position.lastModifiedDateTime >= [Start Date]

-- UNION ALL (Configured by adding a sibling element)

// BLOCK 6: Position Reviewed for Compliance
// This requires a custom MDF object or workflow configured by the customer.
ENTITY: Position -> cust_ComplianceReview.position
FIELDS:
  PositionId = Position.code
  ActivityName = 'Position Reviewed for Compliance' (Fixed Value)
  EventTime = cust_ComplianceReview.lastModifiedDate
  SourceSystemId = '[Your SFTP Server Name]' (Fixed Value)
  LastDataUpdateTime = Current Execution Time (System Variable)
  EventEndTime = cust_ComplianceReview.lastModifiedDate
  UserId = cust_ComplianceReview.lastModifiedBy
  DepartmentName = Position.department.name
  PositionStatus = Position.status
  ApproverId = cust_ComplianceReview.reviewerId
FILTERS:
  cust_ComplianceReview.lastModifiedDate >= [Start Date]

-- UNION ALL (Configured by adding a sibling element)

// BLOCK 7: Position Frozen/Suspended
ENTITY: Position (Effective Dated History)
FIELDS:
  PositionId = Position.code
  ActivityName = 'Position Frozen/Suspended' (Fixed Value)
  EventTime = Position.effectiveStartDate
  SourceSystemId = '[Your SFTP Server Name]' (Fixed Value)
  LastDataUpdateTime = Current Execution Time (System Variable)
  EventEndTime = Position.effectiveStartDate
  UserId = Position.lastModifiedBy
  DepartmentName = Position.department.name
  PositionStatus = Position.status
  ApproverId = null (Fixed Value)
FILTERS:
  Position.status = '[Your Frozen Status Code]'
  Position.lastModifiedDateTime >= [Start Date]

-- UNION ALL (Configured by adding a sibling element)

// BLOCK 8: Position Deactivated
ENTITY: Position (Effective Dated History)
FIELDS:
  PositionId = Position.code
  ActivityName = 'Position Deactivated' (Fixed Value)
  EventTime = Position.effectiveStartDate
  SourceSystemId = '[Your SFTP Server Name]' (Fixed Value)
  LastDataUpdateTime = Current Execution Time (System Variable)
  EventEndTime = Position.effectiveStartDate
  UserId = Position.lastModifiedBy
  DepartmentName = Position.department.name
  PositionStatus = Position.status
  ApproverId = null (Fixed Value)
FILTERS:
  Position.status = 'I' (Inactive)
  Position.lastModifiedDateTime >= [Start Date]

-- UNION ALL (Configured by adding a sibling element)

// BLOCK 9: Position Closed
ENTITY: Position (Effective Dated History)
FIELDS:
  PositionId = Position.code
  ActivityName = 'Position Closed' (Fixed Value)
  EventTime = Position.effectiveStartDate
  SourceSystemId = '[Your SFTP Server Name]' (Fixed Value)
  LastDataUpdateTime = Current Execution Time (System Variable)
  EventEndTime = Position.effectiveStartDate
  UserId = Position.lastModifiedBy
  DepartmentName = Position.department.name
  PositionStatus = Position.status
  ApproverId = null (Fixed Value)
FILTERS:
  Position.status = '[Your Closed/Eliminated Status Code]'
  Position.lastModifiedDateTime >= [Start Date]

ステップ

Report Center Canvas Reports、Employee Central Position Management、Position MDFの監査または履歴データ、ワークフローデータ、安全なFTPによる納品が、テナントで有効かつ利用可能であることを確認します。必要なレポート権限と監査権限について、SuccessFactors管理者にも確認してください。
Report CenterでCanvas Reportを作成し、Employee Centralのポジション、ワークフロー、監査、およびテナントで利用できる顧客固有のコンプライアンスデータソースを選択します。オブジェクト名とフィールド名は設定によって異なるため、標準名を前提とせず、設定済みの対応オブジェクトを選択してください。
Position IDをケース識別子として、レポートの結合を設定します。ポジションレコードをワークフローレコード、監査または履歴レコード、設定済みのコンプライアンスレコードと結合します。イベントごとに1行を出力し、ポジションごとに1行へ集約しないでください。
必要なすべてのアクティビティについて、イベント抽出ロジックを設定します：ポジション申請を開始、ポジション申請をマネージャーが承認、ポジション申請を人事が承認、ポジション予算を承認、人事システムでポジションを作成、ポジションを有効化、ポジション属性を変更、ポジションを再分類、コンプライアンス審査のためポジションを確認、ポジションを凍結／一時停止、ポジションを無効化、ポジション申請を却下、ポジションを終了。
各イベントをActivityNameとEventTimeにマッピングします。「ポジション申請を開始」にはワークフローの申請タイムスタンプ、承認アクティビティには承認完了タイムスタンプ、「人事システムでポジションを作成」にはポジション作成タイムスタンプ、変更には監査または履歴のタイムスタンプ、「コンプライアンス審査のためポジションを確認」には設定済みのコンプライアンス審査タイムスタンプを使います。状況に基づくアクティビティには、設定済みの状況または監査のタイムスタンプを使います。
必須の出力列PositionId、ActivityName、EventTime、SourceSystemId、LastDataUpdateTimeを追加します。データソースにある場合は、EventEndTime、UserId、DepartmentName、PositionStatus、ApproverIdも追加します。SourceSystemIdには「SuccessFactors Employee Central」などの固定値を設定し、LastDataUpdateTimeにはレポートの更新時刻または抽出時刻を入力します。
[Start date parameter]と[End date parameter]を使って、EventTimeに日付フィルターを設定します。[Company Code filter]や[Document Type filter]などの顧客固有のフィルターは、該当フィールドが設定済みで、かつ必要な場合にのみ適用します。選択したプロセス期間に必要な過去のイベントがフィルターで除外されないようにしてください。
Canvas Reportをテストしてからスケジュールします。テナントで承認された宛先、ファイル名の規則、区切り文字、文字コード、保持設定を使って、定期実行と安全なFTPによる納品を設定します。プラットフォームで管理対象の認証情報が必要な場合を除き、レポート定義に認証情報を直接記載しないでください。
安全なFTPから納品されたCSVファイルを取得し、ヘッダー、区切り文字、文字コード、タイムスタンプ形式、重複行、NULL値を確認します。必要に応じてファイルを整形し、アクティビティごとに1行を作成して、各行にPositionIdを記載します。
最終版のCSVをProcessMindに読み込みます。PositionIdをケース識別子、ActivityNameをアクティビティ、EventTimeをイベントタイムスタンプとしてマッピングし、残りの列をイベント属性として設定します。ProcessMindが提供されたイベントログをそのまま読み取り、推定したアクティビティに依存していないことを確認してください。

設定

レポートタイプ：SuccessFactors Report Center Canvas Reportを使用します。正確なソースオブジェクト名、結合方法、フィールドラベルはテナントの設定によって異なります。
必須イベント列：PositionId、ActivityName、EventTime、SourceSystemId、LastDataUpdateTime。
推奨イベント列：EventEndTime、UserId、DepartmentName、PositionStatus、ApproverId。
ケース識別子：PositionIdは、ワークフロー、ポジション、監査、履歴、コンプライアンスの各レコードで一貫している必要があります。
アクティビティの設定：13種類すべてのアクティビティについて、明示的に行を設定します。状況変更とフィールド変更は、現在の状況を示す属性だけでなく、それぞれ独立したイベント行として記録します。
日付範囲：テストと日常的なデータ抽出では、まず3～6か月を対象にします。レポートのパフォーマンスと過去データの利用可否を確認してから、期間を延長してください。
日付フィルター：可能な場合はイベントのタイムスタンプで絞り込みます。現在のポジションレコードの日付だけで絞り込むと、過去のワークフローイベントや監査イベントが除外される可能性があるため、避けてください。
重要なフィルター：[Company Code filter]、[Document Type filter]、組織の対象範囲、ポジションの状況、有効期間の各フィルターは、業務上必要であり、テナントに設定されている場合にのみ使用します。
有効期間：選択したポジションおよびMDFのデータソースに有効期間が設定されているか確認します。利用できる場合は、イベントのタイムスタンプと関連する有効開始日または終了日を保持してください。
ワークフロー設定：マネージャー承認、人事承認、予算承認、却下、差し戻しに対応する設定済みのワークフローステップを特定します。顧客固有のワークフローステップ名は、明示的にマッピングしてください。
コンプライアンス審査：コンプライアンス審査のためのポジション確認は、利用可能な顧客固有のワークフロー、MDFオブジェクト、またはその他の監査可能なデータソースからのみ設定してください。根拠のない推測でこのイベントを作成しないでください。
状況値：テナントで設定されている「アクティブ」「凍結」「一時停止」「非アクティブ」「無効」「終了」「廃止」の各値をマッピングします。可能な場合は、元のPositionStatusの値を保持してください。
属性変更：ポジション属性の変更を取得するため、監査または履歴データの抽出を設定します。「ポジションを再分類」については、設定済みのJob CodeまたはJob Classificationフィールドの変更を特定してください。
更新時刻：LastDataUpdateTimeにはレポートの実行時刻またはデータソースの更新時刻を入力し、1回の抽出に含まれるすべての行で統一します。
パフォーマンス：初回は日付範囲を限定し、必要な列だけを選択します。不要な多対多結合を避け、結合によって行数が増えていないかテストしてください。監査データやワークフローデータの量が多い場合は、スケジュールを分割するか、別々に抽出してから管理された方法で統合する必要があります。
納品：テナントで承認された認証情報、暗号化、ディレクトリ、ファイル名、保持設定を使って、安全なFTPで納品します。ProcessMindに取り込む前に、ファイルが完全に納品されたことを確認してください。
前提条件：Employee CentralとPosition Managementの必要な設定、Report Centerへのアクセス、選択したすべてのオブジェクトに対するレポート権限、監査または履歴データへのアクセス権、ワークフローの閲覧権限、安全なFTPによる納品機能、および該当するレポートまたは連携ライセンス。

クエリの例 sql

SELECT
    PositionId,
    ActivityName,
    EventTime,
    SourceSystemId,
    LastDataUpdateTime,
    EventEndTime,
    UserId,
    DepartmentName,
    PositionStatus,
    ApproverId
FROM [Your configured Canvas Report output for Position Request Initiated]
WHERE EventTime >= [Start date parameter]
  AND EventTime < [End date parameter]
UNION ALL
SELECT
    PositionId,
    ActivityName,
    EventTime,
    SourceSystemId,
    LastDataUpdateTime,
    EventEndTime,
    UserId,
    DepartmentName,
    PositionStatus,
    ApproverId
FROM [Your configured Canvas Report output for Position Request Approved by Manager]
WHERE EventTime >= [Start date parameter]
  AND EventTime < [End date parameter]
UNION ALL
SELECT
    PositionId,
    ActivityName,
    EventTime,
    SourceSystemId,
    LastDataUpdateTime,
    EventEndTime,
    UserId,
    DepartmentName,
    PositionStatus,
    ApproverId
FROM [Your configured Canvas Report output for Position Request Approved by HR]
WHERE EventTime >= [Start date parameter]
  AND EventTime < [End date parameter]
UNION ALL
SELECT
    PositionId,
    ActivityName,
    EventTime,
    SourceSystemId,
    LastDataUpdateTime,
    EventEndTime,
    UserId,
    DepartmentName,
    PositionStatus,
    ApproverId
FROM [Your configured Canvas Report output for Position Budget Approved]
WHERE EventTime >= [Start date parameter]
  AND EventTime < [End date parameter]
UNION ALL
SELECT
    PositionId,
    ActivityName,
    EventTime,
    SourceSystemId,
    LastDataUpdateTime,
    EventEndTime,
    UserId,
    DepartmentName,
    PositionStatus,
    ApproverId
FROM [Your configured Canvas Report output for Position Created in HR System]
WHERE EventTime >= [Start date parameter]
  AND EventTime < [End date parameter]
UNION ALL
SELECT
    PositionId,
    ActivityName,
    EventTime,
    SourceSystemId,
    LastDataUpdateTime,
    EventEndTime,
    UserId,
    DepartmentName,
    PositionStatus,
    ApproverId
FROM [Your configured Canvas Report output for Position Activated]
WHERE EventTime >= [Start date parameter]
  AND EventTime < [End date parameter]
UNION ALL
SELECT
    PositionId,
    ActivityName,
    EventTime,
    SourceSystemId,
    LastDataUpdateTime,
    EventEndTime,
    UserId,
    DepartmentName,
    PositionStatus,
    ApproverId
FROM [Your configured Canvas Report output for Position Attributes Modified]
WHERE EventTime >= [Start date parameter]
  AND EventTime < [End date parameter]
UNION ALL
SELECT
    PositionId,
    ActivityName,
    EventTime,
    SourceSystemId,
    LastDataUpdateTime,
    EventEndTime,
    UserId,
    DepartmentName,
    PositionStatus,
    ApproverId
FROM [Your configured Canvas Report output for Position Reclassified]
WHERE EventTime >= [Start date parameter]
  AND EventTime < [End date parameter]
UNION ALL
SELECT
    PositionId,
    ActivityName,
    EventTime,
    SourceSystemId,
    LastDataUpdateTime,
    EventEndTime,
    UserId,
    DepartmentName,
    PositionStatus,
    ApproverId
FROM [Your configured Canvas Report output for Position Reviewed for Compliance]
WHERE EventTime >= [Start date parameter]
  AND EventTime < [End date parameter]
UNION ALL
SELECT
    PositionId,
    ActivityName,
    EventTime,
    SourceSystemId,
    LastDataUpdateTime,
    EventEndTime,
    UserId,
    DepartmentName,
    PositionStatus,
    ApproverId
FROM [Your configured Canvas Report output for Position Frozen or Suspended]
WHERE EventTime >= [Start date parameter]
  AND EventTime < [End date parameter]
UNION ALL
SELECT
    PositionId,
    ActivityName,
    EventTime,
    SourceSystemId,
    LastDataUpdateTime,
    EventEndTime,
    UserId,
    DepartmentName,
    PositionStatus,
    ApproverId
FROM [Your configured Canvas Report output for Position Deactivated]
WHERE EventTime >= [Start date parameter]
  AND EventTime < [End date parameter]
UNION ALL
SELECT
    PositionId,
    ActivityName,
    EventTime,
    SourceSystemId,
    LastDataUpdateTime,
    EventEndTime,
    UserId,
    DepartmentName,
    PositionStatus,
    ApproverId
FROM [Your configured Canvas Report output for Position Request Rejected]
WHERE EventTime >= [Start date parameter]
  AND EventTime < [End date parameter]
UNION ALL
SELECT
    PositionId,
    ActivityName,
    EventTime,
    SourceSystemId,
    LastDataUpdateTime,
    EventEndTime,
    UserId,
    DepartmentName,
    PositionStatus,
    ApproverId
FROM [Your configured Canvas Report output for Position Closed]
WHERE EventTime >= [Start date parameter]
  AND EventTime < [End date parameter];

ステップ

Python環境を準備する：Python 3.6以降がインストールされていることを確認します。pipを使って必要なライブラリをインストールします：pip install requests pandas。
APIアクセスを設定する：SAP SuccessFactorsのAPI認証情報を取得します。APIサーバーのURL、会社ID、技術ユーザーのユーザー名とパスワード（またはOAuth 2.0のクライアントIDとシークレット）が必要です。このユーザーには、Position、WfRequest、WfRequestStepおよび関連する基礎オブジェクトなどのエンティティに対するOData APIのアクセス権が必要です。
スクリプトのパラメーターを設定する：提供されたPythonスクリプトを開きます。先頭にある設定セクションで、API_ENDPOINT、COMPANY_ID、API_USER、API_PASSWORDのプレースホルダー値と、抽出期間のSTART_DATEおよびEND_DATEを置き換えます。
マッピングを調整する：スクリプト内のSTATUS_ACTIVITY_MAPとWORKFLOW_STEP_MAPの辞書を確認します。SuccessFactorsの状況コードやワークフローステップ名にあたるキーと、設定するアクティビティ名にあたる値を、組織のSuccessFactors環境に合わせて調整します。
スクリプトを実行する：ターミナルでpython extract_position_management.pyを実行します。スクリプトがSuccessFactors APIに接続し、ポジションとワークフローのデータを取得します。ページングも自動的に処理します。
データを処理する：スクリプトは、生のAPIデータをメモリ上で処理します。作成イベント、状況変更、属性変更、ワークフローステップを特定し、標準形式のイベントログに変換します。個別の業務イベントごとに1行を作成します。
カスタムイベントを処理する：「コンプライアンス審査のためポジションを確認」アクティビティは、個別の設定が必要です。スクリプト内のプレースホルダー関数get_compliance_review_eventsを探し、システムの設定に応じて、該当するカスタムMDFオブジェクトまたはワークフローを照会するロジックを実装します。
出力を確認する：スクリプトの実行が完了すると、position_management_event_log.csvという名前のCSVファイルが作成されます。このファイルに抽出したイベントログが含まれます。
データを検証する：CSVファイルを開き、検証手順に沿って確認します。ケース数、アクティビティの分布、属性の充足度が想定どおりであることを確認してください。
アップロードを準備する：CSVファイルのヘッダーがProcessMindのデータモデル要件に合っていることを確認します。必須列のPositionId、ActivityName、EventTimeが含まれ、正しい形式である必要があります。これでProcessMindにアップロードできます。

設定

APIユーザーの権限：API用の技術ユーザーには、次のODataエンティティへの読み取りアクセス権が必要です：Position、WfRequest、WfRequestStep、ユーザー、FODepartment、および属性の補完に必要なその他のエンティティ。権限にはOData API Position ExportとOData API Workflow Exportを含めてください。
日付範囲による絞り込み：スクリプトではSTART_DATEとEND_DATEを使い、lastModifiedDateTimeに基づいてレコードを絞り込みます。初回のデータ取得では、ライフサイクル全体を把握できるよう、12～24か月の期間を推奨します。差分取得では、前回の取得が正常に完了した時刻を新しいSTART_DATEに設定してください。
ページネーション：スクリプトは$topと$skipのパラメーターを使ってAPIのページネーションを処理します。PAGE_SIZEの値は調整できますが、パフォーマンスとメモリ使用量のバランスを考慮すると、通常は200～500が適切です。
エンティティの選択：スクリプトでは主にPositionとWfRequestのエンティティを照会します。$selectパラメーターを使って必要なフィールドだけを取得し、APIのパフォーマンスを高めます。
ステータスとワークフローのマッピング：スクリプトには、SuccessFactorsの技術的な値（ステータス「アクティブ」を示す「A」、ワークフローのステップ名を示す「WF_STEP_HR」など）を、業務で分かりやすいアクティビティ名に変換する辞書（STATUS_ACTIVITY_MAP、WORKFLOW_STEP_MAP）が含まれています。これらは、利用環境の設定に合わせて構成してください。
差分取得の処理：スクリプトは、指定した日付範囲内の全件取得を想定しています。定期的にデータを取得する場合は、重複データの処理を避けるため、LastDataUpdateTimeに基づいて差分レコードを管理するロジックを実装してください。

クエリの例 python

import requests
import pandas as pd
from datetime import datetime
import json

class=class="hl-string">"hl-comment"># --- Configuration ---
class=class="hl-string">"hl-comment"># Replace with your SuccessFactors API details
API_ENDPOINT = class="hl-string">"https://apiX.successfactors.com/odata/v2"
COMPANY_ID = class="hl-string">"[Your_Company_ID]"
API_USER = class="hl-string">"[Your_API_User]@[Your_Company_ID]"
API_PASSWORD = class="hl-string">"[Your_API_Password]"

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

class=class="hl-string">"hl-comment"># Pagination size
PAGE_SIZE = 500

class=class="hl-string">"hl-comment"># Mappings (Customize to your SF configuration)
STATUS_ACTIVITY_MAP = {
    class="hl-string">'A': class="hl-string">'Position Activated',
    class="hl-string">'I': class="hl-string">'Position Deactivated',
    class="hl-string">'S': class="hl-string">'Position Frozen/Suspended',
    class="hl-string">'E': class="hl-string">'Position Closed',
    class="hl-string">'F': class="hl-string">'Position Frozen/Suspended'
}

class=class="hl-string">"hl-comment"># Note: Workflow step names can be found in WF_REQUEST_STEP.step_name
WORKFLOW_STEP_MAP = {
    class="hl-string">'Manager Approval': class="hl-string">'Position Request Approved by Manager',
    class="hl-string">'HR Approval': class="hl-string">'Position Request Approved by HR',
    class="hl-string">'Budget Approval': class="hl-string">'Position Budget Approved'
}

class=class="hl-string">"hl-comment"># --- Helper Functions ---
def fetch_sf_data(entity, select_fields, filter_query):
    class="hl-string">"""Fetches paginated data from a SuccessFactors OData entity."""
    all_records = []
    skip = 0
    while True:
        url = fclass="hl-string">"{API_ENDPOINT}/{entity}?$format=json&$top={PAGE_SIZE}&$skip={skip}"
        if select_fields:
            url += fclass="hl-string">"&$select={','.join(select_fields)}"
        if filter_query:
            url += fclass="hl-string">"&$filter={filter_query}"
        
        print(fclass="hl-string">"Fetching {entity} data, page starting at record {skip}...")
        response = requests.get(url, auth=(API_USER, API_PASSWORD))
        if response.status_code != 200:
            print(fclass="hl-string">"Error fetching {entity}: {response.status_code} {response.text}")
            break

        data = response.json()[class="hl-string">'d'][class="hl-string">'results']
        if not data:
            break

        all_records.extend(data)
        skip += PAGE_SIZE

    return all_records

def parse_sf_timestamp(sf_date):
    class="hl-string">"""Parses SuccessFactors OData timestamp format /Date(...)/."""
    if not sf_date:
        return None
    try:
        class=class="hl-string">"hl-comment"># Extract timestamp in milliseconds and convert to datetime
        ts = int(sf_date.split(class="hl-string">'(')[1].split(class="hl-string">')')[0])
        return datetime.fromtimestamp(ts / 1000)
    except (IndexError, ValueError):
        return None

class=class="hl-string">"hl-comment"># --- Main Extraction Logic ---
def main():
    events = []
    source_system_id = class="hl-string">"SAP SuccessFactors"
    last_data_update_time = datetime.now()

    class=class="hl-string">"hl-comment"># 1. Fetch Position history data
    position_filter = fclass="hl-string">"lastModifiedDateTime ge datetime'{START_DATE}T00:00:00Z' and lastModifiedDateTime le datetime'{END_DATE}T23:59:59Z'"
    position_fields = [class="hl-string">"code", class="hl-string">"effectiveStartDate", class="hl-string">"status", class="hl-string">"jobCode", class="hl-string">"lastModifiedBy", class="hl-string">"lastModifiedDateTime", class="hl-string">"createdBy", class="hl-string">"createdDateTime", class="hl-string">"departmentNav/name"]
    positions_raw = fetch_sf_data(class="hl-string">"Position", position_fields, position_filter)

    class=class="hl-string">"hl-comment"># Group by position code to process history
    positions_by_code = {}
    for pos in positions_raw:
        code = pos.get(class="hl-string">'code')
        if code not in positions_by_code:
            positions_by_code[code] = []
        positions_by_code[code].append(pos)

    class=class="hl-string">"hl-comment"># Process Position history for events
    for pos_id, history in positions_by_code.items():
        class=class="hl-string">"hl-comment"># Sort records by effective date and last modified date to establish order
        history.sort(key=lambda x: (parse_sf_timestamp(x[class="hl-string">'createdDateTime']), parse_sf_timestamp(x[class="hl-string">'lastModifiedDateTime'])))

        class=class="hl-string">"hl-comment"># Event: Position Created in HR System
        creation_record = history[0]
        events.append({
            class="hl-string">'PositionId': pos_id,
            class="hl-string">'ActivityName': class="hl-string">'Position Created in HR System',
            class="hl-string">'EventTime': parse_sf_timestamp(creation_record[class="hl-string">'createdDateTime']),
            class="hl-string">'UserId': creation_record.get(class="hl-string">'createdBy'),
            class="hl-string">'DepartmentName': creation_record.get(class="hl-string">'departmentNav', {}).get(class="hl-string">'name'),
            class="hl-string">'PositionStatus': creation_record.get(class="hl-string">'status'),
            class="hl-string">'ApproverId': None
        })
        
        last_status = creation_record.get(class="hl-string">'status')
        last_job_code = creation_record.get(class="hl-string">'jobCode')

        for i in range(len(history)):
            record = history[i]
            event_time = parse_sf_timestamp(record[class="hl-string">'lastModifiedDateTime'])
            department = record.get(class="hl-string">'departmentNav', {}).get(class="hl-string">'name')

            class=class="hl-string">"hl-comment"># Events from status changes (Activated, Deactivated, Frozen, Closed)
            current_status = record.get(class="hl-string">'status')
            if current_status != last_status and current_status in STATUS_ACTIVITY_MAP:
                events.append({
                    class="hl-string">'PositionId': pos_id,
                    class="hl-string">'ActivityName': STATUS_ACTIVITY_MAP[current_status],
                    class="hl-string">'EventTime': event_time,
                    class="hl-string">'UserId': record.get(class="hl-string">'lastModifiedBy'),
                    class="hl-string">'DepartmentName': department,
                    class="hl-string">'PositionStatus': current_status,
                    class="hl-string">'ApproverId': None
                })
            last_status = current_status

            class=class="hl-string">"hl-comment"># Event: Position Reclassified (Job Code changed)
            current_job_code = record.get(class="hl-string">'jobCode')
            if current_job_code != last_job_code and i > 0: class=class="hl-string">"hl-comment"># Avoid flagging on creation
                events.append({
                    class="hl-string">'PositionId': pos_id,
                    class="hl-string">'ActivityName': class="hl-string">'Position Reclassified',
                    class="hl-string">'EventTime': event_time,
                    class="hl-string">'UserId': record.get(class="hl-string">'lastModifiedBy'),
                    class="hl-string">'DepartmentName': department,
                    class="hl-string">'PositionStatus': current_status,
                    class="hl-string">'ApproverId': None
                })
            last_job_code = current_job_code

            class=class="hl-string">"hl-comment"># Event: Position Attributes Modified (generic modification)
            if i > 0: class=class="hl-string">"hl-comment"># This fires for any modification after creation
                 events.append({
                    class="hl-string">'PositionId': pos_id,
                    class="hl-string">'ActivityName': class="hl-string">'Position Attributes Modified',
                    class="hl-string">'EventTime': event_time,
                    class="hl-string">'UserId': record.get(class="hl-string">'lastModifiedBy'),
                    class="hl-string">'DepartmentName': department,
                    class="hl-string">'PositionStatus': current_status,
                    class="hl-string">'ApproverId': None
                })


    class=class="hl-string">"hl-comment"># 2. Fetch Workflow (WfRequest) data for position creations
    wf_filter = fclass="hl-string">"lastModifiedDateTime ge datetime'{START_DATE}T00:00:00Z' and (module eq 'POSITION' or objectType eq 'Position')"
    wf_fields = [class="hl-string">"wfRequestId", class="hl-string">"status", class="hl-string">"effectiveDate", class="hl-string">"createdBy", class="hl-string">"createdDate", class="hl-string">"wfRequestSteps/processedBy", class="hl-string">"wfRequestSteps/status", class="hl-string">"wfRequestSteps/createdDate", class="hl-string">"wfRequestSteps/stepName", class="hl-string">"objectKey"]
    wf_requests_raw = fetch_sf_data(class="hl-string">"WfRequest", wf_fields, wf_filter)

    for wf in wf_requests_raw:
        pos_id = wf.get(class="hl-string">'objectKey')
        if not pos_id: continue

        class=class="hl-string">"hl-comment"># Event: Position Request Initiated
        events.append({
            class="hl-string">'PositionId': pos_id,
            class="hl-string">'ActivityName': class="hl-string">'Position Request Initiated',
            class="hl-string">'EventTime': parse_sf_timestamp(wf[class="hl-string">'createdDate']),
            class="hl-string">'UserId': wf.get(class="hl-string">'createdBy'),
            class="hl-string">'DepartmentName': None, class=class="hl-string">"hl-comment"># Department info is not in WfRequest
            class="hl-string">'PositionStatus': class="hl-string">'Pending',
            class="hl-string">'ApproverId': None
        })

        class=class="hl-string">"hl-comment"># Event: Position Request Rejected
        if wf[class="hl-string">'status'] == class="hl-string">'REJECTED':
            last_step = wf.get(class="hl-string">'wfRequestSteps', {}).get(class="hl-string">'results', [])[-1] if wf.get(class="hl-string">'wfRequestSteps') else {}
            events.append({
                class="hl-string">'PositionId': pos_id,
                class="hl-string">'ActivityName': class="hl-string">'Position Request Rejected',
                class="hl-string">'EventTime': parse_sf_timestamp(last_step.get(class="hl-string">'createdDate')),
                class="hl-string">'UserId': last_step.get(class="hl-string">'processedBy'),
                class="hl-string">'DepartmentName': None,
                class="hl-string">'PositionStatus': class="hl-string">'Rejected',
                class="hl-string">'ApproverId': last_step.get(class="hl-string">'processedBy')
            })

        class=class="hl-string">"hl-comment"># Events for approval steps
        if wf.get(class="hl-string">'wfRequestSteps') and class="hl-string">'results' in wf[class="hl-string">'wfRequestSteps']:
            for step in wf[class="hl-string">'wfRequestSteps'][class="hl-string">'results']:
                step_name = step.get(class="hl-string">'stepName', class="hl-string">'')
                if step[class="hl-string">'status'] == class="hl-string">'APPROVED' and step_name in WORKFLOW_STEP_MAP:
                    events.append({
                        class="hl-string">'PositionId': pos_id,
                        class="hl-string">'ActivityName': WORKFLOW_STEP_MAP[step_name],
                        class="hl-string">'EventTime': parse_sf_timestamp(step[class="hl-string">'createdDate']),
                        class="hl-string">'UserId': step.get(class="hl-string">'processedBy'),
                        class="hl-string">'DepartmentName': None,
                        class="hl-string">'PositionStatus': class="hl-string">'In Approval',
                        class="hl-string">'ApproverId': step.get(class="hl-string">'processedBy')
                    })

    class=class="hl-string">"hl-comment"># 3. Placeholder for class="hl-string">'Position Reviewed for Compliance'
    class=class="hl-string">"hl-comment"># This event is highly customer-specific. You need to implement the logic here.
    class=class="hl-string">"hl-comment"># Example: Query a custom MDF object or a specific workflow type.
    class=class="hl-string">"hl-comment"># compliance_events = get_compliance_review_events(START_DATE, END_DATE)
    class=class="hl-string">"hl-comment"># events.extend(compliance_events)

    class=class="hl-string">"hl-comment"># --- Final Dataframe Creation ---
    if not events:
        print(class="hl-string">"No events found for the specified period.")
        return

    df = pd.DataFrame(events)

    class=class="hl-string">"hl-comment"># Add standard columns
    df[class="hl-string">'SourceSystemId'] = source_system_id
    df[class="hl-string">'LastDataUpdateTime'] = last_data_update_time
    df[class="hl-string">'EventEndTime'] = df[class="hl-string">'EventTime'] class=class="hl-string">"hl-comment"># For atomic events, end time is the same as start time

    class=class="hl-string">"hl-comment"># Standardize column names and order
    final_columns = [
        class="hl-string">'PositionId', class="hl-string">'ActivityName', class="hl-string">'EventTime', class="hl-string">'EventEndTime', class="hl-string">'UserId',
        class="hl-string">'DepartmentName', class="hl-string">'PositionStatus', class="hl-string">'ApproverId', class="hl-string">'SourceSystemId', class="hl-string">'LastDataUpdateTime'
    ]
    df = df.reindex(columns=final_columns)

    class=class="hl-string">"hl-comment"># Clean up and save
    df.dropna(subset=[class="hl-string">'PositionId', class="hl-string">'ActivityName', class="hl-string">'EventTime'], inplace=True)
    df.sort_values(by=[class="hl-string">'PositionId', class="hl-string">'EventTime'], inplace=True)

    output_filename = class="hl-string">'position_management_event_log.csv'
    df.to_csv(output_filename, index=False)
    print(fclass="hl-string">"Event log successfully created: {output_filename}")

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

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

この便利なデータテンプレートを使って、採用から退職までのポジション管理プロセスの改善に取り組みましょう。インサイトを見つけ、組織全体の効率向上につなげてください。

改善ガイドに戻る

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

採用から退職までのポジション管理を今すぐ効率化しましょう！

ボトルネックを特定し、採用から退職までのサイクルタイムを短期間で30％短縮しましょう。

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

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

採用から退職までのポジション管理用データテンプレート

採用から退職までのポジション管理用データテンプレート

採用から退職までのポジション管理の属性

採用から退職までのポジション管理のアクティビティ

データ抽出ガイド

SuccessFactors Integration Centerによる外部エクスポート

ステップ

設定

クエリの例 sql

SuccessFactors Report Center Canvas Reportによるエクスポート

ステップ

設定

クエリの例 sql

SuccessFactors OData APIを使ったPythonスクリプトによる抽出

ステップ

設定

クエリの例 python

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

採用から退職までのポジション管理を今すぐ効率化しましょう！