ZipOut Administrative Settings Tool

Download and Installation
How Administrative Settings Work
Special Settings
Using the Tool
Deploying Admin Settings
List of Administrative Registry Values

Every aspect of ZipOut's function and user interface can be administratively controlled through registry values in the HKEY_LOCAL_MACHINE hive. The ZipOut Administrative Settings Tool shown below allows an administrator to easily create or modify a .reg file with the exact settings desired. The finished .reg file can be used to modify a ZipOut installation through a command-line parameter, or it can be incorporated into a transform file of the ZipOut Installer package.

Download and Installation
  1. Visit the ZipOut Administrative Settings Tool Download page.
  2. Click the download link to copy the Setup package to your computer.
  3. Double-click ZipOutAdminTool.exe to install the ZipOut Administrative Settings Tool.

Back to top

How Administrative Settings Work

By default ZipOut gives the end user very granular control of its configuration. The user can decide whether to show or hide the ZipOut buttons on each type of Outlook item, what  compression level to use, whether or not to block potentially harmful attachments, what file types to block or to compress, etc. These choices and others are stored in the registry under HKEY_CURRENT_USER\Software\Microsoft\Office\Outlook\Addins\MicroEyeZipOut.Connect. ZipOut also reads the corresponding HKEY_LOCAL_MACHINE key for values which are treated as Administrative Settings. An Admin Setting will override any user configured option and can not be changed through the ZipOut user interface. So, for example, if the Admin Setting for Always reset to ZipOut On has the value of 1 (True), then when the user opens the Micro Eye ZipOut property page the Always reset to ZipOut On checkbox will be checked and disabled. If the Admin Setting has a 0 (False) value then this option will be unchecked but still disabled. If there is no Admin Setting for a particular property (i.e. no value in HKLM) then the option will be enabled on the property page or toolbar and the user will be able to change the configuration at will.

ZipOut normally allows the user to turn attachment compression on or off on a message-by-message basis. This is controlled by the ZipOut On/Off button on the toolbar. The administrator can use an Admin Setting to lock ZipOut in the "On" state and ensure that attachments are always compressed. When this setting is applied the ZipOut On/Off button will not appear on the toolbar at all, to reduce confusion for the end user and free up some toolbar real estate. Likewise if the option to create Combined or Separate zip files is set administratively the corresponding toolbar button will not be displayed.

Back to top

Special Settings

ZipOut has special Admin Settings beyond those which are available to the end user. Some hide specific parts of the standard user interface. The NoPage value, for example, can be used to hide the ZipOut property page. Settings such as SkipPFCheck control aspects of ZipOut's behavior that cannot be set through the UI: when attachment blocking is enabled ZipOut will attempt to use Outlook's Level 1 Attachment list to identify files which are potentially damaging. If Outlook is configured to read its list of blocked files from the default form in the Outlook Security Settings or Outlook 10 Security Settings public folder then ZipOut will try to retrieve that list from the form when ZipOut loads. On some networks this call may create an unacceptable lag during Outlook startup. The administrator can set SkipPFCheck =1 to prevent ZipOut from trying to access the public folder.

Back to top

Using the Tool

The ZipOut Administrative Settings Tool can be used to create a new Admin Settings .reg file or modify an existing one. When the tool loads it will ask if you want to load an existing file.

The tree view lists the individual items that can be included in the Admin Settings file, along with headings such as "Item Types" that are only used for grouping and do not map to a specific registry value. To include a particular item select it in the tree and then check the Admin lock down box. Once you check an item type such Mail Items or a setting like Compression Level you will be able to choose the specific value for that setting, corresponding to a user selection on the ZipOut property page.

If an item or any of its children have been checked it will appear bold in the tree to make it easy to identify. Bear in mind that any setting which is normally configurable through the user interface will be locked and disabled when Admin lock down is checked.

Once you have selected and configured those settings that you want to control administratively click Save to write your selections to a .reg file. You can modify your choices later by launching the Admin Settings tool and browsing to this file.

Back to top

Deploying Admin Settings

There are a number of different ways to use an Admin Settings .reg file in a ZipOut deployment. You can supply the path to the file as a command-line argument, import it into an Office Custom Installation Wizard transform, or add it to your own transform if you have a tool for creating and modifying Windows Installer packages.

Command line install To deploy Admin Settings in a command-line install add an argument for the ADMINREG property with the full UNC path to the .reg file that you created:
    msiexec /i \\UNC Path\ZipOut.msi /q [PIDKEY="license code"] [ADMINREG="\\UNC Path\AdminSettings.reg"]
The ADMINREG argument can be combined with arguments for other properties such as PIDKEY and any Installer switches that you choose to include.

Chained Install If you include ZipOut within a Microsoft Office deployment as a chained install you can set ZipOut's Admin Settings at the same time. Include  ADMINREG="\\UNC Path\AdminSettings.reg" in the Cmdline= option of Setup.ini.

Installer Transform You can use a tool for working with Installer packages to create a transform that modifies the ZipOut MSI. This tool may allow you to directly import a .reg file, or you may need to merge your Admin Settings file into the registry on a build machine and then import the values from the MicroEyeZipOut.Connect key under HKLM. The transform that you create can be included in a command line installation of ZipOut using the TRANSFORMS="\\UNC path\your transform.mst" argument. If you use an Active Directory Group Policy object to deploy ZipOut then your transform should be used to modify the base installation. When creating a new package for ZipOut under Software Installation you must select "Advanced published or assigned" as the deployment method. Then add the Admin Settings transform that you created on the Modifications tab of the package property pages.

Back to top

List of Administrative Registry Values
Key Name Type Possible Values Explanation
MailItems DWORD 0 or 1 Value determines whether attachments to items of this type will be compressed if ZipOut is On. ZipOut toolbar buttons will not appear on the item if value=0.
PostItems DWORD 0 or 1 Value determines whether attachments to items of this type will be compressed if ZipOut is On. ZipOut toolbar buttons will not appear on the item if value=0.
ApptItems DWORD 0 or 1 Value determines whether attachments to items of this type will be compressed if ZipOut is On. ZipOut toolbar buttons will not appear on the item if value=0.
ContactItems DWORD 0 or 1 Value determines whether attachments to items of this type will be compressed if ZipOut is On. ZipOut toolbar buttons will not appear on the item if value=0.
DistListItems DWORD 0 or 1 Value determines whether attachments to items of this type will be compressed if ZipOut is On. ZipOut toolbar buttons will not appear on the item if value=0.
JournalItems DWORD 0 or 1 Value determines whether attachments to items of this type will be compressed if ZipOut is On. ZipOut toolbar buttons will not appear on the item if value=0.
TaskItems DWORD 0 or 1 Value determines whether attachments to items of this type will be compressed if ZipOut is On. ZipOut toolbar buttons will not appear on the item if value=0.
CustomItems DWORD 0 or 1 Value determines whether custom items will inherit the setting of the parent type (listed above). ZipOut toolbar buttons will not appear on any custom items if value=0.
Level String -ex, -en ,-ef, -es Sets compression level of Maximum, Normal, Fast or Superspeed.
AlwaysReset DWORD 0 or 1 When value=1 then OnOffState will always be reset to On if user toggles value to Off for a particular item.
DefaultState DWORD 0, 1 or 2 Outlook 2007 only: determines the default compression setting when opening an item. Values can be 0 (No Compression), 1 (Combine attachments) or 2 (Separate attachments). This setting will be overridden if a conflicting value has been administratively set for OnOffState or Combine.
BlockOn DWORD 0 or 1 Turn attachment blocking on (1) or off (0).
SkipPFCheck DWORD 1 When SkipPFCheck=1 ZipOut will not attempt to retrieve Level 1 Attachment list of harmful file types from Outlook Security Settings public folder.
Warn DWORD 0 or 1 If Warn=1then ZipOut will display a warning when the user opens an item with one or more files from the Block Attachments list.
Check DWORD 0 or 1 When Check=1 ZipOut will add a warning text file and comment to zip archives if there are included files that are listed in Block Attachments.
Tray DWORD 0 or 1 Value determines whether ZipOut icon is displayed in system tray.
AutoUpdate DWORD 0 or 1 If AutoUpdate=1 then ZipOut will check the Micro Eye web site every 30 days and alert the user if there is an update available.
EnableUTF8 DWORD 0 or 1 Value determines whether UTF-8 encoding is enabled.
Exclude String colon-delimited list of file extensions This value contains a list of file types that will not be compressed when the user sends or saves items. The user will be able to add extensions from the property page, but will not be able to delete any that appear in this list.
ZipBytes DWORD 1 to 99999999 (decimal) Sets a threshold (in bytes) for attachment compression on outgoing messages. Files that are smaller than this value will not be zipped.
CombineName String any valid filename, minus extension Sets the default name for the single compressed archive that is created when Combine is selected. Unlike other Admin Settings, this is only a suggested value. The user will be able to change the default value on the Send Settings... property page dialog or, if ZipOut Options has not been disabled, on each individual message.
ExcludeCompress String colon-delimited list of file extensions This value contains a list of file types that will not be compressed during the Manage Attachments procedure. The user will be able to add extensions from the property page, but will not be able to delete any that appear in this list.
ZipBytesCompress DWORD 1 to 99999999 (decimal) Sets a threshold (in bytes) for attachment compression during Manage Attachments. Files that are smaller than this value will not be zipped.
Block String colon-delimited list of file extensions This value contains a list of potentially harmful file types that will be blocked and/or warned about. The user will be able to add extensions from the property page, but will not be able to delete any that appear in this list.
NoMessage DWORD 1 Set NoMessage=1 to stop ZipOut from placing an alert message in the user's Inbox listing files that have been deleted from a message due to attachment blocking.
NoDefaultComments DWORD 1 Set NoDefaultComments=1 to suppress addition of  the default "Created by Micro Eye ZipOut..." comment to each new zip file.
NoPromptSchedule DWORD 1 The first time ZipOut runs it normally prompts the user to create a task to Manage or Index attachments. Set NoPromptSchedule=1 to suppress this prompt.
NoUI DWORD 1 Set NoUI=1 to hide all ZipOut command bar buttons and toolbars. This setting does not affect display of the property page or system tray icon.
OnOffState DWORD 0 or 1 Set OnOffState=1 to always set to ZipOut to On or OnOffState=0 to permanently set ZipOut to Off. Setting either value will also hide the ZipOut On/Off command bar button for Outlook 2000, 2002 or 2003. For Outlook 2007 setting this value to 1 will remove the No Compression button from the Ribbon and eliminate that option from Default State drop down. Setting OnOffState = 0 will disable all three buttons on the Ribbon as well as the Default State drop down on the property page.
Combine DWORD 0 or 1 Set Combine=1 to always roll attachments into a single compressed file or Combine=0 to always compress into separate files.  Setting either value will also hide the ZipOut Combine/Separate command bar button for Outlook 2000, 2002 and 2003. For Outlook 2007 setting this value administratively will remove the alternative option from the Ribbon and the Default State drop down.
NoOptions DWORD 1 When NoOptions=1 the ZipOut Options command bar button will be hidden.
NoIndex DWORD 1 Set NoIndex=1 to hide the Index Attachments... command on the ZipOut Tools and Tray menus.
NoManageAttachments DWORD 1 Set NoManageAttachments=1 to hide the Manage Attachments... command on the ZipOut Tools and Tray menus.
NoSchedule DWORD 1 Set NoSchedule=1 to hide the Scheduled Tasks... command on the ZipOut Tools and Tray menus.
NoUpdate DWORD 1 Set NoUpdate=1 to hide the Check for ZipOut Updates option on the ZipOut Tools and Tray menus.
NoPage DWORD 1 NoPage=1 will hide the Micro Eye ZipOut property page
NoFindAttach DWORD 1 Hides the Find Attachment option on both menus when the value is set to 1.
NoAdvancedFind DWORD 1 Set NoAdvancedFind=1 to remove the Advanced Find option from the ZipOut Tools and Tray menus. This setting does not affect the native Outlook display of this command.
NoIndexInfo DWORD 1 Use this setting to hide the Index Information option.
NoCompressResults DWORD 1 Set NoCompressResults=1 to remove the Chart of Compression Results option.
NoCompressLog DWORD 1 Removes Log of Last Compression from the ZipOut Tools and Tray menus.
NoTechSupport DWORD 1 If NoTechSupport=1 then the Request Technical Support option will not be available.
NoHelp DWORD 1 Set this value to remove the link to ZipOut Help from the Tools and Tray menus. An option labeled 'Micro Eye ZipOut Help' will still be available on the Help menu of Outlook Inspectors. 
NoCommandBar DWORD 1 Use this option to prevent display of the ZipOut command bar. This setting does not affect the Tray icon popup menu. Note that eliminating every option on the menu through individual administrative settings will prevent display of the command bar and Tray popup, even if the Tray and NoCommandBar values have not been set.
NoLicenseDisplay DWORD 1 Use this setting to prevent display of the license code on the ZipOut property page and in the subject of any technical support request message.

Back to top