1. Hapara Support
  2. For Hāpara administrators
  3. Troubleshooting

Menu

Articles in this section

How to troubleshoot Data Loader error messages Follow

As you begin the school year, uploading data to Hāpara is one of the first steps you’ll take as a Hāpara admin. It allows you to create classes and accounts to get educators and learners ready to use Hāpara.

You’ll complete your data load with one of the following:

When you use the Data Loader in the Hāpara Admin Console, it’s important to check the status of the load. This can quickly reveal if it was successful or if anything is preventing your data from processing.

 

Checking the data load status

  1. In Data Loader, after you’ve begun the data load, you’ll be brought to the status screen.
  2. Click Status at the top (or Go To Status Screen at the bottom).
  3. View the Load History. Load History provides a list showing current and historical data loads. 
  4. Click More Details to find out the details of an individual load. This is where you can locate log messages during the data load and troubleshoot any errors that may have occurred.

Screen_Shot_2022-06-30_at_2.29.41_PM.png

Data Loader error messages

The following are common Data Loader error messages:

 

The following are additional error messages you may see:

 

Troubleshooting Data Loader errors

Use the following steps to troubleshoot the errors listed above.

 

Error message: Unexpected error encountered

Screen_Shot_2022-07-14_at_9.24.59_AM.png

What it means: An error occurred outside of known errors and requires support team troubleshooting.

Hāpara support team help: Please Click Send Error or contact the Hāpara support team to troubleshoot the error.

 

Error message: User account is suspended or email is not recognized; email/user not added.

Screen_Shot_2022-06-30_at_2.41.20_PM.png

What it means: This is often an oversight. It could be that the teacher/student account is suspended, it wasn’t created, information is incorrect, or information is missing.

How to troubleshoot: 

  1. Check that the user information is correct and active in Google Admin Console. 
  2. Once the user information is confirmed correct and active in Google Admin Console, check the data in your SIS/Clever or spreadsheet/CSV file. Ensure that it matches what is in the Google Admin Console. 
  3. Update the user information if needed.
  4. Then reload/sync your data. 

Hāpara support team help: Suspended users will need to be refreshed in the Hāpara system once the user has been restored. Please contact the Hāpara support team before you reload/sync your data.

 

Helpful articles:

 

Error message: Class does not exist; students not added to class

GG-Class_name.png

What it means: The Google group for the class does not exist or is invalid. It could be that the Google group is missing, there is a spelling error, or the group has been deleted.

How to troubleshoot: 

  1. Check in Google Admin to see if the group exists and is active. If unsure of what happened to the group in Google, checking the audit logs can help with that.  
  2. Correct the mailbox value in your classes spreadsheet/CSV
  3. And/or create a class Google group by loading classes first.
  4. Then reload the student data.

Note: If trying to add a student to Google Classroom, the student must be added to Google Classroom first. Then you can sync to Hāpara. The student cannot be uploaded just to Google Classroom.

Helpful Articles:

 

Error message: Hāpara group is missing (TD.All, TD.Current)

TD-Groups.png

What it means:  The TD Google group created by Hāpara does not exist. Either the Google group is missing or the group has been deleted.

How to troubleshoot: Check in Google Admin to see if the group exists and is active. If unsure of what happened to the group in Google, checking the audit logs can help.  

Hāpara support team help: If unable to locate groups or undelete the group, please contact the Hāpara support team to assist in the creation of new TD Google Groups.

Helpful Articles:

Google groups

Google audit logs

 

Error message: Class/student can not be assigned to a school/class

School_code.png

What it means:  Data Loader can’t determine which school or class to add a student to.

How to troubleshoot: 

During your Hāpara setup, school codes were added. These codes were created because your domain has more than one school. 

  1. In Hāpara Admin Console check the Configuration Page > School Configuration to compare school codes or gather the correct school codes. 
  2. Correct or add school codes in your classes or student spreadsheet/CSV. 
  3. And/or reload the student data. 
  4. The SIS/Clever school code should now match. Please make sure the school code in your SIS/Clever matches the school code in Hāpara.

 

Error message: Missing teacher value

Missing_Teacher.png

What it means: A teacher’s email is missing from the class upload. This is commonly seen when classes do not have teachers yet. 

How to troubleshoot: 

  1. Add a teacher to the class to ensure their class is uploaded. 
  2. Check your SIS/Clever to make sure there is a teacher assigned to the class. 
  3. Reload the class once a teacher has been added.

 

Error message: Class name could not be created for class

Class_Name.png

What it means:  A class is missing a name. This is most commonly seen after an SIS/Clever sync.

How to troubleshoot: 

  1. Check to make sure all fields are correctly completed in SIS/Clever. 
  2. Once all fields are correct, re-sync the class data.

Hāpara support team help: If you’re unsure which fields need to be filled out in SIS/Clever, please contact the Hāpara support team.


Error message: Too many subject folders for group

Subject_Folder.png

What it means: Hāpara configuration is set up to only have one subject folder. If there is a comma in the folder name, the Data Loader identifies it as more than one folder.

How to troubleshoot: 

  1. Remove or substitute commas.
  2. Reload the class data.

Related articles