E-Forms EZ
©1998 by James Carr
http://www.azwebpages.com/e-forms
Fields You Can Place on
Your Feedback
Form or Set Using E-Forms.INI
When you create your form, you can
set the values of these fields using visible or hidden fields. If
you prefer, you can set all of these fields using E-Forms.INI and saving that file in the same directory as e-forms.exe.
When the form is submitted, the program will look in the form
itself for the values of the fields listed below. If a field is
not found, the program will check E-Forms.INI for the default
value. If the field is not found there either, the program will
assume that the fields is not being used.
Note: You can create as many other fields as you want to on your form for whatever needs you have. If you name the field with _req as the last four letters, it will be considered a required field by the E-Forms EZ. If the value of a required field is blank when the form is submitted, the Info Missing Page will be displayed.
| Field Name | Required | Description |
| smtp_server | Yes | Name of the SMTP server which will process your mail such as mailhost.worldnet.att.net. Check your mail software's account or server setup to determine this value or ask your web administrator. This field is almost always hidden or set using E-Forms.INI. |
| smtp_port | No | Port number used to connect to the SMTP server. By default this value is set to 25, however if you are running on a proxy server or Intranet, you may need to check with your network administrator for the correct value and set the value accordingly. This field is almost always hidden or set using E-Forms.INI. |
| mail_to | Yes | Address to which the message will be sent. You can list multiple recipients by separating them with a space. This field is sometimes visible to the user. If you send a Receipt Message, the receipt will be sent from this address unless you specify a value for receipt_from. |
| mail_from | Maybe | Address from which the message will appear to have been sent. If you choose to send a Receipt Message, the Receipt will be sent to this address unless you specify a value for receipt_to. You can require this field by setting the mail_from_required field to a value of yes (or set this option in the Wizard). If you don't require the use to fill out this field, then it will be set to the same as the mail_to field. |
| mail_from_required | No | Set this value to Yes if you want the mail_from field to be required. If you set this field to Yes and the mail_from field does not have a value (hidden or filled out by user), the Information Missing page will be triggered and the message will not be sent. |
| mail_subject | No | Subject of the message. Use a word or phrase to indicate something about the message. This field is sometimes visible to the used. If this field is omitted, the URL of the form will be used. You can combine other macros to make the subject dynamic. For example, the user could select a product from a drop-down box called "product_name" and a location from a drop-down box called "location". You could then set the value of the hidden field mail_subject read "Inquiry from %location% about %product_name". The result might be "Inquiry from Mesa, AZ about E-Forms EZ". |
| message_text | No | Name of the file which contains the
message text to be sent. It can be a standard text file
or an HTML file. If the file is located in the same
directory as e-forms.exe just use the file name without
the drive or directory (message_text="myfile.txt").
If the file is in a directory below the directory where e-forms.exe
is stored, use the format message_text="\mydir\mfile.txt".
If you know the absolute location of the file, use the
format message_text="c:\webfiles\myfile.txt".
You cannot use a URL for this file name. If you know the person receiving the e-mail can view HTML code with his mail reader, you may use an HTML document as your Message Text file. If you want to send an HTML message, the extension for this file must be ".htm". E-Forms EZ checks the file extension to determine whether to send plain text or HTML. If you use any other extension besides ".htm" your message will be sent as plain text. This field is almost always hidden. If you omit this field or the file cannot be found, the program will create a file using the default file format set in E-Forms.INI. If that value is not set, the message will be sent with each field and its corresponding value listed on one line. |
| response_page | No | Name of the HTML file which will be displayed to the user after the message is sent. If the file is located in the same directory as e-forms.exe just use the file name without the drive or directory (response_page="myfile.htm"). If the file is in a directory below the directory where e-forms.exe is stored, use the format response_page="\mydir\mfile.htm". If you know the absolute location of the file, use the format response_page="c:\webfiles\myfile.htm". You can use a URL (http://www.mydomain.com) for this file name, however, you cannot use any macros if you use a URL. This field is almost always hidden. |
| mail_cc | No | Address to which a carbon copy of the message will be sent. You can list multiple recipients by separating them with a space. This field is sometimes visible to the user. |
| mail_bcc | No | Address to which a blind carbon copy of the message will be sent. You can list multiple recipients by separating them with a space. This field is sometimes visible to the user. The Carbon Copy list can be seen by other recipients on the list. Blind Carbon Copy recipients cannot be seen by others. |
| attached_file | No | Name of a file to attach to the message. If the file is located in the same directory as e-forms.exe just use the file name without the drive or directory (attached_file="attach.zip"). If the file is in a directory below the directory where e-forms.exe is stored, use the format attached_file="\webfiles\attach.zip". If you know the absolute location of the file, use the format attached_file="c:\webfiles\attach.zip". You cannot use a URL for this file name. This field is almost always hidden. Tip: The Results_File is created before the message is sent. This means you can attach the Results_File to the message. |
| file | No | Create a field of type "FILE" to accept an uploaded file from the user. If a file is uploaded by the user, it will be attached to the Primary message sent by E-Forms EZ to mail_to. It might look like <input TYPE="FILE" NAME="file" size=50>. |
| error_page | No | Name of HTML file to be displayed to the user if there is an error sending the message. If you don't create an error page, E-Forms EZ will display it's own internal version. If the file is located in the same directory as e-forms.exe just use the file name without the drive or directory (error_page="error.htm"). If the file is in a directory below the directory where e-forms.exe is stored, use the format error_page="\mydir\error.htm". If you know the absolute location of the file, use the format error_page="c:\webfiles\error.htm". You can use a URL (http://www.mydomain.com) for this file name, however, you cannot use any macros if you use a URL. This field is almost always hidden. |
| receipt_text | No | Name of a file to be used for the body
of the Receipt Message (a secondary message sent to the
user after the message_text message has
been sent). If you omit this field, no Receipt Message
will be sent. If the file is located in the same
directory as e-forms.exe just use the file name without
the drive or directory (receipt_text="receipt.txt").
If the file is in a directory below the directory where e-forms.exe
is stored, use the format receipt_text="\mydir\receipt.txt".
If you know the absolute location of the file, use the
format receipt_text="c:\webfiles\receipt.txt".
You cannot use a URL for ths file. If you know the person receiving the e-mail can view HTML code with his mail reader, you may use an HTML document as your Receipt Text file. If you use this option, the extension for this file must be ".htm". E-Forms EZ checks the file extension to determine whether to send plain text or HTML. If you use any other extension besides ".htm" your message will be sent as plain text. This field is almost always hidden. |
| receipt_subject | No | Subject of the Receipt Message. If you omit this field the word "Receipt" along with the referring URL will be used as the subject. This field is almost always hidden. |
| receipt_from | No | Address from which the Receipt Message will appear to have been sent. If you omit this field, the value of the mail_to field will be used. This field is almost always hidden. |
| receipt_to | No | Address to which the Receipt Message will be sent. If you omit this field, the mail_from address will be used. This field is usually completed by the user. |
| info_missing_page | No | Name of HTML file to be displayed to the
user if one of the following fields is blank when the
form is submitted: mail_to, smtp_server,
or any field you create with _req as the
last four characters of the field name. If you don't create an Info Missing Page, E-Forms EZ will display it's own internal version. If the file is located in the same directory as e-forms.exe just use the file name without the drive or directory (info_missing_page="missing.htm"). If the file is in a directory below the directory where e-forms.exe is stored, use the format info_missing_page="\mydir\missing.htm". If you know the absolute location of the file, use the format info_missing_page="c:\webfiles\missing.htm". You can use a URL (http://www.mydomain.com) for this file name, however, you cannot use any macros if you use a URL. This field is almost always hidden. |
| entry_log | No | Name of a file to use as a log file. Each time E-Forms EZ sends a message and finds a valid value for this field, it will append the current date and time. Use this log to keep track of when the script is executed. You can use a different log file for each page or share log files among different pages. If you want this file located in the same directory as e-forms.exe just use the file name without the drive or directory (entry_log="mylog.txt"). If the file is in a directory below the directory where e-forms.exe is stored, use the format entry_log="\mydir\mylog.txt". If you know the absolute location of the file, use the format entry_log="c:\webfiles\log.txt". This field is almost always hidden. |
| results_file | No | Name of a file into which the results of
the form will be placed. You can use a different Results File for each page or
share files among different pages. If this is file
located in the same directory as e-forms.exe just use the
file name without the drive or directory (results_file="myresults.txt").
If the file is in a directory below the directory where e-forms.exe
is stored, use the format results_file="\mydir\myresults.txt".
If you know the absolute location of the file, use the
format results_file="c:\webfiles\myresults.txt".
This field is almost always hidden. Automatically Generated Unique File Names: If you set the name of this field to /auto, unique file name will be generated automatically. This will allow you to have a unique results_file for each form submitted. If this file does not exist on disk, it will be created when the program is executed. If you need to reset this file, simply delete it and let the program create a new one the next time it is executed. This file is updated before the message is sent, which allows you to attach it to the message using the attached_file field. |
| results_file_template | No | If you create a results_file,
the form results will be inserted using the value of the default_format
field. If that field is omitted, then the results will be
formatted with one field per line (mail_to:carrprog@azwebpages.com).
If you want to customize the format of the results_file,
then create a results_file_template. This
file is formatted using macros the same way as the message_text
file is. The results_file_template
overrides the default_format field. You can use a different Results File Template for each page or share files among different pages. If this is file located in the same directory as e-forms.exe just use the file name without the drive or directory (results_file_template="myresults_template.txt"). If the file is in a directory below the directory where e-forms.exe is stored, use the format results_file_template="\mydir\myresults_template.txt". If you know the absolute location of the file, use the format results_file_template="c:\webfiles\myresults_template.txt". This field is almost always hidden. |
| delete_results_file | No | Set this value to "Yes" to set the program to delete the Results File after the message has been sent. By default this value is set to "No". |
| default_format | No | If you choose not to create a message_text
file, E-Forms EZ will create a message for you. By
default it will create a message using one form field per
line (mail_to:carrprog@azwebpages.com). If you want the
program to use a defaullt Auto-Format, you can specify
the type of message using the default_format field and
one of the following values: EZ1ColTextNoLabel: One
Column, No Labels, Text Format See the E-Forms Wizard for examples of these formats. |
| use_asterisks | No | If you set this value to "Yes" then any macro that does not have a corresponding field value will be evaluated to "**". If you set this value to "No" then the macro will be replaced with a blank space. By default this value is set to "Yes". |
| date_format | No | Determines how the results of the macro ucgi_date
is formatted. Set the default value using the Wizard to
use the same format for all of your forms. Examples
include: dd-mmm-yy = 04-Jul-98 mm-dd-yy = 07/04/98 |
| time_format | No | Determines how the reults of the macro ucgi_time
is formatted. Set the default value using the Wizard to
use the same format for all of your forms. Examples
include: hh:mm = 11:37 h:m:s = 9:07:23 |
Note: You may use any file name you want for the Response Page, Message Text, Error Page, Info Missing Page, Attached File, Receipt Text and Entry Log. You can use different names for different forms or share the same files among different forms. This gives you complete control over your site.