CoursesMigrator#

Import course reserve courses into FOLIO from JSON data files.

When to Use This Task#

Migrating course reserve courses from legacy systems
Setting up course structures before adding reserve items
Importing courses with terms, departments, and instructors

Configuration#

{
    "name": "migrate_courses",
    "migrationTaskType": "CoursesMigrator",
    "courseFile": {
        "file_name": "courses.json"
    }
}

Parameters#

Parameter	Type	Required	Description
`name`	string	Yes	The name of this task.
`migrationTaskType`	string	Yes	Must be `"CoursesMigrator"`
`courseFile`	object	Yes	File definition with `file_name` for the courses JSON file

Source Data Requirements#

Location: Place JSON files in iterations/<iteration>/source_data/courses/
Format: JSON with course data structured for FOLIO’s course reserves API

Course Data Format#

The courses file should contain a JSON array or newline-delimited JSON objects with course data:

{
    "name": "Introduction to Library Science",
    "courseNumber": "LIS 101",
    "sectionName": "Section A",
    "termId": "42093be3-d1e7-4bb6-b2b9-18e153d109b2",
    "departmentId": "7532e5ab-9812-496c-ab77-4fbb6a7e5dbf",
    "courseListingId": "existing-listing-uuid-if-any"
}

Prerequisites#

Ensure the following reference data exists in FOLIO before running:

Terms (/coursereserves/terms) - Academic terms like “Fall 2024”
Departments (/coursereserves/departments) - Academic departments

Output Files#

Files are created in iterations/<iteration>/results/:

File	Description
Report files	Migration statistics and error logs

Examples#

Basic Course Migration#

{
    "name": "migrate_courses",
    "migrationTaskType": "CoursesMigrator",
    "courseFile": {
        "file_name": "courses.json"
    }
}

Running the Task#

folio-migration-tools mapping_files/config.json migrate_courses --base_folder ./

Next Steps#

After migrating courses:

Add Reserves: Use ReservesMigrator to add items to courses

CoursesMigrator

Contents