Technical Support

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

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

Users can parse uploaded iReady filenames and generate Test Score Report records (in test_score_reports table) through the existing scheduled job, Generate Test Score Report records based on report files.

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. You will need to upload test files that match the file naming convention for iReady reports:

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

    The filename is not case-sensitive.

    Ex: iReady_Fall_2021_Math_FL123412341234.pdf

    The district is responsible for removing student report files prior to uploading new files.

    5. Be sure the  student(s) have a matching FLEID (e.g., FL123412341234) stored in custom_200000224 of the students table.

    6. 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.