SATFORM
S@
Home SATGUI SATSHELL SATFORM SATFILTER SATREPORT SATMYSQL License Download Examples Contact

ANNOUNCEMENT (18th October 2003):

ANNOUNCEMENT (24th March 2002):


What is SATFORM

SATFORM is a forms processor which provides a facility to print "word processor" quality letters/reports by merging a data source with a template form. The output is suitable for HP LaserJet III (PCL), or later, compatible printers.

Although designed to work with other SAT components, SATFORM is equally effective when used "stand alone". It is very easy to create shell/awk/perl scripts which make use of SATFORM functionality to create letters/reports/mail-shots etc.

It is also possible to make use of SAT/ML formatting to process embeded SAT/ML tags using the companion SATFILTER script.

SATFORM is implemented as a script for easy portability.

How SATFORM works

SATFORM uses an HTML style markup system (SAT/ML) to define document template forms. As many people are familiar with HTML it was decided to copy this style. Some of the tags function as they do in HTML, but many have functionallity specific to SAT/ML.

The format required for merge data is simple, making it easy to format data from a variety sources, for example, "flat" files.

The (SAT/ML) document template forms are merged variable data to produce the final (LaserJet PCL) formatted result.

See the Examples page for sample SAT/ML and scripts.

Release Status

SATFORM is currently at release 1.00.00

System Requirements

Any Unix system with a version of nawk/gawk which supports toupper and tolower.

Installation

To extract the Unix "tar" files


The directory location of the SATFORM script (satform) is not important, but it is suggested that it be placed in the /usr/local/bin directory.

The first line of satform...

#!/usr/bin/nawk

Will probably need to be changed to reflect the location of the nawk/gawk interpreter on your system.

Release History

1.00.0010/2003 New: Subscript/Superscript tags.
New: "ltrim", "trim" and "rtrim" tags.
New: Delta and Omega special characters.
Fixes: Problem with "{}" in regexp for some AWKs.
Fixes: Problem losing trailing zero in "abs".
Fixes: Problem with "repeat".
Fixes: Problem with external tag parameters.
Beta412/2001 New: String Macros.
Beta306/2001 Fixes: Special Characters sometimes not being processed.
Beta205/2001 Fixes: Incorrect numeric comparisons in Conditional Macros when either operand is a single digit integer -and- Hang/crash problem when Macro body contains a Special Character. New: Case Macros.
Beta104/2001 Numeric right justify supports numbers containing commas.
Alpha212/2000 Fixes: Hang/Core Dump problem when variable data contains an ampersand (&) -and- "close" syntax problem with some AWK interpreters.
Alpha110/2000 First public release.

Known Bugs

ReleaseBugFixed in
Beta4 Problem with "{}" in regexp for some AWKs.
Problem losing trailing zero in "abs".
Problem with "repeat".
Problem with external tag parameters.
1.00.00
Beta2 Special Characters sometimes not processed. Beta3
Beta1 Incorrect numeric comparisons in Conditional Macros when either operand is a single digit integer -and- Hang/crash problem when Macro body contains a Special Character. Beta2
Alpha1 Hang/Core Dump problem when variable data contains an ampersand (&) -and- "close" syntax problem with some AWK interpreters. Alpha2


Copyright © 2003 Adrian Davis.