Terry's ORA Tips

Template Example – FindAGrave Citations

This page updated 18 Jun 2020

Version note: Applies to ORA 1.1

This article describes one of my example Templates for Online Repository Assistant (ORA). The other example Templates can be found in the index of Example Templates. Other articles in my ORA Section cover various topics about using the software. The "How it Works" section below includes links to articles describing the ORA features used in these Templates.

Description:

The Templates described here are designed to type data from a FindAGrave.com memorial record to complete a Citation entry for that memorial in TMG. These Templates are designed to work with "lumper" style source, where a single Source Definition is defined for the entire Collection, and details for a specific record are entered in the Citation Detail field when the source is cited.

The Templates are designed to work with FindAGrave.com memorials, but could easily be adapted to work with other Collections that are used with "lumper" style sources. I have not tested them with other genealogy programs, but they could no doubt be adapted to them as well.

A separate Template is provided Citations to different Tag Types, and for differing data for Birth and Death Tags.

Example Output:

Name Tag:

memorial # 136961829, Willie Gilmore MacNeill, includes tombstone photo showing same

Birth Tag, with Age:

memorial # 136961829, Willie Gilmore MacNeill, includes tombstone photo showing age 54 at death 26 Dec 1921

Birth or Death Tag, with Year:

memorial # 136961829, Willie Gilmore MacNeill, shows year and includes tombstone photo showing same

Birth or Death Tag, with Date:

memorial # 136961829, Willie Gilmore MacNeill, shows date and includes tombstone photo showing same

Burial Tag:

memorial # 136961829, Willie Gilmore MacNeill, includes tombstone photo
Type:

Auto Type, intended for use with TMG

Use:

In TMG, open a Tag Entry screen for a Tag in which you intend to cite this memorial.

In your browser, navigate to the memorial record for the person for which the Citation is being created. In the ORA Control Panel, click the Auto Type button associated with the desired Template. The Template opens a Citation screen, and in it enters the Source Number, Citation Detail text, and Sureties.

Limitations:
How it Works:

The Templates are intended to generate a complete Citation, starting with an open Tag Entry screen. The Template opens a Citation screen. With the "lumper" method of entering sources the Source Number for any record set is always the same, to the Templates enter it, then uses {tab} Control Sequences to advance to other fields in the Citation screen, ending after entering Surety values.

The methods used to create output for various segments of the Templates are shown below.

Opening the Citation Screen

The template uses TMG's keyboard shortcut F4 key to open the Citation screen, with the Control Sequence for that key:

{F4}{fast}

On my system the rest of the Template works reliably at a faster speed, so I add the {fast} speed code to speed up the rest of the typing. With a different system you may have to omit that to obtain reliable results.

Source Number

The Source Number for a "lumper" style source is always the same, so the Template enters it with literal text, then tabs to the Citation Detail field:

500{tab}

My assigned Source Number for FindAGrave.com is 500, for easy recall during manual entry. You would, of course, change that value to what is used in your system.

Memorial Number

The first part of the Citation Detail entry in my practice is the memorial number, which is created with the literal text "memorial # " followed by the Variable for the number itself from the record, and finally a comma and space produced by literal text:

memorial # [Record ID],

Name

The name field of married women often includes their maiden name, which is in Italics in the FindAGrave record. Since Italics are not reliably transmitted through the wide variety of applications ORA users may employ, ORA records the maiden names enclosed in parentheses. This makes it fairly easy to extract them or to render then differently if desired. I choose to record them as FindAGrave.com does, in Italics. I do that by using the :replace Transformation to replace the parentheses with TMG's Italics codes, with the following Template segment:

[Name:replace:\(:\[ITAL\:\]::replace:\):\[\:ITAL\]]

This segment uses two :replace Transformations, chained one after the other. The first, shown in green above, replaces the opening " ( " with TMG opening Italics code " [ITAL:] ". The second, shown in yellow, replaces the closing ")" with TMG opening Italics code " [:ITAL] ".

Because the square brackets and colons used in TMG's codes are also special characters to ORA, they must be preceded by the escape character " \ " as shown in yellow in the same code segment repeated below:

[Name:replace:\(:\[ITAL\:\]::replace:\):\[\:ITAL\]]

In addition, the :replace Transformation is designed to accept "Regular Expressions" in both of the first two parameters – the "pattern" string and the "replace" string. The opening and closing parentheses being replaced here are both special characters in Regular Expressions, so they too must be escaped, as shown in pink above.

Finally, when Transformations are chained together as they are here, if any of them but the last have optional parameters, those otherwise optional parameters must be supplied. If not, the following Transformation is interpreted as the missing parameter, which will then cause the Template to fail.

The :replace Transformation has an optional third "flag" parameter, which is generally not required but must be included when it is chained with another Transformation. If no value is needed for that parameter, as is the case here, it can be left empty, that is just the introductory colon is required with nothing following. This done in this Template with the double colons shown in green above. The first colon introduces the (empty) third parameter of the first :replace Transformation. The second colon introduces the second :replace Transformation.

If there are no parentheses in the name field the :replace Transformations do nothing, and the contents of the name field are output unchanged. So a test to determine whether or not they exist is not required.

If you are happy with enclosing the maiden name in parentheses as ORA displays it, you can ignore the :replace Transformation and use the [Name] Variable alone.

Prompt for Age

Since FindAGrave.com memorials do not record the age, except when the contributor has recorded it in a field not designed for that data, ORA cannot extract it from the record and we cannot extract it automatically. Instead, I use an Assignement Variable to prompt the user to enter it:

[=:Age]

When the Auto Type Template is used a prompt appears for the user to enter the age manually.

Text

The note portions of the Templates consist of literal text that differs for the various Tags and the information present about dates, as shown in the Example Output section near the top of this page.

Sureties

Finally, a {tab} Control Sequence advances to the Sureties fields, and enters the appropriate number of the literal text " 2 " – I assign all FindAGrave.com memorials a surety of two when they include a tombstone photo.

 
Templates:

The following are the complete Templates for the various Tag Types and date combinations. They can be copied from the areas below and pasted into an Auto Type Template in the OraSettings window. The separation of the coding into "paragraphs" is used only to make the coding easier to understand. The paragraph breaks are ignored by ORA when the Template is used.

Name Tag:

{F4}{fast}500{tab}

memorial # [Record ID],

[Name:replace:\(:\[ITAL\:\]::replace:\):\[\:ITAL\]]

, includes tombstone photo showing same{tab}2

Birth Tag, with Age:

[=:Age]

{F4}{fast}500{tab}

memorial # [Record ID],

[Name:replace:\(:\[ITAL\:\]::replace:\):\[\:ITAL\]]

, includes tombstone photo showing age XXX at death [Death Date]{tab}21

Birth or Death Tag, with Year:

{F4}{fast}500{tab}

memorial # [Record ID],

[Name:replace:\(:\[ITAL\:\]::replace:\):\[\:ITAL\]]

, shows year and includes tombstone photo showing same{tab}21

Birth or Death Tag, with Date:

{F4}{fast}500{tab}

memorial # [Record ID],

[Name:replace:\(:\[ITAL\:\]::replace:\):\[\:ITAL\]]

, shows date and includes tombstone photo showing same{tab}22

Burial Tag:

{F4}{fast}500{tab}

memorial # [Record ID],

[Name:replace:\(:\[ITAL\:\]::replace:\):\[\:ITAL\]]

, includes tombstone photo{tab}2{tab}{tab}2

 

 

ReigelRidge Home Terry's Tips Home Contact Terry

 

The Second Edition of my sell-out book, A Primer for The Master Genealogist, is still available.

Details are can be seen here.

 

Copyright 2000- by Terry Reigel