http://www4mail.org/help/forms.txt
www4mail provides support for submission of form data in two mode
1. THROUGH A WEB BROWSER (Recommended method)
In this mode you can enter your data and your selections
on a web page, the data is automatically submitted to
www4mail server.
Here you have use the Submit button provided by the Web Page
and not the www4mail "Get Selected Document(s)" button.
Most submit buttons are labeled Submit or Search or Get it.
2. TEXT (E-MAIL only) MODE
In this mode all interation is by e-mail. Your initial
request for the URL, should have the XFORMREPLY = TEXT entry. See help
xformreply
Example
XFORMREPLY = TEXT
http://www.yahoo.com
The above example generates the reply shown at the bottom of
this document
The reply is in 3 separate parts:
* A TEMPLATE SECTION
* TEXT DUMP OF THE URL (showing locations of Form variables)
* A KEY explaining the various FORM variables.
In order to use this effectively, it is necessary to 1. check the
location of the variable in the TEXT DUMP section.
(in the example, the variable named p is to be filled
in with the user data, notice it appears just before
the ________________________ ).
2. Cut the particular form template to a new e-mail page
3. Filling the data against the variable
4. Send the template back to www4mail
Example
X---- START FORM 1 ----X
XFORM=FORM ACTION http://search.yahoo.com/bin/search METHOD GET
XBASE = http://www.yahoo.com/
XFORMREPLY = TEXT
p=frog+dissertion
Search=on
XSUBMIT_NOW = on
XFORM= /FORM
X---- CUT HERE FOR FORM 1 ----X
end
Sending the above to the www4mail server will cause a search for
frog+dissertion on the search.yahoo.com and the results will
again be returned as text.
SEE ALSO
help xformreply
Note: The Search Button is already placed into the template
3. NOTES ON SUBMITTING MULTI-LINE DATA
For submitting multi-line data, you may use the following
table to get different behaviour from the www4mail server.
{( First line
second line
third line
...
last line )}
Your data will be submitted to the WEB server as one
line with each line separated by %20 (a single space).
{ First line
second line
third line
....
last line }
Your data will be submitted to the WEB server as one
line without any gap between the lines.
[ First line
second line
third line
....
last line ]
Your data will be submitted to the WEB server as one
line with each line separated by %0D0A (the Enter or Return key).
( First line
second line
third line
.....
last line )
Your data will be submitted to the WEB server as one
line with each line separated by a single space.
Note that the www4mail gateway may remove this space
later.
In all above examples note that spaces in the middle of lines
are preserved.
If you are using the TEXT mode then make sure that the {, ( or [ or {(
comes after the = sign on the same line.
If you use a web browser then make sure that the first character of your
entry is the {, ( , [ or {( sign(s).
---------------------------------------------------
SAMPLE REPLY FOR EXAMPLE ABOVE http://www.yahoo.com
---------------------------------------------------
WWW4MAIL TEMPLATE FOR FORM(s) IN THIS DOCUMENT
X---- START FORM 1 ----X
XFORM=FORM ACTION http://search.yahoo.com/bin/search METHOD GET
XBASE = http://www.yahoo.com/
XFORMREPLY = TEXT
p=
Search=on
XSUBMIT_NOW = on
XFORM= /FORM
X---- CUT HERE FOR FORM 1 ----X
end
END OF FORM TEMPLATE(s)
*****************************************************
* TEXT DUMP OF PAGE SHOWING LOCATION OF VARIABLES: *
* Use the page and associated KEY below to complete *
* and return one or more sections of the template *
* shown above. *
*****************************************************
Yahoo!
[ [1]Reuters News Headlines | [2]What's New | [3]Cool Sites]
[ [4]Write Us | [5]Add URL | [6]Random Link | [7]Info ]
*p* ______________________________ *Search* Search [8]Options
* [9]Arts-- Humanities, Photography, Architecture, ...
* [10]Business and Economy [11][Xtra!]-- Directory, Investments,
Classifieds, ...
* [12]Computers and Internet [13][Xtra!]-- Internet, WWW, Software,
Multimedia, ...
* [14]Education-- Universities, K-12, Courses, ...
* [15]Entertainment [16][Xtra!]-- TV, Movies, Music, Magazines,
Books, ...
* [17]Government-- Politics [18][Xtra!], Agencies, Law, Military,
...
* [19]Health [20][Xtra!]-- Medicine, Drugs, Diseases, Fitness, ...
* [21]News [22][Xtra!] -- World [23][Xtra!], Daily, Current Events,
...
* [24]Recreation and Sports [25][Xtra!]-- Sports, Games, Travel,
Autos, ...
* [26]Reference-- Libraries, Dictionaries, Phone Numbers, ...
* [27]Regional-- Countries, Regions, U.S. States, ...
* [28]Science-- CS, Biology, Astronomy, Engineering, ...
* [29]Social Science-- Anthropology, Sociology, Economics, ...
* [30]Society and Culture-- People, Environment, Religion, ...
_________________________________________________________________
References
1. http://www.yahoo.com/text/headlines/
2. http://www.yahoo.com/text/new/
3. http://www.yahoo.com/text/Entertainment/Cool_Links/
4. http://www.yahoo.com/text/suggest.html
5. http://add.yahoo.com/bin/add
6. http://random.yahoo.com/bin/ryl
7. http://www.yahoo.com/text/docs/info/
8. http://www.yahoo.com/search.html
9. http://www.yahoo.com/text/Arts/
10. http://www.yahoo.com/text/Business_and_Economy/
11. http://www.yahoo.com/text/headlines/business/
12. http://www.yahoo.com/text/Computers_and_Internet/
13. http://www.yahoo.com/text/headlines/tech/
14. http://www.yahoo.com/text/Education/
15. http://www.yahoo.com/text/Entertainment/
16. http://www.yahoo.com/text/headlines/entertainment/
17. http://www.yahoo.com/text/Government/
18. http://www.yahoo.com/text/headlines/politics/
19. http://www.yahoo.com/text/Health/
20. http://www.yahoo.com/text/headlines/health/
21. http://www.yahoo.com/text/News/
22. http://www.yahoo.com/text/headlines/news/
23. http://www.yahoo.com/text/headlines/international/
24. http://www.yahoo.com/text/Recreation/
25. http://www.yahoo.com/text/headlines/sports/
26. http://www.yahoo.com/text/Reference/
27. http://www.yahoo.com/text/Regional/
28. http://www.yahoo.com/text/Science/
29. http://www.yahoo.com/text/Social_Science/
30. http://www.yahoo.com/text/Society_and_Culture/
X---- KEY TO FORM DATA CHOICES & OPTIONS ----X
NAME : p
SHOWN AS: *p*
DEFAULT VALUE:
NAME : Search
SHOWN AS: *Search*
DEFAULT VALUE: on
NOTE(s): Submit Button
----------------------------------------------------------------------
To contribute to the discussion, email to accmail@listserv.aol.com
To unsubscribe, email to the *admin* address lists...@listserv.aol.com
with UNSUBSCRIBE ACCMAIL as the message body.
WWW: http://emailonly.szs.net/
Archives: http://news.gmane.org/gmane.mail.emailonly
----------------------------------------------------------------------
