6. The File field transitions from “In Progress” to a CSV icon.
TROUBLESHOOTING
See the KITE webpage for troubleshooting information and common error messages related to upload file errors.
COMMON DATA UPLOAD ISSUES
Experience Possible Causes
Nothing happens when I click the Upload button (for User, Enrollment, or Roster files).
File is not CSV format.
Incompatible browser; use a supported browser as listed under the Educator Portal heading on
http://dynamiclearningmaps.org/requirements: SYSTEM ERROR MESSAGES
To view error messages, click View Details. A message which reads “invalid” does not require action; a message which reads “rejected” requires action.
The table below shows some error messages which may appear when uploading Roster or Enrollment files.
This table does NOT apply to states who upload records via a web service.
Message Possible Causes
### records created, ### records updated and ### records are rejected out of ### total records. Upload completed with errors.
The file was uploaded, but Educator Portal found errors. The hash tags (#) will be replaced with numbers indicating how many records updated and how many errors were found.
Message Possible Causes
Please enter a value with a valid
extension. The file was NOT uploaded because the file format was not CSV. This error may occur if you have copied and pasted data from other programs into the CSV file. Typically this can be corrected by transferring the data into a fresh copy of the CSV file that you are attempting to upload.
File format is not correct. The file was NOT uploaded. One possible reason is that a header is missing or is incorrect. Use the templates provided on the name of webpage for your state. File is required. User clicked the Upload button before
attaching a file.
“Blank value is not valid” The record is not actually rejected and no action required. This message will appear for any field that is not required and is left blank.
The Roster upload file is rejected Use only “English Language Arts” or “Mathematics” in the
State_Subject_Area_Code field. Spelling and capitalization must be as shown above.
Check the Current_School_Year field is completed correctly.
HELP DESK ASSISTANCE REQUIRED
Please contact the Help Desk for assistance with these items. • Change the State Student Identifier.
• Add or change state or district organizational data. • Remove a student from Educator Portal.
APPENDIX
If your state has provided an appendix to this manual with information customized for your state, you will find that on your state’s DLM webpage. The filename will look like this:
DATA STEWARD MANUAL APPENDIX ST (where ST is the two-letter abbreviation for your state). See Access Additional Resources on page 7 to get started.
SEAs: if you wish to provide a state appendix to this manual, send the finished file along with a DLM Website Update Request Form.
DOCUMENT HISTORY
Page numbers are valid ONLY for the date and version noted. They may change in future versions.
Date Section Name/
Summary of Changes Starting Page
04/14/2015 Manage Student Moves
Correction to procedure for moving a student between districts.
70
03/05/2015 Manage Student Moves
Added new section to summarize how to address student moves during the spring testing window
69
01/05/2015 Merged Release Notes into this document. Future changes will be documented directly into this manual, eliminating the need for a separate Release Notes document.
Updated the Required Software section. 13 Manage User Data section
Updated Overview
Added Add a User Manually
Updated Assign A User Role Or Multiple Roles plus permissions table
Updated Change User Account Information Added View User Data Extract
Date Section Name/
Summary of Changes Starting Page
Manage Enrollment Data section
Updated Create An Enrollment File plus field definition table (no new or deleted fields, just clarified data)
Added View Enrollment Data Extract
47
Manage Roster Data
Added View Roster Data Extract
71 Added Reports and Data Extracts section 82 Troubleshooting
Updated Common Data Upload Issues 84 11/04/2014 Beginning November 3, users uploaded via the User
Template are assigned a default role of "Teacher" and the KITE activation email message is automatically sent. You may change the role using the Assign a User Role or Multiple Roles.
28
Corrections to the Test, Exit, and Clear (TEC) data dictionary. These are below step 6 of the procedure titled Remove a Student from Educator Portal.
52-53
Changes to introductory text and fields of Roster File
data dictionary. 58 & 59 replace pages 58-60, below step 6 of the procedure titled Create a Roster File. Changes to Create a Roster Manually. Step 8 offers more
fields to choose from than previously.
66 10/21/2014 Add A Student Record Manually
Step 5 includes new screen shot and new field definition table. Best practices and corrections when using this procedure in combination with the Test, Exit, and Clear (TEC) file are offered.
51
09/24/2014 The Current_Grade_Level field uses one character for grades 3-9 and two characters for grades 10-12. The file will reject if there is a zero in front of a number (i.e. 03).