Diff for "FinalisingMarksInAstra"

Differences between revisions 1 and 47 (spanning 46 versions)

(Work in progress. Adding more info as questions are received.)

Term 2 2019 onwards, mark finalisation is done in Astra astra.unsw.edu.au.

$/!\$ Outside UNSW network, connect to UNSW/CSE VPN first.

sms to astra

sms2astra.sh script can help you in the process.

0. sms2astra.sh --help

1. List astra fields and their attributes, look for precision and maximum value.

sms2astra.sh --info

2. Generate mapping file of astra fields to sms fields.

sms2astra.sh --config

3. Edit mapping file, replacing hyphens with corresponding sms fields. 4. Check that sms fields attributes are compatible with astra fields.

sms2astra.sh --check

5. Generate a csv file of component marks.

sms2astra.sh

6. Copy this csv file to your local computer for uploading into astra.

Note 1

$/!\$ Fields and attributes (structure) changes in Astra will not be reflected in sms2astra.sh script straightaway. During the term, the list of astra fields is manually copied from Astra to CSE once a week. It will be updated every four hours in the last two days leading up to results submission deadline. If you need an updated list urgently, please email meicheng@unsw.edu.au.

Note 2

Question - There is a bug in the script for a couple of students, the CSV file contain invalid mark values.

Answer - This is because there are non ascii characters entered in a sms's comment field. The script uses the name command. Check the output of name by printing the field with the invalid mark. Then remove the offending non ascii characters from the comment in sms.

e.g.
name 5555555 -p exam_total

To find the offending non ascii in the comment, search for the student in student record text file

e.g.
cd $SMSDB
less student_recs/19T2COMP9517_rec

non sms users

How to generate the csv file?

1. In Astra, select Manage menu tab, then Upload/Download

2. Select the fields from the Items dropdown list, Confirm

3. Download button

4. Add or change the item marks in the csv and upload (same page, reason is required and retained).

No Mark or Query (Pending) Mark

No mark is either dot or empty and Pending mark is '?'. Same as in sms.

Maximum or Precision value

How to change maximum value for an assessment?

In Astra, select Prepare menu tab, then Structure
Select Edit mode, Select the radiobutton for the field (Item) to change, Edit the selected Item (Bottom of the page)
Scroll down to the Mark/Scale Attributes panel, enter new Maximum or Precision, then Save

Note

If there are marks for the assessment item, reset the marks to either dot or empty first.

Supp Exam list

How to get a list of students with approved special consideration?

From the class account,

get_supp_list.sh term course
e.g.
get_supp_list.sh 19T2 COMP1511

assuming /home/give/stable/bin is in $PATH

prints all special cons
get_supp_list.sh --all term course

prints all final exam special cons whether approved or not
get_supp_list.sh --allfinal term course

https://cgi.cse.unsw.edu.au/~sturec/Consid/index.php

WC grade

How to assign WC grade to students with approved special consideration?

In Astra, select Manage menu tab, then View/Enter
Select Final Exam from the dropdown Item list, then Confirm
Search for the student, then View/Add under the History & Exception column.
- Instead of searching each student, sort on the Final Exam column, scroll to where the marks are dots or empty
Add Exception, Pick Special Consid: Supp Assessmt from the dropdown Exception list.

WD grade

How to withheld final result for plagiarism or misconduct cases?

Same 1, 2, 3 steps as WC grade, except select Final Result from the dropdown Item list instead of Final Exam.
Add Exception, Enter "WD" against Related Value.

Hurdle

How to add final exam hurdle?

Part 1

In Astra, select Prepare menu tab, then Structure
Select Edit mode, Select Final Exam radiobutton, Edit the selected Item (Bottom of the page)
Scroll down to Competency, enter the mark for Standard to demonstrate competency for this item, then Save

Part 2

Select Edit mode again, this time select Final Result radiobutton, Edit the item (Bottom of the page)
Scroll down to Competency, select Apply Final UF Grade radiobutton, then Save

$/!\$ Convenors don't have access to edit Final Result, email staff with admin access (e.g. meicheng) to complete this.

Updating marks or amendments

After marks have been changed, recalculate the final results either via the View/Entry page or the Checkpoint page.
Then press the Submit Updates or Amendments button

-  ⇤ ← Revision 1 as of 2019-09-02 11:58:30 → 
  Size: 662
  Editor: MeichengWhale
  Comment:
+   ← Revision 47 as of 2019-09-10 14:00:51 → ⇥
  Size: 5541
  Editor: MeichengWhale
  Comment:
-Deletions are marked like this.
+Additions are marked like this.
 Line 1:
-Term 2 2019 onwards, mark finalisation is done in Astra.
+## page was renamed from FinalisingMarkInAstra
#acl All:read GeoffWhale:read,write
-Line 3:
+Line 4:
+=== (Work in progress. Adding more info as questions are received.) ===

Term 2 2019 onwards, mark finalisation is done in Astra [[https://astra.unsw.edu.au|astra.unsw.edu.au]].

/!\ '''Outside UNSW network, connect to UNSW/CSE VPN first.'''

== sms to astra ==
-Line 6:
+Line 14:
-Line 16:
+Line 25:
-. Go to astra.unsw.edu.au
+=== Note 1 ===
/!\ Fields and attributes (structure) changes in Astra will not be reflected in sms2astra.sh script straightaway. During the term, the list of astra fields is manually copied from Astra to CSE once a week. It will be updated every four hours in the last two days leading up to results submission deadline. If you need an updated list urgently, please email meicheng@unsw.edu.au.

=== Note 2 ===
'''Question''' - There is a bug in the script for a couple of students, the CSV file contain invalid mark values.

'''Answer''' - This is because there are non ascii characters entered in a sms's comment field.
The script uses the '''name''' command. Check the output of name by printing the field with the invalid mark.
Then remove the offending non ascii characters from the comment in sms.

{{{
e.g.
name 5555555 -p exam_total
}}}

To find the offending non ascii in the comment, search for the student in student record text file 
{{{
e.g.
cd $SMSDB
less student_recs/19T2COMP9517_rec
}}}

== non sms users ==
How to generate the csv file?

1. In Astra, select '''Manage''' menu tab, then '''Upload/Download'''

2. Select the fields from the '''Items''' dropdown list, '''Confirm'''

3. '''Download''' button

4. Add or change the item marks in the csv and upload (same page, reason is required and retained).

== No Mark or Query (Pending) Mark ==

 No mark is either dot or empty and Pending mark is '?'. Same as in sms.

== Maximum or Precision value ==
How to change maximum value for an assessment?

 * In Astra, select '''Prepare''' menu tab, then '''Structure'''
 * Select '''Edit''' mode, Select the radiobutton for the field (Item) to change, '''Edit''' the selected Item (Bottom of the page)
 * Scroll down to the '''Mark/Scale Attributes''' panel, enter new Maximum or Precision, then '''Save'''

=== Note ===
If there are marks for the assessment item, reset the marks to either dot or empty first.

 
== Supp Exam list ==
How to get a list of students with approved special consideration?

From the class account, 
{{{
get_supp_list.sh term course
e.g.
get_supp_list.sh 19T2 COMP1511
}}}
assuming /home/give/stable/bin is in $PATH

{{{
prints all special cons
get_supp_list.sh --all term course

prints all final exam special cons whether approved or not
get_supp_list.sh --allfinal term course
}}}

https://cgi.cse.unsw.edu.au/~sturec/Consid/index.php

== WC grade ==
How to assign WC grade to students with approved special consideration?

 1. In Astra, select '''Manage''' menu tab, then '''View/Enter'''
 1. Select '''Final Exam''' from the dropdown Item list, then '''Confirm'''
 1. '''Search''' for the student, then '''View/Add''' under the '''History & Exception''' column.
    Instead of searching each student, sort on the '''Final Exam''' column, scroll to where the marks are dots or empty
 1. '''Add Exception''', Pick '''Special Consid: Supp Assessmt''' from the dropdown Exception list.

== WD grade ==
How to withheld final result for plagiarism or misconduct cases?

 * Same 1, 2, 3 steps as WC grade, except select '''Final Result''' from the dropdown Item list instead of Final Exam.
 * '''Add Exception''', Enter "WD" against '''Related Value'''.

== Hurdle ==
How to add final exam hurdle?

=== Part 1 ===
 * In Astra, select '''Prepare''' menu tab, then '''Structure'''
 * Select '''Edit''' mode, Select '''Final Exam''' radiobutton, '''Edit''' the selected Item (Bottom of the page)
 * Scroll down to '''Competency''', enter the mark for '''Standard to demonstrate competency for this item''', then '''Save'''

=== Part 2 ===
 * Select '''Edit''' mode again, this time select '''Final Result''' radiobutton, '''Edit''' the item (Bottom of the page)
 * Scroll down to '''Competency''', select '''Apply Final UF Grade''' radiobutton, then '''Save'''
/!\ Convenors don't have access to edit Final Result, email staff with admin access (e.g. meicheng) to complete this.

== Updating marks or amendments ==
 1. After marks have been changed, recalculate the final results either via the View/Entry page or the Checkpoint page.
 1. Then press the Submit Updates or Amendments button

== Other useful documentation ==

 * [[https://www.cse.unsw.edu.au/~nss/astra/Astra-T2ResultsProcessingNotesV1.1.pdf|Astra T2 Results Processing Notes]]

 * [[https://www.cse.unsw.edu.au/~nss/astra/SMS-AstraV1.1.pdf|SMS to Astra]]

 * [[https://www.cse.unsw.edu.au/~nss/astra/ManagingSpecialGradesinAstraV1.2.pdf|Managing Special Grades and Multi-Term Courses in Astra]]