Difference between revisions of "Review designer"

From PARS
Jump to navigationJump to search
Line 11: Line 11:
  
  
===A mock-up of how the final report should look===
+
=Submitting a design to be created=
  
*This could be a Word document, PDF, publisher document, image file, etc. The mock up should resemble the desired report as closely as possible, including the layout and any images
+
The process of creating a student review design will typically take approximately two weeks from the submission of the design and a valid [[OUTPUT.XML]] until a first draft is sent to you. In most cases the first draft will need several revisions to account for anomalies in your data and layout that may not be obvious until the first draft is seen. '''You should allow at LEAST one month from the point that all of the data requested below are sent until the report is ready to print'''.  
*'''Each column or other grade/comment container on the report should show which grade element code is to appear in that column (see below). A design cannot be produced without this information'''
 
*Where multiple columns use the same grade element code, the exact Result Set, EV_INST_ID or Date range should be included. These can be found by using the [[default slip]].
 
  
 +
Before submitting a design please add the [[Default slip]] and check that it contains the data you wish to see on the report. The [[Default slip]] will usually need to be referred to multiple times during the creation of a new review design.
  
===A list of grade element codes to be used on the report===
 
  
*The grade element codes are visible on the [[configure grading elements]] page
+
'''Here is a checklist of what is needed when submitting a design. If any part is missing or incomplete then work cannot commence:
*If there are multiple grade element codes that are all used in the same column and all share a similar code (e.g. an "Effort" column should contain grades with codes EFF_EN, EFF_MA, EFF_SCI, etc.) then only the shared part of the code is needed (in this case "EFF_")
 
*If a grade element is scheduled multiple times in a year or has multiple result sets, then a way to distinguish the correct grades for each time period is needed. The [[default slip]] can be used to find a field of information that distinguishes the schedules / result sets
 
*'''The report mock up must include grade element codes in the mock up as shown in the example below. A design cannot be produced without this information''' <br> <br>
 
  
{| border="1" style="border-collapse:collapse; text-align:center" width="65%"
+
=== A mock up of how you would like the final report to look. ===
|+ align="bottom"|''EFF_* means "the codes in the column all start with EFF_" so there is no need to enter every EFF_ code''
+
*This could be a Word document or Image file and should resemble the final report as closely as possible.
|style="font-size:12pt; font-weight:bold" width="17%;"|Subject
+
*It should include any images (logos etc) and layout.
|style="font-size:12pt; font-weight:bold" width="17%;"|Effort
+
*'''Each column or other grade/comment container on the mock up should show which grade element code is to appear in that column (see below). A design submitted without these data included will be ignored.'''
|style="font-size:12pt; font-weight:bold" width="17%;"|Attitude
+
*Where multiple columns use the same grade element code, the exact Result Set, EV_INST_ID or Date range should be included. These can be found by using the [[Default slip]].
|style="font-size:12pt; font-weight:bold" width="17%;"|Homework
 
|style="font-size:12pt; font-weight:bold" width="17%;"|Predicted
 
|style="font-size:12pt; font-weight:bold" width="17%;"|Target
 
|-
 
|'''English'''||EFF_*||ATT_*||HWK_*||PR_*||TG_*
 
|-
 
|'''Maths'''|| || || || ||
 
|-
 
|'''Science'''|| || || || ||
 
|} <br> <br>
 
  
===A list of rules required on report===
+
=== A list of grade element codes to be used on the report ===
 +
*The grade element codes are visible on the [[Configure Grade Elements]] screen in the left hand column.
 +
*If there are multiple grade element codes that are all used in the same column and all share a similar code (e.g. an "Effort" column should contain grades with codes EFF_EN, EFF_MA, EFF_SCI etc) then only the shared part of the code is needed (in this case "EFF_").
 +
*If the a grade element is scheduled multiple times in a year then a way to distinguish the correct grades for each time period is needed. Refer back to the [[Default slip]] to find out what should be used, it will either be the EV_INST_ID, the DATE or part of the SIMSDETAIL fields. Please include the correct information for each period in the submission. If all grades in a review period have the same DATE field (or fall within the same date range that does not overlap any other periods), it is easiest to use this.
 +
*'''The report mock up MUST include grade element codes IN THE DESIGN as shown in the example below. If it does not you will be asked to resend it with the correct codes included. The table below is the actual mock up of the report rather than a separate table just listing codes.'''
 +
[[image:ExampleSubmission.PNG]]
  
Each design can perform rules or calculations, such as hiding or renaming certain subjects, selecting the correct grade element codes, applying colours and more. The exact details of how these work are required.  
+
EFF_* means "the codes in the column all start with EFF_" so there is no need to enter every EFF_ code. You can save a LOT of time by following this particular suggestion. Any exceptions to the rule (e.g. a subject that contains two different EFF_ grade codes and only one should be used) should be mentioned.
  
Examples of common rules are listed below:
+
=== A list of rules required on report===
*Hide the effort column for pupils in year 11
 
*If a student is in class 10A/En1, add an extra row for English Literature using grade element codes EFF_ENL, PR_ENL, TG_ENL
 
*If a student is found to have a grade with code ABC_123 in Year 11 Science, remove the row for Science and add extra rows for Biology, Chemistry and Physics using these grade element codes (etc)
 
*If a subject has no grades hide the row for that subject
 
*Colour code the grades in column X by comparing them to the grades in column Y based on these scores "A=1, B=2 etc" and these criteria for each colour (Red = X<Y, Amber = X=Y, Green = X>Y)
 
*If attendance is <95%, colour the cell containing the attendance red
 
  
 +
Each student review design has a section at the top to hide or rename certain subjects and to select the correct grade element codes, usually a number of other rules are required. The exact details of how these work are required.
  
===Images===
+
Here are some examples of rules you may need:
 +
*Hide the effort column for pupils in year 11.
 +
*If a student is in class 10A/En1, add an extra row for English Literature using grade element codes A, B and C.
 +
*If a student is found to have a grade with code ABC_123 in Year 11 Science, remove the row for Science and extra rows for Bio, Chem and Phys using grade element codes (etc).
 +
*If a subject has no grades hide the row for that subject or insert N/A for the grade.
 +
*Colour code the grades in column X by comparing them to the grades in column Y based on these scores "A=1, B=2 etc" and these criteria for each colour (Red = X<Y, Amber = X=Y, Green = X>Y).
 +
*If attendance is <95%, colour the cell containing the attendance red.
  
Any images (school logos etc) to be included on the report should be hosted on a web server and be accessible via the internet from outside the school. The images should be resized to the size required on the final report. The externally-accessible URLs should be supplied via the [[help|helpdesk]].
+
=== Images ===
  
 +
Any images (school logos etc) to be included on the report should be hosted on a web server and be accessible via the internet from outside the school. The images should be resized to the size required on the final report. Please provide URLs to any images that are required.
  
 
=== An [[OUTPUT.XML]] file containing the relevant grades===
 
=== An [[OUTPUT.XML]] file containing the relevant grades===
  
This is the data file that your report will be based on. This file is generated by clicking the XML button on the [[review periods]] page. <br> <br>
+
This is the data file that your report will be based on. See the [[OUTPUT.XML]] page for information on how to create this file.
  
 
=Importing and managing designs in PARS=
 
=Importing and managing designs in PARS=

Revision as of 15:38, 28 April 2016

Lock.gif| Permissions required
to access this module:
Section:
Reviews
Permission(s):
Add and modify student review designs
Lock.gif| Permissions required
to access this module:
Section:
Grading
Permission(s):
Access grading

PARS can generate reports for parents e.g. End of Term Reports, or Progress Reports, which are created by our technicians and match school design specifications. For examples of slips and reports that have been designed for other schools, see this page.

This page is used to import the designs sent to school by our programmers so that reports can be printed at a later date.

The design process

A design for a custom report must be submitted via the online helpdesk, as well as other information. The information required to produce a custom report is as follows:


Submitting a design to be created

The process of creating a student review design will typically take approximately two weeks from the submission of the design and a valid OUTPUT.XML until a first draft is sent to you. In most cases the first draft will need several revisions to account for anomalies in your data and layout that may not be obvious until the first draft is seen. You should allow at LEAST one month from the point that all of the data requested below are sent until the report is ready to print.

Before submitting a design please add the Default slip and check that it contains the data you wish to see on the report. The Default slip will usually need to be referred to multiple times during the creation of a new review design.


Here is a checklist of what is needed when submitting a design. If any part is missing or incomplete then work cannot commence:

A mock up of how you would like the final report to look.

  • This could be a Word document or Image file and should resemble the final report as closely as possible.
  • It should include any images (logos etc) and layout.
  • Each column or other grade/comment container on the mock up should show which grade element code is to appear in that column (see below). A design submitted without these data included will be ignored.
  • Where multiple columns use the same grade element code, the exact Result Set, EV_INST_ID or Date range should be included. These can be found by using the Default slip.

A list of grade element codes to be used on the report

  • The grade element codes are visible on the Configure Grade Elements screen in the left hand column.
  • If there are multiple grade element codes that are all used in the same column and all share a similar code (e.g. an "Effort" column should contain grades with codes EFF_EN, EFF_MA, EFF_SCI etc) then only the shared part of the code is needed (in this case "EFF_").
  • If the a grade element is scheduled multiple times in a year then a way to distinguish the correct grades for each time period is needed. Refer back to the Default slip to find out what should be used, it will either be the EV_INST_ID, the DATE or part of the SIMSDETAIL fields. Please include the correct information for each period in the submission. If all grades in a review period have the same DATE field (or fall within the same date range that does not overlap any other periods), it is easiest to use this.
  • The report mock up MUST include grade element codes IN THE DESIGN as shown in the example below. If it does not you will be asked to resend it with the correct codes included. The table below is the actual mock up of the report rather than a separate table just listing codes.

ExampleSubmission.PNG

EFF_* means "the codes in the column all start with EFF_" so there is no need to enter every EFF_ code. You can save a LOT of time by following this particular suggestion. Any exceptions to the rule (e.g. a subject that contains two different EFF_ grade codes and only one should be used) should be mentioned.

A list of rules required on report

Each student review design has a section at the top to hide or rename certain subjects and to select the correct grade element codes, usually a number of other rules are required. The exact details of how these work are required.

Here are some examples of rules you may need:

  • Hide the effort column for pupils in year 11.
  • If a student is in class 10A/En1, add an extra row for English Literature using grade element codes A, B and C.
  • If a student is found to have a grade with code ABC_123 in Year 11 Science, remove the row for Science and extra rows for Bio, Chem and Phys using grade element codes (etc).
  • If a subject has no grades hide the row for that subject or insert N/A for the grade.
  • Colour code the grades in column X by comparing them to the grades in column Y based on these scores "A=1, B=2 etc" and these criteria for each colour (Red = X<Y, Amber = X=Y, Green = X>Y).
  • If attendance is <95%, colour the cell containing the attendance red.

Images

Any images (school logos etc) to be included on the report should be hosted on a web server and be accessible via the internet from outside the school. The images should be resized to the size required on the final report. Please provide URLs to any images that are required.

An OUTPUT.XML file containing the relevant grades

This is the data file that your report will be based on. See the OUTPUT.XML page for information on how to create this file.

Importing and managing designs in PARS

The review designer page

This page is accessed via: (for grade reports)
PARS main menu > Grading > Configure > Review designer

This page will show you a list of all the review designs currently in your database.

Revdes01a.jpg

Adding and editing slip/review designs

To import a design that you have received, first click the "Add" button from the top toolbar. This will take you to another page showing some code. Simply overwrite the code on this page with the code in the design sent to you, then give it a name and click "Save" at the top right. You can also edit existing designs by clicking to select them, and then clicking the "Edit" button.

Slipdes02.jpg

Deleting designs

To delete a design, first click on it to select it. Then click the "Delete" button from the top toolbar - this will delete the design so that it cannot be used again. It will not delete any actual slips that have been generated.

Uploading images for the report