Managing Alerts (Windows SharePoint Services 2.0)

Because Web sites based on Microsoft Windows SharePoint Services are meant to help groups of users work together, they tend to grow quickly and change often. Keeping up with these changes can be difficult for users, especially if they aren't checking on the site every day. To help users stay in touch with changes on a site, Windows SharePoint Services includes a feature called Alerts, an e-mail notification service. When documents, lists, or items in a list on a server running Windows SharePoint Services are created, modified, or deleted, users who sign up for alerts receive messages informing them that changes have been made.

Users can create alerts to track items within a site, such as:

• Lists — Users are notified of changes to the list, such as when an item is added, deleted, or changed in a list.

• List items — Users are notified of changes to a particular item in a list.

• Document libraries — Users are notified of changes to the document library, such as when a document is added, deleted, or changed in a document library or when Web discussion are added, changed, deleted, closed, or activated for a document.

• Documents — Users are notified of changes in a particular document or when Web discussions are added, changed, deleted, closed, or activated for a document.

  Important

  Before alerts can work for a particular site, the e-mail server settings must be configured at the server or virtual server level. For more information, see Configuring E-Mail Settings (Windows SharePoint Services 2.0).

When a user creates an alert for one of these items, he or she can specify what types of events will trigger an alert. Alerts can be generated whenever a document or list item is added, updated, or deleted in a document library or list, or when a Web discussion on a document or list changes. A user can specify one of these events, or select all of them to be notified whenever anything changes on the list, list item, document, or document library they want to track.

Users also have the ability to decide how often they want to receive alerts: immediately, daily, or weekly. Immediate alerts are sent as individual e-mail messages, and daily or weekly alerts are combined into summary messages for the entire Web site.

Users can change their alerts by using the My alerts on this site link on the Site Settings page of their Web site.

Customizing the Message Text for Alerts

For Windows SharePoint Services, you can customize the contents of the alert messages. Keep in mind that while you can alter the contents of the message, there is still no mechanism for identifying and extracting exact text changes within a document or list item. You can, however, customize the text in the message and re-order, add, and remove fields from the message.

The message text for immediate, daily, and weekly alerts is based on content in a series of XML templates on the server computer. To customize the message text, you must edit the XML templates that contain the message text. The templates are stored on the front-end Web server at \\Program Files\Common Files\Microsoft Shared\Web Server Extensions\60\Template\LCID\XML, where LCID is the locale ID. The templates that contain message text for alerts are described in the following table.

You can edit the XML templates to include any of the following tags:

You can use any XML editing tool, such as Notepad, to edit the templates. Keep in mind that any changes you make to this message text are used for all alert messages sent to all users of your server. If you are in a server farm environment, you must edit the templates on each server in the server farm, or copy the edited templates to each server in the server farm. You must be an administrator of the local server computer to edit the XML templates for Windows SharePoint Services.

Configuring and Managing Alerts

You can view alerts for a Web site or subsite and delete alerts that are no longer needed.

If you are a server administrator or a member of the SharePoint administrators group, you can also use SharePoint Central Administration pages to configure settings for alerts, such as the following:

• View alert settings.

• Turn alerts on or off.

• Specify how many alerts users can create.

You can also use the Stsadm.exe command-line tool to configure alert settings if you are a server administrator. Using the command line, you can:

• Turn alerts on or off.

• Specify how many alerts users can create.

Alerts use the Windows SharePoint Services e-mail settings to send alert items. When you configure alert settings, be sure that you also double-check the e-mail settings for your virtual server.

Managing Alerts for a Web Site

You can use HTML Administration pages to view and delete alerts on your site. To manage alerts, you use the Manage User Alerts page in the Site Administration pages.

Manage alerts

1. On the Site Settings page for the Web site, under Administration, click Go to Site Administration.

2. Under Management and Statistics, click Manage user alerts.

3. On the Manage User Alerts page, select a user name in the Display alerts for ___ box, and then click Update.

4. To delete an alert, select the check box next to the alert, and then click Delete Selected Alerts.

Configuring Alerts for a Virtual Server

You can also change alert settings for a virtual server. Changes you make on the virtual server affect all Web sites under that virtual server. To change settings for a virtual server, you use commands on the Virtual Server Settings page. You must be a member of the SharePoint administrators group or an administrator of the local computer to change virtual server settings.

Configure alerts for a virtual server

1. On the server that contains the virtual server, click Start, point to All Programs, point to Administrative Tools, and then click SharePoint Central Administration.

2. On the Central Administration page, under Virtual Server Configuration, click Configure virtual server settings.

3. On the Virtual Server List page, click the virtual server you want to configure.

4. On the Virtual Server Settings page, under Virtual Server Management, click Virtual server general settings.

5. In the Alerts section, next to Alerts on this server are, click On or Off.

6. Under Maximum number of alerts that a user can create, specify whether users can have a limited or unlimited number of alerts.

   • If you want to limit the number of alerts users can create, specify the number of alerts a user can create.

   • If you want users to be able to create as many alerts as they like, select Unlimited number.

7. Click OK.

Using the Command Line to Configure Alerts

You can manage alerts from the command line by using the GetProperty and SetProperty operations with Stsadm.exe. You can set the following properties to configure how alerts work.

The following example shows the syntax to use to turn off alerts:

stsadm.exe -o setproperty -url <url> -pn alerts-enabled
-pv false

Related Topics

For more information about using the administration tools or setting properties on the command line, see Introducing the Administration Tools for Windows SharePoint Services 2.0 in the Windows SharePoint Services Administrator's Guide and Command-Line Properties (Windows SharePoint Services 2.0).

The Alerts feature relies on the e-mail settings and timer service settings you configured for your server or virtual server. For more information about configuring e-mail settings, see Configuring E-Mail Settings (Windows SharePoint Services 2.0). For more information about Microsoft SharePoint Timer Services, see Scheduling Timed Jobs (Windows SharePoint Services 2.0).