Documentation for AdministratorsSISSIS Administrator HelpSetupPublishing Test Scores and Reports to the Student/Parent Portal

Publishing Test Scores and Reports to the Student/Parent Portal

Publishing FSA/Pearson Test Score Reports to the Student/Parent Portal

Focus allows users to publish student's test score to the Student and/or Parent Portal via a link that displays in the Messages section of the portal. When the link is clicked, the posted test scores display in PDF format.

1. Students and Parents will see a file/link on the Reports tab of the Portal, similar to the message for downloading report cards.

Below is an example of downloaded Biology test scores.

2. In order for the files to find a student/parent match, the student needs to have a FLEID and the file names from Pearson need to contain the student's FLEID.

3. Both FSA and Pearson test score reports should be uploaded directly into the applicable FSA and Pearson folders.

4. In the configuration, the default upload folder is: $uploaded_assets_dir = '/var/www/html/uploaded-assets/'

If the upload folder has been customized for your county, folder and file names will differ than the examples displayed here.

5. The file name of the test score report is very specific and will not post to the Student/Parent Portal if it does not meet the following format exactly. This has been established to enhance security.

Example of file name: /uploaded-assets/test_score_reports/FSA/FAL17_16_0331_STUDENT-NAME_FL123412781234_AL1.pdf

/uploaded-assets/test_score_reports/FSA/FAL17_16_0331_STUDENT-NAME_FL123412781234_AL1.pdf

FAL17 = Fall 2017: The Term the test was taken.

/uploaded-assets/test_score_reports/FSA/FAL17_16_0331_STUDENT-NAME_FL123412781234_AL1.pdf

16 = District ID

/uploaded-assets/test_score_reports/FSA/FAL17_16_0331_STUDENT-NAME_FL123412781234_AL1.pdf

0331 = School ID

/uploaded-assets/test_score_reports/FSA/FAL17_16_0331_STUDENT-NAME_FL123412781234_AL1.pdf

STUDENT-NAME = Student's first, middle, and last name.

/uploaded-assets/test_score_reports/FSA/FAL17_16_0331_STUDENT-NAME_FL123412781234_AL1.pdf

FL123412781234 = FLEID

/uploaded-assets/test_score_reports/FSA/FAL17_16_0331_STUDENT-NAME_FL123412781234_AL1.pdf

AL1 = Algebra I: The subject tested.

/uploaded-assets/test_score_reports/FSA/FAL17_16_0331_STUDENT-NAME_FL123412781234_AL1.pdf

Other subjects:

AL1 = Algebra 1

A1R = Algebra 1 Retake

AL2 = Algebra 2

GEO = Geometry

ELA = English Language Arts (ELA)

ELR = English Language Arts (ELA) Retake

G10R = English Language Arts (ELA) 10th Grade Retake

MAT = Mathematics

BIO1 = Biology 1

HIST = History

CIVI = Civics

SCI = Science

Math = Math

ALG1 = Algebra 1 EOC

A1 = Algebra 1 EOC

RETA = Algebra 1 EOC Retake

G = Geometry

G10 = English Language Arts (ELA) Grade 10

G3R = ELA Reading Grade 3

CIV = Civics EOC

BIO = Biology EOC

USH = US History EOC

The term abbreviation in the filename is case-sensitive.

Focus also supports extended filenames on the FSA/Pearson test score reports, such as

WTR16_16_0331_ABBOTT-ANDY-LEEANN_FL123412341234_G10R_57f680d2-06fc-ea11-80ed-941882806e62.pdf

which can also be added as  Spr17_16_0331_ABBOTT-ANDY-LEEANN_FL123412341234_AL1.pdf

6. Once you download the test score, the file begins with "(ISRpilot - pilot Individual PDF by Student)." This is visible when opening the PDF in your browser and hovering over the browser tab. Note: Pearson is responsible for the naming of the files and cannot be edited by Focus.

7. Create and run the Generate Test Score Report records based on report files job via Setup > Scheduled Jobs.

8. The Portal alerts are not limited by syear (school year) and do not have an expiration date. They will appear on the portal as long as there is a file for that student in the specified folder. When the district wants to remove the links for students and parents, they will have to remove those files from the folder.

Publishing IEP Progress Reports to the Student/Parent Portal

Focus allows users to publish student's IEP Progress Reports to the Student and/or Parent Portal via a link that displays on the Reports tab of the portal. When the link is clicked, the posted progress report displays in PDF format.

1. Students and Parents will see a file/link on the Reports tab of the Portal, similar to the message for downloading report cards.

Below is an example of downloaded IEP Progress Report.

ProgressReportV2

2. In order for the files to find a student/parent match, the student needs to have a FLEID set.

3. The following folder needs to be setup:

{path of $uploaded_assets_dir, set in config.inc.php}/test_score_reports/IEP_Progress_Report

4. Upload the file to the appropriate assets folder. Example filename: IEP Progress Report_Qtr4_FL123412341234.pdf

The FLEID in the filename must match the FLEID saved for the student via Students > Student Info.

5. Create and run the Generate Test Score Report records based on report files job via Setup > Scheduled Jobs.

To remove the IEP links, the files need to be removed from the folder and the scheduled job must be run again.

Publishing Academic Progress Monitor Reports to the Student/Parent Portal

Focus allows users to publish student's IEP Progress Reports to the Student and/or Parent Portal via a link that displays in the Messages section of the portal. When the link is clicked, the posted progress report display in PDF format.

1. Students and Parents will see a file/link on the Reports tab of the Portal, similar to the message for downloading report cards.

2. Make sure the uploaded assets directory is properly set up (case sensitive):

The path to the $uploaded_assets_dir for a particular site is set in the config.inc.php.

3. In the configuration, the default upload folder is: {$uploaded_assets_dir}/test_score_reports/academic_progress

5. The file name of the test score report is very specific and will not post to the Student/Parent Portal if it does not meet the following format exactly. This has been established to enhance security.

Example of file name: 0008800018333_Academic_Progress_Monitor_Datasheet.pdf

0008800018333 = Student's ID Number

Academic progress reports use the student's student_id in the filename, not the FLEID.

6. Create and run the Generate Test Score Report records based on report files job via Setup > Scheduled Jobs.

7. The Portal alerts are not limited by syear (school year) and do not have an expiration date. They will appear on the portal as long as there is a file for that student in the specified folder. When the district wants to remove the links for students and parents, they will have to remove those files from the folder.

Publishing Test Score Reports Using iReady Support

To publish iReady report links on the Student/Parent Portal, districts simply upload report files and run the scheduled job, Generate Test Score Report. This job can be run manually to publish the report links right away, or automatically overnight (by default, this job runs nightly except for weekends). When users are ready to remove the report links from the Portal, they can remove the uploaded report files and then run the scheduled job again.

1. File Naming Convention: (not case-sensitive)

   iReady_{TERM}_{SYEAR}_{SUBJECT}_{FLEID}.pdf

   iReady_Fall_2021_Math_FL123412341234.pdf

2. {SYEAR} = school year and not calendar year. This means that:

   iReady_Fall_2020_Reading_FL123412341234.pdf

   iReady_Winter_2020_Math_FL123412341234.pdf

   iReady_Spring_2020_Math_FL123412341234.pdf

are all in the same syear = 2020. So even though the test was from March 2021 on the calendar, the filename needs to read 'Spring 2020' or else the link will not show up on the Portal properly.

3. Focus system administrators will need to add a new folder in the appropriate uploaded assets directory. The 'iReady' directory is case-sensitive.

(In the config, $uploaded_assets_dir = '/var/www/html/uploaded-assets/'

Ex: uploaded-assets/test_score_reports/iReady

4. Run the Generate Test Score Report records based on report files scheduled job after uploading/removing report files to/from the uploaded assets directory via Setup > Scheduled Jobs.

Publishing Test Score Reports Using APM Support

To publish APM report links on the Student/Parent Portal, districts simply upload report files and run the scheduled job, Generate Test Score Report. This job can be run manually to publish the report links right away, or automatically overnight (by default, this job runs nightly except for weekends). When users are ready to remove the report links from the Portal, they can remove the uploaded report files and then run the scheduled job again.

Reports.png

1. File Naming Convention: (not case-sensitive)

APM1_{TERM}_{SYEAR}_{SUBJECT}_{FLEID}.pdf

APM_Fall_2019_Math_FL123456789000.pdf

APM1_Fall_2019_Science_FL123456789000.pdf

2. {SYEAR} = school year and not calendar year. This means that:

APM1_Fall_2020_Science_FL123456789000.pdf

APM_Fall_2020_Math_FL123456789000.pdf

APM2_Spring_2020_Math_FL123456789000.pdf

are all in the same syear = 2020. So even though the test was from March 2021 on the calendar, the filename needs to read 'Spring 2020' or else the link will not show up on the Portal properly.

3. Focus system administrators will need to add a new folder in the appropriate uploaded assets directory. The 'APM' directory is case-sensitive.

(In the config, $uploaded_assets_dir = '/var/www/html/uploaded-assets/' most of the time, but could be different for your particular test site)

Ex: uploaded-assets/test_score_reports/APM

4. Run the Generate Test Score Report records based on report files scheduled job after uploading/removing report files to/from the uploaded assets directory via Setup > Scheduled Jobs.

Publishing Gifted Progress Reports to the Student/Parent Portal

Focus allows users to publish student's Gifted Progress Reports to the Student and/or Parent Portal via a link that displays on the Reports tab of the portal. When the link is clicked, the posted progress report displays in PDF format.

1. Students and Parents will see a file/link on the Reports tab of the Portal.

2. In order for the files to find a student/parent match, the student needs to have a FLEID set.

3. The following folder needs to be setup:

uploaded-assets/test_score_reports/gifted_progress_reports

4. Upload the PDF to the appropriate assets folder. Example filename: {student_id}.pdf or 9540001332.pdf

5. Create and run the Generate Test Score Report records based on report files job via Setup > Scheduled Jobs.

To remove the Gifted links, the files need to be removed from the folder and the scheduled job must be run again.

Publishing FAST Test Score Reports

Focus allows users to publish student's FAST Test Score Reports to the Student and/or Parent Portal via a link that displays on the Reports tab of the portal. When the link is clicked, the posted report displays in PDF format.

FAST Test Score Reports are only applicable to Florida State Reporting clients.

1. Students and Parents will see a file/link on the Reports tab of the Portal, similar to the message for downloading report cards.

With (2).png

2. In order for the files to find a student/parent match, the student needs to have a FLEID and the file names from FAST need to contain the student's FLEID.

3. The FAST test score reports received from the test vendor should be uploaded directly into the applicable FAST folder.

4. Make sure the uploaded assets directory is properly set up (case sensitive) and the test files are uploaded into the proper test folder: test_score_reports/FAST.

If the upload folder has been customized for your county, folder and file names will differ than the examples displayed here.

5. The file name of the test score report is very specific and will not post to the Student/Parent Portal if it does not meet the following format exactly. This has been established to enhance security.

Original FAST file naming convention:

{FLEID}_PM22022-23_{TEST (e.g., FASTGrade5ELAReading)}{YEAR_RANGE}_StudentISRs_124237018 PM.pdf

{FLEID}_PM22022-23_{TEST}{YEAR_RANGE}_StudentISRs_124237018 PM.pdf

Examples:

FL123412341234_AllTestReasons_FASTGrade5ELAReading2022-2023_StudentISRs_200902130 PM.pdf

FL123412341234_PM22022-23_FASTGrade3Mathematics2022-2023_StudentISRs_124236940 PM.pdf

FL123412341234_PM22022-23_FASTGrade10ELAReading2022-2023_StudentISRs_083446568 AM.pdf

Newly updated FAST file naming convention:

{FLEID}_PM22022-23_{TEST (e.g., Grade5FASTELAReading)}{YEAR_RANGE}_StudentISRs_124237018 PM.pdf

Examples:

FL123412341234_PM22022-23_Grade5FASTELAReading2022-2023_StudentISRs_200902130 PM.pdf

FL123412341234_PM22022-23_Grade3FASTMathematics2022-2023_StudentISRs_124236940 PM.pdf

FL123412341234_PM22022-23_Grade10FASTELAReading2022-2023_StudentISRs_083446568 AM.pdf

6. Create and run the Generate Test Score Report records based on report files job via Setup > Scheduled Jobs.

The Portal alerts are not limited by syear (school year) and do not have an expiration date. They will appear on the portal as long as there is a file for that student in the specified folder. When the district wants to remove the links for students and parents, they will have to remove those files from the folder.

Publishing B.E.S.T. Score Reports

Focus allows users to publish student's B.E.S.T. score reports to the Student and/or Parent Portal via a link that displays on the Reports tab of the portal. When the link is clicked, the posted report displays in PDF format.

B.E.S.T. score reports are only applicable to Florida State Reporting clients.

1. Students and Parents will see a file/link on the Reports tab of the Portal, similar to the message for downloading report cards.

image-20230607-123554.png

2. In order for the files to find a student/parent match, the student needs to have a FLEID and the file names from B.E.S.T. need to contain the student's FLEID.

3. The B.E.S.T score reports received from the test vendor should be uploaded directly into the applicable B.E.S.T. folder.

4. Make sure the uploaded assets directory is properly set up (case sensitive) and the test files are uploaded into the proper test folder: uploaded-assets/test_score_reports/BEST.

If the upload folder has been customized for your county, folder and file names will differ than the examples displayed here.

5. The file name of the test score report is very specific and will not post to the Student/Parent Portal if it does not meet the following format exactly. This has been established to enhance security.

Original FAST file naming convention:

{FLEID}_B.E.S.T.{TERM}2022-23_B.E.S.T.{TEST}{YEAR_RANGE}_StudentISRs_124237018 PM.pdf

Examples:

FL123412341234_B.E.S.T.Spring2022-23_B.E.S.T.Algebra1EOC2022-2023_StudentISRs_145430350 PM.pdf

FL123412341234_B.E.S.T.Winter2022-23_B.E.S.T.GeometryEOC2022-2023_StudentISRs_145430350 AM.pdf

6. Create and run the Generate Test Score Report records based on report files job via Setup > Scheduled Jobs.

The Portal alerts are not limited by syear (school year) and do not have an expiration date. They will appear on the portal as long as there is a file for that student in the specified folder. When the district wants to remove the links for students and parents, they will have to remove those files from the folder.

Publishing iReady Test Score Reports

Focus allows users to publish student's iReady test score reports to the Student and/or Parent Portal via a link that displays on the Reports tab of the portal. When the link is clicked, the posted report displays in PDF format.

1. Students and Parents will see a file/link on the Reports tab of the Portal, similar to the message for downloading report cards.

image-20240201-163559.png

2. Make sure that the test score report filename follows the accepted format:

{SYEAR}_{STUDENT_LAST_NAME}_{STUDENT_FIRST_NAME}_{STUDENT_ID}_for-families_{SUBJECT}_{DATE_OF_DOWNLOAD}.pdf

3. Make sure the uploaded assets directory is properly set up (case sensitive) and the test files are uploaded into the proper test folder: test_score_reports/iReady.

4. Create and run the Generate Test Score Report records based on report files job via Setup > Scheduled Jobs.

The Portal alerts are not limited by syear (school year) and do not have an expiration date. They will appear on the portal as long as there is a file for that student in the specified folder. When the district wants to remove the links for students and parents, they will have to remove those files from the folder.

The test score report download links are syear dependent, so reports from the 2023-2024 school year will only appear on the Student/Parent Portal when 2023 is selected in Top Right.