.. image:: https://odoo-community.org/readme-banner-image
:target: https://odoo-community.org/get-involved?utm_source=readme
:alt: Odoo Community Association
==================
HR Timesheet Sheet
==================
..
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
!! This file is generated by oca-gen-addon-readme !!
!! changes will be overwritten. !!
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
!! source digest: sha256:38e8716bc0160c1e4fc736d5ae81a37f8f7a2e9abfd098bd7bd0bffef8b2cc6c
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
.. |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/license-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%2Ftimesheet-lightgray.png?logo=github
:target: https://github.com/OCA/timesheet/tree/18.0/hr_timesheet_sheet
:alt: OCA/timesheet
.. |badge4| image:: https://img.shields.io/badge/weblate-Translate%20me-F47D42.png
:target: https://translation.odoo-community.org/projects/timesheet-18-0/timesheet-18-0-hr_timesheet_sheet
: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/timesheet&target_branch=18.0
:alt: Try me on Runboat
|badge1| |badge2| |badge3| |badge4| |badge5|
This module supplies a new screen enabling you to manage your work
encoding (timesheet) by period. Timesheet entries are made by employees
each day. At the end of the defined period, employees submit their
validated sheet and the reviewer must then approve submitted entries.
Periods are defined in the company forms and you can set them to run
monthly, weekly or daily. By default, policy is configured to have HR
Officers as reviewers.
**Table of contents**
.. contents::
:local:
Installation
============
This module relies on:
- The OCA module '2D matrix for x2many fields', and can be downloaded
from Github:
https://github.com/OCA/web/tree/16.0/web_widget_x2many_2d_matrix
Configuration
=============
If you want other default ranges different from weekly, you need to go:
- In the menu Configuration -> Settings -> **Timesheet Options**, and
select in **Timesheet Sheet Range** the default range you want.
- When you have a weekly range you can also specify the **Week Start
Day**.
To change who reviews submitted sheets, go to *Configuration > Settings
> Timesheet Options* and configure **Timesheet Sheet Review Policy**
accordingly.
For adding more review policies, look at the
*hr_timesheet_sheet_policy_xxx* extra modules.
Usage
=====
If you modify the Details tab, automatically the Summary tab is updated.
But if you modify the Summary tab, you need to save in order to have the
Details tab updated.
In case you modify the unit amount of both tabs, the Details tab will
prevail. If you modify the Summary tab, and you need to do a change in
the Details tab, please save before.
Known issues / Roadmap
======================
- The timesheet grid is limited to display a max. of 1M cells, due to a
limitation of the tree view limit parameter not being able to
dynamically set a limit. Since default value of odoo, 40 records is
too small, we decided to set 1M, which should be good enough in the
majority of scenarios.
Bug Tracker
===========
Bugs are tracked on `GitHub Issues <https://github.com/OCA/timesheet/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/timesheet/issues/new?body=module:%20hr_timesheet_sheet%0Aversion:%2018.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
-------
* ForgeFlow
* Onestein
* CorporateHub
Contributors
------------
- Miquel Raïch <miquel.raich@forgeflow.com>
- Andrea Stirpe <a.stirpe@onestein.nl>
- Lois Rilo <lois.rilo@forgeflow.com>
- `CorporateHub <https://corporatehub.eu/>`__
- Alexey Pelykh <alexey.pelykh@corphub.eu>
- Dennis Sluijk <d.sluijk@onestein.nl>
- Sunanda Chhatbar <sunanda.chhatbar@initos.com>
- `Sodexis <https://www.sodexis.com>`__
- SodexisTeam <dev@sodexis.com>
- Sowrirajan <sowrirajan@sodexis.com>
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/timesheet <https://github.com/OCA/timesheet/tree/18.0/hr_timesheet_sheet>`_ project on GitHub.
You are welcome to contribute. To learn how please visit https://odoo-community.org/page/Contribute.
d48a6967cf