Example Append Setups
This section uses HTML 3 elements; if it doesn't make sense on your browser, look at this text version.
Desired Setup | Field has value of: |
_append | _comment_dir | _appendfile | _appendformat | _append[n] | _append_vals |
Append some HTML text as specified in an external file with variable instantiation |
true |
the directory containing the file to be appended to |
the name of the file to append to |
the external file |
not set |
Append some HTML text as specified inline with variable instantiation |
true |
the directory containing the file to be appended to |
the name of the file to append to |
not set |
the HTML (in symbol encoded format) |
not set |
Append some fields in the default format |
true |
the directory containing the file to be appended to |
the name of the file to append to |
not set |
the fields you want appended or "all" |
Nothing is appended |
not true |
the directory containing the count file |
not set |
The Append Fields
- _append
- Meaning: If the value is true some text is appended to a file as specified with the following fields otherwise nothing is.
- Applies: Always
- Default: true
- _comment_dir
- Meaning: A full path to the directory in which comments (the output of the form) are stored.
- Applies: When "_append" is true
- Default: "/local/Web/comments". Reliance upon this default is discouraged.
- Errors: if the specified directory does not exist or could not be changed to, an error will be reported and all processing will terminate.
- _appendfile
- Meaning: The file in the _comment_dir that will get appended to (the log file).
- Applies: When "_append" is true
- Default: "comments.html"
- Errors: If the specified file does not exist or could not be written to, an error will be reported and processing will continue without an append having taken place. Note that if the file does not exits, it will not be created. This is done for safety reasons.
- _appendformat
- Meaning: If this field is present, then its value is interpreted as the full path to an external HTML file which is to be used as the format for what is to be appended to the log file. Variable-encoded format conversion is performed on this file.
- Applies: When "_append" is true
- Default: not present
- Errors: if the specified file does not exist or is not readable, an error will be reported and all processing will terminate.
- _append[n] (_append1, _append2, ...)
- Meaning: If "_append1" is present, then these fields are appended in order to the "comments.html" file. Variable-encoded format and symbol-encoded format are used.
- Applies: When "_append" is true and "_appendformat" is not present
- Default: not present
- _append_vals
- Meaning: When the text to append is not specified with "_append[n]", this indicates what fields are to be put in a default format. This field is a whitespace separated list of fields to be appended in order or "all".
- Applies: When "_append" is true, "_append1" is not present, and "_appendformat" is not present
- Default: "all"
See Also
-
Controlling the display
-
Controlling the sending of electronic mail
-
Variable encoded format
-
Symbol encoded format
|
|