When using most FactsFacts are one of the key concepts at the heart of Family Historian; they are how you record the things that happened to, or described, each ancestor (Individual)., the standard Fields of Age, DateWhen an Event happened, or an Attrribute was true., PlaceAccording to GEDCOM, a Place should hold "The jurisdictional name of the place where the event took place…" , Address"The address structure should be formed as it would appear on a mailing label…", according to GEDCOM; however, this is capable of a number of interpretations, and Address and Place are best considered together. & Note are usually sufficient but sometimes extra fields are desirable. Those standard fields are described in Entering Ages, Entering Dates & Sort Dates and Working with Places and Addresses.
However, when using standard Facts or creating custom FactsUsers of Family Historian can customize fact definitions, or create their own fact definitions to more closely match they way they want to work., there may be a desire to add custom fields to hold particular data.
Custom fields cannot be added to Facts, and even if they could, when exported in a GEDCOMGEDCOM, an acronym for GEnealogical Data COMmunication, is a specification for exchanging genealogical data between different genealogy software. It is a file format that most genealogical programs and online trees recognise. file they would not be recognised by other genealogy products. This article explains some alternative techniques.
Basic Techniques
When designing a Custom Fact and just one extra field is needed, then instead of an Event try using an Attribute, which offers a value field after its name in the Facts tab, and is referenced by the {value}
code in its Sentence Template (see standard Attributes such as OccupationAn occupation is defined in the GEDCOM standard as: ‘The kind of activity that an individual does for a job, profession, or principal activity’. and Property). In practice, Events and AttributesEvents are things that happened to an Individual and Attributes are things that described them. are identical apart from the value field. There are no significant known issues when exporting to other products by reclassifying Events as Attributes. See Narrative Report Fact Sentence Templates for further details.
In addition to the Age, Date, Place, Address and Note fields, there are other standard fields available via the All tab of the Property Box including:
Cause (CAUS), Descriptor (TYPE), Email (EMAIL), Fax (FAX), Phone (PHON), Web Site (WWW), Responsible Agency (AGNC) & Religious Affiliation (RELI).
They can be used to hold appropriate information and referenced using {cause}
or {%FACT.CAUS%}
, {%FACT.TYPE%}
, etc.
The Cause field is particularly useful because it automatically appears in Reports as illustrated later.
The Emigration and Immigration events have additional To and From (_PLAC) fields and users often wonder if those fields can be used in other facts. They cannot, but labelled Note meta-fields can be used instead.
Labelled Note Meta-fields
A popular method of adding custom fields uses labelled meta-fields in the Note box, and is illustrated here using a Baptism Event:
The following Function Codes in the Narrative Report Fact Sentence Templates would compose the Sentence text:
{individual} was baptised {date} {place} {age}< by the {=GetLabelledText(%FACT.NOTE2%,"Minister: ")}>< for a fee of {=GetLabelledText(%FACT.NOTE2%,"Charge: ")}>
Each labelled meta-field can be included or excluded in any combination desired.
This not only allows the details to be exported satisfactorily in GEDCOM files, but also allows other Note text not required in the Sentence, unlike the {note}
code that would include it all.
It is advisable to enclose the meta-fields in Private Notes privacy [[ brackets ]] so the fields or the brackets can be excluded from or included in Reports by adjusting the Options. Those privacy [[ brackets ]] also exclude the fields from Note text produced by the {note}
code.
In the Tools > Fact Types dialogue, Edit… definition, there is a handy feature via the Advanced… button that offers an Auto-Create Note box that can hold the meta-field Note labels, so they automatically get created whenever that Fact is added. To start each label on a new line use Ctrl+Enter
to insert a line break.
Source Note Field
Alternatively, the Source Note field %FACT.SOUR2%
can be used in much the same way but rather less obtrusively. It is a local NoteFamily Historian version 6 and below supports two types of Notes: Local notes (associated with a single person, record, or fact); and Note Records (sometimes called Shared Notes), that can be linked to multiple records and/or facts. Version 7 introduced that appears in the yellow Sources For pane, but is nothing to do with Source recordsSource: "where information was found". This could be anything from an archive in a county records office, a book, or even a relative's recorded recollection. Citing your Sources helps to show how you reached a particular conclusion about an Individual.. The way to add a Source Note is via the All tab in an Individual’s Property Box. Right-click the Fact and choose Add Source Note in ƒh7 or Add Source and then Add Source Note to this Record in earlier ƒh versions. Add the text to the Source Note and it will appear in the Sources For pane. To edit the text use the All tab again and expand the Fact to reveal the Source Note box.
When exported to other products there is a small risk that Source Notes may get converted to Source CitationA link between a source and a fact, documenting Where within the source you find information being "cited" to support the fact/conclusion. Records.
Show Fact Fields in the Property Box
As explained above, a labelled meta-field is visible in the Note box and in the Sentence box when the Fact is selected.
Any field can be included in the Facts list at the top of the Facts tab so it is visible even when the Fact is not selected.
The custom fact Flew from illustrates this feature by adding a labelled Note meta-field To: Glasgow, Scotland second Place (see Emigration & Immigration events) and on the All tab by adding a Cause: by hot-air balloon field.
Use Tools > Fact Types, select the Fact, click the Edit… button, then the Advanced… button and enter the required templates.
Summary Template: Flew from {_place}< to {=GetLabelledText(%FACT.NOTE2%,"To: ")}> {cause}
Override Template: Flew {date} from {_place}< to {=GetLabelledText(%FACT.NOTE2%,"To: ")}> {cause}
Examples of the Fact Types dialogue, and the Property Box Facts tab and All tab are illustrated below.
Most of the other codes and functionsA 'function' is an expression which returns values based on computations. Typically, functions require data to be supplied to them as 'parameters'. A function in Family Historian is similar to a 'function' as used in spreadsheet applications (such as MS are supported similarly to Sentence TemplatesSentences are used in conjunction with Fact Sets to produce Narrative Reports; their templates are highly customisable.. So standard fields such as Cause & Descriptor mentioned above can be displayed using the codes {cause}
or {%FACT.CAUS%}
, {%FACT.TYPE%}
, etc.
A corollary to this technique is to add a symbol to indicate whether the Fact has a Source Citation or not. To do that start the Summary Template with the following expressionExpressions are composed from two technical features: Data References and Functions; they also often involve Operators to compare values. which tests if a Source link exists:
{=TextIf(%FACT.SOUR%,"§","–")}
where §
is the Section Sign UTF+00A7 and –
is the En Dash UTF+2013 which are both the same width so the Fact names are tidily aligned.
Show Fact Fields in Reports
The Sentence Template defines how fields appear in Narrative Reports and others that use Narrative style Sentences. The template can use the codes {note}
and {%FACT.NOTE2%}
to include Note text, and the Report Options include Event/Attr Notes by default, but that option is inhibited fact by fact if the template codes are used to prevent duplicated Note text.
Most other reports show Notes by default, but if the labelled Note is enclosed in privacy [[ brackets ]] it will be excluded unless the Inc. [[private]] Notes option is enabled.
The labelled Note does not have to be in privacy [[ brackets ]] but that may cause other problems when there is further Note text.
An alternative is to create a 2nd local Note via the All tab and adjust the template expressions to support both the 1st and 2nd local Notes.
Template expression: < to {=GetLabelledText(%FACT.NOTE2%,"To: ")}>< to {=GetLabelledText(%FACT.NOTE2[2]%,"To: ")}>
The only drawback is the 2nd local Note is not shown in the Facts tab Note box, although it is shown in the Notes tab, and can be shown elsewhere in the Property Box as explained above.
Summary Conclusions
If a Custom Fact needs just one extra field, then instead of an Event try using an Attribute, which offers the value field and {value}
code.
Consider using the standard Cause field and {cause}
code available with every Fact and shown in Reports.
If other fields are needed then a flexible option is to use labelled Note meta-fields available with every Fact and optionally shown in Reports.
Finally, there are the standard All tab fields Descriptor, Email, Fax, Phone, Web Site, Responsible Agency, Religious Affiliation and Source Note.