Import Logs + Roster Troubleshooting

Overview

To view import logs, you must be a System Administrator in Wayfinder.

When you import roster data into Wayfinder, the results of your import will be found on the Import Logs tab.  This will occur when you utilize our Flat File uploads (manual or SFTP) or our Clever integration.

The Import Logs tab is extremely useful in tracking down any problems that might have occurred during your import.  Let's take a look at an example.

Viewing Import Logs

To view import logs, after logging in as a System Administrator: 

  1. Click on "System Admin" in the left-hand navigation menu
  2. Then, click on the"Import Logs" tab

Here, you'll be able to see the time and date an import took place, the source of the import (Manual, SFTP, ClassLink, or Clever), the status of the import, and important details on any errors or notices that occurred. 

Imports can have three different statuses: 

  • "Processing" indicates that your import is still running.  Please check back later or continue to refresh to see the status (the status will not refresh on its own). This process may take up to an hour.  If it takes longer, please contact us.
  • "Finished" indicates that your files were successfully imported; however, the import may still have errors that you'll want to review. 
  • "Invalid" indicates that the import was not processed, and your rosters have not been uploaded.

By clicking on one of the records, you'll get more details about the import. Click on each file title to see any errors or warnings that occurred in that file. 

Above, you'll see that we've 1.) selected the staff.csv file and 2.) see that one of our records has a warning.  Warnings are the most common type of error, and come with a human-readable explanation.  In this case, we're being warned that there are duplicate staff IDs found in the file, and the rows with duplicate IDs will be ignored (not rostered).

Warnings result in the specified record not being imported.  Errors are more serious, and mean that the entire import was stopped due to the noted problem.

Common Import Log Errors

Error: The percent of changes is greater than the allowed percent of 10%

  • This error indicates that the percent of changes in your import is greater than the Allowed % Change that you have set. The Allowed % Change setting prevents unintentional data loss since any users or sections that are not present in a new import are archived in Wayfinder. 
  • If the changes in a recent import are intentional, and you'd like to push the sync through, follow the steps below: 
    1. Navigate to System Admin > Import Settings tab 
    2. Under Settings, increase your Allowed % Change to a higher percentage 
    3. Click the "Run Import Now" button at the bottom of the page 
    4. Once you've verified that the new sync was successful on the Import Logs page, we'd recommend lowering the Allowed % Change setting again. 

Error: A user with email '____' already exists in the system

  • This error indicates that a user with that email already exists in the system, and thus, they were not imported. Our system only allows one account per email address. 
  • This error can occur if the user exists in your district and their ID does not match the ID coming through with the new import, or the user exists under a different district in Wayfinder. 
  • To resolve this error, please email us at support@withwayfinder.com.

If there's an issue you're not sure how to handle, please feel free to contact us and we'll be glad to help.