District Assessments, Start to Finish

A district assessment is an assessment your district builds and gives outside the benchmark sequence, most often a midterm. This page is the order to do things in. Each step links to the page that covers it in full.

Only District Admins can do any of this.

Finish your rollover first

A score attaches to a student through their enrollment for that school year. Until your district has rolled over into the current school year and its student information system data is current, there are no enrollments for us to attach to.

Confirm your rollover has been approved and your nightly sync has resumed before you start. See Resume Nightly Sync and After You Submit.

Step 1. Check that district assessments are on

District assessments are an add-on, already enabled for the districts that opted in. If yours is one of them you will see a New Assessment Definition button on the Assessment Definitions page, and District Assessment in the File Uploader menu.

If you see an "Add district midterms" card instead of that button, they are not on for your district yet. Open a Helpdesk Ticket if you are interested, or if you believe your district gives midterms and should already have them.

Step 2. Set your midterm ranges

Your district assessment is scored against percent-correct bands you define, not against a vendor's performance levels. Those bands have to exist before you upload, or every row derives a blank score and is dropped.

Open the Midterm Ranges tile on your district page and either copy your benchmark ranges or start from the standard defaults, then adjust.

Step 3. Create the assessment definition

Open Assessment Definitions from your district page and click New Assessment Definition. Fill in the Assessment Timeframe, Name, and Short Name. The school year and the type are set for you.

You can have up to four district assessments per school year.

Creating it also pulls in the banked scores it qualifies for. A student's grade-9 Algebra I, Biology I or English II result, and a compacted grade-8 Algebra I result, count as a prior for a later year, and those are attached to your new assessment as soon as it exists. You do not have to create the assessment before the MAAP file imports, or re-import anything afterward.

Then drag it into place. Each row has a drag handle at its left edge; the new order saves on its own. The order you set here is the order assessments appear everywhere they are listed, including the picker you will choose from when you upload, so put your midterm where it falls in your year.

Step 4. Get your files ready

Every file needs a column for the student's MSIS number and a column for percent correct. The columns can be named whatever your export names them.

Whether you need a third column depends on how your files are split:

If your files are	You need
One file per grade and subject	Two columns. You pick the grade and subject for each file during upload.
One file carrying several subjects	Three columns, the third saying which subject each row belongs to.

Accepted types are .csv and .xlsx, up to 25MB. Percent correct is a number between 0 and 100, decimals included.

Step 5. Upload

Click the File Upload icon in the navbar and choose District Assessment. The form asks one thing at a time: pick the assessment, add your files, confirm the columns we found in them, then set the grade and subject for each file.

Processing starts when you click Finish. You are copied on a confirmation email listing the assessment, the columns we read, and every file with the grade and subject you gave it. Check it against what you meant to send. A few minutes later the import status email follows, with how many rows of each file became scores and a spreadsheet of any that did not.

Step 6. Wait for us to finish processing

Uploading loads your scores. Turning them into impacts is a step our team runs, so your assessment is not finished the moment your upload is.

We will email you when your data has been processed and is ready to look at. Until then, do not read anything into what the assessment's tracker shows.

If a file was rejected during upload, you will have seen it on screen at the time: the message names the file and what to fix. The usual causes are a column mapped to the wrong header, percent values written as fractions of one, or a subject value we do not recognize.

Doing it again

Steps 1 and 2 are one-time. For each new district assessment you repeat steps 3 through 6.

If you need to correct a file, fix it and upload it again for the same assessment. Re-uploading updates the scores already there rather than adding a second copy.

Support

Helpdesk Ticket: Helpdesk Ticket
Website: https://tkganalytics.org