Search 1.9 billion lines of Odoo code on GitHub
project_timesheet_time_control
<h1 class="title">Project timesheet time control</h1>
<p><a class="reference external" href="https://odoo-community.org/page/development-status"><img alt="Beta" src="https://img.shields.io/badge/maturity-Beta-yellow.png" /></a> <a class="reference external" href="http://www.gnu.org/licenses/agpl-3.0-standalone.html"><img alt="License: AGPL-3" src="https://img.shields.io/badge/licence-AGPL--3-blue.png" /></a> <a class="reference external" href="https://github.com/OCA/project/tree/15.0/project_timesheet_time_control"><img alt="OCA/project" src="https://img.shields.io/badge/github-OCA%2Fproject-lightgray.png?logo=github" /></a> <a class="reference external" href="https://translation.odoo-community.org/projects/project-15-0/project-15-0-project_timesheet_time_control"><img alt="Translate me on Weblate" src="https://img.shields.io/badge/weblate-Translate%20me-F47D42.png" /></a> <a class="reference external" href="https://runbot.odoo-community.org/runbot/140/15.0"><img alt="Try me on Runbot" src="https://img.shields.io/badge/runbot-Try%20me-875A7B.png" /></a></p>
<p>Allow to track the exact moment when a timesheet line is started (not only
the day, but also the minute and second) and let users start and stop timers
easily.</p>
<p><strong>Table of contents</strong></p>
<div class="contents local topic" id="contents">
<ul class="simple">
<li><a class="reference internal" href="#installation" id="id1">Installation</a></li>
<li><a class="reference internal" href="#usage" id="id2">Usage</a></li>
<li><a class="reference internal" href="#known-issues-roadmap" id="id3">Known issues / Roadmap</a></li>
<li><a class="reference internal" href="#bug-tracker" id="id4">Bug Tracker</a></li>
<li><a class="reference internal" href="#credits" id="id5">Credits</a><ul>
<li><a class="reference internal" href="#authors" id="id6">Authors</a></li>
<li><a class="reference internal" href="#contributors" id="id7">Contributors</a></li>
<li><a class="reference internal" href="#maintainers" id="id8">Maintainers</a></li>
</ul>
</li>
</ul>
</div>
<a name="installation"></a>
<h2><a class="toc-backref" href="#id1">Installation</a></h2>
<p>This module depends on modules found in these repositories:</p>
<ul class="simple">
<li><a class="reference external" href="https://github.com/OCA/timesheet">OCA/timesheet</a></li>
<li><a class="reference external" href="https://github.com/OCA/web">OCA/web</a></li>
</ul>
<a name="usage"></a>
<h2><a class="toc-backref" href="#id2">Usage</a></h2>
<p>You can access via timesheets:</p>
<ol class="arabic simple">
<li>Go to <em>Timesheets > Timesheet > All Timesheets</em>.</li>
<li>Create a new record.</li>
<li>You will see now that the <em>Date</em> field contains also time information.</li>
<li>If you don't select any "project", you will be able to select any "task",
opened or not.</li>
<li>Selecting a "task", the corresponding "project" is filled.</li>
<li>Selecting a "project", tasks are filtered for only allow
to select opened tasks for that project. Remember that an opened task is
a task whose stage doesn't have "Closed" mark checked.</li>
<li>At the end of the line, you will see a stop button.</li>
<li>When you press this button, the difference between <em>Date</em> field and the
current time is saved in the "Duration" field.</li>
<li>You can modify the <em>Date</em> field for altering the computation of the
duration.</li>
<li>After a record is stopped, you see a <em>Resume</em> button, which will open a
wizard that inherits all relevant values from that timesheet line and lets
you duplicate it to indicate you start working in the same thing.</li>
<li>If you didn't stop the timer, but still hit <em>Resume</em> in any other, the
wizard will tell you that you have a running timer and that starting a new
one will stop the other one that is running.</li>
</ol>
<p>To access the wizard directly:</p>
<ol class="arabic simple">
<li>Go to <em>Timesheet > Timesheet > Start work</em>.</li>
<li>You will be able to enter a new timesheet line from scratch, but by using
this wizard, you avoid problems with old or duplicate running timers.</li>
</ol>
<p>Or via projects:</p>
<ol class="arabic simple">
<li>Go to <em>Project > Projects</em>.</li>
<li>If a project has a running timesheet line, it will display a <em>Stop</em> button.</li>
<li>Other projects that have enabled timesheets will display a <em>Start</em> button
that will open the same wizard as the timesheet lines, but duplicating
project's last timesheet line without a task.</li>
<li>You can see the same in list and form views.</li>
</ol>
<p>Or via tasks:</p>
<ol class="arabic simple">
<li>Go to <em>Project > All Tasks</em>.</li>
<li>If a task has a running timesheet line, it will display a <em>Stop</em> button.</li>
<li>Other tasks that have enabled timesheets will display a <em>Start</em> button
that will open the same wizard as the timesheet lines, duplicating task's
last timesheet line.</li>
<li>You can see the same in list view.</li>
<li>Click on any existing task or create a new one.</li>
<li>You can see the same feature in the action buttons box.</li>
<li>On the <em>Timesheets</em> page, you will be able to handle records the same way
as you do in the above explanation (except the task selection part, which
in this case doesn't appear as it's the current one).</li>
</ol>
<p>Note: All the <em>Start/Resume/Stop</em> features are disabled if you don't belong to
the <em>Timesheets/User</em> group or if you are viewing a timesheet that belongs
to another user.</p>
<a name="known-issues-roadmap"></a>
<h2><a class="toc-backref" href="#id3">Known issues / Roadmap</a></h2>
<ul class="simple">
<li>Rename to <code>hr_timesheet_time_control</code>.</li>
<li>Move to <a class="reference external" href="https://github.com/OCA/timesheet">OCA/timesheet</a>.</li>
</ul>
<a name="bug-tracker"></a>
<h2><a class="toc-backref" href="#id4">Bug Tracker</a></h2>
<p>Bugs are tracked on <a class="reference external" href="https://github.com/OCA/project/issues">GitHub Issues</a>.
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
<a class="reference external" href="https://github.com/OCA/project/issues/new?body=module:%20project_timesheet_time_control%0Aversion:%2015.0%0A%0A**Steps%20to%20reproduce**%0A-%20...%0A%0A**Current%20behavior**%0A%0A**Expected%20behavior**">feedback</a>.</p>
<p>Do not contact contributors directly about support or help with technical issues.</p>
<a name="credits"></a>
<h2><a class="toc-backref" href="#id5">Credits</a></h2>
<a name="authors"></a>
<h3><a class="toc-backref" href="#id6">Authors</a></h3>
<ul class="simple">
<li>Tecnativa</li>
</ul>
<a name="contributors"></a>
<h3><a class="toc-backref" href="#id7">Contributors</a></h3>
<ul>
<li><p class="first"><a class="reference external" href="https://www.tecnativa.com">Tecnativa</a>:</p>
<blockquote>
<ul class="simple">
<li>Pedro M. Baeza</li>
<li>Antonio Espinosa</li>
<li>Carlos Dauden</li>
<li>Sergio Teruel</li>
<li>Luis M. ontalba</li>
<li>Ernesto Tejeda</li>
<li>Jairo Llopis</li>
<li>Carlos Roca</li>
</ul>
</blockquote>
</li>
</ul>
<a name="maintainers"></a>
<h3><a class="toc-backref" href="#id8">Maintainers</a></h3>
<p>This module is maintained by the OCA.</p>
<a class="reference external image-reference" href="https://odoo-community.org"><img alt="Odoo Community Association" src="https://odoo-community.org/logo.png" /></a>
<p>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.</p>
<p>Current <a class="reference external" href="https://odoo-community.org/page/maintainer-role">maintainer</a>:</p>
<p><a class="reference external" href="https://github.com/ernestotejeda"><img alt="ernestotejeda" src="https://github.com/ernestotejeda.png?size=40px" /></a></p>
<p>This module is part of the <a class="reference external" href="https://github.com/OCA/project/tree/15.0/project_timesheet_time_control">OCA/project</a> project on GitHub.</p>
<p>You are welcome to contribute. To learn how please visit <a class="reference external" href="https://odoo-community.org/page/Contribute">https://odoo-community.org/page/Contribute</a>.</p>