LogoLogo
  • ManageBac OneRoster 1.2 CSV Custom Specification
  • User Guide
  • CSV_Files
    • academicSessions.csv
    • classes.csv
    • courses.csv
    • demographics.csv
    • enrollments.csv
    • manifest.csv
    • orgs.csv
    • roles.csv
    • users.csv
  • Messages
    • Errors
    • Warnings
Powered by GitBook
On this page
  • Navigation
  • Overview
  • Import Validations
  • File format
  • Universal Row-level Validations
  • Universal Mappings

Was this helpful?

Export as PDF

ManageBac OneRoster 1.2 CSV Custom Specification

NextUser Guide

Last updated 9 days ago

Was this helpful?

Navigation

  • Custom Specification for:

Overview

ManageBac's support of OneRoster 1.2 is implemented via a custom specification. ManageBac exports and imports records by adopting OneRoster extensions. The special handling is necessary due to differences in the data model provided by the base OneRoster specification and ManageBac's functional requirements.

Due to this requirement, exports from source systems using the base OneRoster specification will require additional transformations or adjustments to the source data. To request that a source system, such as an MIS or SIS, export in ManageBac's custom specification, please contact the vendor.

This document will describe this custom specification by explaining the additional validations, required columns, and formatting required by ManageBac. This custom OneRoster specification is coined "ManageBac OneRoster Dialect" or "MB OR Dialect" for short.

Import Validations

The custom OneRoster specification validates the contents of the file according to requirements of ManageBac's data model.

File format

ManageBac accepts zip archives that must contain the following file:

  • manifest.csv

The following files are not strictly required. If no such records for a given entity are to be included, the file associated with that entity can be optionally marked "absent" in the manifest. Otherwise, when marked "present", the file is required to be present in the archive:

  • academicSessions.csv

  • orgs.csv

  • courses.csv

  • classes.csv

  • roles.csv

  • users.csv

  • enrollments.csv

  • demographics.csv

The zip archive must have the ".zip" extension and the .csv files contain ordered columns. An empty file must still contain the requisite columns. For the required columns for each entity, see the respective details.

Universal Row-level Validations

ManageBac processes every row and every file with the following commmon validations:

  • Every row must have a non-blank sourcedId and is unique across all the files

  • In delta mode, dateLastModified is included and non-blank and is a date

  • In delta mode, status is included and non-blank, and is either "active" or "tobedeleted"

  • In bulk mode, dateLastModified and status are included and values are blank

  • All dates values must be in ISO 8601 format

Additional row-level validations that apply to specific files are enumerated in the respective area under the heading "Import Validations."

Universal Mappings

In OneRoster there are two entities that have grade properties: students and classes.

The OneRoster grade property corresponds to ManageBac's core grade entity, which is found in the frontend in the table Settings > Schools Settings: Grades & Labels (Y axis).

The tables below indicate how this grade information corresponds to each other. Note that the "MB Core grade label" refers to an annotation in the table, and not the string used to represent the student's grade on their profiles.

On Import

OneRoster
MB core grade
MB core grade label

IT

n/a

n/a

PR

-2

Pre-K2

PK

-1

Pre-K3

TK

0

Pre-K4

KG

1

Kindergarten

01

2

Grade 1

02

3

Grade 2

03

4

Grade 3

04

5

Grade 4

05

6

Grade 5

06

7

Grade 6

07

8

Grade 7

08

9

Grade 8

09

10

Grade 9

10

11

Grade 10

11

12

Grade 11

12

13

Grade 12

On Export

MB core grade
OneRoster

-2

PR

-1

PK

0

TK

1

KG

2

01

3

02

4

03

5

04

6

05

7

06

8

07

9

08

10

09

11

10

12

11

13

12

The formal specification for base OneRoster CSV Binding is .

Data Exchange User Guide
Manifest
Organizations
Academic Sessions
Courses
Classes
Users
Roles
Enrollments
hosted by IMS Global
Grade Mappings