Review the import summary and handle errors

After an import finishes, MapleGather shows a summary of what happened — and what you need to do next. This guide covers how to read the summary, download the error report, and send your members their welcome email.

Who can do this: Admins with the import view-summary permission.

Before you start

The summary screen appears automatically when an import completes. You can also reach it from Migration: on your import’s row, select the ⋮ menu and choose View summary.

Steps

Read the summary

The summary screen is headed Import complete when every row imported, or Partial import when some rows failed. Under the heading, a line gives the counts — for example, “245 members imported · 3 failed.”

Import complete means every row succeeded.
Partial import also shows a warning, “{N} rows need attention” — “Some rows didn’t import. Download the error report to review what went wrong.” This is a partial success: the rows that succeeded are committed; only the failed rows need attention.
Import failed is the summary of an import that failed (you reach it from View import summary on the progress screen). Nothing was imported, so there’s no count line and no broadcast button: an error message headed Nothing was imported gives the cause and what to do next, word for word as on the progress screen (the messages are listed in Commit and monitor an import). Download error report appears only when the import judged its rows — for example, when none of them could be imported. A failed import can’t be started again: to try again, upload the file as a new import.

Download the error report

If there are failed rows, select Download error report to get a CSV file. The report repeats your file’s columns and adds an ImportError column with a plain-English description of what went wrong for each failed row (for example, Email ‘BND-4471’ is not a valid email address.). Fix those rows, then import them again as a new import — see Your import has errors or skipped rows. Rows already imported are matched by email and not duplicated.

The report is prepared shortly after the import finishes, however many rows failed, and it always downloads directly — nothing is emailed. A value written with a ' in front (so a spreadsheet doesn’t run it as a formula) is read back without the ' when you import the fixed rows. The report is kept for 29 days after the import, so download it while you’re working on the fixes.

Possible duplicates

If the import flagged records that may be the same person, a Possible duplicates section shows how many pairs were flagged for review. This section appears only if your role can view members.

Send your members their welcome email

When you’re ready to notify your imported members, select Set up the broadcast. This takes you to the broadcast configurator. See Configure and send the post-migration broadcast. The button appears only if your role can send the migration broadcast.

Verify

You’ll know you’re done with the summary when the heading reads Import complete (or you’ve downloaded the error report for a Partial import and imported the fixed rows) and you’ve decided whether to send the broadcast.

If something goes wrong

The fixed rows fail again — Read their ImportError reasons in the new import’s error report: each one names what to change in the row. If every row fails the same way, check the column mapping. See Your import has errors or skipped rows.
The error report won’t download — If you see “The error report isn’t ready for this import yet. It is prepared after the import finishes — check back in a minute.”, the import is still running or its report is still being prepared: wait a minute and try again. If the whole import failed before any row was checked, there is no report: nothing was imported, so run the import again. “You don’t have permission to download this import’s error report.” means your admin role doesn’t include viewing import errors; “The error report couldn’t be reached right now. Try again in a few minutes.” is a temporary problem. Two messages mean the report won’t come however long you wait: “This import’s error report has expired — reports are kept for 29 days after the import.” (it is more than 29 days old), and “This import’s error report couldn’t be saved to storage, so it can’t be downloaded. The import itself is not affected. The rows that failed were not imported: fix them in your file and import it again — rows already imported are matched by email and not duplicated.” (MapleGather couldn’t save it — the members that imported are unaffected).