Library Template: TmgRecordId

For other Library Templates you can import, see the Importable Library Templates page.

TmgRecordId.ora-templates (v1.00) includes a single Library Template, TmgRecordId.

TmgRecordId

Use TmgRecordId in the TMG Citation window to enter a value in that window's Reference textbox. The Library Template assumes that the cursor begins in the Citation Details textbox and uses the appropriate number of {TAB} control sequences to advance through the Surety and Citation Memo texboxes.

The IdFieldName parameter is optional and defaults to "Record ID".

It's useful to enter a Record ID in the Citation window's Reference textbox, but it's tedious to do so with an Auto Type Template because the number of enabled Surety textboxes varies based on the parent window from which you open the Citation window.

TmgRecordId should only be used in Auto Type Templates.

TmgRecordId is complicated because the number of Surety textboxes varies based on the parent record. So, for example, a Citation for a Birth Event will have four enabled Surety textboxes whereas a Citation for a Census Event will have five enabled Surety textboxes. That means the Library Template must customize the number of {TAB} control sequences based on the parent window/record.

By default, the TmgRecordId will prompt the user to enter the number of Surety values. The user may respond with a number, 0 to 5, or an alphabetic character that indicates the type of parent record:

• A, Add Person window, no surety textboxes. The user may also enter a zero, '0'.
• N, Name record, three surety textboxes. The user may also enter a three, '3'.
• B, Birth event, four surety textboxes. The user may also enter a four, '4'.
• M, Marriage event, five surety textboxes. The user may also enter a five, '5'.
• D, Death event, four surety textboxes. The user may also enter a four, '4'.
• U, Burial event, five surety textboxes. The user may also enter a five, '5'.
• O, Other event, any event with five surety textboxes. The user may also enter a five, '5'.

[lib.TmgRecordId] leaves the text cursor in the first surety textbox.

Example 1

[lib.TmgRecordId]

Example 2

If you use TmgRecordId] in a context where you know the parent window or record type, for example, when TmgRecordId will always be used for a Birth event citation, you can set the Surety count before making a reference to TmgRecordId:

[=:SuretyCount:4][lib.TmgRecordId]

Assigning a value to SuretyCount triggers TmgRecordId to skip the prompt for the number of surety textboxes.

<[?:SuretyCount]|[?:o.Test=1][=:SuretyCount:5]>
<[?:SuretyCount]|[=:Surety Count (A,N,B,D,U,M,O)][=:SuretyCount:[Surety Count (A,N,B,D,U,M,O)]]>

<[?:SuretyCount/^[Aa]$/][=:SuretyCount:0]>
<[?:SuretyCount/^[Nn]$/][=:SuretyCount:3]>
<[?:SuretyCount/^[BbDd]$/][=:SuretyCount:4]>
<[?:SuretyCount/^[MmUuOo]$/][=:SuretyCount:5]>
<[?:SuretyCount]|[=:SuretyCount:5]>

# Tab to Reference textbox
{TAB*[SuretyCount:mathAdd:2]}

[{1:Record Id}]

# Tab back to first surety textbox
<[?:SuretyCount>0]{SHIFT+TAB*[SuretyCount:mathAdd:1]}>