Skip to content

Commit 9535432

Browse files
mcsi-odoomcsi-odoo
committed
[ADD] spreadsheet: sharing and collaborating on spreadsheets
task-4943669 X-original-commit: 27a5a22
1 parent bedf2f7 commit 9535432

File tree

2 files changed

+300
-0
lines changed

2 files changed

+300
-0
lines changed

‎content/applications/productivity/spreadsheet.rst‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -13,6 +13,7 @@ Spreadsheet
1313
spreadsheet/insert
1414
spreadsheet/work_with_data
1515
spreadsheet/visualize_data
16+
spreadsheet/share_collaborate
1617

1718
**Odoo Spreadsheet** allows you to organize, manipulate, analyze, and visualize data. It offers
1819
similar functionality to other spreadsheet solutions with the added benefit of integrating directly

‎content/applications/productivity/spreadsheet/share_collaborate.rst‎

Lines changed: 299 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,299 @@
1+
=====================
2+
Share and collaborate
3+
=====================
4+
5+
Odoo Spreadsheet offers various features that allow for efficient real-time collaboration while
6+
ensuring the appropriate level of control and traceability, including:
7+
8+
- :ref:`permission-based sharing <spreadsheet/collaboration/access-sharing>`
9+
- :ref:`version history <spreadsheet/get-started/manage-spreadsheets-versioning>`
10+
- discussions via :ref:`comments and the spreadsheet's chatter thread
11+
<spreadsheet/collaboration/chatter>`
12+
13+
.. _spreadsheet/collaboration/access-sharing:
14+
15+
Access and sharing
16+
==================
17+
18+
In principle, the rights to access Odoo spreadsheets are handled like :ref:`any other file in the
19+
Documents app <documents/access-rights>`. :ref:`Roles and permissions
20+
<spreadsheet/collaboration/roles-permissions>` are either inherited from the folder a spreadsheet is
21+
saved in or controlled at the level of the spreadsheet itself.
22+
23+
However, there are important differences to consider between :ref:`spreadsheets that contain only
24+
static data <spreadsheet/collaboration/static-spreadsheet>` and :ref:`spreadsheets that contain
25+
dynamic Odoo data <spreadsheet/collaboration/dynamic-spreadsheet>`, in terms of both access and data
26+
visibility.
27+
28+
.. tip::
29+
30+
- Access to a folder or spreadsheet can be managed by its owner or any user with
31+
:guilabel:`Editor` rights.
32+
- A user with :guilabel:`Viewer` rights cannot share a spreadsheet with a specific user
33+
directly, but can copy a link to the spreadsheet.
34+
- Any user with access to a spreadsheet can download it as an `.xlsx` file by clicking
35+
:menuselection:`File -->` :icon:`os-download` :menuselection:`Download` from the menu bar. If
36+
the spreadsheet contained dynamic data, the values are frozen at the moment of download.
37+
38+
.. _spreadsheet/collaboration/roles-permissions:
39+
40+
Roles and permissions
41+
---------------------
42+
43+
Permissions are managed using the following roles:
44+
45+
.. list-table::
46+
:header-rows: 1
47+
:stub-columns: 1
48+
:widths: 5 5 5 5 5 5 5 5 5
49+
50+
* - Role
51+
- View
52+
- Edit
53+
- Delete
54+
- Download .xlsx
55+
- Share
56+
- Manage roles
57+
- Use comments
58+
- Use chatter
59+
* - Owner
60+
- :icon:`fa-check`
61+
- :icon:`fa-check`
62+
- :icon:`fa-check`
63+
- :icon:`fa-check`
64+
- :icon:`fa-check` with specific people or via link
65+
- :icon:`fa-check` including changing owner
66+
- :icon:`fa-check`
67+
- :icon:`fa-check`
68+
* - Editor
69+
- :icon:`fa-check`
70+
- :icon:`fa-check`
71+
- :icon:`fa-check`
72+
- :icon:`fa-check`
73+
- :icon:`fa-check` with specific people or via link
74+
- :icon:`fa-check` but cannot change owner
75+
- :icon:`fa-check`
76+
- :icon:`fa-check`
77+
* - Viewer
78+
- :icon:`fa-check`
79+
- :icon:`oi-close`
80+
- :icon:`oi-close`
81+
- :icon:`fa-check`
82+
- :icon:`fa-check` only via link
83+
- :icon:`oi-close`
84+
- :icon:`oi-close`
85+
- :icon:`fa-check`
86+
87+
.. _spreadsheet/collaboration/static-spreadsheet:
88+
89+
Share a static spreadsheet
90+
--------------------------
91+
92+
Spreadsheets containing only static data can be shared internally or externally by the owner of the
93+
spreadsheet or any user with :guilabel:`Editor` rights.
94+
95+
To do so, click :icon:`fa-share-alt` :guilabel:`Share` in the upper-right corner above the
96+
spreadsheet, then :ref:`configure access as appropriate <documents/access-rights>`.
97+
98+
.. _spreadsheet/collaboration/dynamic-spreadsheet:
99+
100+
Share a dynamic spreadsheet
101+
---------------------------
102+
103+
A spreadsheet is considered a *dynamic spreadsheet* if it contains any of the following:
104+
105+
- formulas that retrieve live data from an Odoo database, e.g., in a :doc:`list or pivot table that
106+
has been inserted into the spreadsheet <insert>`
107+
- a linked :ref:`data source <spreadsheet/insert/data-sources>`, even if the corresponding list or
108+
pivot table has been deleted from the spreadsheet
109+
- links to Odoo menu items
110+
111+
Internal sharing
112+
~~~~~~~~~~~~~~~~
113+
114+
Spreadsheets containing dynamic Odoo data can be shared *with internal users only* by the owner of
115+
the spreadsheet or any user with :guilabel:`Editor` rights.
116+
117+
However, having access to a spreadsheet does not necessarily mean an internal user *sees* all the
118+
data in the original spreadsheet. The visibility of dynamic Odoo data is based on an internal user’s
119+
access rights to the model from which the data has been retrieved, and takes into account any record
120+
rules that may restrict access.
121+
122+
.. important::
123+
Permissions to view data are taken into account when an internal user opens a spreadsheet, with
124+
the spreadsheet only being populated with data the user is authorized to see.
125+
126+
.. example::
127+
A sales manager creates a spreadsheet that includes sales data for all the salespeople in their
128+
team. Users with the permission `Sales / User: Own Documents Only` only see data related to
129+
their own sales.
130+
131+
To share a spreadsheet containing dynamic Odoo data, click :icon:`fa-share-alt` :guilabel:`Share` in
132+
the upper-right corner above the spreadsheet, then :ref:`configure access as appropriate
133+
<documents/access-rights>`.
134+
135+
External sharing
136+
~~~~~~~~~~~~~~~~
137+
138+
Spreadsheets containing dynamic Odoo data *cannot be accessed by external users*.
139+
140+
.. note::
141+
If an external user attempts to access a dynamic spreadsheet via a link, an error message is
142+
shown.
143+
144+
If a spreadsheet containing Odoo data needs to be shared with an external user, the owner of the
145+
spreadsheet or a user with :guilabel:`Editor` rights can create a frozen, read-only version. In this
146+
version, all Odoo formulas are converted to their value at the moment the frozen version is created,
147+
and any links to Odoo menus are removed.
148+
149+
To create a frozen version of a spreadsheet that contains dynamic Odoo data, click
150+
:icon:`fa-share-alt` :guilabel:`Freeze and share` in the upper-right corner above the spreadsheet,
151+
then :ref:`configure access as appropriate <documents/access-rights>`.
152+
153+
.. tip::
154+
It is also possible to download a frozen version of a spreadsheet that contains Odoo data as an
155+
`.xlsx` file by clicking :menuselection:`File -->` :icon:`os-download` :menuselection:`Download`
156+
from the menu bar. The values of any dynamic data are frozen at the moment of download.
157+
158+
.. _spreadsheet/collaboration/comments-chatter:
159+
160+
Comments and chatter
161+
====================
162+
163+
Odoo Spreadsheet offers two ways to communicate with other users who have access to the same
164+
spreadsheet, namely by using:
165+
166+
- :ref:`comments <spreadsheet/collaboration/comments>`
167+
- the spreadsheet's :ref:`chatter thread <spreadsheet/collaboration/chatter>`
168+
169+
.. _spreadsheet/collaboration/comments:
170+
171+
Use comments in a spreadsheet
172+
-----------------------------
173+
174+
Comments, which are added to individual spreadsheet cells, are useful for discussing specific
175+
elements of a spreadsheet. Other collaborators can be notified by typing `@` followed by their
176+
name.
177+
178+
.. important::
179+
Only the spreadsheet's owner or users with :guilabel:`Editor` rights can use comments in a
180+
spreadsheet; both roles can perform the same actions. Comments are not visible to users with
181+
:guilabel:`Viewer` rights.
182+
183+
.. _spreadsheet/collaboration/comments-add-react:
184+
185+
Add or react to comments
186+
~~~~~~~~~~~~~~~~~~~~~~~~
187+
188+
To add or react to a comment:
189+
190+
#. If the comment is:
191+
192+
- the first comment being added to the cell, right-click the cell then click :icon:`os-comments`
193+
:guilabel:`Insert comment` or click :menuselection:`Insert -->` :icon:`os-comments`
194+
:menuselection:`Insert comment` from the menu bar.
195+
- a reaction to an existing comment thread on a cell, click on the relevant cell or on the
196+
comment thread to open the thread.
197+
198+
#. Type a comment in the text box.
199+
200+
.. tip::
201+
Type `@` to tag users, or add emojis or GIFs by clicking :icon:`oi-smile-add` :guilabel:`Add a
202+
Reaction`.
203+
204+
#. Click :guilabel:`Send` or press `Ctrl` + `Enter`.
205+
206+
Click anywhere else in the spreadsheet to close the comment thread.
207+
208+
.. tip::
209+
To react to an individual comment with only an emoji, hover over the comment, click the
210+
:icon:`oi-smile-add` :guilabel:`(Add a Reaction)` icon, then select the desired emoji.
211+
212+
.. _spreadsheet/collaboration/comments-view:
213+
214+
View comments
215+
~~~~~~~~~~~~~
216+
217+
When a comment has been added to a cell, a small yellow triangle appears in the top right corner of
218+
the cell.
219+
220+
To view a comment thread on a single cell, hover over the cell; click the cell or the comment
221+
thread to open the thread to be able to add a comment.
222+
223+
To view all comments on a spreadsheet, click :menuselection:`View -->` :icon:`os-comments`
224+
:menuselection:`All comments` from the menu bar. Alternatively, after opening a comment thread,
225+
click :guilabel:`Open all comments`.
226+
227+
The :guilabel:`Comments` panel opens on the right side of the spreadsheet. By default, comment
228+
threads for :guilabel:`All sheets` of the spreadsheet are shown, grouped by sheet. To see only the
229+
comment threads for the current sheet, select :guilabel:`This sheet` in the :guilabel:`Filter
230+
comments` field.
231+
232+
Click on a comment thread in the :guilabel:`Comments` panel to open it.
233+
234+
.. _spreadsheet/collaboration/comments-edit-delete:
235+
236+
Edit or delete comments
237+
~~~~~~~~~~~~~~~~~~~~~~~
238+
239+
.. note::
240+
A spreadsheet's owner or users with :guilabel:`Editor` rights can edit or delete any comment.
241+
242+
To edit a comment:
243+
244+
#. Hover over the comment, then click the :icon:`fa-ellipsis-v` :guilabel:`(ellipsis)` icon.
245+
#. Click :icon:`fa-pencil` :guilabel:`Edit`.
246+
#. Make the desired changes, then click :guilabel:`Save` or press `Enter`. To abort the edit, click
247+
:guilabel:`Cancel` or press `Escape`.
248+
249+
.. tip::
250+
A comment that has been modified has *(edited)* added to the end of the text.
251+
252+
To delete a comment:
253+
254+
#. Hover over the comment, then click the :icon:`fa-ellipsis-v` :guilabel:`(ellipsis)` icon.
255+
#. Click :icon:`fa-trash` :guilabel:`Delete`.
256+
#. Click :guilabel:`Confirm` to confirm the deletion.
257+
258+
.. _spreadsheet/collaboration/comments-resolve:
259+
260+
Resolve comment threads
261+
~~~~~~~~~~~~~~~~~~~~~~~
262+
263+
To resolve a comment thread:
264+
265+
#. Access the :guilabel:`Comments` panel by clicking :menuselection:`View -->` :icon:`os-comments`
266+
:menuselection:`All comments` from the menu bar. Alternatively, with a comment thread open, click
267+
:guilabel:`Open all comments`.
268+
#. Click the :icon:`fa-ellipsis-v` :guilabel:`(ellipsis)` icon for the relevant comment thread, then
269+
click :guilabel:`Resolve this thread`.
270+
271+
Once resolved, the comment thread is no longer accessible directly on the spreadsheet, but remains
272+
visible in the :guilabel:`Comments` panel; resolved threads are identified by a :icon:`fa-check`
273+
:guilabel:`(check)` icon.
274+
275+
To reopen a resolved comment thread, from the :guilabel:`Comments` panel, click the
276+
:icon:`fa-ellipsis-v` :guilabel:`(ellipsis)` icon for the relevant comment thread, then click
277+
:guilabel:`Re-open this thread`.
278+
279+
.. _spreadsheet/collaboration/chatter:
280+
281+
Use a spreadsheet's chatter thread
282+
----------------------------------
283+
284+
Whereas :ref:`comments <spreadsheet/collaboration/comments>` on specific spreadsheet cells are
285+
suited for discussions about specific elements of a spreadsheet, a spreadsheet’s :doc:`chatter
286+
thread <../discuss/chatter>` allows for a more general discussion.
287+
288+
To access the chatter thread of a spreadsheet:
289+
290+
#. With the **Documents** app open, navigate to the folder or section where the spreadsheet is
291+
saved.
292+
#. Select the :icon:`oi-view-list` :guilabel:`(List)` view in the upper-right corner.
293+
#. Select the relevant spreadsheet, then click the :icon:`fa-info-circle` :guilabel:`(Info & tags)`
294+
button in the upper-right corner next to the view selector. Alternatively, with the spreadsheet
295+
selected, click the :icon:`fa-cog` :guilabel:`Action` button, then select :icon:`fa-info-circle`
296+
:guilabel:`(Info & tags)`.
297+
298+
The spreadsheet’s chatter thread opens on the right of the screen, below the spreadsheet's
299+
:ref:`details panel <documents/details-panel>`.

0 commit comments

Comments
 (0)