The purpose of the CCMR Assessment File Data Loader web application is to allow data stewards at the district level to upload ACT, AP, IB, SAT and TSI assessment data into their district's CCMR Insights dashboard using a simple, intuitive interface which provides loading and error statistics for the end user.
How to Log In
1.) If you don’t already have one, get a Region 10 account at https://headstart.region10.org/ords/f?p=138
2.) Go to https://headstart.region10.org/ords/f?p=119 and log in
NOTE: If you do not have proper access you will receive the following message:
...
3.) Clicking the Data Upload button in the top-left of the web page (see below)
...
4.) Following the above steps will bring you to the Home page of the CCMR Assessment File Data Loader
...
Overview of the Home Page
The Home Page is where you will start the loading process. Let’s look at each section in some detail
1.) Top Menu (top-right of web page)
...
From here you can go back to the Monitoring Dashboard and you can see your login name and district id. Clicking the login name will allow you to logout of the application.
2.) Navigation Bar (left-side of web page)
...
Access to all you can do with the tool is located here in the Navigation Bar.
(a.) Clicking an assessment type will be you to that assessments loading web page.
(b.) Clicking on the Upload Data Reports will allow you to view the data from the file(s) you have uploaded. Only the data pertinent for assessments to be imported into the CCMR Insights Dashboard are uploaded, not the entire file contents.
(c.) Should you get a file format error (i.e. an error related to the way the file to be loaded is formatted based on the header), you can click on the File Format Errors to see which fields are causing an error and compare that to how the fields should be formatted.
(d.) Clicking on the Import Status will provide the status of the assessment file load into the ODS. This status will contain rows inserted, updated and failed.
Introduction and information Page
Information and assistance with the CCMR Assessment File Data Loader can be found here.
...
1.) Be sure to read the Important Notice section.
2.) A link to this user guide is found in the Help sections along with a link to open a support ticket.
3.) If there are any issues, questions or suggestions for enhancement, please use the support ticket link. The link will take you to the ticketing system page as seen below:
...
NOTE: Compliments are welcomed too!!
Overview of the Assessment upload and import process
The process of getting the assessment data into the ODS is a two-step process. First, the assessment data is uploaded to an staging database for preprocessing and a file is generated. Then the assessment data is imported into the ODS for the district to view via the CCMR Insights Dashboard. There can be a 5 minute delay between the assessment data being uploaded and the assessment data being available on the district dashboard.
Detailed Overview of the AP, IB, SAT and TSI assessment load pages
The AP, IB, SAT and TSI assessment load pages all have the same layoout. Let’s look at the AP assessment load page as an example of all the assessment load pages (with the exception of the ACT assessment page which is covered later).
The top-half of the assessment load page looks as follows:
...
1.) The first section (see below) contains the fields to choose the file (or files since multiple files can be loaded at once) and the button to upload the file(s).
...
districtId is the 6-digit district id or CDN
assessmentType is ACT, AP, IB, SAT or TSI
xxxxxxx is any description you want (not to exceed 50 characters)
...
All of the above components (except the file extension) are separated by an underscore ( _ ).
Examples:
723406_SAT_2019_tests.csv
678901_ACT_2020_test_results.txt
Failure to comply with the file naming standard will result in the file not being uploaded and one of the following errors being generated:
...
The purpose of the CCMR Assessment File Data Loader web application is to allow data stewards at the district level to upload ACT, AP, IB, SAT and TSIA/TSIA2 assessment data into their district's CCMR Insights dashboard using a simple, intuitive interface which provides loading and error statistics for the end user.
How to Log In
1.) If you don’t already have one, get a Region 10 account at https://account.region10.org/ords/f?p=138
2.) Go to https://reveal.region10.org/ords/f?p=119 and log in
NOTE: If you do not have proper access you will receive the following message:
...
3.) Click on the Data Upload button in the top-left of the web page (see below)
...
4.) Following the above steps will bring you to the Home page of the CCMR Assessment File Data Loader
...
Overview of the Home Page
The Home Page is where you will start the loading process. Let’s look at each section in some detail
1.) Top Menu (top-right of web page)
...
From here you can go back to the Monitoring Dashboard and you can see your login name and district id. Clicking the login name will allow you to logout of the application.
2.) Navigation Bar (left-side of web page)
...
Access to all you can do with the tool is located here in the Navigation Bar.
(a.) Clicking an assessment type will be you to that assessments loading web page.
(b.) Clicking on the Upload Data Reports will allow you to view the data from the file(s) you have uploaded. Only the data pertinent for assessments to be imported into the CCMR Insights Dashboard are uploaded, not the entire file contents.
(c.) Should you get a file format error (i.e. an error related to the way the file to be loaded is formatted based on the header), you can click on the File Format Errors to see which fields are causing an error and compare that to how the fields should be formatted.
(d.) Clicking on the Import Status will provide the status of the assessment file load into the ODS. This status will contain rows inserted, updated and failed.
Introduction and information Page
Information and assistance with the CCMR Assessment File Data Loader can be found here.
...
1.) Be sure to read the Important Notice section.
2.) A link to this user guide is found in the Help sections along with a link to open a support ticket.
3.) If there are any issues, questions or suggestions for enhancement, please use the support ticket link. The link will take you to the ticketing system page as seen below:
...
NOTE: Compliments are welcomed too!!
Overview of the Assessment upload and import process
The process of getting the assessment data into the ODS is a two-step process. First, the assessment data is uploaded to a staging database for preprocessing and for the generation of an import file. Then the assessment data within the import file is imported into the ODS for the district to eventually view via the CCMR Insights Dashboard.
It is worthy to note that the assessment import to the ODS (and its status which can be viewed via the Import Status page) can be viewed 5 minutes after the assessment data has been uploaded, but the assessment data will only be visible to the district on the district’s CCMR Insights Dashboard after the nightly refresh has been completed.
Detailed Overview of the AP, IB, SAT and TSI assessment load pages
The AP, IB, SAT and TSI assessment load pages all have the same layout. Let’s look at the AP assessment load page as an example of all the assessment load pages (with the exception of the ACT assessment page, which is covered later).
The top-half of the assessment load page looks as follows:
...
1.) The first section (see below) contains the fields to choose the file (or files since multiple files can be loaded at once) and the button to upload the file(s).
NOTE: All assessment files must follow the format districtId_assessmentType_xxxxxxx.yyywhere:
districtId is the 6-digit district id or CDN
assessmentType is ACT, AP, IB, SAT, TSI, or TSI2
xxxxxxx is any description you want (not to exceed 50 characters)
yyy is the file type extension which should be .csv for AP, IB, SAT or TSI files and .txtfor ACT files
All of the above components (except the file extension) are separated by an underscore ( _ ).
Examples:
723406_SAT_2019_tests.csv
678901_ACT_2020_test_results.txt
Also, there should be no spacesin the file name,
Failure to comply with the file naming standard will result in the file not being uploaded and one of the following errors being generated:
...
| Info |
|---|
IMPORTANT NOTE: The Assessment File Data Loader doesn’t mind but the Data Importer that runs behind the Assessment File Data Loader will not load the same file more than once. And no error message is generated by the Data Importer to alert you of this event. So, to get around this limitation, if you need to re-load a file, just rename the file differently for each load. As an example, given an initial file named 012345_TSI_May2019.csv, if you want to re-load the same file, then change the filename to 012345_TSI_May2019_v2.csv and proceed as usual. There is no standard for renaming the file so the district is free to rename the file as they see fit. |
Also in this section you will also see a list of the last 5 files that have been loaded.
...
2.) The next section (see below) contains any records in the file(s) that were uploaded where no student id could be found in the ODS. All student assessment records are matched with an associated student record in the ODS by using the student’s first name, last name and date of birth. If a match fails for a student ,then a “student id mismatch” occurs and the student's first name, last name and date of birth, along with the associated assessment file that contains the student’s assessment data, will appear in this section. The Clear button on the upper-right can be used to clear/reset the records in this section. There is also an action (see Actions button) to download the contents of this section to a .csv file on your local system. Also, you can search for a student by name or search for a filename using the search feature (see Student or File Name button).
...
After the assessment data has been successfully uploaded, and after a 5 minute delaythe nightly refresh has been completed, the status of the assessment data import can be verified by viewing this page. As mentioned in the important notice at the top of the page, any unsolvable errors should be reported to Region 10 Customer Support:
...
The top section will provide the import status by filename. The status will contain:
...
A totally successful import will appear in green while import with errors will appear in red.
A Refresh button exists (top-right) so that the page can be manually updated to show the latest status.
...