Q&A: How can we prevent teacher class assignments from being removed during a new school year import if the school administration system does not provide class assignments?

Question:

How can we prevent teacher class assignments from being removed during a new school year import if the school administration system does not provide class assignments?

Answer:

Yes, this can be prevented.

The UCS@school import supports keeping existing class assignments if no new class information is provided during the import. This is useful in scenarios where teacher-to-class assignments are managed manually via the UMC modules instead of being delivered by the external administration system.

To achieve this, set the configuration option school_classes_keep_if_empty to true.

When enabled, the import behaves as follows:

  • If the school_classes field is empty during import,
  • existing class assignments are preserved,
  • and no teacher-class relationships are deleted.

The UCS@school import documentation describes this behavior in the ImportUser.school_classes section.

Relevant documentation: