コンテンツへスキップ

Odooのhr.employeeモデルを徹底解説 — 社員データ構造を理解する

人事担当者・開発者・業務コンサル向け:Odooの社員(従業員)モデルを徹底解説
2026年3月11日 by
Odooのhr.employeeモデルを徹底解説 — 社員データ構造を理解する
Dasolo
| まだコメントがありません

導入


Odooでは“モデル”がデータの設計図です。受注や請求書、従業員情報など、業務で扱うあらゆるデータはモデルとして定義され、データベースに保存されます。


モデルの理解は、開発者・業務担当の双方にとって不可欠です。モデルはフィールドや関連性、業務ロジックの型を決めるため、システム全体の土台になります。


ここではHR(人事)モジュールの中核である hr.employee モデルを取り上げます。独自の人事ワークフロー構築、給与連携、勤怠や休暇設定など、多くの場面でこのモデルに触れることになります。

hr.employee モデルとは何か


hr.employee は Odoo における従業員を表す中心的なモデルです。社員の基本情報や組織情報がここに集約されます。


このモデルはHRアプリ群の一部で、勤怠、休暇、契約、給与計算、タイムシートなどと連携して使われます。


Employees アプリを有効にすると hr.employee が導入され、他のモジュールは継承を通じて必要なフィールドや機能を追加します。hr_contract は契約情報、hr_attendance はチェックイン情報、hr_leave は休暇機能を追加する、といった具合で、コア構造はそのままに拡張されます。


参照用に制限されたビューを提供する hr.employee.public のようなパターンもあり、抽象モデルや継承を用いて表示・アクセスを制御する設計が取られています。

モデルの主要フィールド


以下は hr.employee で特に重要なフィールド一覧です。これらを押さえておくと従業員データの扱いがスムーズになります。


1. name

型: Char。従業員の表示名です。多くの画面で主キー的に使われ、一覧やフォームの代表表示となります。


2. create_date

型: Datetime。レコード作成日時を保持します。Odooが自動管理し、監査やレポートで使えます。


3. write_date

型: Datetime。最終更新日時を保持します。こちらも自動管理で、データ更新の追跡に便利です。


4. active

型: Boolean。ソフト削除フラグです。False にするとアーカイブ扱いになり、通常ビューからは隠れます。従業員退職時などに物理削除せず利用します。


5. company_id

型: Many2one (res.company)。マルチカンパニー環境で所属する会社を示します。多くのレコードで必須となる重要フィールドです。


6. user_id

型: Many2one (res.users)。Odooユーザーと紐付けるフィールド。ログインや承認、タイムシートの操作権限に影響します。


7. work_email

型: Char。勤務先メールアドレス。社内連絡や通知送信に使われます。


8. work_phone

型: Char。勤務先電話番号。従業員フォームや連絡フローで表示されます。


9. mobile_phone

型: Char。携帯番号。緊急連絡やSMS通知に利用されることが多いです。


10. department_id

型: Many2one (hr.department)。所属部署。組織図や承認ルート、分析レポートで使われます。


11. job_id

型: Many2one (hr.job)。職位を示すリンク。求人や職務定義との連携に用います。


12. job_title

型: Char。自由記述の職務名。job_id が設定されない場合やカスタム表記で利用します。


13. parent_id

型: Many2one (hr.employee)。直属の上司を示します。承認フローや組織構造の階層化に用いられます。


14. coach_id

型: Many2one (hr.employee)。メンターや指導担当者です。評価・育成の管理に利用され、デフォルトで特別な権限は付与されません。


15. resource_id

型: Many2one (resource.resource)。リソースモデルへのリンク。スケジューリングや稼働計画、カレンダー連携で使います。


16. work_contact_id

型: Many2one (res.partner)。勤務先の連絡先(取引先)への紐付け。業務連絡や書類作成で利用されます。


17. address_id

型: Many2one (res.partner)。勤務先住所。オフィス所在地などをパートナーに紐付けて管理します。


18. address_home_id

型: Many2one (res.partner)。自宅住所。給与や緊急連絡先など私的な情報管理で使用されます。


19. resource_calendar_id

型: Many2one (resource.calendar)。勤務カレンダー。就業時間や休暇計算の基準となる勤務スケジュールを指定します。


20. employee_type

型: Selection。従業員タイプ(正社員、外注、インターン等)。契約管理や給与計算に影響するため必須設定となることが多いです。


21. barcode

型: Char。バッジID。勤怠キオスクや入退室管理のバーコード運用で使われます。


22. pin

型: Char。キオスクでの打刻用PIN。POSでのレジ交代などにも利用されます。


23. birthday

型: Date。生年月日。人事記録やバースデーリマインダーに使用できます。


24. identification_id

型: Char。国民識別番号など法令で必要なID。人事・給与のコンプライアンス管理に重要です。


25. passport_id

型: Char。パスポート番号。出張や就労ビザ管理で参照されます。


26. bank_account_id

型: Many2one (res.partner.bank)。給与振込先口座の参照です。


27. private_email

型: Char。私用メールアドレス。勤務先メールが無い場合の連絡先として使われます。


28. phone

型: Char。自宅電話など私用の電話番号。業務連絡先と区別して管理します。


29. contract_id

型: Many2one (hr.contract)。現在の有効契約を指す参照フィールドです。


30. contract_ids

型: One2many (hr.contract)。当該従業員に紐づく契約履歴の一覧です。過去の契約を追跡できます。


31. image_1920

型: Binary。従業員の写真やアバター。フォームや名簿、帳票でサイズ違いの画像を利用します。


32. related_partner_id

型: Many2one (res.partner)。従業員に紐づく取引先レコード。CRMや請求書発行など他モジュールとの橋渡しになります。


33. leave_manager_id

型: Many2one (res.users)。休暇承認権限を持つユーザー。未設定時は管理者または指定の承認者に回ります。


34. expense_manager_id

型: Many2one (res.users)。経費精算の承認者を指定します。未設定の場合は管理者権限が関与します。


35. timesheet_manager_id

型: Many2one (res.users)。タイムシートの承認者。未設定だとタイムシート管理者のルールが適用されます。

ビジネスワークフローでの利用例


1. 従業員名簿とオンボーディング

人事が新しい従業員を登録するとき、hr.employee に氏名、部署、職位、上司、連絡先などを入力します。Odooアクセスが必要な場合は user_id を紐付けてアカウントを発行します。


2. 勤怠と時間管理

社員が勤怠アプリで打刻すると、hr.attendance に出退勤が記録され、そのレコードは hr.employee と結び付きます。バーコードやPINはキオスク運用を可能にします。


3. 休暇申請と承認フロー

休暇申請は当該従業員を参照します。leave_manager_id や resource_calendar_id に基づいて承認者や付与日数が決まります。


4. 給与計算と契約管理

給与プロセスは hr.employee の給与構造、銀行口座、契約情報に依存します。contract_id は現行契約を、contract_ids は履歴管理を担います。


5. タイムシートとプロジェクト配分

プロジェクトへ時間を記録するとき、タイムシートは従業員に紐付き、timesheet_manager_id による承認や resource_id を使ったリソース計画が行われます。

開発者がモデルを拡張する方法


開発者は Odoo の継承パターンを用いて hr.employee を拡張します。いくつかの典型的な手法があります。


モデル継承

モデルを拡張する際は _inherit = 'hr.employee' を使います。新しいフィールドの追加、メソッドのオーバーライド、制約追加などが可能で、変更は別モジュールに収めるため将来のアップグレードが容易になります。


フィールド追加

継承モデルで新しいフィールドを定義します。Char、Many2one、Boolean、Integer、Text、Selection 等、用途に合った型を選んでください。マルチカンパニー対応が必要なら company_dependent の考慮を。


Pythonでの拡張

create、write、unlink といったメソッドをオーバーライドして業務ロジックを差し込みます。必ず super() を呼んで元の動作を維持し、計算フィールドの依存関係には注意してください。


Odoo Studio の活用

コードを書かずにフィールドを追加できる Odoo Studio は短期的なカスタマイズに便利です。ただし複雑なロジックや保守性を重視するならカスタムモジュールで実装するほうが安全です。

ベストプラクティス


  • 全員に user_id を割り当てる必要はありません。Odooへのログイン権が必要な従業員にのみ user_id を設定しましょう。
  • 組織構造は parent_id を正しく設定して上位から積み上げるように設計してください。
  • resource_calendar_id を設定しておくと就業時間と休暇計算が一貫しやすくなります。
  • API連携を作る際は XML-RPC や JSON-RPC を利用します。hr.employee は外部連携用に公開されているので、外部IDのマッピングは慎重に行ってください。
  • カスタムフィールドを作る際は x_ プレフィックスやモジュール接頭辞を使って将来のバージョンとの衝突を避けましょう。
  • hr.group_hr_user に制限されるフィールドは、HR権限を持たないユーザーへプリフェッチされないようにフィールド定義でグループ設定を行ってください。

よくある失敗例


  • 既存レコードを検索せずに重複した従業員レコードを作成してしまうケースが多いです。work_email や identification_id を使って重複チェックを行いましょう。
  • user_id と related_partner_id を混同しないでください。user_id はOdooログイン用、related_partner_id は連絡先(取引先)です。
  • employee_type を設定し忘れると契約や給与処理に影響が出ます。必須項目として扱ってください。
  • コアメソッドをオーバーライドして super() を呼ばないと、他モジュールや将来のアップグレードで不具合が発生します。
  • 既存レコードのためのデフォルトを与えずに必須のカスタムフィールドを追加すると、アップグレード時に検証エラーが起きます。初期値を考慮してください。
  • センシティブな人事情報を hr.group_hr_user を持たないユーザーに公開しないよう、フィールドレベルで適切なグループ制御を行ってください。

まとめ


hr.employee は Odoo の人事機能の核です。従業員データを保持し、契約、勤怠、休暇と連携します。フィールドの意味や拡張方法を理解しておくと、設定・カスタマイズ・連携が格段にやりやすくなります。


業務プロセスを設計するコンサルタントでも、カスタムモジュールを作る開発者でも、hr.employee を正しく扱えることが工数削減とミス防止につながります。

Odoo 導入のサポートが必要ですか?


Dasolo は Odoo の導入、カスタマイズ、最適化を支援します。API連携や開発に強みがあり、hr.employee のようなデータモデルに深い知見を持つチームが対応します。


Odoo の導入支援、人事モジュールのカスタム開発、外部システム連携などの相談があればご連絡ください。 デモを予約する プロジェクトについて詳しくお話ししましょう。

Odooのhr.employeeモデルを徹底解説 — 社員データ構造を理解する
Dasolo 2026年3月11日
このポストを共有
サインイン コメントを残す