Technical Notes, Zetafax

HOWTO: Installing Zetafax Outlook forms and extensions

ZTN1113

ID: ZTN1113

This Zetafax technical note applies to:

Summary

Users wishing to send faxes from their Microsoft Outlook client software have the ability to use similar features to those available within in the Zetafax client.  The 'Compose Fax' form and integrated viewer allow the sending and viewing of faxes directly from within Outlook.  For Exchange 5.5 only, the Zetafax Outbox folder also allows one to monitor the status of faxes submitted to the Zetafax server.  This is not a feature of Exchange 2000 or 2003.  Users are also able to specify various sending options, such as the choice of coversheet or letterhead to be included in their fax. Please follow the appropriate instructions for your Exchange environment.

Exchange 2000 and 2003:

To provide these functions within Outlook using Exchange 2000/3, the following three steps need to be performed.

  1. Create an Organizational Forms folder for Microsoft Exchange
  2. Install the Zetafax forms
  3. Install the Zetafax Outlook extensions for each user

Creating an Organisational Forms Folder

From within the Microsoft Exchange System Manager (ESM):

  1. Expand the 'Organisation' object.
  2. Expand your 'Administrative Group'.
  3. Expand 'Folders'.
  4. Right-click 'Public Folders'.
  5. Click 'on View System Folders'.
  6. In the list of folders present in the right-hand pane, click the 'EFORMS Registry' folder.
  7. Right-click the EFORMS Registry folder, then click New.
  8. Click 'Organizational Form'.
  9. Enter a name for your Organizational Form, set the language, and then click OK.

  1. Click on the 'Permissions' tab.

 

  1. Add the mailbox you are using to the user list, and give yourself the 'Owner' role from the permissions section.  Default should be set to 'Reviewer' and Anonymous set to 'None'

The next step of the installation process is to install the forms into this Organisational Forms Library and then Zetafax Outlook Extensions on each client PC that wishes to send faxes from Microsoft Outlook.  This is a two step process.

  1. Install the Zetafax forms. It is necessary to install the forms only once to the Organizational Forms library you created in the previous step.
  2. Once the Zetafax Outlook Extensions have then been installed onto the client machines, the forms will be installed automatically on those machines.

Installing the Outlook Forms

On a client PC, copy the Zetafax.pst file from \Zetafax\Zfforms on the Zetafax product CD to a local folder on the PC.

Start up Microsoft Outlook logging on as the user which has 'Owner' permissions on the Organizational Forms folder as above.

In Outlook go to 'File, Open, Outlook Data File.' browse to the zetafax.pst and then click OK.

In the Outlook folder list select the Zetafax folder you have just added and browse to the forms folder.

Open the 'Install the Forms' message. Click the 'Install Forms' button at the bottom of this message. This may take a few seconds. The Zetafax forms will now be installed in the Organizational Forms folder created earlier.

Note: If the install fails, please verify that the user is logged into Outlook using the mail profile previously given 'Owner' permissions to the 'Organizational Forms' folder and try again.

Installing the Zetafax Outlook Extensions

This section describes the process to install the Zetafax Outlook Extensions on a client by client basis.

Note: The extensions may not install correctly if Outlook is running.

How to install the Outlook Extensions

Copy the Zetafax Outlook Extensions install folder from the Product CD to a network share. For Exchange 5.5 this will be \zetafax\ZfOutExt and for Exchange 2000 or later this will be \zetafax\ZfExtE2k.

Close Outlook and then install the Zetafax Outlook Extensions (run setup.exe).

This has to be done on all users PCs. Windows 2000 Active Directory sites can use group policy to install the outlook extensions on client PC's. Click here for instructions on how to do this. ZTN1337

(Note: users will need it have local administrator rights to install the extensions and they need to be installed under the users profile).

The next time you run Microsoft Outlook, the Zetafax Outlook Extensions will be installed.

Checking the installation

The following points will help to verify the installation on the Zetafax extensions on the Outlook client.

Clicking the 'New Fax' button on the toolbar will launch the 'Compose Fax' form which looks like this.

You may access the 'Zetafax options' tab from 'Options' on the 'Tool' menu and set suitable default settings for each time you send a fax.

 

Exchange 5.5

Downloads:

Exchange 5.5 Connector

The connector is installed on the Exchange server and is responsible for passing messages to and from the Zetafax server to Outlook.

Zetafax Outlook Forms for Exchange

The forms are operating system specific and enable you to view received faxes. If you are in a mixed environment, please ensure you save each download to a separate location.

Zetafax Outlook Extensions

The extensions are operating system specific and help you address faxes from Outlook. If you are in a mixed environment, please ensure you save each download to a separate location.

To provide these functions within Outlook for Exchange 5.5, the following three steps need to be performed.

  1. Create an Organizational Forms folder for Microsoft Exchange 5.5
  2. Install the Zetafax forms.
  3. Install the Zetafax Outlook extensions for each user

Creating an Organizational Forms Folder

  1. Open the Microsoft Exchange Administrator Program (ADMIN.EXE).
  2. Select 'Forms Administrator' from the 'Tools' menu.
  3. From the 'Organizational Forms Library Administrator' window click the 'New' button to create a new forms folder called 'Organizational Forms'.  If this folder already exists, skip this step.
  4. With the 'Organizational Forms' selected, click the 'Permissions' button.

  1. Once inside the 'Forms Library Permissions' window ensure that the name of the Exchange mailbox (Outlook profile) being used to install the forms has a role of 'Owner'.  To do this, click 'Add' and select the name of the Exchange mailbox from the user list, and then choose 'Owner' role from the drop down list of pre-configured roles.

Note: If the mailbox being used to install the Zetafax forms does not possess 'Owner' permissions, the forms will not install into the 'Organizational Forms' folder.

Installing the Outlook Forms

During the installation of the Zetafax connector on the Exchange server, a directory called Zetafax Outlook Extensions is created in \Program Files.  It will be necessary for the person installing the Zetafax forms on the Exchange site to have access to this directory and to be logged into Outlook using the Outlook profile previously assigned 'Owner' permission of the 'Organizational Forms' folder.  If the forms are not being installed from the Outlook client on the Exchange server, the \Program Files\Zetafax Outlook Extensions directory will have to be shared so that it is accessible from another computer on the network.  Once access to the \Program Files\Zetafax Outlook Extensions directory has be confirmed, the following steps will need to be performed to install the 'Zetafax personal folder'.

You may skip the next 2 steps if you chose to add the 'Zetafax personal folder' to the Outlook client on the Exchange server during the connector installation.

  1. From within Outlook choose 'Open' from the 'File' menu and select 'Personal Folders File (.pst)'.
  2. From the 'Open Personal Folders' window Browse to the ZETAFAX.PST file and select 'OK'.

Now that the Zetafax personal folder has been added to Outlook, the forms and extensions may be installed:

  1. Open the 'Zetafax personal folders' and select the 'Forms' subfolder.
  2. Double click the 'Install the forms' message making sure that it is maximized.

  3. Click on the 'Install Forms' button found at the bottom of the message.
  4. The Zetafax forms will now be installed in the Organizational Forms folder created earlier.

Note: If the install fails, please verify that the user is logged into Outlook using the mail profile previously given 'Owner' permissions to the 'Organizational Forms' folder and try again.

Installing the Zetafax Outlook Extensions

The final step of the installation process is to install the Zetafax Outlook Extensions on each client PC that wishes to send faxes from Microsoft Outlook.  At this point the network administrator has two options for installing the extensions on each machine:

  • Option 1: E-mail the Outlook Extensions to each user so that they can install the extensions themselves.

Note: If the user is running Windows NT 4.0 Workstation or Windows 2000 Professional, they will need local administration rights to install the extensions.

  • Option 2: Visit each user's PC and install the Outlook Extensions.

The Zetafax Outlook Extensions are provided in a single self-extracting executable file called ZFOUTEXT.EXE.  This file can be found in either the 'Welcome to Zetafax Outlook Extensions' message within the 'Forms' subfolder of the 'Zetafax personal folders' or in the \Program Files\Zetafax Outlook Extensions\ZFOUTEXT.EXE on the Microsoft Exchange server.  To install the Zetafax Outlook Extensions follow either option below:

Option 1
  1. Select the message titled 'Welcome to Zetafax Outlook Extensions'.
  2. Forward the e-mail message to each user who is enabled to use the e-mail gateway.
  3. Have each user follow the instructions contained within the e-mail message.
Option 2
  1. Log on to the users PC as the Administrator if the users account does not have local administration rights.
  2. Close Outlook by using the 'Exit and Log Off' option from the 'File' menu.

Note: The extensions will not install correctly if the Outlook client is running.

  1. Double-click ZFOUTEXT.EXE from the share on the Exchange server to run the setup program.
  2. Follow the on screen instructions to complete the installation. The next time Outlook is opened the Zetafax extensions will be installed.

Checking the installation

The following points will help to verify the installation on the Zetafax extensions on the Outlook client.

  1.   The 'Zetafax toolbar' will be available from within the Microsoft Outlook 2000 main window.

Note: The Zetafax toolbar is not supported on previous versions of Microsoft Outlook.

  1. Clicking the 'New Fax' button on the toolbar will launch the 'Compose Fax' form.

  1. You may access the 'Zetafax options' tab from 'Options' on the 'Tool' menu and set suitable default settings for each time you send a fax.

References

ZTN1337-HOWTO: Install the Zetafax Outlook extensions using Group Policy

Last updated: 17 April 2007 (ZM/ )

Date Published 17 July 2002 (LD/GC)