Note that this article is for alerts on a SharePoint list. If you are alerting on a List Rollup Data View, the potential causes are slightly different.
The first thing to check when e-mails aren't going out for an alert you just configured is the Last Run Status column of the Alert Plus Web Part.
Status is Success
If the status is Success, and you are sure that there are items in your list that should have generated an email, the first thing to check are the Event Receivers on the alert list. When an alert is created and enabled for a SharePoint list, event receivers are added to the Alert List. You can tell if they are working properly by checking the Alert+ AlertChangeList.
You should find the Alert+ AlertChangeList on the site where your Alert Plus Web Part is. When you dropped the Alert Plus Web Part on a page, the Alert+ AlertChangeList and another list called the Alert+ Configuration List were created.
The event receiver added to your Alert List will depend on the type of alert: on create, on modify, or on delete. If you are alerting when an item is created, an item will be added to the Alert+ AlertChangeList when an item is created in your Alert List. Likewise, for modifications and deletions.
To make sure the event receivers are working properly, you need to watch the Alert+ AlertChangeList. Follow these steps:
- Look in the Alert+ Configuration List to determine the ID of your problem alert. It's ID will be the value of the ID in this list.
- With the Alert ID of your problem alert, look in the Alert+ AlertChangeList for any items where the AlertID column is equal the ID of your problem alert. I would expect that you won't see any items in the list with that AlertID. Leave this IE window open so you can refresh this list after step 3 below.
- Do whatever will trigger an alert - i.e., create a new item, modify an existing item, or delete an item.
- Refresh your Alert+ AlertChangeList view and see if an item was created with an AlertID of your troublesome alert. It's important you do this within 2 minutes of completing step 3 because the alert service runs every two minutes - after it processes an alert, it should clean out the Alert+ AlertChangeList so no more records with the AlertID of the processed alert exist.
- If you don't see any items getting added to the Alert+ AlertChangeList with your troublesome alert ID, you have confirmed that there is an issue with the event receivers. This is what to do next:
- Disable your troublesome alert - this will remove the event receiver from the alert list for the alert.
- Enable your troublesome alert - this will create the event receiver for the alert.
- Repeat steps 1-4 above. If you still don't see any items added to the Alert+ AlertChangeList, submit a Support Ticket through MyBamboo.
Status is an Error
If the status column shows some sort of error, we need to take a closer look. Some of the errors you might see are:
- the Last Run Status field for the alert in the Web Part reports Can't find a view with name....This happens when the alert service can't find the view. This could be because the view name was changed after the alert was configured or the view is private and only the person who created it can see it. Alerts are processed by the service, which runs under a particular identity. This user won't be able to access private views that he didn't create. Make sure the view you specified in the alert configuration exists and is a public view.
- the Last Run Status field for the alert in the Web Part report The request failed with HTTP status 401: Unauthorized. This happens when the account the service runs as doesn't have access to the alert list, the Alert+ Configuration List, or the Alert+ AlertChangeList. If its the alert list that is the problem, and you are sure that user has access to the list, it could be the URL to list. Try adjusting the URL of the Alert List Site Path in the Alert+ Configuration List. For example, try using the internal name of the server rather than the name used by external users. You can also try using the IP address of the server. If you have other alerts in your Alert+ Configuration List that are working OK, compare the Alert List Site Path of the ones working OK to the one that is not OK.