DocuShare User's Guide
10. Using the Windows Client
Overview

Mounting a DocuShare Server on Windows Explorer

Accessing a Mounted DocuShare Server via Windows Explorer

Viewing DocuShare Files on the Windows Client

New Function Buttons on the Windows Client

New Menus in the Windows Client

Working with DocuShare Files on the Windows Client

Searching DocuShare on the Windows Client

Configuring Options

Table of Contents     Searching in DocuShare     DocuShare ODMA Client

Overview

The Windows Client allows you to work with a DocuShare repository of files (or several) from within Windows Explorer. Once you mount the server and log in, DocuShare will appear as a separate drive in the familiar Explorer tree environment. When you click on the DocuShare drive from Windows, DocuShare collections appear as folders, and files appear as the appropriate icons. You can bypass normal upload procedures and copy files to a DocuShare collection from your local or network drives, or you can pull files from DocuShare directly to your computer, avoiding the download step. Simply select the file (or files) you want and drag it to the folder to which you wish to upload or download. It works the same as when you drag files around within your computer or to and from network drives.


Mounting a DocuShare Server on Windows Explorer

The DocuShare Windows Client must be installed on your computer before you can mount a DocuShare server on Windows Explorer. See Installing the Windows Client, Chapter 1. Once you have installed the Windows Client, click the DocuShare icon as it appears in Windows Explorer.

The first time you click on the DocuShare icon, a window will appear asking if you want to map an initial DocuShare server. To map additional servers, under the Explorer Tools Menu, select Map DocuShare Server. In both cases, the Step 1 dialog box appears.

  1. Under Home URL, type in the name of your DocuShare server (e.g., http://sales.acme.com).

  2. If a proxy server is needed, press the Advanced button. If the DocuShare server you are using is local, do not use a proxy server.

  3. Press Next. The Step 2 dialog box appears. If you do not have an account on the DocuShare server entered in Step 1, press the Registry button. This will take you to the web page to create an account.

  4. Enter your user ID under Account Name.

  5. Enter your password under Password.

  6. Press Next. The Step 3 dialog box appears.

  7. Enter the name you want to appear in the Windows Client under Folder Name in Explorer. Although this name can be different than the name of your DocuShare website, you probably want to give it the same name or a related, meaningful name to avoid any confusion with other servers.

  8. Enter a name under Work-in-progress directory name that is at least four characters long.

  9. Press Next. The Step 3 4 dialog box lets you review the information you entered in steps 1 through 3. If the information is correct, press Finish to create the server folder. If you experience a login problem, see Chapter Troubleshooting DocuShare.

At this point, you will see the new folder name appear in Windows Explorer under the DocuShare icon.

Removing a DocuShare Server

To remove a DocuShare server from the DocuShare Windows Client, follow the steps below:

  1. Select Disconnect DocuShare Server from the Explorer Tools Menu.

  2. Select the DocuShare server you wish to disconnect.

  3. Press OK.

The server you selected for removal should no longer appear on the Explorer interface. If the server does still appear, select Refresh.


Accessing a Mounted DocuShare server via Windows Explorer

To access a mounted DocuShare server via Windows, double click on the DocuShare icon which appears in your Windows Explorer tree structure. See example below:

  1. Type your password in the dialog box, which may appear, then click OK. Remember that your password is case-sensitive. If you make a mistake and see an error message, try entering your password again or see your Site Administrator.

  2. The DocuShare server then opens onto your Windows Explorer Interface, and you will see the familiar folder pattern of collections and objects that make up the DocuShare site.

At this point, you can point and click to open DocuShare collections on your DocuShare site as if they were folders on one of your local or network drives.


Viewing and Editing Files with the DocuShare Windows Client

Viewing and editing DocuShare files on the Windows Client is similar to viewing and editing files on one of your local drives in Explorer. Collections appear as Explorer folders that may contain files, URLs, calendars, bulletin boards or other collections/folders. Files will appear with their corresponding icons (e.g., for Microsoft Word files).

To open a DocuShare collection/folder in the Windows Client, simply double click the folder with your mouse. The contents of that collection/folder will then appear in the right-hand side of the Explorer Interface. Remember that permissions still apply, so depending on your access, you may not be able to view restricted collections or folders. See Chapter 3, DocuShare Permissions for further information.

To open a DocuShare file, simply double click on the file name. There are two ways to "open" a DocuShare file. The default response to double clicking on the file is to open the corresponding application with the file set to read only. This is called browse mode. Alternatively, you may open the file for editing and save it back to DocuShare when you are done. This is called check out. When you check out a file, the original copy on the DocuShare server is locked while you edit the file so that others will not be able to create new versions while you are editing the current version. Both options are available from the menu that appears when you click your right mouse button on the file name. Which action is your default in response to a double click is configurable from the DocuShare settings screen (see Configuring Options).

The DocuShare Windows Client supports the following applications for check out:

Other applications may or may not correctly check out of DocuShare or save back to DocuShare. See Chapter Troubleshooting DocuShare.


New Function Buttons on the Windows Client

Most of the function buttons on the Windows Client are the same as the function buttons in Explorer, but there are a few differences. The table below gives a description of the function buttons in the Windows Client.

Up one Level: Takes you one level higher in the tree structure. It works the same for DocuShare as it does for Explorer.

Large Icons: Displays large icons. It works the same for DocuShare as it does for Explorer.

Small Icons: Displays small icons. It works the same for DocuShare as it does for Explorer.

List: Displays icons in a list. It works the same for DocuShare as it does for Explorer.

Details: Displays icons in a list with details about the files. It works the same for DocuShare as it does for Explorer.

Edit: Opens an edit program for the file. The specific response depends upon the edit program. For supported applications, DocuShare will open the application for editing and offer to save the editing file back to the same DocuShare location when you close the window. For unsupported applications, DocuShare will open the file in read-only mode. See the Editor Support section for more details. It works the same for DocuShare as it does for Explorer, but you will be offered the ODMA option (see ODMA Client).

Print: Prints the current file. It works the same for DocuShare as it does for Explorer.

Add Document: Adds a document to the current collection/folder. This function button is unique to the DocuShare Windows Client.

Create New Version: Creates a new version of the file with which you are working. This function button is unique to the DocuShare Windows Client.

Create New Collection: Creates a new collection within the open collection. This function button is unique to the DocuShare Windows Client.

Delete: Deletes the selected file. It works the same for DocuShare as it does for Explorer, except that you must have Manager access to delete a file.

View Version History: Shows you the version history of the current document. This function button is unique to the DocuShare Windows Client.

View Properties: Displays the properties of the selected file. It works essentially the same for DocuShare as it does for Explorer.

Undo: Undoes the last action. This Windows Explorer function is not supported in the DocuShare Windows Client.

Map Server. Brings up the sequence of screens to map to another DocuShare server. This button only appears when the Xerox DocuShare drive is selected.

Disconnect Server. Allows you to remove one of the currently mapped DocuShare servers. This button only appears when the Xerox DocuShare drive is selected.



New Menus in the Windows Client

In addition to the Explorer function buttons, you will notice various pop-up menus when you right click your mouse within the Windows Client. As with the function buttons, these menus closely resemble the standard Windows Explorer right-click menus with a few differences.

Whenever DocuShare content is selected, the Explorer Tools menu contains an additional section for three DocuShare-specific commands. Map DocuShare Server… allows you to connect to additional DocuShare sites. Disconnect DocuShare Server… allows you to remove currently mapped DocuShare sites. This is also useful if you want to login as a different user. Go to DocuShare URL… brings up a window in which you can enter a DocuShare location directly. The window offers a partial URL as a hint that you must complete.

This menu appears if you right click your mouse in the All Folders section (i.e., left side) of the Windows Client. Functions are an abbreviated list of those found in Windows Explorer. New allows you to create a new folder (i.e., collection) or a new document.

This menu appears if you right click your mouse in the Folder Contents section (i.e., right side) of the Windows Client. Functions are mostly the same as in Windows Explorer. The DocuShare functions are listed below.

View lets you choose among the following: large icons, small icons, list, details, publish view.

Refresh reloads the page from the DocuShare server.

 

This menu appears if you right click your mouse on a file in the Folder Contents section (i.e., right side) of the Windows Client. Functions are a mix of Explorer and DocuShare. The DocuShare functions are listed below.

Browse opens the selected file.

Check Out opens the selected file and locks it so others cannot use or change this file while you have it active.

Lock locks the file.

Unlock unlocks the file.

New creates a new version of the file using the existing file.

Version History lets you view the version history of the file.

Rename lets you rename the file. This will change the file’s Title property on the DocuShare server.

View lets you choose among the following: large icons, small icons, list, details, publish view.

Refresh reloads the page from the DocuShare server.

Properties displays a window for viewing and editing the object’s properties.



Working with DocuShare Files on the Windows Client

Working with DocuShare files on the Windows Client is much the same as working with regular files from your local or network drives on Explorer. Using standard Explorer drag and drop operations, you can copy files to a DocuShare collection from your local or network drives, or you can copy files from DocuShare directly to your computer. You can also copy and move DocuShare files from folder to folder within the DocuShare using drag and drop operations. Other standard Explorer features are available as well, such as Rename, Delete, and Properties.

Adding Files or Folders

To add (i.e., upload) files from a local or network drive to a DocuShare folder (i.e., collection) on the Windows Client, follow the steps below:

  1. Select the file(s) you wish to add with your mouse and drag it to the desired DocuShare folder.
    Note: Remember that you must be logged in and have Writer permission to add files to a DocuShare collection.

  2. A confirmation message box will appear. Click Yes.
The file will now appear in the DocuShare folder you designated. If you do not see the copied file, right click your mouse in the contents area (i.e., right side of Explorer Screen) and select Refresh.
Note: You can also add files to DocuShare via the ODMA Client. See Chapter 11: The DocuShare ODMA Client for further information. The above process works the same for adding folders from a local or network drive to a DocuShare folder on the Windows Client. All contents of the added folder will be included.

Copying Files or Folders

To copy files from a DocuShare folder to a folder on your local or network drives, select the file(s) you wish to copy with your mouse and drag it to the desired local or network folder.
Note: The Confirm Item Copy screen does not pop up for this type of action (i.e., a download).

Use the same select and drag procedure as above to copy files from one DocuShare folder (i.e., collection) to another. The Confirm Item Copy screen will pop up if you copy files from one DocuShare server to another, but otherwise the process is the same. Remember that you must have Write permission to add files to a DocuShare collection even if the files are coming from another DocuShare collection or server.

The above process works the same for copying folders from a DocuShare folder on the Windows Client to a local or network drive. All contents of the added folder will be included.

Deleting Files or Folders

To delete files from DocuShare on the Windows Client, follow the steps below.

  1. Select the file(s) with your mouse and press the delete function button on the Windows Client Interface or the delete button on your keyboard.
    Note: Remember, you must have Manager access to delete files or folders from DocuShare.

  2. A confirmation screen will appear. Click Yes if you are certain you want to delete the file or folder.
The file or folder is now deleted. You may need to select Refresh from the right mouse click menu to reload the page and see the deletion.

Versioning and Locking Files

Versioning and Locking Files basically works the same way as it does in the web version; see Chapter 5, DocuShare Files for in-depth information. Follow the process below to create a new version of a file on the DocuShare Windows Client.

  1. Click on the Create New Version function button at the top of the interface or choose New à Version from the mouse right-click menu. The file must be selected for you to use the right-click menu.

  2. The Create New Document Version dialog box appears:



  3. Enter the file name or select it by using the Browse key.
To view the Version History of a document on the DocuShare Windows Client, select the file by right-clicking it and choose Version History from the menu. You can also view the version history by clicking the View Version History function button at the top of the Windows Client interface. To lock a file on the DocuShare Windows Client, select the file by right-clicking it and choose Lock from the menu that appears. A padlock symbol will appear to the right of the document icon.

You can also Checkout a document by selecting the document with a right mouse click and choosing Checkout from the menu. This automatically opens the file and locks it so you can work on it. See Chapter 11, The DocuShare ODMA Client for further information. To unlock a file on the DocuShare Windows Client, select the file by right-clicking it and choose Unlock from the menu that appears. The padlock symbol will disappear.


Searching DocuShare on the Windows Client

To search DocuShare on the Windows Client, follow the steps below.
  1. Select Find ® Files on DocuShare from the Explorer Tools Menu.



  2. The DocuShare Find File dialog box appears.



  3. Fill in your search criteria as necessary. There are 4 tabs of criteria at your disposal: Title & Location, Date Modified, Advanced Search, and Options. These 4 tabs together mirror the search criteria options from the web view.

  4. Click Find Now when you are ready to start the search.

  5. The Search Results appear underneath the Find File box.



You can now start a new search by clicking the New Search button, or you can open the found file by clicking on it. To exit the search dialog box, press the X in the upper right-hand corner.


Configuring Options

There are several options on the Windows Client that you can configure. To access the options, right click on the red Xerox icon in the toolbar of your Windows Explorer interface (On most machines, the will be located at the bottom right corner – the Start button is usually in the bottom left corner.) When you right click on the icon, a short menu appears:

Choose Settings.
Note: Disable ODMA from this menu will turn off the ODMA option, and View WIP Folder shows you information about the Work in Progress (if there is one). About DsClient gives you license and version information on the DocuShare Windows Client.
After you select Settings, the DocuShare Client Settings dialog box appears.
Note: The options shown as selected in the following examples are the DocuShare Windows Client default options. Your Site Administrator can help you figure out the best settings for your machine and requirements. The DocuShare Settings dialog offers various options regarding DSClient’s behavior.

ODMA Settings

Windows Explorer

General


Table of Contents     Searching in DocuShare     DocuShare ODMA Client

Copyright © 1997, 1998, 1999 by Xerox Corporation. All Xerox product names mentioned in this document are trademarks of Xerox Corporation. All other product names mentioned in this document are trademarks of their respective companies.