To create the association between a form and an error condition, create a form with one of the following names. Then create an editable text field named MessageString to hold the error message. Add additional text, links, and other form objects that you want to display with the error message.

Form name	Condition
$$ReturnAuthenticationFailure	The user’s name and password cannot be verified.
$$ReturnAuthorizationFailure	The user does not have a sufficient access level for the database.
$$ReturnDocumentDeleted	A document was successfully deleted.
$$ReturnGeneralError	Any other error condition has occurred.

Adding the message field

Create one of the following fields to hold the error message:

• An editable text field named MessageString to display the default server-generated error message.
• A computed-for-display field whose formula replaces the default error message with a customized message.

  For example, this formula for a field named CustomString on a $$ReturnAuthenticationFailure form gives more information to the user if authentication fails. The formula takes the value from the default MessageString field if it contains "unauthenticated" and replaces it with instructions to the user. If the MessageString field does not contain the word "unauthenticated", Domino uses the value of MessageString instead.

  @If(@Contains(messagestring;"unauthenticated");"Sorry, the name and password you entered are unknown in our system. If you are new to our site, return to the home page and follow instructions for registering.";messagestring)

Glossary