OneRoster /students - One school has "grades" array, another doesn't

Eric Eskildsen

Hi all,

Does anyone know how to get this nice handy grades array in the OneRoster /students endpoint response?

One school has it….Most that I work with don't.

Everybody has metadata.grade, but that uses the school's grade description. The nice thing about the grades array is that it returns plain numbers, even though they're strings.

For example, some schools call their eighth grade “Eighth Grade”, and that comes through in metadata.grade. But the grades array seems to use numbers regardless.

Here's the array in question. This school has it.

Here's another school. They don't have a grades array.

The OneRoster provider setting doesn't seem to affect this. Neither does the OneRoster version (1 vs. 2). I've tried creating connections with the Standard provider, the Canvas provider, the Schoology provider, etc., but none of them have the grades array for a school that doesn't currently have it.

Eric Eskildsen

Hi @Eric Eskildsen,

You need to set up Integration mappings for Grade levels. (Yes, I discovered this a few minutes after posting. )

The grades property is only present for students in mapped grades.

Integration mappings are under Core (1) > Settings (2) > Integration mappings (3).

The page shows the school's list of grades.

These are grades that the school has set up. Blackbaud doesn't know how they correspond to standard OneRoster grades. You have to tell it that yourself.

To tell it, click the pencil icon next to each grade that can be mapped to a standard OneRoster grade.

Select the OneRoster grade to map it to in the dropdown. Then click Save.

Students in mapped grades will now have the grades property in OneRoster.

Todd DeSchuiteneer

Hi @Eric Eskildsen, here is a knowledge base article for you to share with any schools on how to get to that mapping task if needed: