Equisys Technical Notes

Technical guidance, explanations and fixes for our products

HOWTO: Creating coversheets under Citrix WinFrame

Print

ZTN1045

ID: ZTN1045

This Zetafax technical note applies to:

  • Zetafax 5.5 client
  • Zetafax 6.0 client

Summary

Zetafax 6 introduced a Coversheet editor program COVEDIT.EXE. This program provides a graphical interface to create Zetafax coversheets, including support for TrueType fonts.  The program is not supported under Windows NT 3.51, so it cannot be run in a WinFrame session, but can be run on any full network client under Windows 95/98, Windows NT 4.0 or Windows 2000.

This document describes the method of creating coversheets with previous versions of Zetafax (5.5 or earlier), expanding on the information in the User Guide.  Coversheets created using earlier versions of Zetafax can still be used with Zetafax 6.

More information

A Zetafax coversheet consists of two files: a foreground file that contains text, which is different for each fax (such as the name and organisation), and a background file, containing fixed information such as the company logo. The background file is optional, and can be omitted if all the fixed information is in the foreground file.

Coversheets are stored in the zfax\SYSTEM\Z-COVER directory, where 'zfax' is the name of the directory where the Zetafax server files are installed. The foreground is a FaxMerge format file with an extension of .EPN. It can be produced using any Windows word processor program. The background is a graphics file, with extension .G3F for fine mode faxing, or .G3N for standard mode. Zetafax is shipped with a standard coversheet (called COVSHEET) plus a number of example foreground files (called EXAMPLE1 etc), all in Write format. The examples are not distributed with the evaluation system due to disk space limitations.

The simplest way of personalising the coversheet is to use the standard foreground (COVSHEET), and just replace the background with your company logo or letterhead. Alternatively you can create a completely new foreground file, changing the design as required.

Foreground file

The coversheet foreground file contains the variable information that is overlaid onto the background file at sending time. Zetafax adds items such as addressee, sender, date, and number of pages automatically, replacing fields contained in the foreground file. These fields are called FaxMerge commands, and have the form %%[...]

You can change the layout of the foreground information on the coversheet if required. This is done by creating a file in your word processor containing a number of FaxMerge commands, which must be in a printer font (for example Zetafax Roman 10cpi). In order to see the Zetafax printer fonts you must first set the current printer to the Zetafax FaxMerge printer driver. Printer fonts can be identified by the symbol next to the font name.

When creating, editing or printing a document containing FaxMerge commands you should make sure that the Zetafax FaxMerge printer has been set as the current one. All FaxMerge commands must appear in a Zetafax printer font.

There are several example files in the zfax\SYSTEM\Z-COVER directory in WRITE format, though you can use any Windows word processor. An example file might be:

Date:

%%[DATE]

To:

%%[NAME]

Company:

%%[ORGANISATION]

From:

%%[FROM]

Pages:

%%[PAGES] (including this)

%%[NOTE]

%%[NOTE]

%%[NOTE]

%%[NOTE]

%%[NOTE]

%%[NOTE]

%%[NOTE]

%%[NOTE]

%%[NOTE]

%%[NOTE]

Each %%[NOTE] field gets replaced with the next line of the coversheet note field from the addressing dialog box, which is word-wrapped automatically by Zetafax. You should ensure that there are at least 10 of these fields on the coversheet.

The steps to create a new coversheet foreground are as follows:

  1. Create the document in your word processor. You should remember that a printer font is specific to a particular printer driver (not like true type fonts which are resident throughout your system) so will need to select the Zetafax FaxMerge printer to choose these. The document can also contain any other text or graphics, as required.
  2. Print your document to the Zetafax FaxMerge printer. When the addressing dialog box is displayed click on the SAVE AS button. Note that you will not be able to view the file at this stage, as it is not in a graphics format.
  3. Select the COVERSHEET, LETTERHEAD OR ATTACHMENT option and click OK . This will display the "Save as system file" dialog, where you should select COVERSHEET FOREGROUND. The option will be disabled if the wrong Zetafax printer driver was used.
  4. Enter a file name without any extension (e.g. COVSHEET to overwrite the default file), and a short description to help users. Click OK and the coversheet will be created.

A number of other FaxMerge commands are available for including in the foreground file.

Command

Description

%%[Append:file]

Appends a TIFF format graphics file. Do not include the extension.

%%[CoverText]

Text entered in the NOTE field of the addressing window.

%%[Date]

Today's date.

%%[From]

Full name of the sending user.

%%[FromEmail]

E‑ mail address of the sending user.

%%[FromFax]

Fax number of the sending user.

%%[FromTelephone]

Telephone number of the sending user.

%%[FromOther]

Other details of the sending user.

%%[Insert:file]

Inserts a TIFF format graphics file at this point. Do not include the extension.

%%[Note]

Same as CoverText.

%%[Pages]

Number of pages, including the coversheet (may only be used on the coversheet).

%%[Time]

The time in the format hh:mm using the twenty-four hour clock.

%%[> file]

Same as Append.

%%[< file]

Same as Insert.

In addition, the following FaxMerge address book commands can be used, and they correspond to the fields in the address book editor:

%%[Name]

%%[Department]

%%[PostcodeZip]

%%[Title]

%%[Organization]

%%[Country]

%%[FirstNames]

%%[Address1]

%%[Telephone]

%%[FamilyName]

%%[Address2]

%%[Fax]

%%[DearName]

%%[Address3]

%%[Synonyms]

%%[Address4]

%%[Position]

%%[Address5]

Background file

The coversheet background file is similar to a letterhead. It is a TIFF FAX format graphics file, and contains the fixed part of the coversheet, like the logo and address of the sender. If you already have the coversheet available in a word processor or other application program, this will generally give the best result.

Note: The foreground must be created before the background.

  1. Select the Zetafax FaxMerge printer driver.
  2. With the server and workstation running, print the document using the Zetafax printer driver. After a short time the Zetafax Addressing window will appear. Click the SAVE AS button to display the "Save file as" dialog box.
  3. Select the "Save image file" option and click OK. This will display the "Save as" dialog, give it a name and click OK to accept the default file type (*.epn).
  4. Select the file created in 4 from the Zetafax filed window, then choose File | Forward and select the Zetafax user you are currently logged in as, and click OK. After a while a new message will appear in the IN window - this has now been converted to a fax graphics format file (.G3F)
  5. Highlight this newly received message and choose File | Save as system file.. which will launch the "Save as system file" dialog, where you should select "Coversheet background".
  6. Enter a file name without any extension or select a coversheet from the list (e.g. "COVSHEET" to overwrite the default file), and a short description to help users. Click OK and provided a foreground file is already present, the coversheet background will be replaced.

If you do not have a word processor version of your coversheet, you can still create a new Zetafax coversheet simply by sending from another fax machine (effectively using the other fax machine as a scanner).

References

For additional information on Zetafax in an application server environment, please see the following Zetafax technical notes:

ZTN1020-INFO Zetafax printer not supported on an application server.

ZTN1024-HOWTO Configuring Zetafax (pre 6.01) with Citrix WinFrame.

ZTN1041-HOWTO Configuring Zetafax (pre 6.01) with MS Terminal server.

ZTN1053-HOWTO Configuring Zetafax 6.01 on an application server.

ZTN1002-HOWTO Creating letterheads and attachments with application servers.

Last updated: 14 January 2000 (GC/GW)

EquisysLogo

Recent news

This article describes the new features and other improvements in the August 2019 release of the Zetadocs Expenses service. Zetadocs Expenses ...

This article describes the new features and other improvements in the latest release of Zetafax. This improves support for using Fax over IP (FoIP) with SIP trunks and public SIP fax services, ...