Author: |
cibex,Odoo Community Association (OCA) |
License: |
AGPL-3 |
Branch: |
14.0 |
Repository: |
acsone/hr |
Dependencies: |
hr_contract,
and
hr_employee_calendar_planning |
Languages: |
HTML (353, 59.3%),
Python (153, 25.7%),
XML (14, 2.4%),
and
reStructuredText (75, 12.6%) |
Other repositories: |
Change2improve/hr,
Darknroses/hr,
Digital5-Odoo/hr,
MallorcaSoft/hr,
OCA/hr,
Studio73/hr,
Tecnativa/hr,
brain-tec/hr,
coopiteasy/hr,
elego/oca-hr,
and
tegin/hr |
<h1 class="title">Hr Contract Employee Calendar Planning</h1>
<p><a class="reference external" href="https://odoo-community.org/page/development-status"><img alt="Beta" src="https://img.shields.io/badge/maturity-Beta-yellow.png" /></a> <a class="reference external" href="http://www.gnu.org/licenses/agpl-3.0-standalone.html"><img alt="License: AGPL-3" src="https://img.shields.io/badge/licence-AGPL--3-blue.png" /></a> <a class="reference external" href="https://github.com/OCA/hr/tree/14.0/hr_contract_employee_calendar_planning"><img alt="OCA/hr" src="https://img.shields.io/badge/github-OCA%2Fhr-lightgray.png?logo=github" /></a> <a class="reference external" href="https://translation.odoo-community.org/projects/hr-14-0/hr-14-0-hr_contract_employee_calendar_planning"><img alt="Translate me on Weblate" src="https://img.shields.io/badge/weblate-Translate%20me-F47D42.png" /></a> <a class="reference external" href="https://runbot.odoo-community.org/runbot/116/14.0"><img alt="Try me on Runbot" src="https://img.shields.io/badge/runbot-Try%20me-875A7B.png" /></a></p>
<p>This module ensures a consistent working times history when using the
<strong>hr_contract</strong> and <strong>hr_employee_calendar_planning</strong> modules together.</p>
<p>There are 3 different data models which can relate to working time
(resource.calendar) records:</p>
<ul class="simple">
<li>Employees (hr.employee)</li>
<li>Contracts (hr.contract)</li>
<li>Resources (resource.resource) -> related to hr.employee through resource.mixin</li>
</ul>
<p>The <strong>hr_employee_calendar_planning</strong> module adds the calendar_ids field
to employees, which allows a more flexible working times configuration:
Instead of selecting a single resource.calendar, multiple calendars can be
combined into one auto-generated calendar.</p>
<p>However, contracts are not considered when creating auto-generated calendars.
This can lead to unexpected behaviour, because the active contract calendar
and the employee calendar can diverge (calendar mismatch). Additionally, when
configuring a new contract, or changing the existing contract calendar,
the employee calendar will be overwritten by the contract calendar.</p>
<p>To resolve this issue, this module migrates current and previous contract
calendars into the calendar_ids and thus the auto-generated calendar.
Additionally, changes to the employee calendar by contracts are prevented.
The resource_calendar_id field is hidden in contract views, since all
working times should be managed in the calendar_ids field for each employee.
However, it is still possible to keep a meaningful contract history,
e.g. for salary information.</p>
<p><strong>Table of contents</strong></p>
<div class="contents local topic" id="contents">
<ul class="simple">
<li><a class="reference internal" href="#bug-tracker" id="id1">Bug Tracker</a></li>
<li><a class="reference internal" href="#credits" id="id2">Credits</a><ul>
<li><a class="reference internal" href="#authors" id="id3">Authors</a></li>
<li><a class="reference internal" href="#contributors" id="id4">Contributors</a></li>
<li><a class="reference internal" href="#maintainers" id="id5">Maintainers</a></li>
</ul>
</li>
</ul>
</div>
<a name="bug-tracker"></a>
<h2><a class="toc-backref" href="#id1">Bug Tracker</a></h2>
<p>Bugs are tracked on <a class="reference external" href="https://github.com/OCA/hr/issues">GitHub Issues</a>.
In case of trouble, please check there if your issue has already been reported.
If you spotted it first, help us smashing it by providing a detailed and welcomed
<a class="reference external" href="https://github.com/OCA/hr/issues/new?body=module:%20hr_contract_employee_calendar_planning%0Aversion:%2014.0%0A%0A**Steps%20to%20reproduce**%0A-%20...%0A%0A**Current%20behavior**%0A%0A**Expected%20behavior**">feedback</a>.</p>
<p>Do not contact contributors directly about support or help with technical issues.</p>
<a name="credits"></a>
<h2><a class="toc-backref" href="#id2">Credits</a></h2>
<a name="authors"></a>
<h3><a class="toc-backref" href="#id3">Authors</a></h3>
<ul class="simple">
<li>cibex</li>
</ul>
<a name="contributors"></a>
<h3><a class="toc-backref" href="#id4">Contributors</a></h3>
<ul class="simple">
<li>Jonas Buchholz <<a class="reference external" href="mailto:J.Buchholz@cibex.net">J.Buchholz@cibex.net</a>></li>
</ul>
<a name="maintainers"></a>
<h3><a class="toc-backref" href="#id5">Maintainers</a></h3>
<p>This module is maintained by the OCA.</p>
<a class="reference external image-reference" href="https://odoo-community.org"><img alt="Odoo Community Association" src="https://odoo-community.org/logo.png" /></a>
<p>OCA, or the Odoo Community Association, is a nonprofit organization whose
mission is to support the collaborative development of Odoo features and
promote its widespread use.</p>
<p>This module is part of the <a class="reference external" href="https://github.com/OCA/hr/tree/14.0/hr_contract_employee_calendar_planning">OCA/hr</a> project on GitHub.</p>
<p>You are welcome to contribute. To learn how please visit <a class="reference external" href="https://odoo-community.org/page/Contribute">https://odoo-community.org/page/Contribute</a>.</p>