Grades configuration variables

Variable

Type

Default Value

Description

d2l.Tools.Grades.
AutoUpdateFinalGrade

OrgUnit

ON

Determines whether final grades are kept up to date automatically. Can also be set from the Grades Settings area or Grades Setup Wizard.

d2l.Tools.Grades.
CalcGradeItem.CalculationMethod

OrgUnit

OFF

Determines the calculation method for the calculated grade item. Options can allow the calculation to be similar to the Final grade calculation which scales to fill 100% as items are dropped (when dropped items are in a category, the remaining items in the category will scale to fit 100% of the category). Milestone grade calculation drops items from the sum total of the calculation, making the calculation based on the specified weights. No value set indicates Milestone Grade Calculation as the default method. Setting a value results in making the Final Grade Calculation method the default.

d2l.Tools.Grades.
ControlDecimalPlaces

OrgUnit

2

Controls the number of decimal places displayed in the Grades tool.

d2l.Tools.Grades.
DefaultGradesArea

User-OrgUnit

Enter Grades

Determines the first area displayed when the user enters the Grades tool.

d2l.Tools.Grades.
ExportHandlerPage

System or OrgUnit

null

Sets the absolute path of the grades handler page. For example: http://hostname/d2l/im/gradesexport/export_grades.d2l?ou={orgUnitId}

Can be set for specific courses (for testing purposes) or for the Org so that all courses have it configured. Users with the Export Grades permission see the Export To SIS button in the Grades tool on the Enter Grades page.

Your D2L site administrator must set the path.

d2l.Tools.Grades.ExportToSIS.Banner.Destination

System or Org

com_sct_ldi_sis_UpdateRequest

The instance name for the SIS to connect to.

d2l.Tools.Grades.ExportToSIS.
Banner.ReplyTo

Org

com_sct_ldi_sis_UpdateReply

Name of the JMS Queue the SIS will reply to.

d2l.Tools.Grades.ExportToSIS.
ExportMidtermGrades

System or OrgUnit

OFF

Determines if the option to export grades as midterm grades displays. You can add override values for individual org units.

d2l.Tools.Grades.ExportToSIS.
GradeMustBeReleased

Org

OFF

Boolean value that determines if a final grade needs to be released in Brightspace Learning Environment for submission to the SIS.

d2l.Tools.Grades.ExportToSIS.
GradeToSubmit

System or Org

0 (Use Org Unit Setting)

Determines which final grade submits to the SIS. The following are valid values:

  • 0 = Use Org Unit Setting
  • 1 = Calculated Final Grade
  • 2 = Adjusted Final Grade

d2l.Tools.Grades.ExportToSIS.LAExportHandlerPage

OrgUnit

/d2l/im/gradesexport/export_grades.d2l?ou={orgUnitId}

URL to the page that handles exporting grades to a Student Information System (SIS) or other system after entering last date of attendance for learners with failing grades. This value controls the destination of the Save and Continue button on the Last Date of Attendance page. Your D2L site administrator must set the value.

d2l.Tools.Grades.ExportToSIS.LAMidtermRequired

OrgUnit

OFF

Boolean value that determines if there is a requirement to set the last date of attendance for learners with failing grades when exporting midterm grades. Your D2L site administrator must set the value.

d2l.Tools.Grades.ExportToSIS.LATriggerGrades

OrgUnit

X,E,F

Comma-separated list of letter grades defined as failing in the system. These values trigger the requirement to set a last date of attendance for a learner. Your D2L site administrator must set the value.

d2l.Tools.Grades.ExportToSIS.LATriggerPercentage

OrgUnit

50

A numeral value that triggers the requirement to set a last date of attendance for a learner. This value is only used if the Final Grade object has a scheme that does not have one or more of the letter grade values defined in the d2l.Tools.Grades.ExportToSIS.LATriggerGrades configuration variable. Your D2L site administrator must set the value.

d2l.Tools.Grades.ExportToSIS.
PollingFrequency

System

5

Instance-wide variable that determines the amount of wait time (in seconds) between checking for transactions to export grades.

If a transaction timeout occurs, it is possible that Luminis Message Broker did not receive and process the Grade Exchange Message. Try resubmitting the response.

d2l.Tools.Grades.ExportToSIS.
SendSymbolOrValue

System or Org

System value set to S

Instance-wide variable that determines the format used to export grades, where V= Value and S = Symbol.

d2l.Tools.Grades.ExportToSIS.
SISPassword

System or Org

System value (hidden)

Password used to connect to the SIS service.

d2l.Tools.Grades.ExportToSIS.
SISUri

System or Org

http://localhost/d2l/im/gradesexport/
BannerMessageQueue?LoopBack=true

URI used to connect to the SIS service.

d2l.Tools.Grades.ExportToSIS.
SISUsername

System or Org

System value (null)

Username used to connect to the SIS service.

d2l.Tools.Grades.ExportToSIS.
TransactionTimeout

System

300

Amount of time (in seconds) to wait for a response from the SIS.

d2l.Tools.Grades.FinalGrade.
AdjFinalCanExceed

OrgUnit

OFF

Allows the final adjusted grade to exceed the max grade that a user can earn.

d2l.Tools.Grades.FinalGrade.AutoReleaseFinalGrade

OrgUnit

OFF

Marks users' final grades as released upon creation, if the Automatically release final grade option is enabled.

d2l.Tools.Grades.FinalGrade.
CalcFinalCanExceed

OrgUnit

OFF

Allows the final calculated grade to exceed the max grade that a user can earn.

d2l.Tools.Grades.FinalGrade.
ReleaseAdjustedGrade

OrgUnit

ON

Indicates whether to release the final adjusted grade or final calculated grade.

d2l.Tools.Grades.GradeSchemeId

OrgUnit

Percentage

Grade scheme ID that the org unit uses.

d2l.Tools.Grades.GradesList.
MaxRecords

OrgUnit

4000

Limits the number of users per page based on the maximum number of grade items that can be viewed on a page.

d2l.Tools.Grades.GradesList.
MaxSpreadsheetRecords

OrgUnit

2000

Limits the number of users per page based on the maximum number of grade items that can be viewed on a page in spreadsheet mode.

d2l.Tools.Grades.GradesList.
NumbCharsToDisplay

User-OrgUnit

50

Sets the number of characters to display in grades list for text items.

d2l.Tools.Grades.GradesList.
RepeatColumns

User-OrgUnit

5

Sets the number of columns before a repeat of the user list.

d2l.Tools.Grades.GradesList.
RepeatRows

User-OrgUnit

10

Sets the number of rows before a repeat of the grade objects.

d2l.Tools.Grades.GradesList.
ShowAdjFinalAtStart

User-OrgUnit

OFF

Final adjusted grade is duplicated at start of grades list.

d2l.Tools.Grades.GradesList.
ShowCalcFinalAtStart

User-OrgUnit

1

Final calculated grade is duplicated at start of grades list.

d2l.Tools.Grades.GradesList.
ShowEmail

User-OrgUnit

OFF

Shows email in grades list.

d2l.Tools.Grades.GradesList.
ShowGradeScheme

User-OrgUnit

ON

Shows users grade scheme grade.

d2l.Tools.Grades.GradesList.
ShowOrgDefinedId

User-OrgUnit

OFF

Shows orgDefinedId in grades list.

d2l.Tools.Grades.GradesList.
ShowPointsGrade

User-OrgUnit

OFF

Determines whether to show out of grade.

d2l.Tools.Grades.GradesList.
ShowUserName

User-OrgUnit

OFF

Shows username in grades list.

d2l.Tools.Grades.GradesList.
ShowWeightedGrade

User-OrgUnit

ON

Shows weighted grades in the grade list.

d2l.Tools.Grades.GradesList.
SpreadsheetView

Org

OFF

Determines whether spreadsheet mode is the default view for the User List.

d2l.Tools.Grades.GradingSystem

Org

Points

Indicates the type of grading system that is being used: Weight, Points, or Formula.

d2l.Tools.Grades.
HasAdjustedFinalGrade

OrgUnit

ON

Determines if the Grades tool provides the ability to enter a final adjusted grade in addition to the final calculated grade that the tool determines based on the grade book setup.

d2l.Tools.Grades.Import.
CreateNewItemUnrecognized

OrgUnit

OFF

The default value of the option for creating new grade items when an unrecognized item is referenced on import.

d2l.Tools.Grades.Import
.NumRecordsPerImportStep

OrgUnit

10000

Sets the number of records imported in each batch.

d2l.Tools.Grades.
IncludeEmptyGradesInFinal

Org

OFF

Includes grade items with no grade in the final grade calculation.

d2l.Tools.Grades.
MaxRecordProcessingCount

Org

20

Sets the number of records processed at one time during a recalculation.

d2l.Tools.Grades.MyGrades.
ControlDecimalPlaces

OrgUnit

2

Sets the number of decimal places to display on my grades view page.

d2l.Tools.Grades.MyGrades.
NumbCharsToDisplay

OrgUnit

50

Determines the number of characters to display in my grades for text grade items.

d2l.Tools.Grades.MyGrades.
ShowFinalAverage

OrgUnit

OFF

Determines whether the average final grade is released to users.

d2l.Tools.Grades.MyGrades.
ShowFinalDistribution

OrgUnit

OFF

Determines whether the final grade distribution is released to users.

d2l.Tools.Grades.MyGrades.
ShowFinalGradeFormula

OrgUnit

OFF

Show the final grade calculation formula in my grades.

d2l.Tools.Grades.MyGrades.
ShowGradeColours

OrgUnit

OFF

Determines whether the color associated with a grade scheme range is displayed for grade items in my grades.

d2l.Tools.Grades.MyGrades.
ShowGradeScheme

OrgUnit

ON

Determines whether the symbol associated with a grade scheme range is displayed for grade items in my grades.

d2l.Tools.Grades.MyGrades.
ShowPoints

OrgUnit

OFF

Determines whether the points grade a user achieved on a grade item displays to that user.

d2l.Tools.Grades.MyGrades.
ShowWeighted

OrgUnit

ON

Determines whether the weighted grade a user achieved on a grade item displays.

d2l.Tools.Grades.
NewItemsDisplayAverage

OrgUnit

OFF

The default value of the display class average to users setting for new grade items.

d2l.Tools.Grades.
NewItemsDisplayDistribution

OrgUnit

OFF

The default value of the display grade distribution to users setting for new grade items.

d2l.Tools.Grades.SetupWizard

Org

ON

Determines whether the Setup Wizard is available or not.

d2l.Tools.Grades.
ShowFormulaGradeItemType

Org

ON

Indicates whether the Formula grade item type is available in the Grade book.

d2l.Tools.Grades.
ShowFormulaSystemOption

Org

ON

Indicates whether the Formula Grading System is available in the Grade book.

d2l.Tools.Grades.
ShowStatusIconsOnStandardView

OrgUnit

ON

Determines whether the Submission Status Icons display in Standard View.

d2l.Tools.Grades.Import.ProcessTxtFileAs Org Comma Determines how text files are imported into the grade book, as either comma delimited or tab delimited files.