Metadata-Version: 2.1
Name: odoo-addon-hr_timesheet_sheet_warning
Version: 18.0.1.0.0.2
Requires-Python: >=3.10
Requires-Dist: odoo-addon-hr_timesheet_sheet==18.0.*
Requires-Dist: odoo==18.0.*
Summary: Timesheet Sheets, Activities
Home-page: https://github.com/OCA/timesheet
License: AGPL-3
Author: ForgeFlow, Odoo Community Association (OCA)
Author-email: support@odoo-community.org
Classifier: Programming Language :: Python
Classifier: Framework :: Odoo
Classifier: Framework :: Odoo :: 18.0
Classifier: License :: OSI Approved :: GNU Affero General Public License v3
Description-Content-Type: text/x-rst

.. 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 Warning
==========================

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

.. |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_warning
    :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_warning
    :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 provides functionality for defining custom warning criteria
related to Timesheet Sheets using Python expressions. Users can
establish specific conditions for evaluating certain aspects of the
Sheets. Once the warnings are defined, the module facilitates a
systematic evaluation of Timesheet Sheets against these conditions. It
generates individual warnings for each Sheet, if the warnings criteria
are met.

**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

Usage
=====

In order to create warning definitions for Timesheet Sheets, you need to
go:

- In the menu Configuration -> **Warnings**, and start creating a new
  instance of a warning definition.
- Once inside, you will be able to specify the domain of the warning
  (the Timesheet Sheets it will be checked against) and the warning
  expression (the Python code that will be run and, if it evaluates to
  true, will indicate that a warning should be raised for that specific
  Sheet), amongst other fields.

To run those checks and raise the necessary warnings for a specific
Timesheet Sheet, you need to go:

- When looking at a Timesheet Sheet, go to the 'Warnings' tab.
- There you can press the button 'Generate Warnings', and you will be
  able to see the generated warnings in the list below the button.
- Warnings are also automatically generated when a Timesheet Sheet is
  submitted to the reviewer.

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_warning%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

Contributors
------------

- Laura Cazorla <laura.cazorla@forgeflow.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_warning>`_ project on GitHub.

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