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

From Deckhand

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

Use this importer when you have an Deckhand 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 Deckhand Speaker importer reads a CSV file exported from Deckhand and imports:

  • Speaker names
  • Their privilege
  • The list of public talks they can give
  • The Talk Coordinator flag
  • 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
  • PTC
  • Speaker
  • Standing
  • Talks

These must match exactly as written in the CSV header.

Note: Deckhand exports speakers as an Excel workbook with two tabs (Speakers and Public Talks). You must save the Speakers tab as a UTF‑8 encoded CSV file, ensuring that the first row contains the column headings.

Opening the Importer

From the Import Menu

Import → Speakers → From Deckhand

Import menu open, showing Speakers → From Deckhand.

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

Import Steps

1. Select the Deckhand CSV file

Choose the CSV file exported from Deckhand.

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.

Field mapping dialog showing memo fields available for speakers.

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.
The importer also uses the PTC value to identify the talk coordinator only when a placeholder congregation is created.

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.
PTC Marks the speaker as the congregation’s talk coordinator. Only applied when a placeholder congregation is created.
Speaker The speaker’s name.
Standing 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 Deckhand Speaker importer provides a simple way to bring speaker information into Meeting Schedule Assistant. It supports:

  • Setting the Talk Coordinator when a placeholder congregation is created.
  • 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