Use SOCS Calendar Events and Music Lessons

SOCS calendar events appear as normal Schoolbox calendar events.

• Events are read-only in Schoolbox.
• Event visibility is based on the campus matched from the SOCS School or Schools values.
• Events use the configured Default Calendar Category.

If no matching campus is found, the event will not appear in Schoolbox.

Refresh timing and date windows

General calendar events are retrieved on demand when calendar data is requested, with responses cached for 20 minutes. Schoolbox requests the date range being loaded in the calendar.

The 20-minute cache is not a background sync schedule. The next request after the cached response expires fetches fresh data. External calendar applications may have their own refresh schedules.

SOCS music lessons appear as normal Schoolbox calendar events.

Music lessons match staffid to a Schoolbox staff user and pupilid (also accepted as studentid) to a Schoolbox student user, using the user’s External ID. Matching does not use names or email addresses and checks the corresponding student/staff role.

A lesson is visible only when the user whose calendar is being viewed matches the lesson’s student or staff member. A missing match for one participant does not prevent the lesson appearing for the other matched participant.

Refresh timing and date windows

Music lessons are retrieved on demand, with responses cached for 20 minutes. Schoolbox does not send a date window to SOCS for this feed. It retrieves the lessons SOCS returns and filters them locally to the requested calendar range. The available date coverage therefore depends on the SOCS response.

The 20-minute cache is not a background sync schedule. The next request after the cached response expires fetches fresh data. External calendar applications may have their own refresh schedules.

SOCS calendar events and music lessons use Schoolbox calendar categories.

• Calendar events use the configured Default Calendar Category.
• The SOCS Category field is not used to select the Schoolbox calendar category.
• Music lessons use the configured Default Music Lesson Category.

SOCS calendar events and music lessons can display event details in Schoolbox.

• Title
• Date and time
• Location
• Description or notes
• Linked staff and student names, where available

Event times are treated as local school time. Calendar events whose start time is All Day or tbc are displayed as all-day events. If only the end time is tbc, Schoolbox uses the start time as the end time.