summaryrefslogtreecommitdiff
path: root/helpcontent2/source/text/shared/guide/collab.xhp
blob: d6f66df93438aae0d6e92ab9abd00198a9dd17ff (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
<?xml version="1.0" encoding="UTF-8"?>

<!--
 ***********************************************************************
 *
 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
 * 
 * Copyright 2008 by Sun Microsystems, Inc.
 *
 * OpenOffice.org - a multi-platform office productivity suite
 *
 * $RCSfile: collab.xhp,v $
 * $Revision: 1.3 $
 *
 * This file is part of OpenOffice.org.
 *
 * OpenOffice.org is free software: you can redistribute it and/or modify
 * it under the terms of the GNU Lesser General Public License version 3
 * only, as published by the Free Software Foundation.
 *
 * OpenOffice.org is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 * GNU Lesser General Public License version 3 for more details
 * (a copy is included in the LICENSE file that accompanied this code).
 *
 * You should have received a copy of the GNU Lesser General Public License
 * version 3 along with OpenOffice.org.  If not, see
 * <http://www.openoffice.org/license.html>
 * for a copy of the LGPLv3 License.
 *
 ************************************************************************
 -->


		<helpdocument version="1.0">
<meta>
<topic id="textsharedguidecollabxml" indexer="include" status="PUBLISH">
<title id="tit" xml-lang="en-US">Collaboration</title>
<filename>/text/shared/guide/collab.xhp</filename>
</topic>
</meta>
<body>
<bookmark xml-lang="en-US" branch="index" id="bm_id4459669"><bookmark_value>sharing documents;collaboration</bookmark_value>
<bookmark_value>collaboration;sharing documents</bookmark_value>
</bookmark>
<paragraph role="heading" id="hd_id130008" xml-lang="en-US" level="1" l10n="NEW"><variable id="collab"><link href="text/shared/guide/collab.xhp">Collaboration</link>
</variable></paragraph>
<paragraph role="paragraph" id="par_id5821710" xml-lang="en-US" l10n="NEW">In %PRODUCTNAME Writer, Impress, and Draw, only one user at a time can open any document for writing. In Calc, many users can open the same spreadsheet for writing at the same time.</paragraph><comment>Tools - Share Document menu</comment>
<bookmark xml-lang="en-US" branch="hid/.uno:ShareDocument" id="bm_id8779564" localize="false"/><paragraph role="paragraph" id="par_id9590136" xml-lang="en-US" l10n="NEW"><ahelp hid="." visibility="hidden">Opens the Share Document dialog where you can enable or disable collaborative sharing of the document.</ahelp></paragraph><comment>Share Document dialog - Share this spreadsheet with other users</comment>
<bookmark xml-lang="en-US" branch="hid/sc:CheckBox:RID_SCDLG_SHAREDOCUMENT:CB_SHARE" id="bm_id7900021" localize="false"/><paragraph role="paragraph" id="par_id2519913" xml-lang="en-US" l10n="NEW"><ahelp hid="." visibility="hidden">Enable to share the current document with other users. Disable to use the document unshared. This will invalidate the not yet saved edits that other users applied in the time since you last opened or saved this document.</ahelp></paragraph>
<paragraph role="heading" id="hd_id6917020" xml-lang="en-US" level="2" l10n="NEW">Collaboration in Calc</paragraph>
<paragraph role="paragraph" id="par_id4411145" xml-lang="en-US" l10n="NEW">In %PRODUCTNAME Calc, document sharing allows simultaneous write access for many users. Every user who wants to collaborate should enter a name on the <emph>Tools - Options - %PRODUCTNAME - User Data</emph> tab page.</paragraph>
<paragraph role="warning" id="par_id6799218" xml-lang="en-US" l10n="NEW">Some commands are not available (grayed out) when change tracking or document sharing is activated. For a new spreadsheet you cannot apply or insert the grayed out elements. <comment>Spec Doc owner told me that this is work in progress and may change any time</comment></paragraph>
<paragraph role="heading" id="hd_id3274941" xml-lang="en-US" level="3" l10n="NEW">Creating a new spreadsheet</paragraph>
<paragraph role="paragraph" id="par_id9804681" xml-lang="en-US" l10n="NEW">User A creates a new spreadsheet document. The following conditions can apply:</paragraph>
<list type="unordered">
<listitem>
<paragraph role="paragraph" id="par_id2109744" xml-lang="en-US" l10n="NEW">The user does not want to share the spreadsheet for collaboration.</paragraph>
<paragraph role="paragraph" id="par_id5374614" xml-lang="en-US" l10n="NEW">User A opens, edits, and saves the document as described above for Writer, Impress, and Draw document.</paragraph>
</listitem>
<listitem>
<paragraph role="paragraph" id="par_id768761" xml-lang="en-US" l10n="NEW">The user wants to share the document for collaboration.</paragraph>
<paragraph role="paragraph" id="par_id6844691" xml-lang="en-US" l10n="NEW">The user chooses <item type="menuitem">Tools - Share Document</item> to activate the collaboration features for this document. A dialog opens where the user can choose to enable or disable sharing. If the user enables sharing, the document will be saved in shared mode, which is also shown on the title bar.</paragraph>
</listitem>
</list>
<paragraph role="paragraph" id="par_id5288857" xml-lang="en-US" l10n="NEW">The <item type="menuitem">Tools - Share Document</item> command can be used to switch the mode for the current document from unshared mode to shared mode. If you want to use a shared document in unshared mode, you would save the shared document using another name or path. This creates a copy of the spreadsheet that is not shared.</paragraph>
<paragraph role="heading" id="hd_id8842127" xml-lang="en-US" level="3" l10n="NEW">Opening a spreadsheet</paragraph>
<paragraph role="paragraph" id="par_id7276528" xml-lang="en-US" l10n="NEW">User A opens a spreadsheet document. The following conditions can apply:</paragraph>
<list type="unordered">
<listitem>
<paragraph role="paragraph" id="par_id8363902" xml-lang="en-US" l10n="NEW">The spreadsheet document is not in shared mode.</paragraph>
<paragraph role="paragraph" id="par_id5974303" xml-lang="en-US" l10n="NEW">The user can open, edit, and save the document as described above for Writer, Impress, and Draw documents.</paragraph>
</listitem>
<listitem>
<paragraph role="paragraph" id="par_id5323343" xml-lang="en-US" l10n="NEW">The spreadsheet document is in shared mode.</paragraph>
<paragraph role="paragraph" id="par_id5824457" xml-lang="en-US" l10n="NEW">The user sees a message that the document is in shared mode and that some features are not available in this mode. The user can disable this message for the future. After clicking OK, the document is opened in shared mode.</paragraph>
</listitem>
</list><comment>Resolve Conflicts dialog</comment>
<bookmark xml-lang="en-US" branch="hid/HID_SCDLG_CONFLICTS" id="bm_id9671926" localize="false"/><paragraph role="paragraph" id="par_id5800653" xml-lang="en-US" l10n="NEW"><ahelp hid="." visibility="hidden">If the same contents are changed by different users, the Resolve Conflicts dialog opens. For each conflict, decide which changes to keep.</ahelp></paragraph><comment>Keep Mine</comment>
<bookmark xml-lang="en-US" branch="hid/sc:PushButton:RID_SCDLG_CONFLICTS:BTN_KEEPMINE" id="bm_id1640369" localize="false"/><paragraph role="paragraph" id="par_id6263924" xml-lang="en-US" l10n="NEW"><ahelp hid="." visibility="hidden">Keeps your change, voids the other change.</ahelp></paragraph><comment>Keep Other</comment>
<bookmark xml-lang="en-US" branch="hid/sc:PushButton:RID_SCDLG_CONFLICTS:BTN_KEEPOTHER" id="bm_id1640360" localize="false"/><paragraph role="paragraph" id="par_id3609118" xml-lang="en-US" l10n="NEW"><ahelp hid="." visibility="hidden">Keeps the change of the other user, voids your change.</ahelp></paragraph><comment>Keep All Mine</comment>
<bookmark xml-lang="en-US" branch="hid/sc:PushButton:RID_SCDLG_CONFLICTS:BTN_KEEPALLMINE" id="bm_id1640361" localize="false"/><paragraph role="paragraph" id="par_id7184057" xml-lang="en-US" l10n="NEW"><ahelp hid="." visibility="hidden">Keeps all your changes, voids all other changes.</ahelp></paragraph><comment>Keep All Others</comment>
<bookmark xml-lang="en-US" branch="hid/sc:PushButton:RID_SCDLG_CONFLICTS:BTN_KEEPALLOTHERS" id="bm_id1640363" localize="false"/><paragraph role="paragraph" id="par_id786767" xml-lang="en-US" l10n="NEW"><ahelp hid="." visibility="hidden">Keeps the changes of all other users, voids your changes.</ahelp></paragraph>
<paragraph role="heading" id="hd_id2934965" xml-lang="en-US" level="3" l10n="NEW">Saving a shared spreadsheet document</paragraph>
<paragraph role="paragraph" id="par_id1174657" xml-lang="en-US" l10n="NEW">User A saves a shared document. The following conditions can apply:</paragraph>
<list type="unordered">
<listitem>
<paragraph role="paragraph" id="par_id2577593" xml-lang="en-US" l10n="NEW">The document was not modified and saved by another user since user A opened the document.</paragraph>
<paragraph role="paragraph" id="par_id5883968" xml-lang="en-US" l10n="NEW">The document is saved.</paragraph>
</listitem>
<listitem>
<paragraph role="paragraph" id="par_id9049653" xml-lang="en-US" l10n="NEW">The document was modified and saved by another user since user A opened the document.</paragraph>
<paragraph role="paragraph" id="par_id1976683" xml-lang="en-US" l10n="NEW">If the changes do not conflict, the document is saved.</paragraph>
<paragraph role="paragraph" id="par_id43946" xml-lang="en-US" l10n="NEW">If the changes conflict, the Resolve Conflicts dialog will be shown. User A must decide for the conflicts which version to keep, "Keep Mine" or "Keep Other". When all conflicts are resolved, the document is saved. While user A resolves the conflicts, no other user is able to save the shared document.</paragraph>
</listitem>
<listitem>
<paragraph role="paragraph" id="par_id6449171" xml-lang="en-US" l10n="NEW">Another user tries to save the shared document and resolves conflicts in this moment.</paragraph>
<paragraph role="paragraph" id="par_id7101046" xml-lang="en-US" l10n="NEW">User A sees a message that a merge-in is in progress. User A can choose to cancel the save command for now, or retry saving some time later.</paragraph>
</listitem>
</list>
<paragraph role="paragraph" id="par_id7186498" xml-lang="en-US" l10n="NEW">When a user successfully saves a shared spreadsheet, the document will be reloaded after the save command, so that the spreadsheet shows the latest version of all changes that got saved by all users. A message shows that "foreign changes have been added" when another user did change some contents.</paragraph>
<paragraph role="heading" id="hd_id2871791" xml-lang="en-US" level="2" l10n="NEW">Collaboration in Writer, Impress, and Draw</paragraph>
<paragraph role="paragraph" id="par_id2675862" xml-lang="en-US" l10n="NEW">For all modules Writer, Impress, Draw, and for Calc when document sharing is not enabled, a file locking is possible. This file locking is available even when accessing the same document from different operating systems:</paragraph>
<paragraph role="paragraph" id="par_id7333597" xml-lang="en-US" l10n="NEW">User A opens a document. The following conditions can apply:</paragraph>
<list type="unordered">
<listitem>
<paragraph role="paragraph" id="par_id9976195" xml-lang="en-US" l10n="NEW">The document is not locked by any other user.</paragraph>
<paragraph role="paragraph" id="par_id2507400" xml-lang="en-US" l10n="NEW">This document will be opened for read and write access by user A. The document will be locked for other users until user A closes the document.</paragraph>
</listitem>
<listitem>
<paragraph role="paragraph" id="par_id216681" xml-lang="en-US" l10n="NEW">The document is marked as "read-only" by the file system.</paragraph>
<paragraph role="paragraph" id="par_id7709585" xml-lang="en-US" l10n="NEW">This document will be opened in read-only mode. Editing is not allowed. User A can save the document using another document name or another path. User A can edit this copy.</paragraph>
</listitem>
<listitem>
<paragraph role="paragraph" id="par_id4309518" xml-lang="en-US" l10n="NEW">The document is locked by another user.</paragraph>
<paragraph role="paragraph" id="par_id206610" xml-lang="en-US" l10n="NEW">User A sees a dialog that tells the user the document is locked. The dialog offers to open the document in read-only mode, or to open a copy for editing, or to cancel the Open command.</paragraph>
</listitem>
</list>
<section id="relatedtopics">
<paragraph role="paragraph" id="par_id4263740" xml-lang="en-US" l10n="NEW"><link href="text/shared/01/01070000.xhp" name="Save As">Save As</link></paragraph>
</section>
</body>
</helpdocument>