用來將資料輸入 Apple School Manager 的範本資料
如要將資料加到 Apple School Manager，你可以使用 Apple 格式或 OneRoster 格式的 .csv 範本檔案。
Apple .csv 範本名稱：學生、職員、課程、班級、名單、位置
OneRoster .csv 範本名稱：用户、課程、班級、註冊、機構
Apple 檔案名稱 | OneRoster 檔案名稱 | 內容 | |||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
Apple：載有學生帳户資料。 OneRoster：載有學生、教師和職員帳户資料。 | |||||||||||
不適用 | 載有職員（例如教師）帳户資料。 | ||||||||||
載有課程資料。 | |||||||||||
載有班級和教師（職員）資料。 | |||||||||||
載有班級、學生和位置（名單）資料。 | |||||||||||
載有位置（學校或學系）資料。 | |||||||||||
範本和管理式 Apple 帳户
如果選填欄位 (例如 person_number 或 sis_username) 是你管理式 Apple 帳户格式的一部分，則會成為必填欄位。如果你將其留空，SFTP 上載將會失敗，並顯示錯誤 MANAGED_ID_GENERATION_FAILED。
準備範本
準備範本時須符合以下條件：
結構
.csv 檔案名稱必須與本來的檔案名稱完全相同。
請勿更改任何檔案的標題列名稱。
即使直欄為空，也請勿將其刪除。
在所有範本中，每一列必須代表一個獨有值。例如，在 students.csv 檔案，每一列上的學生不可在其他列重複出現。
在 students.csv 和 staff.csv 範本中，person_id 必須在所有位置都是獨一無二。
重要事項：如果你使用 SFTP 上載新用户，同時你分派的 person_id 已分派給其他用户，則新用户會覆寫 Apple School Manager 中的現有用户。覆寫完成後，你只能透過 SFTP 更新該用户。
某些值可以為空。例如，在 students.csv 檔案中，中間名可以為空。
使用你自己的資料取代範例資料。
格式化
文字值，如名稱中的斷行標記或引號，必須避開反斜線 (\)。以下為範例：\"。任何輸入的識別碼須為英數字元，可包含連字號 (-)。
如輸入值包含空格 ( ) 或逗號 (,)，前後請加上半形引號 (")。如輸入值不含任何特殊字元，請勿使用引號。如你在不需要時使用引號，或使用彎曲引號，上載過程將會出錯。
無論以甚麼方式建立檔案，檔案中的值都必須以逗號 (,) 或分號 (;) 分隔。在逗號或分號與下一個值之間，不要使用空白鍵或 tab 鍵。檔案必須以 UTF-8 編碼。請使用 UNIX 換行編碼 \n 代表行尾。
其他 .csv 檔案的所有外部索引鍵參考資料都必須在參考的檔案中定義。
上傳中
如果缺少早前上載的項目，用户帳户將會停用並於 120 天後自動刪除，除非：
用户具有已購買大量 App 或書籍的職務
用户在 120 天限制之前被手動刪除。
所有檔案必須壓縮成一個 .zip 封存檔，才能上載。
ZIP 封存檔內的檔案不能放在任何資料夾內。
.csv 範本的字元限制
.csv 範本部分欄位有字元數量限制。
屬性名稱 | 範本 | 字元限制 |
|---|---|---|
Apple：first_name OneRoster：givenName | Apple：學生、職員 OneRoster：用户 | 32 |
Apple：middle_name OneRoster：middleName | Apple：學生、職員 OneRoster：用户 | 32 |
Apple：last_name OneRoster：familyName | Apple：學生、職員 OneRoster：用户 | 64 |
Apple：grade_level OneRoster：grades | Apple：學生 OneRoster：用户 | 64 |
Apple：email_address OneRoster：email | Apple：學生 OneRoster：用户 | 256 |
Apple：person_number OneRoster：identifier | Apple：學生、職員 OneRoster：用户 | 64 |
Apple：person_id OneRoster：sourcedId | Apple：學生、職員、班級、名單 OneRoster：用户、班級、註冊 | 256 |
Apple：sis_username OneRoster：username | Apple：學生、職員 OneRoster：用户 | 256 |
Apple：class_id OneRoster：sourcedID | Apple：班級、名單 OneRoster：班級、註冊 | 256 |
Apple：class_number OneRoster：classCode | Apple：學生、班級 OneRoster：班級 | 64 |
Apple：course_id OneRoster：sourcedID | Apple：課程、班級 OneRoster：課程、班級 | 256 |
Apple：course_name OneRoster：title | Apple：課程 OneRoster：課程 | 128 |
Apple：course_number OneRoster：courseCode | Apple：課程 OneRoster：課程 | 64 |
Apple：location_name OneRoster：name | Apple：位置 OneRoster：機構 | 256 |
Apple：location_id OneRoster：sourcedID | Apple：學生、職員、課程、班級、位置 OneRoster：用户、課程、班級、機構 | 256 |