Utility ~ Property Box Tab Organiser

Description

Family Historian V4 introduced the powerful Customize Property Box facility to change the Main tab fields and add Custom tabs to every type of Property Box.
Family Historian V5 offers Custom Tab Import/Export using a new .fhpbt file format supported by the Property Box Tab Organiser.
All FHUG Downloads ~ Property Box Tab Definitions will use this new .fhpbt file format.

The Property Box Tab Organiser utility supplements the fh V4 facilities with the following organisational capabilities:

  • Change the Order of your custom tabs in fh V4
  • Change the Name of any custom tab in fh V4 Property Box Tab Organiser
  • Backup and Restore all the fh Property Box tab definitions
  • Import or Export from or to any FHUG Downloads ~ Property Box Tab Definitions
  • Load or Save any merged set of tab definitions from or to fh V4
  • View the internal code of any tab definition
  • Export V5 Tab in .fhpbt fh V5 tab definition file format

This utility is only required for fh V4 since all later versions of fh have similar features built into the Property Box Menu > Customize Data Entry dialogue.

Installation Instructions

Click on the link below to download and save the Property Box Tab Organiser.zip file, then right-click this Compressed (zippped) Folder file, and choose Extract All to unpack its contents:

  • Property Box Tab Organiser.exe (Application)
  • Property Box Tab Organiser.lnk (Shortcut)

These files may be placed in any folder and no Administrator privileges are needed.

If on running the Property Box Tab Organiser.exe Application it produces an Open File - Security Warning window due to an Unknown Publisher, then right-click the Application file, choose Properties and click the Unblock button followed by the OK button.

Some anti-virus utilities report that a threat exists in the Compressed (zippped) Folder file or the Property Box Tab Organiser.exe Application file, but these are false positives. The website VirusTotal shows only 4 of 42 virus scanners reporting a threat, and they each report a different threat as listed below. The Property Box Tab Organiser is built using AutoHotkey, which has a history of virus false positives, as indicated by a Google search for AutoHotkey Virus. The AutoHotkey community has been trying to improve matters for years with an Open Letter to anti-viral companies.

Virus Scanner Threat
Ikarus Trojan.SuspectCRC
Jiangmin Worm/AutoRun.xxx
McAfee-GW-Edition Heuristic.BehavesLike.Win32.Spyware.J
VBA32 Worm.AutoRun.brzs

Download

Property Box Tab Organiser V1.4 for fh V4 and supporting migration to & from fh V5.

Configuration Guide

There are two modes of configuration.
The first uses the folder where the application file is located as its working folder, and assumes Family Historian is installed in its default folder.
The second allows command line parameters to define the working folder, and the Family Historian installation folder.
Click the Help Text button for help and advice.

Default Working Folder Mode

Place the Property Box Tab Organiser.exe Application file in any folder where you wish to manage Property Box custom tab definition files.
e.g. My Documents\Family Historian Projects\{Projectname}\Public\Property Box

Double-click the Application (.exe) file to run it, and this folder becomes the default working folder for all the Backup & Restore, Import & Export, and Save backup functions.

The Property Box Tab Organiser.exe Application may be copied to as many such folders as you like.

The program assumes Family Historian is installed in C:\Program Files\Family Historian, or on 64-bit PC C:\Program Files (x86)\Family Historian

With this method the Shortcut file is superfluous.

Command Line Parameter Mode

Place the Property Box Tab Organiser.exe Application file in a master folder such as C:\Program Files\.

Copy the Property Box Tab Organiser.lnk Shortcut file to your Desktop, Start Menu, etc.

Right-click on this Shortcut file, choose Properties from the menu, and then select the Shortcut tab.

The Target box should contain "quoted strings" each separated by a space character:

  1. The full path of the Application file e.g.
    • "C:\Program Files\Property Box Tab Organiser.exe"
  2. The full path of the working folder e.g.
    • "C:\Users\{Username}\Documents\Family Historian Projects\{Projectname}\Public\Property Box" on Windows 7/Vista
    • "C:\Documents and Settings\{Username}\{Username}'s Documents\Family Historian Projects\{Projectname}\Public\Property Box" on Windows XP
  3. Optionally, the full path of the Family Historian program installation folder e.g. "/P=F:\Genealogy\FamilyHistorian"

Trailing \ characters must not be included in the path specifications. The contents of the Start in box is irrelevant.

If the grey triple tab icon is missing from the Shortcut, then click Change Icon, Browse to and Open the Property Box Tab Organiser.exe file, and select the grey triple tab icon.

Click OK as necessary to save the changes. The filename of the Shortcut may be changed as required.

Double-click the Shortcut to launch the utility with the working folder specified as above. There may be as many such Shortcut files as you like.

Similarly, the utility may be launched via the Start Menu Run option, or the Command Prompt option, or using a .bat file, with the "quoted strings" as above:
e.g.
Run Open: "C:\Program Files\Property Box Tab Organiser.exe" "C:\Users\{Username}\Documents\Family Historian Projects\{Projectname}\Public\Property Box" "/P=F:\Genealogy\FamilyHistorian"

Error Codes

Each program Error number and Message is listed below with Advice about the problem.

Error Message Advice
10 Command line parameter working folder does not exist:
{command-line-working-folder}
The working folder has reverted to the default folder:
{default-working-folder}
Ensure the command line parameter working folder actually exists.
20 ….\Calico Pie\Family Historian\Property Box\ folder does not exist.
This utility only works with Family Historian V4.1 or later.
Ensure that Family Historian V4 or later is installed correctly.
30 Family Historian Installation Tab Definition File Missing:
{FH-installation-folder-tab-definition-file}
Use ""/P={alternate-FH-installation-folder}"" command line parameter.
35 Family Historian {property-box-name} Tab Definition File Missing:
{FH-program-data-folder-tab-definition-file}
Ensure that Family Historian program data folder is not corrupt.
40 Backup File Copy Error and 'Put Custom Tabs List' not Saved to FH. 'Save FH Tabs' cannot create dated & timed backup file in working folder.
45 Backup File Copy Error - Backup FH Aborted. 'Backup FH' cannot create tab definition backup files in working folder.
50 PB-{name}-Backup.fhdata does not exist - Restore FH Aborted. 'Restore FH' cannot find named tab definition backup file in working folder.
55 PB-{name}-Backup.fhdata file copy error - Restore FH Aborted. 'Restore FH' cannot copy named tab definition to FH program data folder.
70 Attempt to delete existing output file failed:
{destination-folder-tab-definition-file}
'Put Custom Tabs List' not Saved / Exported.
'Save FH/Export Tabs' cannot delete existing file before writing new version.
75 Attempt to delete existing output file failed:
{destination-folder-tab-definition-file}
Selected 'Put Tab' not Exported.
'Export V5 Tab' cannot delete existing file before writing new version.

Version History

Version 1.4 (12 July 2011)

  • Added Export V5 Tab button, plus other updates for FH V5 Import/Export Tab .fhpbt files.

Version 1.3 (9 June 2011)

  1. Added the Error Code 10 to report if the command line parameter working folder is missing. See Command Line Parameter Mode above.
  2. Added the Error Codes and Version History pages to the Help Text window.
  3. Refined the Error Code numbers and messages.
  4. Updated & added tooltips for all buttons and boxes on all the windows.
  5. Corrected some cosmetic errors for a few buttons on the main window.

Version 1.2 (6 June 2011)

  • Bug fix to remove superfluous tab definition lines from the end of all Main tab definitions, with the exception of Individual Property Box tab definitions, which were always correct. Note that Family Historian correctly ignored these superfluous tab definition lines.

Version 1.1 (5 June 2011)

Version 1.0 (25 May 2011)

  • Original program release.