=====================================
Theoretical vs Attended Time Analysis
=====================================
.. !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
!! This file is generated by oca-gen-addon-readme !!
!! changes will be overwritten. !!
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
.. |badge1| image:: https://img.shields.io/badge/maturity-Beta-yellow.png
:target: https://odoo-community.org/page/development-status
:alt: Beta
.. |badge2| image:: https://img.shields.io/badge/licence-AGPL--3-blue.png
: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/13.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-13-0/hr-attendance-13-0-hr_attendance_report_theoretical_time
:alt: Translate me on Weblate
.. |badge5| image:: https://img.shields.io/badge/runbot-Try%20me-875A7B.png
:target: https://runbot.odoo-community.org/runbot/288/13.0
:alt: Try me on Runbot
|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.
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.
**Table of contents**
.. contents::
:local:
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.
Configuration
=============
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".
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:
#. Go to *Employees > Employees*.
#. Select an employee.
#. Go to "HR Settings" page.
#. 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.
Usage
=====
#. Go to *Attendances > Reporting > Theoretical vs Attended Time Analysis*.
#. 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.
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 smashing it by providing a detailed and welcomed
`feedback <https://github.com/OCA/hr-attendance/issues/new?body=module:%20hr_attendance_report_theoretical_time%0Aversion:%2013.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>`__:
* Pedro M. Baeza.
* David Vidal
* Víctor Martínez
* Pedro Gonzalez <pedro.gonzalez@pesol.es>
Other credits
~~~~~~~~~~~~~
**Images**
* Font Awesome: `Icon <http://fontawesome.io>`_.
Maintainers
~~~~~~~~~~~
This module is maintained by the OCA.
.. image:: https://odoo-community.org/logo.png
:alt: Odoo Community Association
:target: https://odoo-community.org
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/13.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.
Raw data
{
"_id": null,
"home_page": "https://github.com/OCA/hr-attendance",
"name": "odoo13-addon-hr-attendance-report-theoretical-time",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.5",
"maintainer_email": "",
"keywords": "",
"author": "Tecnativa, Odoo Community Association (OCA)",
"author_email": "support@odoo-community.org",
"download_url": "",
"platform": null,
"description": "=====================================\nTheoretical vs Attended Time Analysis\n=====================================\n\n.. !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!\n !! This file is generated by oca-gen-addon-readme !!\n !! changes will be overwritten. !!\n !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!\n\n.. |badge1| image:: https://img.shields.io/badge/maturity-Beta-yellow.png\n :target: https://odoo-community.org/page/development-status\n :alt: Beta\n.. |badge2| image:: https://img.shields.io/badge/licence-AGPL--3-blue.png\n :target: http://www.gnu.org/licenses/agpl-3.0-standalone.html\n :alt: License: AGPL-3\n.. |badge3| image:: https://img.shields.io/badge/github-OCA%2Fhr--attendance-lightgray.png?logo=github\n :target: https://github.com/OCA/hr-attendance/tree/13.0/hr_attendance_report_theoretical_time\n :alt: OCA/hr-attendance\n.. |badge4| image:: https://img.shields.io/badge/weblate-Translate%20me-F47D42.png\n :target: https://translation.odoo-community.org/projects/hr-attendance-13-0/hr-attendance-13-0-hr_attendance_report_theoretical_time\n :alt: Translate me on Weblate\n.. |badge5| image:: https://img.shields.io/badge/runbot-Try%20me-875A7B.png\n :target: https://runbot.odoo-community.org/runbot/288/13.0\n :alt: Try me on Runbot\n\n|badge1| |badge2| |badge3| |badge4| |badge5| \n\nThis module adds a new report called \"Theoretical vs Attended Time Analysis\"\nthat compares worked time, measured through attendances records, with the\ntheoretical time, computed from employee's working calendar, public holidays\nand employee specific leaves. Missing attendance days are generated on the fly\nin the report with their corresponding theoretical hours.\n\nThere is the possibility of counting as theoretical time some leave types if\nspecified in them.\n\nAs an example, imagine a work week with 40 theoretical hours, and these\nattendance situation:\n\n* Monday: Worked 10 hours\n* Tuesday: Worked 10 hours\n* Wednesday: Worked 10 hours\n* Thursday: Worked 10 hours\n* Friday: Ask for a compensation leave (said leave type), as already worked\n 40 hours.\n\nOn the report, whole week should put 40 theoretical hours - 8 per day - against\n40 worked hours (although they were on previous days, and none on Friday).\n\nOn contrary, if you want to take a holiday one of that days, you should ask for\na leave type without the check for counting as theoretical time, and then the\nwhole week will be 32 theoretical hours against the worked hours of that week\nwithout the leave.\n\n**Table of contents**\n\n.. contents::\n :local:\n\nInstallation\n============\n\nOn installation time, this module computes the theoretical hours for the day of\nthe attendance check-in, so if you have a lot of records, this would be a bit\nslow.\n\nConfiguration\n=============\n\nYou need to be at least \"Attendance / Manual Attendance\" for being able to see\nthe attendances report.\n\nFor including some leave types in the theoretical time, you have to:\n\n#. Go to *Leaves > Configuration > Leave Types*.\n#. Select leave type you want to include.\n#. Check the mark \"Include in theoretical hours\".\n\nWhen generating non worked days, this module uses a start date for beginning\nthe series generation, which is:\n\n* Manual start date set on the employee.\n* If not set, the greatest of these 2 dates:\n\n * Employee creation date.\n * Working calendar line start date.\n\nFor configuring manual start date, you have to:\n\n#. Go to *Employees > Employees*.\n#. Select an employee.\n#. Go to \"HR Settings\" page.\n#. Set the date in \"Theoretical hours start date\" field.\n\nThe generation will stop on the end date of the working calendar line or today,\nso don't forget to properly set start and end dates of the lines of the working\ncalendar for not leaving empty spaces between them.\n\nUsage\n=====\n\n#. Go to *Attendances > Reporting > Theoretical vs Attended Time Analysis*.\n#. Check pivot table or look at the graph view.\n\nKnown issues / Roadmap\n======================\n\n* Employees with less than 1 week in the company will show full week\n theoretical hours.\n* Activate ORM cache for improving performance on computing theoretical hours,\n but assuring that the cache is cleared when the conditions of the computation\n changes.\n* If you change employee's working time, theoretical hours for non attended\n days will be computed according this new calendar. You have to define\n start and end dates inside the calendar for avoiding this side effect.\n* Theoretical hours of affected days when changing the leave type to be\n included or not in theoretical time are not recomputed.\n\nBug Tracker\n===========\n\nBugs are tracked on `GitHub Issues <https://github.com/OCA/hr-attendance/issues>`_.\nIn case of trouble, please check there if your issue has already been reported.\nIf you spotted it first, help us smashing it by providing a detailed and welcomed\n`feedback <https://github.com/OCA/hr-attendance/issues/new?body=module:%20hr_attendance_report_theoretical_time%0Aversion:%2013.0%0A%0A**Steps%20to%20reproduce**%0A-%20...%0A%0A**Current%20behavior**%0A%0A**Expected%20behavior**>`_.\n\nDo not contact contributors directly about support or help with technical issues.\n\nCredits\n=======\n\nAuthors\n~~~~~~~\n\n* Tecnativa\n\nContributors\n~~~~~~~~~~~~\n\n* `Tecnativa <https://www.tecnativa.com>`__:\n\n * Pedro M. Baeza.\n * David Vidal\n * V\u00edctor Mart\u00ednez\n* Pedro Gonzalez <pedro.gonzalez@pesol.es>\n\nOther credits\n~~~~~~~~~~~~~\n\n**Images**\n\n* Font Awesome: `Icon <http://fontawesome.io>`_.\n\nMaintainers\n~~~~~~~~~~~\n\nThis module is maintained by the OCA.\n\n.. image:: https://odoo-community.org/logo.png\n :alt: Odoo Community Association\n :target: https://odoo-community.org\n\nOCA, or the Odoo Community Association, is a nonprofit organization whose\nmission is to support the collaborative development of Odoo features and\npromote its widespread use.\n\nThis module is part of the `OCA/hr-attendance <https://github.com/OCA/hr-attendance/tree/13.0/hr_attendance_report_theoretical_time>`_ project on GitHub.\n\nYou are welcome to contribute. To learn how please visit https://odoo-community.org/page/Contribute.\n\n\n",
"bugtrack_url": null,
"license": "AGPL-3",
"summary": "Theoretical vs Attended Time Analysis",
"version": "13.0.1.1.5",
"project_urls": {
"Homepage": "https://github.com/OCA/hr-attendance"
},
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "531266b2de6f848adbce588b20570fc08f377e879087fecf4f8437b2d72c8aaa",
"md5": "002bcfde9455cab488564a33f9b92dd1",
"sha256": "bf3329789ceaea3f552643ae96c84c9b99c292a5e1c80a84304cb45bae496ffc"
},
"downloads": -1,
"filename": "odoo13_addon_hr_attendance_report_theoretical_time-13.0.1.1.5-py3-none-any.whl",
"has_sig": false,
"md5_digest": "002bcfde9455cab488564a33f9b92dd1",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.5",
"size": 56451,
"upload_time": "2023-07-04T15:01:13",
"upload_time_iso_8601": "2023-07-04T15:01:13.942877Z",
"url": "https://files.pythonhosted.org/packages/53/12/66b2de6f848adbce588b20570fc08f377e879087fecf4f8437b2d72c8aaa/odoo13_addon_hr_attendance_report_theoretical_time-13.0.1.1.5-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-07-04 15:01:13",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "OCA",
"github_project": "hr-attendance",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "odoo13-addon-hr-attendance-report-theoretical-time"
}
JSON
