home *** CD-ROM | disk | FTP | other *** search
/ PC Pro 1999 April / DPPCPRO0499.ISO / April / Netobjs / Install.exe / data1.cab / Components / FormHandlerComp / readme.txt < prev   
Encoding:
Text File  |  1998-12-16  |  4.9 KB  |  115 lines
  1. Form Handler Component for Fusion 4.0
  2.  
  3. Requirements--
  4. The Form Handler component requires a web server capable of executing files with 
  5. the extension .cgi.  The .cgi files need to be published to a directory that has 
  6. executable permission.
  7.  
  8. Supported Web Servers--
  9. The Form Handler component for Fusion 4.0 is supported on the following servers:
  10.  
  11.     +Apache (Linux)    
  12.      +Netscape FastTrack 2.0 (NT 4.0)
  13.     +Netscape Enterprise 2.0(NT 4.0)
  14.     +IIS 4 (NT 4.0)*
  15.           +IIS 2.0/3.0(NT 4.0)
  16.     +WebSTAR 2.0 (Mac)
  17.  
  18. *The Form Handler is supported on IIS4 with the exception that the output file 
  19. is always created in the directory C:\webdata.
  20.  
  21. The Mac version server-side files are stored as a Mac Binary file, with its 
  22. entire content on the data fork.  When publishing to a Mac server, the Mac 
  23. server should convert these files to executable form.  However, if the server is 
  24. not configured to automatically convert the files to a Mac Perl 5 executable, 
  25. you may have to manually convert these files on the server with a utility, such 
  26. as MacBinary II+.
  27.  
  28. On the client side, the Form Handler requires a forms compliant browser 
  29. supporting the <meta redirect> tag.  The following browsers are supported by 
  30. Form Handler:
  31.     
  32.     +Netscape 3.0, 4.0 (for NT/Win 95/Mac/Sun)
  33.     +MSIE 3.0, 4.0 (for NT/Win 95/Mac) - with Script patch/Debugger patch.
  34.  
  35.  
  36. Restrictions--
  37. The Form Handler has the following restrictions
  38.     +There should only be one Form Handler component per form scope.
  39.     +The output directory may have to be created manually for the NT version.
  40.     +Permissions may have to be set on the server side.  When publishing to Unix, 
  41.     file permissions may have to be set appropriately, depending on whether Fusion 
  42.     was able to execute CHMOD over the ftp connection.
  43.     +The Form Handler does not accept more than 256 characters from a multiline edit                 field.  
  44.  
  45. Numbering each data-containing Form element--
  46. a)Click to select a data-containing form element
  47. b)On the property palette, find the name field, enter number 1 for name.
  48. c)repeat steps a) and b) for all form elements (except button element), incrementing 
  49. the number for each name.  So the first element will be 1, the second element will be 
  50. 2..etc.
  51.  
  52. The naming scheme has to be in incremental order starting with 1 and ending with 
  53. the highest element # in order for Forms Handler to function correctly.
  54.  
  55. The order of naming affects the order of the data being stored in the file.  The 
  56. data is saved in a "<tab>" tab comma delimited format.
  57.  
  58.  
  59. Setting the Properties Of Form Handler--
  60. The Form Handler component has properties that should be set in the layout 
  61. view:
  62.  
  63.     +Publish To
  64.     This specifies which version of the Form Handler .cgi is to be sent to the 
  65.     server.  The Windows .cgi is an executable file.  The Unix .cgi is a Perl 5 
  66.     script.  The Mac version is a Mac binary Perl 5 file.  The Email option has no 
  67.     .cgi file corresponding to it.  Selecting the email option causes Form Handler 
  68.     to place a "mailto:" tag in the generated HTML file.
  69.  
  70.     +Submit Name
  71.     This is the name that appears on the submit button.
  72.  
  73.     +Success URL (Windows, Unix, Mac)
  74.     This is the URL that Forms Handler will redirect the web user to on a successful 
  75.     submisssion.
  76.  
  77.     +Error URL (Windows, Unix, Mac)
  78.     This is the URL that Forms Handler will redirect the web user to on a 
  79.     unsuccessful submission.  The unsuccessful submission could be caused by the 
  80.     user failing to fill in a required field. 
  81.  
  82.     +Output file (Windows, Unix, Mac)
  83.     This is the file name that Forms Handler writes your form data into. 
  84.  
  85.     +CGI-Bin Directory (Windows, Unix, Mac)
  86.     This field specifies the directory where the Form Handler cgi will reside.
  87.  
  88.     +Perl Path For Unix (Unix)
  89.     This is the path where your Perl 5 CGI script can find the Perl interpreter 
  90.     during any CGI access.  The Perl 5 script is written and tested for 
  91.     Perl 5.  If you have access to a unix shell prompt, the location can be obtained 
  92.     by typing "which perl" or "which perl5" at the prompt.  The output of the 
  93.     command is the perl 5 path that should be entered for this box. If you are unable to
  94.     locate the Perl 5 interpreter on the server, please contact your ISP/Webmaster/MIS 
  95.     staff.
  96.  
  97.     +Storage Directory (Unix, Mac)
  98.     The directory where the output file is to be stored.  This should be given 
  99.     relative to the base publish directory.
  100.  
  101.     +Abs. Storage Dir (Windows)
  102.     The directory where the output file is to be stored.  This is an absolute path.
  103.  
  104.     +Require Field n
  105.     This specifies whether or not it is required that the site visitor enters a value 
  106.     or makes a selection in a form element of name n.  If set to true, the Form 
  107.     Handler will take the visitor to the error page if field n is not filled in.  
  108.     One of these fields exists for each form element in the form.  These fields are
  109.     ignored for email.
  110.  
  111.     +Email (Email)
  112.     This specifies the email address where the form data is to be sent, if published 
  113.     with the email option.
  114.  
  115.