oca-mrp/odoo-bringout-oca-timesheet-hr_timesheet_sheet/hr_timesheet_sheet

==================
HR Timesheet Sheet
==================

.. 
   !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
   !! This file is generated by oca-gen-addon-readme !!
   !! changes will be overwritten.                   !!
   !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
   !! source digest: sha256:faddd2bab01c77bceef23115853e6806a0b39685cf857967bba202ca08e84895
   !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!

.. |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%2Ftimesheet-lightgray.png?logo=github
    :target: https://github.com/OCA/timesheet/tree/16.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-16-0/timesheet-16-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=16.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:%2016.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>

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/16.0/hr_timesheet_sheet>`_ project on GitHub.

You are welcome to contribute. To learn how please visit https://odoo-community.org/page/Contribute.