在 Apple School Manager 使用 OneRoster 註冊範本
透過 SFTP 使用 OneRoster 註冊範本輸入班級名單。機構內，每個 sourcedID 值在所有位置中的 sourcedID 範本及其中的每一列，都必須獨一無二。例如 OneRoster 註冊範本有 600 位學生，便需要 600 列獨一無二的 sourcedID 值、每位學生的 sourcedID 值及與學生相關的班級 sourcedID 值。
此範本也必須包括每個課程的班級 sourcedID 值和最少一個學生 sourcedID 值。如有更多學生，則以橫列新增。例如，10 個學生就有 10 列，每個學生代表一列。
值 | 描述 | 範例 | 必須填寫/唯一 | ||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
sourcedID | SIS 或其他資料庫中用以識別此註冊的獨有編號。 | BE8FF4CC-5BE2-47C6-9C42-6CDADB9072F8 | 是/是 | ||||||||
status | 註冊記錄的狀態。有兩個選項：「有效」或「待刪除」。 | 有效 | 否/否 | ||||||||
dateLastModified | 上次修改此註冊資料的日期。日期必須使用 ISO 8601 格式表示（較常見的格式為 YYYY-MM-DD）。 | 2024-06-26 | 否/否 | ||||||||
classSourcedID | 班級的 sourcedID。 | F9BF05A9-E40B-4CAD-9B4A-2E0C09EDCCC4 | 是/否 | ||||||||
schoolSourcedID | 此班級所屬學校和學系的 sourcedID。 | DF48675-8307-446A-BAA9-EDEA567493D3 | 否/否 | ||||||||
userSourcedID | 班級就讀學生或負責教師的 sourcedID。 | AE4A6BB3-8D97-446A-BAA9-EDEA567453D3 | 是/否 | ||||||||
role | 此成員的角色。有兩個選項：「學生」和「教師」。 | 學生 | 是/否 | ||||||||
primary | 僅適用於角色為「教師」的用户。有兩個選項：「true」和「false」。 在開始日期和結束日期所定義的時段內，只能指定一名用户為班級的主要教師。 | TRUE | 否/否 | ||||||||
beginDate | 註冊的開始日期。此日期必須與為該班級確定的相關學段（學期）一致。 | 22/8/2026 | 否/否 | ||||||||
endDate | 註冊的結束日期（不含當日）。此日期必須與為該班級確定的相關學段（學期）一致。 | 30/5/2027 | 否/否 | ||||||||