User Tools

Site Tools


Sidebar

Table of Contents

testscores:utilities:importtestscores

Import Test Scores

Test Scores > Utilities > Import Test Scores

This utility imports and updates records from a fixed-length text file (unless otherwise noted) created by third-party testing software.

The utility also imports the testing data into the most current enrollment record for students who were enrolled in a prior year but are not enrolled in the current year. The Maintenance > Individual Maintenance page can also be used to add or update test data.

File Layouts:

  • Click here to view ASCENDER Interfaces that can be used to import and export ASCENDER data from and to third-party products, including file layouts for each test. (Click the Student Interfaces tab.)
  • For TELPAS, click here to view the file layout provided by TEA.
  • For more information about data file formats, see the Data File Formats page at the TEA website.

Click here to view information for ASCENDER ParentPortal Single Sign-on.

Import test data:

❏ Select the Test Type to import:

ACT Test

Students who test more than once will have multiple records imported with the same month and year; however, the test location will vary.

The State ID column displays either the student's eight-digit ACT ID or the last four digits of his social security number.

Hyphens are displayed in fields where the imported record does not have data.

Warning:  If imported records have the same administration date and test location as existing records in the ACT table, the imported records will overwrite the existing records, and all manual updates will be lost.

ACT Plan Test

The import file must be a DAT file.

The file is imported if the student's last and first name, date of birth, gender, and school year match the information in ASCENDER, the test date and location are valid, the Test Scale Scores (01-32), Scale Subscores (01-16), National Norms (01-99), and Reporting Grade (8-12) are in the valid ranges.

If the values of ** or – are displayed in Test Scale Scores or Scale Subscores, the fields are imported as blank.

If the value of – is displayed for National Norms, the field is imported as blank.

AP Test

NOTE: To edit an AP data file from a testing center before importing it, use a text editor only.

EOC/STAAR Alternate 2 EOC Test

For admin year 2014 and later, the import compares the student's Texas Unique Student ID with the ID in the import. If they do not match, the student is not imported. If they do match, or if an ID is not included in the import, the program verifies that the student's SSN, DOB, and last name match the values on Registration > Maintenance > Student Enrollment > Demo1. If any of these fields do not match, the student is not imported, and a list of errors is generated.

This import does not import the cumulative history data section of the EOC assessment data file. To import the cumulative history data, use the EOC Cumulative Hist Test import.

EOC Cumulative Hist Test

This is applicable for test admin year 2014 and later.

The program imports only the cumulative history data section of the EOC assessment data file. To import the current EOC assessment data, use the EOC Test import.

Existing records are updated with the values from the import file. If the scale score in the import file does not match the existing scale score, a warning is listed on the error list.

The following data is imported:

Administration Date: imports the administrative year and season.

County-District-Campus Code: imports the county, district and campus codes.

Test Version: S = STAAR, L = STAAR L

Score Code: A = Absent, O = Other, and S = Score.

Level II: Satisfactory Academic Performance at the Student's Standard: 1 = Yes, 0 = No. If the value is 1, the Student Academic Performance Level 1 field is set to Minimum.

Level III: Advanced Academic Performance: 1 = Yes, 0 = No.

Scale Score: imports the scale score.

Substitute Assessment: indicates if an EOC assessment was substituted by another test. When a record exists with the same EOC type and administration date, the following rules apply:

• • If the Substitute Assessment field in the existing record is 1, it is not overwritten by any value in the import file.

• • The Substitute Assessment field in the existing record is 0, it is not overwritten by blank in the import file.

• • If the import file does not have a Scale Score, and the Substitute Assessment is 1, the record is imported. The Scale Score is not overwritten by a blank, and a warning message is displayed to indicate that the existing score was not updated by the blank score. If there is not an existing Scale Score, a warning is displayed if a blank scale score was imported because of a Substitute Assessment of 1.

EOC English Trans Test

Pearson provides LEAs with a .csv file of students who passed either the reading or writing assessment for previous English I and/or II exams, met the minimum score on the other, and achieved at least a combined scale score of 3750. If the combined total on the reading and writing assessments is less than 3750, the file is not imported.

ITBS Test

You must use the file import Form RPC12 to prevent errors when importing data. The file must be delimited by either comma or tab (not pipe), or use fixed width. Do not use the custom option.

PSAT Test

The data import is typically a fixed-length text file format.

SAT Test

The import allows both a fixed-width positional and a comma-delimited (CSV) file import.

STAAR 3-8/STAAR Alternate 2 3-8 Test

For admin year 2014 only, the import compares the student's Texas Unique Student ID with the ID in the import. If they do not match, the student is not imported. If they do match, or if an ID is not included in the import, the program verifies that the student's SSN, DOB, and last name match the values on Registration > Maintenance > Student Enrollment > Demo1. If any of these fields do not match, the student is not imported, and a list of errors is generated.

A student who takes the STAAR A test using a test booklet and has his responses transcribed into the online system should be designated as having taken a paper test.

TAKS Test

The Ignore record length validation field is displayed if you select TAKS Test. Select the field if you want to be able to import a file that has fewer than 500 characters. The standard import record length is 500 positions; however, if the field is selected, the import program bypasses the length validation and accepts any length record without generating an error. Therefore, if you create a file to import that has fewer than 500 characters, you do not have to space out the remaining positions. Even if the Ignore record length validation field is selected for the TAKS test, position 500 of the test record must contain a period.

TELPAS/TELPAS Alternate Test

The data is typically a fixed-length text file format. The file extension is .dat.

TSI Assessment

This option imports the Texas Success Initiative Assessment (TSIA) scores from a CSV file and generates an error report for invalid records found in the import file.

WARNING: If imported records have the same Test Start Date and Test End Date as existing records in the TSIA table, the imported records will overwrite the existing records, and all manual updates will be lost.

❏ Click Choose File to locate the file on your local computer or network, and click Open.

The file name is displayed.


❏ Click Import.

When the process is complete, if no errors were encountered, a message is displayed indicating the number of rows imported with no errors. Click OK to close the window.

If errors were encountered, a message opens displaying with total count of records not imported, total warnings, and total records imported. Click OK to close the window. Then, click Show Error Rpt to view the error report.

• If the Severity column displays “Warning,” the record was imported; however, you should review the record for accuracy.

• If the Severity column displays “Error,” the record was not imported.

WARNING: The error report is only available at the time of the import. You must save or print the report at this time; it will not be available to view or print after you close the report window.

testscores/utilities/importtestscores.txt · Last modified: 2023/10/16 19:59 by apape