Technical Notes, Zetafax

HOWTO: Configure Zetafax Custom Actions

ZTN1852

ID: ZTN1852

This Zetafax technical note applies to:

  • Zetafax v2011

Summary

Zetafax 2011 includes the ability to configure up to nine Custom Actions in the Zetafax Client. These actions are listed on a dedicated Custom button which is added to the Message ribbon tab in the Zetafax Client.

More Information

Custom Actions are designed for users who need to perform additional processing on a received fax, for example, passing the fax to an electronic records management system for processing or storage.

The custom actions are specified independently for each user on each computer, allowing actions to be tailored for individual user roles, or for situations where the required application is not stored in the same location on each client computer.

Configuring a Custom Action

  • Locate the ZFCLIENT.ini file this is usually located at: C:\Users\\AppData\Roaming\Equisys\Zetafax Client
  • Open the file using a text editor such a Notepad.
  • At the bottom of the file, below the Help location entry, paste the code below for each Custom Action you wish to create.
    • Tool1: Description, "Full program path" "Command line parameters"
  • This consists of four properties:
    • Tool Number, Identifies the order of the Custom Actions 1-9
    • Description, Text which is displayed in the button drop down list in the Zetafax Client
    • Full program path, Full path of the program to be launched when the action is selected
    • Command line parameters, parameters to be supplied to the application, which can include the full pathname of the fax image file
  • For example should we wish to setup a Custom Action to open a selected item from the Zetafax client using Notepad we would adjust the code to:  
    • Tool1: Open as text with Notepad, "c:\windows\notepad.exe" "%file%"
  • Where %file% identifies the file currently selected in the Zetafax Client.
  • Likewise if you wish to add another Custom Action to open the item using a Photo Editor you could adjust the code to:
    • Tool2: Open with Photo Editor, "C:\Program Files\Common Files\Microsoft Shared\PhotoEd\Photoed.exe" "%file%"
  • Save the file when finished and restart the Zetafax Client, the new Custom Actions will then appear in the Custom drop down option on the Message ribbon tab.

Last updated: 18/05/2011 (MW)

Keywords: Zetafax Client, Custom Actions