<?xml version="1.0" encoding="UTF-8"?>
<helpdocument version="1.0">
<!--
 * This file is part of the LibreOffice project.
 *
 * This Source Code Form is subject to the terms of the Mozilla Public
 * License, v. 2.0. If a copy of the MPL was not distributed with this
 * file, You can obtain one at http://mozilla.org/MPL/2.0/.
 *
-->

<meta>
  <topic id="textsharedguidecmisremotefilesxml" indexer="include" status="PUBLISH">
    <title id="tit" xml-lang="en-US">Using Remote Files</title>
    <filename>/text/shared/guide/cmis-remote-files.xhp</filename>
  </topic>
</meta>

<body>
<section id="using_remote_files">
<bookmark xml-lang="en-US" branch="hid/fps/ui/remotefilesdialog/RemoteFilesDialog" id="bm_id3148069" localize="false"/>
<bookmark xml-lang="en-US" branch="hid/fps/ui/remotefilesdialog/@@nowidget@@" id="bm_id3148069" localize="false"/>
<h1 id="hd_id150820161615009403"><variable id="remote-files"><link href="text/shared/guide/cmis-remote-files.xhp">Opening and saving files on remote servers</link></variable></h1>
<paragraph id="par_id15082016161546265" role="paragraph" xml-lang="en-US"><ahelp hid="fps/ui/remotefilesdialog/RemoteFilesDialog">Remote Files Service User Guide</ahelp></paragraph>
<paragraph id="par_id150820161816031425" role="paragraph" xml-lang="en-US">%PRODUCTNAME can open and save files stored on remote servers. Keeping files on remote servers allows to work with the documents using different computers. For example, you can work on a document in the office during the day and edit it at home for last-minute changes. Storing files on a remote server also protects them from computer loss or hard disk failure. Some servers are also able to check in and check out files, thus controlling their usage and access.</paragraph>
<paragraph id="par_id150820161816033566" role="paragraph" xml-lang="en-US">%PRODUCTNAME supports many document servers that use well known network protocols such as WebDAV, Windows share, and SSH. It also supports popular services like Google Drive as well as commercial and open source servers that implement the OASIS CMIS standard.</paragraph>
<paragraph id="par_id170820161605418200" role="paragraph" xml-lang="en-US">To work with a remote file service you must first <link href="text/shared/guide/cmis-remote-files-setup.xhp">setup a remote file connection</link>.</paragraph>
</section>

<bookmark xml-lang="en-US" branch="index" id="bm_id190820161715167576">
  <bookmark_value>opening;CMIS remote file</bookmark_value>
  <bookmark_value>opening;remote file</bookmark_value>
  <bookmark_value>remote file service;opening file</bookmark_value>
  <bookmark_value>opening remote file</bookmark_value>
</bookmark>

<h2 id="par_id160820161854537016">To open a file in a remote file service</h2>

<list type="ordered">
  <listitem>
    <paragraph id="par_id170820161605411154" role="listitem" xml-lang="en-US">Do one of the following:</paragraph>
  </listitem>
</list>

<list type="unordered">
  <listitem>
    <paragraph id="par_id17082016160541995" role="listitem" xml-lang="en-US">Choose <item type="menuitem">File - Open Remote</item> in any %PRODUCTNAME module</paragraph>
  </listitem>
  <listitem>
    <paragraph id="par_id170820161605414687" role="listitem" xml-lang="en-US">Click the <emph>Remote Files</emph> button the Start Center</paragraph>
  </listitem></list>

    <paragraph id="par_id170820161605418205" role="paragraph" xml-lang="en-US">The Remote Files dialog appears.</paragraph>

<list type="ordered" startwith="2">
  <listitem>
    <paragraph id="par_id170820161605417597" role="ol_item" xml-lang="en-US">Select the file and click <emph>Open</emph> or press <emph>Enter</emph>.</paragraph>
  </listitem>
</list>
<paragraph id="par_id150820161816053974" role="paragraph" xml-lang="en-US">The Remote Files dialog which then appears has many parts. The upper list box contains the list of remote servers you have previously defined. The line below the list box shows the path to access the folder. On the left is the folder structure of the user space in the server. The main pane displays the files in the remote folder.</paragraph>

<section id="check">
<bookmark xml-lang="en-US" branch="index" id="bm_id190820161721082861">
  <bookmark_value>remote file service;file lock</bookmark_value>
  <bookmark_value>remote file service;version control</bookmark_value>
  <bookmark_value>remote file service;working copy</bookmark_value>
  <bookmark_value>remote file service;checkout</bookmark_value>
  <bookmark_value>remote file service;checkin</bookmark_value>
</bookmark>

<h2 id="hd_id170820161605421283">Checking out and checking in files</h2>
<paragraph id="par_id170820161605429941" role="paragraph" xml-lang="en-US">The Check Out and Check In actions control updates to the document and prevent unwanted overwrites in a CMIS remote service.</paragraph>
<paragraph id="par_id17082016160542203" role="paragraph" xml-lang="en-US">Checking out a document locks it, preventing other users from writing changes to it. Only one user can have a particular document checked out (locked) at any time. Checking in a document or canceling the checkout unlocks the document.</paragraph>
<note id="par_id170820161605426690">There are no checkin/checkout controls for remote files in Windows Shares, WebDAV and SSH services.</note>
<paragraph id="par_id170820161605428976" role="paragraph" xml-lang="en-US">When a file is open from a CMIS remote file service, %PRODUCTNAME displays a <emph>Check Out</emph> button on the top message area. Click the <emph>Check Out</emph> button to lock the file in the server to prevent edition by another user. Alternatively choose <item type="menuitem">File - Check Out</item>.</paragraph>
<paragraph id="par_id190820161707153804" role="paragraph" xml-lang="en-US">%PRODUCTNAME creates a working copy of the file in the server (and inserts the string <item type="literal">(Working Copy)</item> in the file name) when a file is checked out. Every edition and save operation is done in the working copy. You can save your file as many times you want. When you finished your changes, check in the file.</paragraph>
<paragraph id="par_id190820161707156843" role="paragraph" xml-lang="en-US">To check in the file, choose <item type="menuitem">File - Check In</item>. A dialog opens to insert comments about the last edition. These comments are recorded in the CMIS server for version control. The working copy replaces the existing file and its version number is updated.</paragraph>
<paragraph id="par_id190820161707155303" role="paragraph" xml-lang="en-US">To cancel a checkout, choose <item type="menuitem">File - Cancel Checkout</item>. A warning message will inform that the latest edition will be discarded. If confirmed, no version updates occurs.</paragraph>
<warning id="par_id19082016170715785">Remember to check in the file when finishing using it. Not doing so will lock the file and no other user will be allowed to modify it.</warning>
</section>
<bookmark xml-lang="en-US" branch="index" id="bm_id190820161722159908">
  <bookmark_value>remote file service;saving to remote server</bookmark_value>
  <bookmark_value>remote file service;saving</bookmark_value>
</bookmark>

<h2 id="hd_id170820161605423820">To save a file in a remote file server</h2>

<list type="ordered">
  <listitem>
    <paragraph id="par_id170820161605428770" role="listitem" xml-lang="en-US">Do one of the following</paragraph>
  </listitem>
</list>

<list type="unordered">
  <listitem>
    <paragraph id="par_id170820161605423872" role="listitem" xml-lang="en-US">If the file was opened from a CMIS server, choose <item type="menuitem">File - Save</item>, click on the <emph>Save</emph> button or hit <item type="literal">Ctrl + S</item>.</paragraph>
  </listitem>
  <listitem>
    <paragraph id="par_id190820161707166344" role="listitem" xml-lang="en-US">If the file is not stored in a CMIS server, choose <item type="menuitem">File - Save Remote</item> or long-click the <emph>Save</emph> icon and select <emph>Save Remote File</emph>.</paragraph>
  </listitem></list>

    <paragraph id="par_id170820161605428591" role="paragraph" xml-lang="en-US">The <emph>Remote files</emph> dialog appears. Select the remote file server.</paragraph>

<list type="ordered" startwith="2">
  <listitem>
    <paragraph id="par_id170820161605425024" role="listitem" xml-lang="en-US">In the <emph>Filter</emph> list box, select the desired format.</paragraph>
  </listitem>
  <listitem>
    <paragraph id="par_id170820161605424622" role="listitem" xml-lang="en-US">Enter a name in the File name box and click <emph>Save</emph>.</paragraph>
  </listitem>
  <listitem>
    <paragraph id="par_id190820161707163121" role="listitem" xml-lang="en-US">When you finish working with the file, check it in. To do so, choose <item type="menuitem">File - Check In</item>.</paragraph>
  </listitem>
</list>
<bookmark xml-lang="en-US" branch="index" id="bm_id19082016172305788">
  <bookmark_value>remote file service;CMIS properties</bookmark_value>
  <bookmark_value>remote file service;file properties</bookmark_value>
</bookmark>

<h2 id="hd_id190820161707169171">Properties of files stored in CMIS servers</h2>
<paragraph id="par_id19082016170716519" role="ol_item" xml-lang="en-US">Files stored in CMIS server have properties and metadata not available in a local storage. These metadata are important for controls and debugging of the CMIS connection and server implementation. All parameters displayed are read-only.</paragraph>
<paragraph id="par_id190820161707161708" role="paragraph" xml-lang="en-US">Choose <item type="menuitem">File - Properties</item>, CMIS tab.</paragraph>

<section id="relatedtopics">
<paragraph id="par_id210820161033581776" role="paragraph" xml-lang="en-US"><link href="text/shared/guide/cmis-remote-files-setup.xhp">Setting up a remote file service</link></paragraph>
</section>
</body>

</helpdocument>
