Subscription Overview

Subscription Events of Interest

Adding a Subscription

Viewing Subscription Properties

Editing Subscription Properties

Editing Recipients of a Subscription

Deleting a Subscription

Retrieving a Deleted Subscription

Table of Contents	DocuShare Calendars	DocuShare URLs

DocuShare allows users to subscribe to DocuShare content and be notified by email when changes occur. As with all DocuShare objects, subscriptions have a title, description, and the standard set of permission attributes. Unlike the other DocuShare objects, however, subscriptions do not appear in collections or other container objects. Subscriptions to DocuShare objects can be created and managed through those objects' Edit menu.

Subscriptions provide a variety of options to specify which events are of interest, who should be notified when those events occur, and when email notifications will be sent. The subscription Events of Interest property lists which modifications (e.g., Any Change, Something Deleted) will be reported to the subscription recipients. The subscription Period property indicates when the notifications will be sent, and may be on an Immediate, Daily, or Weekly basis. All daily and weekly notices scheduled to be received by each recipient are combined into a single summary report. The recipients of a subscription may be changed on an as-needed basis through the Edit Recipients option on the subscription's Edit menu.

When a subscription is made to a container object, such as a collection, it applies to the collection and everything within that collection. When a subscription is made to individual, non-container objects, such as a file, it applies only to that individual object.

Each subscription lists the specific set of change events that are of interest to the recipients. Subscriptions can be made for all changes, a limited set of changes, or just one type of change.

The set of possible event types are:

Any user with Read access to an object may create a subscription to that object. If the object is a container, such as a collection, the subscription includes changes to the collection and its contents.

To add a subscription:

1. Go to the collection or object to be modified. From the Edit pull-down menu, click on Subscriptions. The Add Subscription page appears.



2. Fill in the page. Refer to the property descriptions in the table below for descriptions of each field.
   
   

   Note: If you are unsure of the purpose of a field while creating the subscription, you can click on the highlighted field name for a brief Help description of the field.

   Note: To select more than one parameter, press the CONTROL key while clicking on the additional parameters.

3. Click Apply.



4. The subscription is created in DocuShare and the Subscription Services page appears.

The Add Subscription page has the following properties:

To view the properties of a subscription, you must access the Services page by clicking on the View Properties option in the Edit... pull-down menu, or by clicking on the Services icon to the right of the link. Subscription properties include:

• All of the properties listed in the previous section (see Adding a Subscription)



• The subscription's title, summary, description, keywords, handle, owner, create and modified dates, who modified the subscription, the publisher, and the recipients of the subscription.

You can edit the properties of a subscription by selecting Edit Subscription from the Edit... pull-down menu, or by clicking on the Services icon. The Edit Subscription page contains the following properties:

To edit properties of a subscription:

1. In the Edit... pull-down menu, select Edit Properties.
   Note: If you are not automatically taken to the Edit Properties page, click the Go button.



2. Edit the subscription properties. Refer to the property descriptions from the above table for information.
   Note: If you are unsure of the purpose of a field while editing subscription properties, you can click on the field name for a brief Help description of that field.



3. Click the Apply button. The Services page appears for that subscription, and the properties are updated to reflect your changes.

DocuShare allows managers of a subscription to add and remove users or groups from a subscription.

To add or remove users from a subscription:

1. Click on Edit Recipients from the Edit... pull-down menu.



• To add a recipient to the subscriber list, highlight or type the user's name in the Add Recipients box.



• To remove a recipient from the subscriber list, highlight or type the user's name in the Remove Recipients box.



• Enter a comma-separated list of email addresses to include recipients who are not registered users.



2. Click Apply. The Subscription Services page appears, and your changes will be reflected.

To delete a subscription:

1. Open the subscription that you want to delete.



2. Select Delete from the Edit... pull-down menu.



3. The Confirm Deletion page appears. Click on the Delete button to delete the subscription.
   
   Note: If you decide that you do not want to delete the subscription, click the Back button on your browser to close the Delete or Confirm Deletion page.



4. The Delete Successful page appears. Click the Click here to continue link to continue working in DocuShare.

If you inadvertently delete an object from the DocuShare repository, the Site Administrator can easily restore it for you. All deleted content is sent to a trashcan accessible only to the Site Administrator. If you mistakenly delete an object, you must contact the Site Administrator and provide him/her with the necessary information. The Site Administrator is responsible for purging the recycle bin on an as-needed basis. After purging, you will be unable to restore items deleted up to that point, so be sure to notify the Site Administrator of deletion restorations in a timely manner.

Table of Contents	DocuShare Calendars	DocuShare URLs