[ADD] Time off: new my time doc

closes odoo/documentation#9837

Signed-off-by: Samuel Lieber (sali) <sali@odoo.com>
This commit is contained in:
Lara Martini (larm) 2024-06-14 15:58:29 -04:00
parent d31b997900
commit 2ed1db8304
4 changed files with 115 additions and 105 deletions

View File

@ -589,111 +589,6 @@ the time off request in a modal, click the :guilabel:`View` button.
:align: center
:alt: Overview of the user's team, with time off requests shown.
My time
=======
The :guilabel:`My Time` section of the *Time Off* application contains the time off dashboard, as
well as the user's time off requests and allocations.
.. _time_off/dashboard:
Dashboard
---------
All users have access to the time off dashboard, which is the default view in the *Time Off*
application. The dashboard can also be accessed at any point in the application by navigating to
:menuselection:`Time Off app --> My Time --> Dashboard`.
The current year is displayed, and the current day is highlighted in red.
To change the view, click on the :guilabel:`Year` button to reveal a drop-down menu. Then, select
either :guilabel:`Day`, :guilabel:`Week`, or :guilabel:`Month` to present the calendar in that
corresponding view.
To change the presented dates, click the :guilabel:`← (left arrow)` or :guilabel:`→ (right arrow)`
icons to the left of the :guilabel:`Year` button. The calendar view adjusts in increments of the
presented view.
For example, if :guilabel:`Year` is selected, the arrows adjust the view by one year.
To change the view at any point to a view that includes the current date, click the
:guilabel:`Today` button.
Above the calendar view is a summary of the user's time off balances. Every time off type that has
been allocated appears in its own summary box. Each summary lists the type of time off, the
corresponding icon, the current available balance (in hours or days), and an expiration date (if
applicable).
To view the full details of a time off balance, click the :guilabel:`? (question mark)` icon at the
end of the :guilabel:`(DAYS/HOURS) AVAILABLE` on the time off summary. The complete details are
presented in a popover window, including the :guilabel:`Allocated` time, future :guilabel:`Accrual`
time, :guilabel:`Approved` time off scheduled, :guilabel:`Planned` time off, and the currently
:guilabel:`Available` time off.
.. image:: time_off/balance-details.png
:align: center
:alt: A view of the complete time off balance details in the popover window.
A user is also able to see how much time off they will have accrued in the future. On the right side
of the time off summary blocks, there is a :guilabel:`Balance at the (date)` field. Click on the
date, and a calendar selector popover appears.
The current date is the default date selected. Navigate to the desired date, and Odoo displays the
time off balances the user will have on that date. This takes into account all time off currently
planned and approved. To return to the current date, click the :guilabel:`Today` button to the right
of the date field.
On the right side of the calendar, the various time off types are displayed, with their
corresponding colors. The :guilabel:`Legend` explains how the various statuses for time off requests
are presented.
Time off that has been validated appears in a solid color (in the color specified in the
:guilabel:`Time Off Type` section above the :guilabel:`Legend`). Time off requests that still need
to be approved appear with white stripes in the color. Refused time off requests have a colored line
through the dates.
New time off requests can be made from the :guilabel:`Dashboard`. Click the :guilabel:`New` button
at the top of the dashboard, and a :doc:`New Time Off <../hr/time_off/request_time_off>` pop-up
window appears.
New allocation requests can also be made from the :guilabel:`Dashboard`. Click the :guilabel:`New
Allocation Request` button at the top of the :guilabel:`Dashboard` to request more time off, and a
:ref:`New Allocation <time_off/request-allocation>` modal appears.
.. image:: time_off/dashboard.png
:align: center
:alt: Time off dashboard view with the legend, time off summaries, and view buttons highlighted.
.. _time_off/my-time-off:
My time off
-----------
To view a list of all the user's time off requests, navigate to :menuselection:`Time Off app --> My
Time --> My Time Off`. Here, all time off requests, both past and present, appear in a list view.
The list includes the following information for each request: the :guilabel:`Time Off Type`,
:guilabel:`Description`, :guilabel:`Start Date`, :guilabel:`End Date`, :guilabel:`Duration`, and the
:guilabel:`Status`.
A new time off request can be made from this view. Click the :guilabel:`New` button to :doc:`request
time off <../hr/time_off/request_time_off>`.
.. _time_off/my-allocations:
My allocations
--------------
To view a list of all the user's allocations, navigate to :menuselection:`Time Off app --> My Time
--> My Allocations`. All allocations and requested allocations appear in a list view.
The information presented on the :guilabel:`My Allocations` page includes: the :guilabel:`Time Off
Type`, :guilabel:`Description`, :guilabel:`Amount`, :guilabel:`Allocation Type`, and
:guilabel:`Status`.
A new allocation request can be made from this view, as well. Click the :guilabel:`New` button to
:ref:`request an allocation <time_off/request-allocation>`.
.. _time_off/reporting:
Reporting
@ -770,10 +665,12 @@ detailed information on the reports, and their various options, refer to the :do
.. seealso::
- :doc:`time_off/request_time_off`
- :doc:`time_off/my_time`
- :doc:`time_off/management`
.. toctree::
:titlesonly:
time_off/request_time_off
time_off/my_time
time_off/management

View File

@ -0,0 +1,113 @@
=======
My time
=======
The *My Time* menu of the *Time Off* application houses all the various time off information for
the signed-in user.
This includes the main *Time Off* dashboard, which displays an overview of the various time off
balances, as well as time-off requests and allocations.
.. _time_off/dashboard:
Dashboard
---------
All users have access to the *Time Off* :guilabel:`Dashboard`, which is the first page that appears
when the *Time Off* application is opened. The :guilabel:`Dashboard` can also be accessed at any
point in the application, by navigating to :menuselection:`Time Off app --> My Time --> Dashboard`.
The current year is displayed, and the current day is highlighted in a red circle.
To change the view, click on the :guilabel:`Year` button to reveal a drop-down menu. Then, select
either :guilabel:`Day`, :guilabel:`Week`, or :guilabel:`Month` to present the calendar in that
corresponding view.
.. note::
To change the displayed dates, click the :icon:`fa-arrow-left` :guilabel:`(left arrow)` or
:icon:`fa-arrow-right` :guilabel:`(right arrow)` icons to the left of the :guilabel:`Year`
button. The calendar view adjusts in increments of the selected view.
For example, if :guilabel:`Year` is selected, the arrows adjust the view by one year.
To reset the view, so it includes the current date, click the :guilabel:`Today` button.
Above the calendar view is a summary of the user's time off balances. Every time off type that has
been allocated appears in its own summary box. Each summary lists the type of time off, the
corresponding icon, the current available balance (in hours or days), and an expiration date (if
applicable).
To view the full details of a time off balance, click the :icon:`fa-question-circle-o`
:guilabel:`(question mark)` icon at the end of the :guilabel:`(DAYS/HOURS) AVAILABLE` on the time
off summary. The complete details are presented in a popover window, including the
:guilabel:`Allocated` time, :guilabel:`Accrual (Future)` time, :guilabel:`Approved` time off
scheduled, :guilabel:`Planned` time off, and the currently :guilabel:`Available` time off.
.. image:: my_time/balance-details.png
:align: center
:alt: A view of the complete time off balance details in the popover window.
A user can also select a future date to see an estimate of how much time they should accrue by that
point. On the right side of the time off summary blocks, there is a :guilabel:`Balance at the
(date)` field. Click on the date, and a calendar selector popover appears.
.. note::
The :guilabel:`Balance at the (date)` field **only** appears if the user is accruing time off
through an :ref:`accrual plan <time_off/accrual-plans>`.
The current date is the default date selected. Navigate to the desired date, and Odoo displays the
time off balances the user should have on that date. This takes into account all time off currently
planned and approved. To return to the current date, click the :guilabel:`Today` button to the right
of the date field.
On the right side of the calendar, the various time off types are displayed, each with their own
corresponding color. The :guilabel:`Legend` explains how the various statuses for time off requests
are presented.
Time off that has been validated appears in a solid color. Time off requests that still are still in
the :guilabel:`To Approve` stage, appear with white stripes in the color. :guilabel:`Refused` time
off requests have a line through the dates.
The color for each request corresponds to the specified color set with the various time off types,
listed in the section above the :guilabel:`Legend`.
New time off requests can be made from the :guilabel:`Dashboard`. Click the :guilabel:`New` button
in the upper-left corner, and a :doc:`New Time Off <request_time_off>` pop-up window appears.
New allocation requests can also be made from the :guilabel:`Dashboard`. Click the :guilabel:`New
Allocation Request` button to request more time off, and a :ref:`New Allocation
<time_off/request-allocation>` pop-up window appears.
.. image:: my_time/dashboard.png
:align: center
:alt: Time off dashboard view with the legend, time off summaries, and view buttons highlighted.
.. _time_off/my-time-off:
My time off
-----------
To view a list of all the time off requests, navigate to :menuselection:`Time Off app --> My Time
--> My Time Off`. Here, all time off requests, both past and present, appear in a list view.
The list includes the following information for each request: the :guilabel:`Time Off Type`,
:guilabel:`Description`, :guilabel:`Start Date`, :guilabel:`End Date`, :guilabel:`Duration`, and
:guilabel:`Status`.
A new time off request can be made from this view. Click the :guilabel:`New` button to
:doc:`request_time_off`.
.. _time_off/my-allocations:
My allocations
--------------
To view a list of all allocations, navigate to :menuselection:`Time Off app --> My Time --> My
Allocations`. All allocations and requested allocations appear in a list view.
The information presented on the :guilabel:`My Allocations` page includes: :guilabel:`Time Off
Type`, :guilabel:`Description`, :guilabel:`Amount`, :guilabel:`Allocation Type`, and
:guilabel:`Status`.
A new allocation request can be made from this view, as well. Click the :guilabel:`New` button to
:ref:`request an allocation <time_off/request-allocation>`.

View File

Before

Width:  |  Height:  |  Size: 40 KiB

After

Width:  |  Height:  |  Size: 40 KiB

View File

Before

Width:  |  Height:  |  Size: 30 KiB

After

Width:  |  Height:  |  Size: 30 KiB