GSP/OFB - Utility Programs

To support the processing of GEDCOM-files by the GSP- and OFB programs following "GSP/OFB Utility Programs" have been created:

These programs are not part of the "OFB program package" and the "Gedcom Service Program package".

System requirements

Kopf
The programs require the installation of the software packages "OFB bundle" or "GSP". In addition, a valid license must exist on the PC.
The programs have been written using "Microsoft Visual Studio Express 2015".

Installation & Update

Kopf
The programs are without their own installation routine. The installation has to be done manually by the following steps:
  1. Load the respective exe file from the Download area onto your PC.
  2. Copy the exe-file into the program folder of the already installed OFB- resp. GSP-program package.
    After starting the Start Center a button to start the program should show up at the lower area.
  3. Optional create a shortcut of this exe-file onto the desktop or at any other place, e.g. start menu.

Update

An update to a new version has to be done similar to the installation, but without creating a new shortcut.

Program start

The program starts by the appropriate button of the start center, by clicking the shortcut or by calling the exe-file.

Licensing & Copyrights

Kopf
The same copyright and license conditions are valid for the "GSP/OFB - Utility Programs" as defined in the OFB User Guide - part 1 resp. GSP - User Guide - part 1.
These programs will only start with a GSP resp. OFB bundle license.

BatchRun - Sequential processing of Programs & Commands

Kopf
BatchRun

Functionality

The program allows a sequential processing of consecutive GSP- and OFB program runs. Further programs like browser or MS Word or Excel can be started in addition to process the resulting files of the GSP- or OFB program runs. Data-files may be copied, renamed or deleted. The program should support you when recurring sequences of program calls are required, e.g. after entering new data into the Genealogy program and their Gedcom export.

In many cases it is required to correct or modify the ged-files after their export by the Genealogy program before the OFB will create a one-place-study, a family book or anchestry report. When this sequence is required repeatedly, e.g. to consider new data, "BatchRun" will simplify this.

During the process a log-file will be created, to be opened by any text editor, containing:

Description

Kopf
The description is divided into the program sequence, the options, the buttons and their functions, the setup of the text-file and the log-file.

Program sequence

After starting the program above screen will show up.

Options

Option to suppress the execution of various line groups of the text-file: Further options:

Buttons

Text-file

The text-file (*.txt) has to be created by a text editor, e.g. "Notepad++". This file must contain line-by-line the programs and data-files. 3 formats are allowed. Following must be specified - optional elements in squared "[]" brackets: This file must have as file extension ".txt" and should be "UTF-8" coded and stored.
Example of a text-file with comments and program calls:
// Test-Batch for testing functionality of OFB, GSP and standard programs
// created by Diedrich Hesmer - 24.10.2016
"C:\Program Files\OFB\GedcomRedu.exe", "C:\Ofb\1\ages\bat\Reduzierung 1.grsd",/q
"C:\Program Files\OFB\GedcomConv.exe", "C:\Ofb\1\ages\bat\Note-records in text.gcsd",/q
"C:\Program Files\OFB\GedcomRenum.exe", "C:\Ofb\1\ages\bat\Loc-Repo-records.gnsd",/q
"C:\Program Files\OFB\GedcomLis.exe", "C:\Ofb\1\die_af\list\test-new1.glsd",/q
R"C:\Ofb\1\daten\my_data_red_u_num.ged", "my_data1.ged"
"C:\Program Files\OFB\OFB.exe", "C:\Ofb\1\ages\bat\detailliste.ofd",/q
"C:\Program Files\OFB\OFB.exe", "C:\Ofb\1\ages\bat\ancestors for print-dh.ofd",/q
-"C:\Program Files\Microsoft Office\Office14\WINWORD.EXE", "C:\Ofb\2\_aus\4\print\ofb4_w.html"
"C:\Ofb\2\_aus\1\_ofb1index.htm"
"C:\Ofb\stat\test_unehe.csv"
Description for the line numbers:
  1. Comment line
  2. Comment line
  3. The 1st program line starts the GSP Reducer. Because this is the first program call, the name of the original ged-file must be defined in the grsd-file, for example "my_data". To take advantage of "BatchRun", the name of the ged-file must always be the same at each export of the ged-file. The reducer now creates the file "my_data_red.ged".
  4. Starts the converter to reformat e.g. the NOTE records into embedded text. Because here the reduced ged-file should be processes, the name of the ged-file within the gcsd-file must be "my_data_red.ged". The result will be "my_data_red_u.ged" for an UTF-8 coding.
  5. Starts the GSP Renumber to get e.g. the record numbers of _LOC and REPO records numbered in ascending order to have continuous numbers and reshape cryptic texts. Because the reduced and converted ged-file should be processed, the gnsd-file must define the new name of the ged-file "my_data_red_u.ged".
  6. Starts then GSP List to e.g. extract specific data of one of the created ged-files and store them as html- resp. csv-file. The glsd-file must define the name of the required ged-file. No new ged-file will be created. Due to a typo he can't start - see log-file below.
  7. Now we are renaming the long cryptic name of the reduced, converted and renumbered ged-file from "my_data_red_u_num.ged" to get a shorter name for the OFB will not appear in the OFB, we call this here of "Datenbestand_red_u_num.ged" into "my_data1.ged". Don't use "my_data.ged" because this would it would overwrite the original file.
  8. Starts the OFB to create a Detail Liste (Type 1). Because the renamed ged-file should be processed, the ofd-file must use the new name "my_data1.ged".
  9. Starts the OFB to create a Ancestries List (Type 4). The same statement as before applies. In case all programs ran without any error, here a Proband screen will pop to select manually the proband.
  10. Starts WinWord with the specified file, which was optimized for Print/Word.
  11. Opens the Browser with the Detail Liste.
  12. Opens the csv-file with the standard program for csv, usually Excel or equivalent.

Log-file

Exemplary for above text-file and the options of the picture:
Created at  24.09.2016 15:55:46 - BatchRun version: 0.3.0
Base: "c:\ofb\1\ages\bat\testbatch.txt" from 24.09.2016 15:55:43

24.09.2016 15:55:46: Start checking
10 lines checked, 0 erroneous skipped

24.09.2016 15:55:48: Start processing
8 entries found for processing
24.09.2016 15:55:48: "C:\Program Files\OFB\GedcomRedu.exe", "C:\Ofb\1\ages\bat\Reduzierung 1.grsd",/q
24.09.2016 15:55:50: "C:\Program Files\OFB\GedcomConv.exe", "C:\Ofb\1\ages\bat\Note-Datensätze in Text.gcsd",/q
24.09.2016 15:55:53: "C:\Program Files\OFB\GedcomRenum.exe", "C:\Ofb\1\ages\bat\Loc-Repo-Datensätze.gnsd",/q
24.09.2016 15:55:55: "C:\Program Files\OFB\GedcomLis.exe", "C:\Ofb\1\die_af\list\test-new1.glsd",/q
  --> Error => Program-file "C:\Program Files\OFB\GedcomLis.exe" not found
  --> Error => Data-file ""C:\Ofb\1\die_af\list\test-new1.glsd",/q" not found
24.09.2016 15:55:56: R"C:\Ofb\1\daten\Datenbestand_red_u_num.ged", "C:\Ofb\1\daten\Datenbestand1.ged"
24.09.2016 15:55:56: "C:\Program Files\OFB\OFB.exe", "C:\Ofb\1\ages\bat\Detailliste.ofd",/q
24.09.2016 15:56:13: "C:\Program Files\OFB\OFB.exe", "C:\Ofb\1\ages\bat\Vorfahrenliste nach Namen für Druck-dh.ofd",/q
24.09.2016 15:56:26: "C:\Program Files\Microsoft Office\Office15\WINWORD.EXE", "C:\Ofb\2\_aus\4\print\ofb4_w.html"
  --> Error => Program-file "C:\Program Files\Microsoft Office\Office15\WINWORD.EXE" not found
24.09.2016 15:56:28: End processing
Due to the selected option "Suppresss all Type 2" the last 2 lines will be skipped and not added to the log-file.

Notes / Recommendations



GedTagSearch - Search of Gedcom Tag Combinations

Kopf
GedTagSuch

Functionality

This program scans ged-files according defined tag-text-patterns. INDI and/or FAM records will be scanned. Depending on the option, detail data such as the found names/families with or without the tags with their texts found, the line numbers and the number of findings will be listed. The scan can run up to 3 tag levels.

A log file is created during processing, which can be opened with any text editor.

Description

Kopf
The description is divided into the program sequence, the search criteria, the options, the buttons and their functions and the log-file.

Program sequence

After starting the program above screen will show up.
There are 3 tabs for definition of the selections, for listing of the findings and for "Program Description" with examples, which should be read and understood. They include more details as described here.
The line at the bottom is a message line.

Search criteria

These defines the scan for the required combinations of tag-text pattern:

Options

Options for processing and output are are almost self-explanatory. Tooltips and the tab "Program Description" will help you.

Buttons

Examples

They are found at tab "Program Description" > tab "Examples".

Extract of a Log-file

The file lists the ged files found for analysis and i.a. for each finding: Here the results of the definitions of above screen.
Created at 12.02.2017 18:52:32 - GedTagSearch version: 1.0.0

Files for analysis:
1: C:\Ofb\1\pgm_test\ofb-orig\ofb_dh.GED

1 Files found
12.02.2017 18:52:32 Start Scan
  Line-Nbr: Tag combination  -> Record-Id
*** File 1: "C:\Ofb\1\pgm_test\ofb-orig\ofb_dh.GED"  -> SOUR: diverse, CHAR: ANSI, INDI:  23, FAM: 10
        56: 1 ADOP + 2 AGE  -> @I1@  [Dagmar Erika /Wfrau/],  1 ADOP,  2 AGE 3 Yrs
       558: 1 * + 2 HUSB + 3 AGE *  -> @F1@,  1 ENGA,  2 HUSB,  3 AGE 23 y
     1 x  FAM: 1 * + 2 HUSB + 3 AGE *
     1 x  IND: 1 ADOP + 2 AGE

Total found in 1 file(s):
      1 x  FAM: 1 * + 2 HUSB + 3 AGE *
      1 x  IND: 1 ADOP + 2 AGE
      0 x  IND: 1 SEX U
Total records - INDI: 23, FAM: 10
12.02.2017 18:52:32 Analysis of files completed


PersonSearch - Search of Persons

top
BatchRun

Functionality

Program scans ged-files for persons with defined attributes (e.g. occupations) within specified places and/or at a certain date or date ranges. INDI or FAM records may be scanned. The names found will be listed including place and date, optional with year of birth and death. As speciality of the program date ranges can be considered during analysis. Therefor the program can give the answer a.o. "who was mayor in Boston on August 15th 1825".

A log file is created during processing, which can be opened with any text editor.

Description

Kopf
The description is divided into the program sequence, the search criteria, the options, the buttons and their functions, examples and the log-file.

Program sequence

After starting the program above screen will show up.
There are 2 tabs for definition of the selections and listing of the findings and for "Program Description" with examples, which should be read and understood. They include more details as described here.
The line at the bottom is a message line.

Search criteria

These defines the scan for the respective persons resp. families:

Options

Options for processing and output are almost self-explanatory. Tooltips and the tab "Program Description" will help you.

Buttons

Examples

Examples are listed at tab "Program Description" > tab "Examples".

Extract of a Log-file

The file lists for each finding: In addition not interpretable dates found will be listed with the persons name and Id to allow a correction.
04.02.2017 14:09:41 Start Scan
@Id@  [Name]  Search-Tag  D: Date  P: Place
@I11823@  [Johann /Eimer/ (-)]  OCCU Lehrer  D: 29 NOV 1828  P: Schallodenbach
@I17284@  [Johann /Grass/ (-)]  OCCU Lehrer  D: FROM 1801 TO 1823  P: Schallodenbach
2 Findings in 22526 INDI records

No checking due to not interpretable date values in line
339:  FROM 30 APR TO 1829: @I13@  [Conrad Friedrich /Abel/ (-)]
1 not interpretable dates found
04.02.2017 14:09:44 Analysis completed


GedShow - Show Records of the ged-file

Kopf
GedShow

Functionality

This program allows the display of records of the ged-file in separate permanent display screens.

The ged-file will be read and split into their data records. These records are stored separately. As required they can be displayed in separate screens, as described below. Multiple screens can be shown on the display next to each other for viewing and comparison. They can be moved on the display and the size can be changed as desired.

Alternatively to display a complete data record, the heads (1st line) of all data records can be displayed, in which a selected data record is used as a reference.

The data can only be viewed, but not modified and re-stored. No log file is created.

Description

Kopf
The description is divided into the program sequence, how the display works, the options, the buttons and their functions.

Program sequence

After starting the program above screen will show up.
GedShow1
GedShow2
GedShow_rec
GedShow_symb

How the display works

The record references "@Xnn@" of following tags can be listed (if required, more can be added):

Options

Options for output are almost explained above. Tooltips and the tab "Program Description" will help you.

Buttons

Beside the already above described buttons are available:

SourPerson - Search of Persons with defined Source data

Kopf
developmt
SourPers

Functionality

This program scans a ged file for persons with defined sources data and other criteria for the person selection and creates a html file of the persons found with the desired data. In a run, the sources of INDI and, optionally, FAM records can be scanned. Persons with at least 1 SOUR structure (data record or embedded data) matching all defined SOUR search criteria and which additionally meet all defined search criteria for the person selection will be listed. Records that do not contain all defined tags and criteria are ignored.

A log file is created during processing, which can be opened with any text editor.

Description

Top
The description is divided into the program sequence, the search criteria and output definitions, the buttons and their functions and the log-file and an repor examplet is shown.

Program sequence

After starting the program above screen will show up.
There are 4 tabs for definition of the selections and output of the findings and for "Explanations", which should be read and understood. They include more details as described here.
The line at the bottom is a message line.

Search criteria

These defines the scan for the sources and persons. You have to select/define:
Source selection
Selection of Persons
The setup of the screens for tion of Persons and Outpiut definition are shown on the right exemplary (to be enlarged by clicking into the figure).
A finding is given if a match with ALL defined criteria was found in the ged file. The details of the logic you'll find in tab "Explanations" > "Logic of Selection".

Output definition

Rules for the Output definition: Rules for Definition of Output data: The output list ""xxx_sope.html"" ("xxx" = ged filename) will be stored in the folder of the ged-file and may be viewed by any Browser.

Buttons

Extract of a Log-file

The file lists:
Created at 08.07.2017 16:11:43 - SourPerson version: 0.4.1
Base: "C:\Ofb\1\ftm\test\Testfamilie.GED" from 07.07.2017 19:15:25
08.07.2017 16:11:43 Start Scan
Lines read: 316
Records found: 17 INDI, 6 FAM, 7 NOTE, 2 SOUR, 1 REPO
Records selected: 2 INDI, 1 FAM, 3 NOTE, 1 SOUR, 0 REPO
Record Ids replaced by text
08.07.2017 16:11:43 Reading ged-file for output
2 INDI read for output
List with 2 entries in "c:\ofb\1\ftm\test\testfamilie_sope.html"
08.07.2017 16:11:43 Analysis completed

Report example

Bericht


 © 2016-2017, Diedrich Hesmer, Herrenberg (D), Saviese (CH)  -  last update
Kopf

All brand marks are trademarks or registered trademarks of their respective owners.