PeopleSoft Student Administration Integration Pack PeopleBook

Importing Grades

SAIP enables you to import final grades from an external system to your PeopleSoft Student Records grade roster.

This chapter provides an overview of grade import and discusses how to:

Set up grade import.
Import grades.

Note. The SAIP Grade Import service imports final grades into the Student Records grade roster only. It does not interact with Campus Solutions Gradebook. If you use SAIP Grade Import, you cannot also use Gradebook.

Understanding Grade Import

The IMS LIS specification allows for two different models of Outcomes integration: a "pull" methodology in which one system (usually the final system of record, such as the student information system) requests the grades from the system in grades have initially been entered (such as a learning management system); and a "push" methodology in which the system, in which the grades have initially been entered, sends the grades to the final system of record based on an action within that initial system. SAIP supports both of these models.

Setting Up Grade Import

To enable grade import, you must select the Enable Grade Import check box on the SAIP Installation page. This can be selected at implementation time or any time that you want to enable grade import.

When selected, the Grade Import group box and Import Grades button appear on the PeopleSoft Student Records Grade Roster page for any class section that is currently in scope.

Page Used to Set Up Grade Import

Page Name	Definition Name	Navigation	Usage
SAIP Installation	SAE_SETUP	Set Up SACR, Install, SAIP Installation	Enable or disable event triggers and grade import, and identify the default usages, file to use for SAIP initialization and updates.

Setting Up Grade Import Pull

The Grade Import Pull method is initiated through the Campus Solutions Grade Roster. To enable Grade Import Pull, you must select the Enable Grade Import check box on the SAIP Installation page. You can select this at implementation time or any time that you want to enable grade import.

In addition to selecting the Enable Grade Import check box, you must enter a Grade Source ID on the Class Targets page (Curriculum Management, Schedule of Classes, SA Integration Pack, Class Targets).

Note. Grade Source ID can be defined at the institution level and cascade down to academic organization and class section. If a grade source target is not set for a section, then the grade import functionality for that section will be unavailable to the user even if Enable Grade Import is checked at the system level. The "Managing Multitarget Integration" chapter contains more information on setting grade source targets.

Setting Up Grade Import Push

In the Grade Import Push methodology, Campus Solutions Grade Roster is the consumer of information sent from an external grade source such as a learning management system.

To enable Grade Import Push, you must set the following service operations to Active, as well as their corresponding handlers and routings:

SAE_REPLACE_LINEITEM
SAE_REPLACE_RESULTS

The section "Setting Up Integration Broker for SAIP" contains more information on activating service operations, routings, and handlers.

In addition to activating the services, handlers and routings, you must enter a Grade Source ID on the Class Targets page (Curriculum Management, Schedule of Classes, SA Integration Pack, Class Targets). If a grade source target is not set for a section, then the grade import functionality for that section will be unavailable to the user even if Enable Grade Import is checked at the system level. The "Managing Multitarget Integration" chapter contains more information on setting grade source targets.

Importing Grades

This section discusses how to:

Import grades.
Review a Grade Error report.
Import grades using the "push" method.

Note. SAIP Grade Import imports final grades into the Student Records grade roster. It does not import grades into PeopleSoft Gradebook.

Pages Used to Import Grades

Page Name	Definition Name	Navigation	Usage
Grade Roster	GRADE_ROSTER1	Curriculum Management, Grading, Grade Roster, Grade Roster	Enter official grades and requirement designation grades, view enrollment summary information, and add transcript notes.
Grade Roster	SS_GRADE_ROSTER	Self Service, Faculty Center Click the Grade Roster icon on the Faculty Center page.	If your institution also licenses PeopleSoft Campus Self Service, instructors can view or enter grades, update the roster's approval status, and post grades to the grade roster from the self-service faculty center.
Grade Error Report	SAE_GRD_ERR_REPORT	Click the Grade Import Error Log link on the Grade Roster page.	View details of errors and issues encountered during the import of grades from an external system.

Importing Grades

Access the Grade Roster page (Curriculum Management, Grading, Grade Roster, Grade Roster).

Note. In order for the Import Grades button to appear on the grade roster, both Enable Grade Import must be checked on the SAIP Installation page (Set Up SACR, Install, SAIP Installation) and a Grade Source ID must be entered on the Class Targets page (Curriculum Management, Schedule of Classes, SA Integration Pac, Class Targets). If a grade source target is not set for a section, then the grade import functionality for that section will be unavailable to the user even if Enable Grade Import is checked at the system level.

Grade Import

Last Import

Displays the date and time when the Import Grades button was last clicked.

Grade Import Error Log

Appears if any row containing either a student ID or a grade did not successfully import for the course.

Click to access the Grade Error Report page where you can view descriptions of unsuccessful imports.

Note. If a row cannot be imported because no ID is associated, then it also cannot appear in the log, which is ID dependent. A message appears at the bottom of the error log page instead.

Import Grades

Click to capture and import final grades from the external system into the Student Records grade roster.

Grades are pulled for the roster as a whole. You can import grades as many times as desired so long as the roster's approval status is not Approved or Submitted for Approval, and as long as the grades have not yet been posted.

Rows for the imported grades appear in the grid area at the bottom of the page. The grades appear in the Grade Input column and with a status of Assigned. Instructors can check, change, and control grades before finalizing and posting them.

Warning! When you re-import grades, all grades data are overwritten and any manual adjustments that you made will be lost.

See Using the Grade Roster Page to Enter Grades.

Reviewing a Grade Error Report

Access the Grade Error Report page (click the Grade Import Error Log link on the Grade Roster page.)

IMS ID

The ID of the student whose grade is being imported.

Error Description

Error or log messages which may appear here for the following conditions:

Student does not exist on roster: student exists in grade import but not in grade roster.

Student does not exist in LMS: student exists in grade roster but not in incoming grade import.

The grade submitted is not a valid grade for the student: grade scheme for a specific student is invalid in grade import.

Importing Grades Using the Push Method

In a Grade Push methodology, Campus Solutions Grade Roster acts as a recipient of an inbound integration service. The user does not need to undertake any action from within the Campus Solutions Grade Roster to initiate integration; rather, the user would undertake that action from the grade source (such as pushing a "Publish Grades" button). The next time the user accessed the Campus Solutions Grade Roster, the final grades would then be visible and actionable in Grade Roster. Institutions that define multiple grade sources (for example, deploying multiple LMSs as part of their campus topology) may be deploying a mix of Grade Pull and Grade Push methods; because the Enable Grade Import check box is an implementation-level value, it is possible that the Grade Import group box, including the Import Grades button, will be visible even for classes whose grade source is a Grade Push source. Users do not need to use the Import Grades button for those classes; if the grade source supports both Push and Pull methods, users may elect either method to import grades for that roster.

Last Import does not display a value for classes whose grade source is a Grade Push source, nor will a Grade Import Error Log be generated or a hyperlink be displayed. For grade sources using a Grade Push method, the grade source application is the solution through which grade integration is tracked and managed, including error management.

As part of the defined process for receiving the Grades via a Push, SAIP will check for several conditions in order to ensure that the grade roster and individual results are in a consistent state:

Does the student ID exist?
Does the section exist?
Is the section gradable?
Does the student enrollment exist and is it active?
Is the grade valid for the section?
Is the input system authorized for grade upload in this section?

Only one grade source is allowed for a given course section and it must be designated on the Class Targets setup pages.

In any of the above checks result in a condition that would prevent the transfer of Grades for a specific student, SAIP will respond with an appropriate response to the Grade source system.