-
-
Notifications
You must be signed in to change notification settings - Fork 120
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Currently translated at 47.1% (25 of 53 strings) Translation: hr-attendance-16.0/hr-attendance-16.0-hr_attendance_report_theoretical_time Translate-URL: https://translation.odoo-community.org/projects/hr-attendance-16-0/hr-attendance-16-0-hr_attendance_report_theoretical_time/fr/
- Loading branch information
1 parent
559a091
commit c53aa11
Showing
18 changed files
with
202 additions
and
191 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
|
@@ -17,43 +17,45 @@ Theoretical vs Attended Time Analysis | |
:target: http://www.gnu.org/licenses/agpl-3.0-standalone.html | ||
:alt: License: AGPL-3 | ||
.. |badge3| image:: https://img.shields.io/badge/github-OCA%2Fhr--attendance-lightgray.png?logo=github | ||
:target: https://github.com/OCA/hr-attendance/tree/16.0/hr_attendance_report_theoretical_time | ||
:target: https://github.com/OCA/hr-attendance/tree/17.0/hr_attendance_report_theoretical_time | ||
:alt: OCA/hr-attendance | ||
.. |badge4| image:: https://img.shields.io/badge/weblate-Translate%20me-F47D42.png | ||
:target: https://translation.odoo-community.org/projects/hr-attendance-16-0/hr-attendance-16-0-hr_attendance_report_theoretical_time | ||
:target: https://translation.odoo-community.org/projects/hr-attendance-17-0/hr-attendance-17-0-hr_attendance_report_theoretical_time | ||
:alt: Translate me on Weblate | ||
.. |badge5| image:: https://img.shields.io/badge/runboat-Try%20me-875A7B.png | ||
:target: https://runboat.odoo-community.org/builds?repo=OCA/hr-attendance&target_branch=16.0 | ||
:target: https://runboat.odoo-community.org/builds?repo=OCA/hr-attendance&target_branch=17.0 | ||
:alt: Try me on Runboat | ||
|
||
|badge1| |badge2| |badge3| |badge4| |badge5| | ||
|
||
This module adds a new report called "Theoretical vs Attended Time Analysis" | ||
that compares worked time, measured through attendances records, with the | ||
theoretical time, computed from employee's working calendar, public holidays | ||
and employee specific leaves. Missing attendance days are generated on the fly | ||
in the report with their corresponding theoretical hours. | ||
This module adds a new report called "Theoretical vs Attended Time | ||
Analysis" that compares worked time, measured through attendances | ||
records, with the theoretical time, computed from employee's working | ||
calendar, public holidays and employee specific leaves. Missing | ||
attendance days are generated on the fly in the report with their | ||
corresponding theoretical hours. | ||
|
||
There is the possibility of counting as theoretical time some leave types if | ||
specified in them. | ||
There is the possibility of counting as theoretical time some leave | ||
types if specified in them. | ||
|
||
As an example, imagine a work week with 40 theoretical hours, and these | ||
attendance situation: | ||
|
||
* Monday: Worked 10 hours | ||
* Tuesday: Worked 10 hours | ||
* Wednesday: Worked 10 hours | ||
* Thursday: Worked 10 hours | ||
* Friday: Ask for a compensation leave (said leave type), as already worked | ||
40 hours. | ||
- Monday: Worked 10 hours | ||
- Tuesday: Worked 10 hours | ||
- Wednesday: Worked 10 hours | ||
- Thursday: Worked 10 hours | ||
- Friday: Ask for a compensation leave (said leave type), as already | ||
worked 40 hours. | ||
|
||
On the report, whole week should put 40 theoretical hours - 8 per day - against | ||
40 worked hours (although they were on previous days, and none on Friday). | ||
On the report, whole week should put 40 theoretical hours - 8 per day - | ||
against 40 worked hours (although they were on previous days, and none | ||
on Friday). | ||
|
||
On contrary, if you want to take a holiday one of that days, you should ask for | ||
a leave type without the check for counting as theoretical time, and then the | ||
whole week will be 32 theoretical hours against the worked hours of that week | ||
without the leave. | ||
On contrary, if you want to take a holiday one of that days, you should | ||
ask for a leave type without the check for counting as theoretical time, | ||
and then the whole week will be 32 theoretical hours against the worked | ||
hours of that week without the leave. | ||
|
||
**Table of contents** | ||
|
||
|
@@ -63,107 +65,110 @@ without the leave. | |
Installation | ||
============ | ||
|
||
On installation time, this module computes the theoretical hours for the day of | ||
the attendance check-in, so if you have a lot of records, this would be a bit | ||
slow. | ||
On installation time, this module computes the theoretical hours for the | ||
day of the attendance check-in, so if you have a lot of records, this | ||
would be a bit slow. | ||
|
||
Configuration | ||
============= | ||
|
||
You need to be at least "Attendance / Manual Attendance" for being able to see | ||
the attendances report. | ||
You need to be at least "Attendance / Manual Attendance" for being able | ||
to see the attendances report. | ||
|
||
For including some leave types in the theoretical time, you have to: | ||
|
||
#. Go to *Leaves > Configuration > Leave Types*. | ||
#. Select leave type you want to include. | ||
#. Check the mark "Include in theoretical hours". | ||
1. Go to *Leaves > Configuration > Leave Types*. | ||
2. Select leave type you want to include. | ||
3. Check the mark "Include in theoretical hours". | ||
|
||
When generating non worked days, this module uses a start date for beginning | ||
the series generation, which is: | ||
When generating non worked days, this module uses a start date for | ||
beginning the series generation, which is: | ||
|
||
* Manual start date set on the employee. | ||
* If not set, the greatest of these 2 dates: | ||
- Manual start date set on the employee. | ||
- If not set, the greatest of these 2 dates: | ||
|
||
* Employee creation date. | ||
* Working calendar line start date. | ||
- Employee creation date. | ||
- Working calendar line start date. | ||
|
||
For configuring manual start date, you have to: | ||
|
||
#. Go to *Employees > Employees*. | ||
#. Select an employee. | ||
#. Go to "HR Settings" page. | ||
#. Set the date in "Theoretical hours start date" field. | ||
1. Go to *Employees > Employees*. | ||
2. Select an employee. | ||
3. Go to "HR Settings" page. | ||
4. Set the date in "Theoretical hours start date" field. | ||
|
||
The generation will stop on the end date of the working calendar line or today, | ||
so don't forget to properly set start and end dates of the lines of the working | ||
calendar for not leaving empty spaces between them. | ||
The generation will stop on the end date of the working calendar line or | ||
today, so don't forget to properly set start and end dates of the lines | ||
of the working calendar for not leaving empty spaces between them. | ||
|
||
Usage | ||
===== | ||
|
||
#. Go to *Attendances > Reporting > Theoretical vs Attended Time Analysis*. | ||
#. Check pivot table or look at the graph view. | ||
1. Go to *Attendances > Reporting > Theoretical vs Attended Time | ||
Analysis*. | ||
2. Check pivot table or look at the graph view. | ||
|
||
Known issues / Roadmap | ||
====================== | ||
|
||
* Employees with less than 1 week in the company will show full week | ||
theoretical hours. | ||
* Activate ORM cache for improving performance on computing theoretical hours, | ||
but assuring that the cache is cleared when the conditions of the computation | ||
changes. | ||
* If you change employee's working time, theoretical hours for non attended | ||
days will be computed according this new calendar. You have to define | ||
start and end dates inside the calendar for avoiding this side effect. | ||
* Theoretical hours of affected days when changing the leave type to be | ||
included or not in theoretical time are not recomputed. | ||
- Employees with less than 1 week in the company will show full week | ||
theoretical hours. | ||
- Activate ORM cache for improving performance on computing theoretical | ||
hours, but assuring that the cache is cleared when the conditions of | ||
the computation changes. | ||
- If you change employee's working time, theoretical hours for non | ||
attended days will be computed according this new calendar. You have | ||
to define start and end dates inside the calendar for avoiding this | ||
side effect. | ||
- Theoretical hours of affected days when changing the leave type to be | ||
included or not in theoretical time are not recomputed. | ||
|
||
Bug Tracker | ||
=========== | ||
|
||
Bugs are tracked on `GitHub Issues <https://github.com/OCA/hr-attendance/issues>`_. | ||
In case of trouble, please check there if your issue has already been reported. | ||
If you spotted it first, help us to smash it by providing a detailed and welcomed | ||
`feedback <https://github.com/OCA/hr-attendance/issues/new?body=module:%20hr_attendance_report_theoretical_time%0Aversion:%2016.0%0A%0A**Steps%20to%20reproduce**%0A-%20...%0A%0A**Current%20behavior**%0A%0A**Expected%20behavior**>`_. | ||
`feedback <https://github.com/OCA/hr-attendance/issues/new?body=module:%20hr_attendance_report_theoretical_time%0Aversion:%2017.0%0A%0A**Steps%20to%20reproduce**%0A-%20...%0A%0A**Current%20behavior**%0A%0A**Expected%20behavior**>`_. | ||
|
||
Do not contact contributors directly about support or help with technical issues. | ||
|
||
Credits | ||
======= | ||
|
||
Authors | ||
~~~~~~~ | ||
------- | ||
|
||
* Tecnativa | ||
|
||
Contributors | ||
~~~~~~~~~~~~ | ||
------------ | ||
|
||
* `Tecnativa <https://www.tecnativa.com>`__: | ||
- `Tecnativa <https://www.tecnativa.com>`__: | ||
|
||
* Pedro M. Baeza. | ||
* David Vidal | ||
* Víctor Martínez | ||
* Pedro Gonzalez <[email protected]> | ||
* Aritz Olea <[email protected]> | ||
* `Trobz <https://trobz.com>`__: | ||
- Pedro M. Baeza. | ||
- David Vidal | ||
- Víctor Martínez | ||
|
||
* Dzung Tran <[email protected]> | ||
- Pedro Gonzalez <[email protected]> | ||
- Aritz Olea <[email protected]> | ||
- `Trobz <https://trobz.com>`__: | ||
|
||
- Dzung Tran <[email protected]> | ||
|
||
Other credits | ||
~~~~~~~~~~~~~ | ||
------------- | ||
|
||
**Images** | ||
|
||
* Font Awesome: `Icon <http://fontawesome.io>`_. | ||
- Font Awesome: `Icon <http://fontawesome.io>`__. | ||
|
||
The development of this module has been financially supported by: | ||
|
||
* Camptocamp | ||
- Camptocamp | ||
|
||
Maintainers | ||
~~~~~~~~~~~ | ||
----------- | ||
|
||
This module is maintained by the OCA. | ||
|
||
|
@@ -175,6 +180,6 @@ 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. | ||
|
||
This module is part of the `OCA/hr-attendance <https://github.com/OCA/hr-attendance/tree/16.0/hr_attendance_report_theoretical_time>`_ project on GitHub. | ||
This module is part of the `OCA/hr-attendance <https://github.com/OCA/hr-attendance/tree/17.0/hr_attendance_report_theoretical_time>`_ project on GitHub. | ||
|
||
You are welcome to contribute. To learn how please visit https://odoo-community.org/page/Contribute. |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
|
@@ -6,7 +6,7 @@ msgid "" | |
msgstr "" | ||
"Project-Id-Version: Odoo Server 13.0\n" | ||
"Report-Msgid-Bugs-To: \n" | ||
"PO-Revision-Date: 2023-10-09 03:13+0000\n" | ||
"PO-Revision-Date: 2023-10-09 04:55+0000\n" | ||
"Last-Translator: Nils Hamerlinck <[email protected]>\n" | ||
"Language-Team: none\n" | ||
"Language: fr\n" | ||
|
@@ -19,7 +19,7 @@ msgstr "" | |
#. module: hr_attendance_report_theoretical_time | ||
#: model:ir.ui.menu,name:hr_attendance_report_theoretical_time.menu_hr_attendance_theoretical_report | ||
msgid "Analysis" | ||
msgstr "" | ||
msgstr "Tous les employés(e)" | ||
|
||
#. module: hr_attendance_report_theoretical_time | ||
#: model:ir.model,name:hr_attendance_report_theoretical_time.model_hr_attendance | ||
|
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,3 @@ | ||
[build-system] | ||
requires = ["whool"] | ||
build-backend = "whool.buildapi" |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,27 @@ | ||
You need to be at least "Attendance / Manual Attendance" for being able | ||
to see the attendances report. | ||
|
||
For including some leave types in the theoretical time, you have to: | ||
|
||
1. Go to *Leaves \> Configuration \> Leave Types*. | ||
2. Select leave type you want to include. | ||
3. Check the mark "Include in theoretical hours". | ||
|
||
When generating non worked days, this module uses a start date for | ||
beginning the series generation, which is: | ||
|
||
- Manual start date set on the employee. | ||
- If not set, the greatest of these 2 dates: | ||
- Employee creation date. | ||
- Working calendar line start date. | ||
|
||
For configuring manual start date, you have to: | ||
|
||
1. Go to *Employees \> Employees*. | ||
2. Select an employee. | ||
3. Go to "HR Settings" page. | ||
4. Set the date in "Theoretical hours start date" field. | ||
|
||
The generation will stop on the end date of the working calendar line or | ||
today, so don't forget to properly set start and end dates of the lines | ||
of the working calendar for not leaving empty spaces between them. |
28 changes: 0 additions & 28 deletions
28
hr_attendance_report_theoretical_time/readme/CONFIGURE.rst
This file was deleted.
Oops, something went wrong.
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,8 @@ | ||
- [Tecnativa](https://www.tecnativa.com): | ||
- Pedro M. Baeza. | ||
- David Vidal | ||
- Víctor Martínez | ||
- Pedro Gonzalez \<<[email protected]>\> | ||
- Aritz Olea \<<[email protected]>\> | ||
- [Trobz](https://trobz.com): | ||
- Dzung Tran \<<[email protected]>\> |
10 changes: 0 additions & 10 deletions
10
hr_attendance_report_theoretical_time/readme/CONTRIBUTORS.rst
This file was deleted.
Oops, something went wrong.
4 changes: 2 additions & 2 deletions
4
...eport_theoretical_time/readme/CREDITS.rst → ...report_theoretical_time/readme/CREDITS.md
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,7 +1,7 @@ | ||
**Images** | ||
|
||
* Font Awesome: `Icon <http://fontawesome.io>`_. | ||
- Font Awesome: [Icon](http://fontawesome.io). | ||
|
||
The development of this module has been financially supported by: | ||
|
||
* Camptocamp | ||
- Camptocamp |
28 changes: 28 additions & 0 deletions
28
hr_attendance_report_theoretical_time/readme/DESCRIPTION.md
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,28 @@ | ||
This module adds a new report called "Theoretical vs Attended Time | ||
Analysis" that compares worked time, measured through attendances | ||
records, with the theoretical time, computed from employee's working | ||
calendar, public holidays and employee specific leaves. Missing | ||
attendance days are generated on the fly in the report with their | ||
corresponding theoretical hours. | ||
|
||
There is the possibility of counting as theoretical time some leave | ||
types if specified in them. | ||
|
||
As an example, imagine a work week with 40 theoretical hours, and these | ||
attendance situation: | ||
|
||
- Monday: Worked 10 hours | ||
- Tuesday: Worked 10 hours | ||
- Wednesday: Worked 10 hours | ||
- Thursday: Worked 10 hours | ||
- Friday: Ask for a compensation leave (said leave type), as already | ||
worked 40 hours. | ||
|
||
On the report, whole week should put 40 theoretical hours - 8 per day - | ||
against 40 worked hours (although they were on previous days, and none | ||
on Friday). | ||
|
||
On contrary, if you want to take a holiday one of that days, you should | ||
ask for a leave type without the check for counting as theoretical time, | ||
and then the whole week will be 32 theoretical hours against the worked | ||
hours of that week without the leave. |
26 changes: 0 additions & 26 deletions
26
hr_attendance_report_theoretical_time/readme/DESCRIPTION.rst
This file was deleted.
Oops, something went wrong.
Oops, something went wrong.