<%@ page language="java" buffer="100kb" errorPage="/common/error.jsp"%>

<%@ taglib uri="struts-html" prefix="html"%>
<%@ taglib uri="struts-bean" prefix="bean"%>
<%@ taglib uri="vkc-taglib"  prefix="vkc" %>

<html:html locale="true">
<head>
  <vkc:init/>
  <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
  <meta http-equiv="expires" content="0">
  <meta name="description" content="VKC Help: How to use VKC as a Web folder">

  <vkc:cssinclude />

  <title><vkc:message key="vkc" /></title>
  <script type="text/javascript" src="<vkc:rewrite page='/common/utils.js'/>"></script>

  <script type="text/javascript">

  window.name = "MAINVIEW";

  function init() {
  }
  
  function confirmation(){
    return confirm('<vkc:message javascript="true" filter="false" key="vkc.string.confirmation"/>');
  }

  </script>
</head>

<!-- ENGLISH VERSION ************************************************** -->

<!-- Version 30-Jul-2007 VKC 4.0 -->

<body onload="init();">
<a name="top"></a>

<h2>
<a name="webfolder"></a>
VKC Help: How to use VKC as a Web folder (WebDAV)</h2>

<p>
VKC supports the WebDAV protocol
(Web-based Distributed Authoring and Versioning)
that can be used to access files and file trees
over the Internet protocol HTTP
in a similar manner as the local file system.
</p>
<p>
VKC users are able to use the whole document store or part of it
as a Web folder instead of or in addition to the usual access
by Web browser.
VKC categories and documents are made visible in the file system
browser (like Windows Explorer) and can be handled just like
local files or directories.
Thus it is possible to transfer complete directories into VKC by copy/paste
function. One can also export VKC categories to the file
system by copy/paste. Just be aware that this mechanism includes
file contents only without additonal meta data stored and managed
by VKC.
</p>

<p>
You may use system function "Add Network Places" in the Windows Explorer
to open a Web folder. It is even easier when you use Internet Explorer
as Web browser for VKC. A single click is enough then.
Both ways are described below.
</p>
<p>
Advice for <a href="#vkclinux">Linux users ...</a>
</p>

<div align="right">
<a href="#top">
<img src="top-blue.gif" alt="to top of page" border="0"></a>
</div>


<h3>
<a name="openwebfolderview"></a>
Internet Explorer: Open Web folder in VKC
</h3>

<p>
If you access VKC through Internet Explorer,
you will find a small file browser icon as an additional function
in the category functions tool bar.

(Otherwise please continue reading
<a href="#addnetworkplace">Open Web folder as a "Network Place"</a>.)
</p>
<img src="pic3-vkc-dav-webfolder-tool.gif" border="1" alt="Web folder icon">
<p>
Just click on that icon to open the Web folder view of the current
category in a separate Windows Explorer window.
In the following example you can see category <b>Quality Management</b>
below category <b>Doc</b> (some special characters will be coded in UTF-8
code in a URL).
</p>
<img src="pic3-vkc-dav-webfolder.gif" border="1" alt="Web folder view">
<p>
Now you can start <a href="#usewebfolder">to work with the Web folder</a>.
</p>

<div align="right">
<a href="#top">
<img src="top-blue.gif" alt="to top of page" border="0"></a>
</div>


<h3>
<a name="addnetworkplace"></a>
Open Web folder as a "Network Place"
</h3>

<p>
If you use some other Web browser, you may use 
<b>Windows Explorer</b> to open a Web folder.
Navigate to entry <b>My Network Places</b>.
Below you will find the item <b>Add Network Place</b>.
</p>
<img src="pic3-vkc-dav-addnetworkplace1.gif" border="1" alt="Add network place">
<p>
By double click on <b>Add Network Place</b> you can open the wizard
to create a new item.
Proceed by clicking on button <b>Next</b> until you have to enter
the URL for the Web folder ("Address of this network place").
</p>
<img src="pic3-vkc-dav-addnetworkplace2.gif" border="1" alt="enter URL">
<p>
If you want to open a Web folder for your VKC login category,
you have to enter the start URL of your VKC extended by <b>/dav</b>.
You may append further VKC category names (separated by slash)
to address a folder on a deeper level.
Complete the form by clicking on button <b>Next</b>.
</p>
<p>
A small window pops up prompting for your VKC account and password.
After successful login a new form will be opened. You are able
to enter a name for the Web folder that will appear as the name
of the new item in the Windows Explorer.
</p>
<img src="pic3-vkc-dav-addnetworkplace3.gif" border="1" alt="enter name">
<p>
Please complete the form by clicking on <b>Next</b>.
When the connection has been established, you may leave the wizard
by clicking on <b>Finish</b>. 
By default a new Windows Explorer window will be opened with the
Web folder view that has just been created. You may continue to work there.
</p>

<div align="right">
<a href="#top">
<img src="top-blue.gif" alt="to top of page" border="0"></a>
</div>


<h3>
<a name="usewebfolder"></a>
Working with the Web folder view
</h3>

<img src="pic3-vkc-dav-webfolder.gif" border="1" alt="Web folder view">
<p>
You may navigate up and down the Web folder structure just as usual
in the Windows Explorer. You may access the stored files as well as
create new subfolders and documents. All changes will be applied to
the corresponding VKC structures appropriately. If you delete folders
or directories, they will be removed from VKC actually. They are
not available any more.  
</p>

<div align="right">
<a href="#top">
<img src="top-blue.gif" alt="to top of page" border="0"></a>
</div>


<h3>
<a name="closewebfolder"></a>
Close Web folder
</h3>

<p>
When you close the Web folder view window, the corresponding VKC session
will not be closed automatically.
You may close it by removing the shortcut in <b>My Network Places</b>.
Otherwise the session will remain until you log off from the Windows system.
</p>
<img src="pic3-vkc-dav-networkplaces2.gif" border="1" alt="remove shortcut">

<div align="right">
<a href="#top">
<img src="top-blue.gif" alt="to top of page" border="0"></a>
</div>


<h3>
<a name="vkclinux"></a>
VKC as a Web folder on Linux systems
</h3>

<p>
There are different ways to access VKC as a Web folder on Linux systems:
</p>

<ul>
<li>
<p>
You may use the the <b>mount</b> command to add a VKC folder to
the file system. The root URL of the VKC with the appendix "/dav" has
to be used as the source and a path in the local file system has to
be used as the destination, for example<br>
<tt>mount -t davfs https://abc.company.com/dav /home/username/myvkc</tt>
</p>
</li>
<li>
<p>
On the desktop a Web folder can be opened directly, for example in
KDE with Konqueror (protocol: "webdav" or "webdavs").
</p>
</li>
<li>
<p>
Furthermore there is a commandline WebDAV client "cadaver" available
(see www.webdav.org/cadaver for information).
</p>
</li>
</ul>

<div align="right">
<a href="#top">
<img src="top-blue.gif" alt="to top of page" border="0"></a>
</div>


<!-- DOCUMENT FOOTER ************************************************** -->

<hr>
<p>
<b>Attention:</b>
<br>
Please use the <b>back</b> button of your browser for returning
to the previous help page. 
</p>

<img src="vkc-versioninfo.gif" alt="Version information" border="0">

</body>
</html:html>