Q. How do I use Formaldehyde to create a form using FDML?

A. Formaldehyde is software that uses forms-processing scripting language FDML. It is usually used to create discussion forums, guestbooks, or to email form data. Formaldehyde is very similar to our old forms processing software, NetForms, however there are some features that are not supported. Use the NetForms Users Guide to create your form but be sure to ajdust your code based on the information below.

Changes

LINKNEXT and LINKPREVIOUS

These FDML commands will only work correctly if the menufile and htmlfile are in the same directory as the FDML file. If your FDML form is used to modify or create a document in a different directory, you must either give up the use of LINKNEXT and LINKPREVIOUS, or put the FDML file, htmlfile and menufile into the same folder.

AUTOLINK and RECENTLIST

These FDML commands do not work on the new server and are ignored by Formaldehyde.

Absolute paths and FDML

Formaldehyde can not process FDML directives which use absolute paths in filenames processed or created by Formaldehyde. Absolute paths used in FDML commands must be replaced with relative paths. Further, Formaldehyde can only create new pages or edit existing pages which are in the same directory, or subdirectory, as the .fdml file. Formaldehyde can not edit or create pages in a parent directory of the .fdml file.

Translation: You can't use absolute paths in FDML directives. You must use relative paths. FDML files can't
write to parent directories. They can only write to their own directory, or to a sub directory.

Below are examples of the old method and the new method.

Example of old method
(don't do it this way):

<CREATEDOC>"/students/s/smithj/myform/<REPLACE_FN DocTitle>.html"</CREATEDOC>
<AUTOLINK>"/AutoLink.doc"</AUTOLINK>
<MENUDOC "<!--Main-->">"/students/s/smithj/myform/default.html"

Examples of new method
(do it like this):

If the .fdml file is in the "myform" directory, then this code should be rewritten like this:

<CREATEDOC>"<REPLACE_FN DocTitle>.html"</CREATEDOC>
<MENUDOC "<!--Main-->">"default.html"

Or, if the .fdml file is in the "smithj" directory, then this code should be rewritten like this:

<CREATEDOC>"myform/<REPLACE_FN DocTitle>.html"</CREATEDOC>
<MENUDOC "<!--Main-->">"myform/default.html"