FP98: How to Set up FrontPage 98 Forms for E-mail
ID: Q174406
|
The information in this article applies to:
-
Microsoft FrontPage 98 for Windows
SUMMARY
Microsoft FrontPage 98 supports sending form results in e-mail. To
accomplish this, you must configure your form to send results to e-mail and
configure the FrontPage Server Extensions to deliver the e-mail to an e-
mail transport. This article describes how to set up FrontPage 98 forms for
e-mail.
MORE INFORMATION
Defining Your Form
To define your form, follow these steps:
- In FrontPage Editor, right-click the form (inside the dash border)
and then click Form Properties on the menu that appears.
- In the E-mail Address box, type your e-mail address.
- Click OK.
- Save the form by clicking Save on the File menu.
Setting up Your E-mail Transport
To send form results to an e-mail host, the FrontPage Server Extensions
require a Simple Mail Transfer Protocol (SMTP) server. The FrontPage 98
Server Extensions do not support any other form of e-mail server software.
Microsoft Exchange Server 5.0 and above supports SMTP when IMS services
are started.
To send e-mail from the Web server, configure the FrontPage Server
Extensions in the Frontpg.ini file on the server to deliver the mail to an
e-mail transport. To do this, follow these steps:
- On the Windows Start menu, point to Programs, point to Accessories, and
then click Notepad.
- On the File menu, click Open.
- Select the Frontpg.ini file and then click Open.
This file is typically located in the \Windows or \Winnt folder.
- To configure your e-mail transport, locate the [FrontPage 3.0] section
and then enter the parameter you want. When you do this, use the
following syntax.
NOTE: For a list of the supported parameters, please see the
"Parameters" section of this article.
Syntax for Windows NT Server:
Parameter=value
Syntax for UNIX is:
Parameter:value
This should be set in the Wexxxx.cnf configuration file where x stands
for the TCP/IP port on which the Web server is running, for example:
/usr/local/frontpage
- Save and close the file.
- Stop and then restart the Web server.
If your web is hosted on your Web Presence provider's server, you will need
to contact the server administrator and have them follow the steps
previously listed.
Parameters
FrontPage 98 supports five parameters (configurations) for e-mail
transport:
- SMTPHost
This parameter should be set to the name or IP address of a host running
an SMTP server or daemon, such as SendMail on UNIX. When a user submits
a form with results that are to be sent via e-mail, the FrontPage Server
Extensions connect to the SMTP server to deliver the mail. By default,
FrontPage assumes the server is listening to port 25 (the standard for
SMTP) but you can override this by appending the port number to the
name. The name and port number are separated by a colon, like this
name:xx
where xx represents the port number.
The following are examples of a parameter=value setting:
SMTPHost=mail.example.microsoft.com
SMTPHost=127.0.0.1
The following is an example of a parameter:value setting:
SMTPHost:test:1000
- SendMailCommand
This parameter should be set to the name of a program on the server
computer to which e-mail should be piped. Typically, this is SendMail
on UNIX, but it could be any program. When the FrontPage Server
Extensions receive a form processed as an e-mail message, the Server
Extensions invoke the command, replacing all occurrences of "%r" with
the recipient of the mail. The per cent sign character followed by any
other character is replaced by the recipient's e-mail address. The mail
message is passed to the command as standard input. If both
SendMailCommand and SMTPHost are set, SendMailCommand takes
priority.
Following is an example of the SendMailCommand parameter:
SendMailCommand:/usr/lib/sendmail %r
NOTE: Sometimes it may be necessary to add the MailSend parameter. Some
mail servers have filters that block mail by an unknown account, that
is, the account is not a valid email account on the server.
- MailSender
This parameter should be set to the sender's user name. Specifically, it
is used as the argument for the "SEND FROM:" command in SMTP. The
default for SMTP is user@host, where
"user" is the current user account and "host" is the current host name.
- MailCharSet
This parameter can be used to override the character set attribute of
the content-type header.
- MailEncoding
This parameter can be used to override the content transfer encoding
attribute of the content-type header.
Possible Error Messages
If the SMTP host is present when the form is created, but the SMTP host
is later removed (and the form has not changed since then), you receive the
following error on a default page returned by the form when the form is
submitted:
FrontPage Error.
User: Please report details to this site's webmaster.
Webmaster: Please see the server's application event log for more
details.
If SMTPHost is not present when the form is created, you receive the
following error message from FrontPage:
The FrontPage Server Extensions have not been configured to send e-mail.
Please direct your system administrator or Internet Service Provider to
follow the instructions at "Setting Up Your E-Mail Transport" in the
\SERK\enu\Admin.htm file on the FrontPage CD-ROM.
Would you like to remove the e-mail recipient? (Yes or No)
NOTE: This error message is received if e-mail is not configured when the
form is created.
If you choose not to remove the e-mail recipient and the extensions are not
configured correctly, then when the form is filled out and submitted, the
form is refreshed, but a background image (if previously present) does not
appear, and the Address line in your browser is changed from this
http://WebServerURL/YourSubWeb/formtoemail2.htm
to this
http://WebServerURL/YourSubWeb /_vti_bin/shtml.exe/formtoemail2.htm.
or, if hosted on NT Server, it changes to this:
http://WebServerURL/YourSubWeb /_vti_bin/shtml.dll/formtoemail2.htm.
This error occurs anytime that you have a configuration issue with any
of the dynamic run-time components in FrontPage.
If the form is configured to save results to a file, or to send e-mail
simultaneously, and the FrontPage Server Extensions are not configured to
handle e-mail, a 0-byte file is created. It does not contain any data,
you do not see an error message, and the mail is not sent.
REFERENCES
For more information about the FrontPage Server Extensions see the
FrontPage 98 Server Extensions Resource Kit (SERK) located in the \Serk
folder on your FrontPage 98 compact disc.
Additional query words:
98, E-mail mail form
Keywords : fpedit fpiis fpunix fpext
Version : WINDOWS:
Platform : WINDOWS
Issue type : kbhowto
Last Reviewed: July 23, 1999