msa import speakers hourglass - ajtruckle/meeting-schedule-assistant-support GitHub Wiki

From Hourglass

This importer allows you to bring speaker information exported from Hourglass into Meeting Schedule Assistant. It is available from the Import menu.

Use this importer when you have an Hourglass CSV export containing speaker details and want to add new speakers to your congregation records in Meeting Schedule Assistant. If a congregation does not already exist, a placeholder congregation will be created. Existing speakers are skipped.

What This Importer Does

The Hourglass Speaker importer reads a CSV file exported from Hourglass and imports:

  • Speaker names
  • Their privilege
  • The list of public talks they can give
  • Optional memo fields (if mapped)

If a speaker already exists, they are skipped.
If the congregation named in the CSV does not exist, a placeholder congregation is created.

It does not modify existing speakers, congregations, assignment history, or meeting schedules.

Required Format

The CSV file must contain the following fields:

  • congregation
  • name
  • appt
  • talks

These must match exactly as written in the CSV header.

Opening the Importer

From the Import Menu

Import → Speakers → From Hourglass

Image

Figure 1: Selecting the Hourglass speaker importer from the Import menu.

Import Steps

1. Select the Hourglass CSV file

Choose the CSV file exported from Hourglass.

The importer immediately reads the header row and validates the required columns.

2. Map optional memo fields (Speaker)

If your CSV contains additional columns, you may map them to memo fields.

Image

Figure 2: Optional memo field mapping for speakers. Map any additional CSV columns to speaker memo fields.

Use these to map CSV columns to the appropriate memo fields.

Mapping is optional — if you do not select anything, memo fields remain empty.

3. Complete the import

A summary is displayed showing how many congregations were added or skipped.

Field Mappings

Field How it’s used in Meeting Schedule Assistant
congregation The congregation the speaker belongs to. A placeholder is created if it does not exist.
name The speaker’s name.
appt The speaker’s role (Elder or Ministerial Servant).
talks A comma‑separated list of talk numbers the speaker can give.
Mapped memo fields Any additional fields you map manually. Stored in the speaker’s memo record.

Troubleshooting

Memo fields did not import

This can happen if:

  • The CSV column was not mapped
  • The column contains no data

Invalid or unknown talk numbers

If a speaker’s Talks list contains a talk number that does not exist in the Public Talks database, that number is ignored.
Ensure all talk numbers in the CSV match the talk numbers defined in Meeting Schedule Assistant.

Summary

The Hourglass Speaker importer provides a simple way to bring speaker information into Meeting Schedule Assistant. It supports:

  • Importing speaker names
  • Their privilege
  • The list of public talks they can give
  • Optional memo field mapping for speaker notes

Speakers are added only. Existing speakers are skipped.
If a congregation does not already exist, a placeholder congregation is created automatically.

After processing the file, a summary report shows how many speakers were added or skipped.

Back to Speaker Importers

Related Importers