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