Update Matches By Name: Adds item on first pass and updates based on match by content item title during subsequent imports.

Gradable Item Provisioning Check - This setting defines the matching rule for provisioned manual grade columns or grade columns created as a result of the provisioned content items. The options are:

Update Matches By Name: Adds items on first pass and updates them based on match by content item title during subsequent imports.

Update Matches By Metadata: Adds items on first pass and updates them based on match of the value stored in a metadata attribute called "Type" included in the optional data list of the item input data record during subsequent imports.

Result Transfer Settings, File Format, and Grade Column Settings do not apply to REST.

Grade extract settings (outgoing data)

CRON Schedule - Choose how often the background extracts occur. For example, the extracts occur each hour with this value set to 0 0/60 * 1/1 * ? *

Rounding Number - Choose the maximum number of fractional digits for a score.

Extract Value for Unmarked Assessments - Choose the null value you want to unmarked or ungraded items to return.

Column Filter - Select this option if the approval and extract columns list should be limited to a specified comma separated list of grade column names when provisioning is disabled. The purpose of this setting is to allow the extract to contain only those columns that need to be reported.

External Grade Column Only - Select this option if the approval and extract columns list should be limited to course external grade column, that is, the column in grade center marked as External Grade.

This setting takes precedence over the Column Filter setting.

Provisioning Enabled - Select this setting if the approval and extract columns list should be limited to those imported as part of the Content Item and Gradable Item provisioned from SIS.

Column Mapping - Enter a list of name/value pairs separated by a pipe symbol to identify the grade column data fields to include for each record in the report. If left empty, a default list of fields is included in the report:EXTERNAL_COURSE_KEY|STUDENT_ID|BATCH_UID|TITLE|MARK|GRADE|EXTENDED_DATA

Extract Course Role Requirement

Course Roles - Specify the course role required for a user to be able to approve grades (i.e. instructor).

Institutional Roles - Specify the institutional role required for a user to be able to approve grades (i.e. grade approver).

Access Denied Message - Enter a message for users who attempt to extract grades but do not have appropriate permission.

Result Transfer Settings

PostWebservice Endpoint - Specify the endpoint for the grades post.

TestingRestWebservice Endpoint - Ignore this setting (generally).

REST (Outgoing) Security Settings

Enable Secure REST API - Enable this setting if the endpoint will implement the security. If enabled, also set:

Shared Secret - Enter the shared key.

API Key - Enter the API key.

Timestamp Range - Do not set.

Timestamp Parameter - Enter the parameter for the timestamp.

MAC Parameter - Enter the MAC parameter.

API Key Parameter - Enter the API key parameter.

Grade Approval and Transfer Settings

Grade Approval Required - Enable this setting if you want grades to be approved at the column or grade level.

Show History Page? - Enable this setting if you do not want grade-level approval and want the history page shown when you extract from the course.

Perform Extract Button Enabled? - Enable this setting to allow graders to run the extract immediately.

Notification settings

REST API security settings (incoming data security)

Enable Secure REST API - Enable this setting if the incoming endpoints will implement the security.

IP Filter - Enable the filter for any incoming IPs. If this setting is enabled, also set:

Shared Secret - Enter the shared key.

API Key - Enter the API key.

Timestamp Range - Do not set.

Timestamp Parameter - Enter the parameter for the timestamp.

MAC Parameter - Enter the MAC parameter.

API Key Parameter - Enter the API key parameter.

When finished, select Submit.

Logging levels

Configure the following properties:

Logging Configuration

Log Verbosity - Configure this setting to determine the level of logging to the /logs/custom/bbc-GradeyJourney.log file. The default value is INFO, but you may want to add DEBUG for troubleshooting purposes. Production configuration should be set to INFO unless debugging.

Run a validation test

Navigate to System Admin > Grades Extract Settings (Outgoing Data).

Update the transfer method to Local and set the path to a local folder that can be read, updated, and deleted from the user running Blackboard Learn. Choose SITS Integration based on your needs. Select Submit.