Troubleshooting

If you have any questions that are not answered here, please refer to the Support area in CorasWorks Central.

How do I set up a group of individuals to send an email to?

You can do this in two ways:

      You can specify a distribution group email address which would be set up on your Exchange Server

      You can establish the Assigned to and/or CC column as a choice column, then identify email addresses (for either individuals or distribution groups) as the choices. Select the option to display the choices as checkboxes that allow multiple selections. Now you can select more than one email address, and the LIE will send the email to all of the selected addresses.

I didn't receive an email message.

This could be due several reasons:

      An error is occurring do to an incorrect setup of the web part. Please verify all properties correspond to the correct item in the List or Email server and try again. You will know if an error is occurring if the "Send Email" field does not change to "No" after you have saved the list item.

      Your email server is not permitting the email be sent through it. Please make sure you specified the correct email server and try again.

      You did not select "Yes" for the "Send Email" field.

      You did not select a User in the User Lookup field within the list item. (This references the primary User Lookup field only)

      You did not specify a Title within the list item that references the "Title" type field set up in the web part’s custom properties.

      The list item was added or edited in Datasheet mode. Email notifications are triggered when the checkemail.aspx is used and the pop-up is displayed. If the checkemail.aspx is not called, as is the case when Datasheet mode is used, the email will not be sent.

This can also occur if your email server is capturing Spam email message from your SharePoint Server. If you utilize an email address which does not correspond to the Domain (URL) of the server (e.g., yourdomainname.com), then your email server may not permit it since your DNS states that the email address domain you specified does not correspond to the IP Address of the domain from which you are sending.

Others are receiving email, but I am not.

This can occur if your Email Server is capturing SPAM email message from your SharePoint Server. If you utilize an email address which does not correspond to the Domain (URL) of the server (ex. corassolutions.com), then your Email Server may not permit it since your DNS states that the email address domain you specified does not the correspond the IP address of the domain you are sending from.

Notifications do not include a link back to the item.

If you enable both “Use SharePoint Email” and “Send Email as HTML,” you will need to modify the item’s URL setting within the “Email Body” field, setting it to be a hyperlink. If you do not do this, the resulting notification may not have a link back to the item.

I made a change to user access to an email-enabled list, and now the notifications don’t work anymore.

If you change your users’ access to an email-enabled list, it is important that you consider how that modification might interact with the “Reset Send Email to No” property. For example, if you restrict user rights to a list so that the user can only create (not edit) an item, the List Item Emailer will not be able to reset the Send Email field when a list item is created because that is a type of edit. As a result, it will not be able to send the email notification.

Email Notification sends emails when items are closed without saving.

Emails are sent based upon the default behavior of the form pages.  The CheckEmail.aspx page (the small window that is open whenever an item is saved) automatically runs whenever the NewForm.aspx or EditForm.aspx pages are exited.  If that page has a value of "Send Email" equal to Yes, an email is sent. So, if the user does not want to send an email, they should set the “Send Email” value to No before exiting the page.

This can also occur for another reason. If you open a new item and then either close it or use your browser’s Back button, the LIE will look at the last item that was either edited or created and if the Send Email setting is set to Yes, it will send an email for that item. To prevent this from occurring, access the web part properties and locate the Reset Send Email to No property in the Override Properties section. This property is disabled by default. Place a check mark in the box to enable it.

I received the error "Value does not fall within the expected range."

If this error occurs before entering the list, it indicates that the list name located within the "List Name" text box is incorrect. Please correct it and try again.

If this error occurs after entering the list, it indicates that the Subject or Body values being used are incorrect. Please check to make sure that the values you are trying to collect exist within the list and try again.

I received the error "Access is denied."

This indicates that the user trying to send an email does not have permission to view the list shown in the email.

I received the error "User cannot be found."

This indicates that the user specified in the "Assigned To" is not a valid user for the site. This can be seen by trying to view the user within the "Manage Users" administration area.

I receive an error message which references the CDO Object.

This can occur if the email server settings are set incorrectly. You will need to confirm that the "Email Server" text box is correctly set and that the email server is able to send messages. This can also occur if the user who tried to send the email does not have an email address assigned to their account and the "Email From" text box is empty. Please also confirm that your email server permits relay from your current SharePoint Server.

How can I make email notification work with SPS?

Email notification does work in an SPS environment.  However, as was stated earlier in this document, there is a SharePoint limitation that prevents list templates from working with SPS.  The pre-enabled lists and libraries are for use with WSS or in WSS site collections under a portal.  If you want to email-enable a list for use with SPS, you will need to add a few fields to the list.  (If you are a PASM customer, see procedures in the How To: Email-Enable a List or Library document in the Premier section of the CorasWorks Central site.)  Once that is done, you will need to use FrontPage to make the modifications described in the Capabilities Guide.

Tips and Tricks

Here are some hints and tips that CorasWorks Support has found valuable in troubleshooting email problems.

      Field Values – There are several default values in the List Item Emailer web part properties.  Make sure the values correspond exactly to the field names in your list.

      Render Error To Output – The Render Error To Output option, from the Override Properties section of the web part properties, can be very useful as a troubleshooting tool.  If you are experiencing errors and everything looks right, you can add the List Item Emailer web part to any page (default.aspx, for example) and configure it to point to the list you are working on. It will tell you if it has an error, but with more detail than the error log, every time you refresh the page. It will tell you if the error is before entering the list (which means that the list name is wrong) or after entering the list (which denotes an incorrect or empty field value).  If it does not throw an error, after checking all the settings and correcting mistakes, copy the settings into the web part in the checkemail.aspx.

      Enable the ‘Use SharePoint Email’ option – For most people, the “Use SharePoint Email” web part property provides the most effective method of sending email.  It allows the web part to query the SharePoint configuration and use the email information defined there.  It will also allow the email to contain HTML elements.
There are three reasons why email will be sent as straight Mime rather than HTML:

      You have an email address specified in the From field.

      You have an IP address specified in the Server IP address line

      You have not checked the 'Use SharePoint Email' box

      Not Receiving Email Notifications – If some users receive the emails and others do not, make sure that the user has an email address assigned in the SharePoint system.

      If the user is signing in to WSS with an AD account rather than a SharePoint-created account, there will be no email address assigned, (Site Settings/Go to Site Administration/View User information). This is also an issue for SPS (Site Settings/Manage Security and Additional Settings/Show User Information).