DocuShare User's Guide
7. DocuShare URLs
Adding a URL

Viewing URL Properties

Editing URL Properties

Deleting a URL

Editing the Location of a URL

Table of Contents     DocuShare Calendars     DocuShare Bulletin Boards

You can also save URL (Uniform Resource Locator) links in DocuShare. They are represented by a icon. You can think of a DocuShare URL as a shared bookmark.


Adding a URL

URLs can be added to any collection in DocuShare to which you have Writer access. You must be logged in to DocuShare to add a URL.

To add a URL:

  1. In the collection where you want to add the URL, click the Add URL selection in the pull-down menu. The Add URL page appears.

  2. Fill in the URL information: title, summary, and URL. Refer to the property descriptions in the table below for descriptions of each field.

  3. When you are finished, click the Apply button.

The Add URL page has the following properties:

Property

Description

Title

Specifies a descriptive title for the URL being submitted to the DocuShare repository. The title can contain spaces and other punctuation marks. You should assign a meaningful title to the URL. The default title is New. This is a required field.

Summary

(Optional) Specifies a brief description of the URL being submitted to the DocuShare repository. The contents of this field appear below the URL title when you display the contents of the DocuShare collection that contains the URL.

URL

Specifies the URL of the Web document you wish to reference (for example, http://www.xerox.com).
Must be the fully qualified URL (i.e., including the "http://" portion of the reference). The URL can be for any valid internet protocol in addition to HTTP, such as FTP, Gopher, mailto, news, TELNET, WAIS, or file. This is a required field.
An easy method to copy the URL of a Web site or document is to link to that location through your Web browser. You can then copy the URL from your browser and paste it into the DocuShare URL field.

Note: There may be additional properties displayed on this page that are not listed here. They are specific to your DocuShare site. See your Site Administrator for details.

The URL is created in DocuShare and the Services page appears.

You can verify that the URL was created by clicking the Appears In link to move you up one level in the collection hierarchy. The URL should now be listed with a icon. If you don't see the URL, click Reload on your browser to refresh the page display.

Note: After creating the URL, you should adjust the access permissions for the URL to make sure they provide the desired level of access for other users and groups. See the section Viewing and Editing DocuShare Object Permissions in Chapter 3 for more information on adjusting these permissions.


Viewing URL Properties

You can view the properties of a URL at any time. You do not need to be logged in to view a URL's properties. However, you must be logged in to DocuShare to perform any editing functions that can be accessed through the View URL Services page.

To access a URL’s Services page, click on the Services link to the right of the URL in the collection listing.

Properties for a URL include:

All of these properties (except the object ID, the creation/modification dates/times and URL location) can be edited or modified by the owner of the URL or a user with Writer access permissions through the Edit Properties function. Use the Edit Location function to edit the Appears In property (URL location).

The Services page provides access to editing functions, using these selections in the pull-down menu:


Editing URL Properties

You can edit the properties of a URL at any time by selecting Edit Properties from the Edit pull-down menu on the URL Services page. You must be the owner of the URL or have at least Writer access permissions to edit a URL’s properties. You must also be logged in to DocuShare.

To edit the properties of a URL:

  1. Click the Services link for the URL whose properties you want to edit. The URL Services page appears.

  2. Select Edit Properties from the Edit pull-down menu. The Edit URL page appears.

  3. Edit the URL properties. Refer to the property descriptions in the previous section for information.
    Note: While editing the URL properties, if you are unsure of the purpose of a field, you can click on the highlighted field name for a brief Help description of the field.

  4. Click Apply. The Services page for the URL appears. The URL properties are updated to reflect your edits.

Note: There may be additional, editable properties displayed on this page that are not listed here. They are specific to your DocuShare site. See your Site Administrator for details.


Deleting a URL

Only the owner of a URL (the user who added it to DocuShare) or a user with Manager access for that URL can delete a URL from DocuShare. You must be logged in to DocuShare to delete a URL.

To delete a URL:

  1. Click the Services link for the URL you are deleting. The URL Services page appears.

  2. Select Delete from the Edit pull-down menu. The Confirm Deletion page appears.
    Note: If you change your mind, click Back on the browser to close the Confirm Deletion page.

  3. Click the Delete button. The Delete Successful page appears.

  4. Click the Click here to continue link.

The URL is now deleted. You may need to Reload the page to see these changes.


Editing the Location of a URL

The Edit Location command allows a user to move a DocuShare object from one location to another or allows the object to appear in multiple locations within the DocuShare repository. You must have at least Writer access to the object to change its location.

The location of an object is displayed in the Appears In property, which is displayed at the end of each Properties listing for an object. Using the Edit Location command allows you to edit the Appears In property.

This is a helpful command if you have created a URL (or any other DocuShare object) in the wrong location and want to move it instead of deleting it and then re-creating it. It is also helpful if you would like the same object to appear in one or more additional locations. All DocuShare objects can appear in multiple locations at once. However, there is actually only one physical copy of the object in the DocuShare database; the system simply creates additional pointers or references to the object.

A negative side effect of this command is that if used incorrectly, you can orphan the object. Orphaned objects still exist within the DocuShare repository but are not accessible to users. Only a Site Administrator can recover orphaned objects.

To change the location of a URL:

  1. Click the Services link for the URL whose location you want to change. The URL Services page appears.

  2. Select Edit Location from the Edit pull-down menu. The Edit URL Location page appears.

  3. For the Appears In field, a scrolling list is displayed that contains all DocuShare collections to which you have at least Writer access. The URL’s current location is highlighted.

    Note: Use caution when deselecting locations. Deselecting improperly can create orphaned files. Be sure that at least one location is selected in the scrolling list before selecting the Update Locations button.

  4. Click the Update Locations button.

The URL Services page now appears and the new location(s) is/are displayed in Appears In. If you do not see this change reflected on the Services page, click Reload on your browser to refresh the page display.


Table of Contents     DocuShare Calendars     DocuShare Bulletin Boards

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.