輸入資料至 Apple 校務管理的範本資訊
若要將資料新增至「Apple 校務管理」，你可以使用 Apple 或 OneRoster 格式的 .csv 範本檔案。
Apple .csv 範本名稱：學生、職員、課程、班級、名冊、地點
OneRoster .csv 範本名稱：使用者、課程、班級、註冊、機構
Apple 檔案名稱 | OneRoster 檔案名稱 | 內容 | |||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
Apple：包含學生帳號的資訊。 OneRoster：包含學生、教師和職員帳號的資訊。 | |||||||||||
不適用 | 包含職員帳號的資訊，例如教師。 | ||||||||||
包含課程資訊。 | |||||||||||
包含班級和教師（職員）的資訊。 | |||||||||||
包含班級、學生和位置（名冊）的資訊。 | |||||||||||
包含位置（學校或系所）資訊。 | |||||||||||
範本和管理式 Apple 帳號
如果你的管理式 Apple 帳號格式包含 person_number 或 sis_username 等選填欄位，該欄位將變成必填欄位。如果你將欄位留空，SFTP 將上傳失敗，並發生「MANAGED_ID_GENERATION_FAILED」錯誤。
準備範本
製作範本時，必須符合以下條件：
在 students.csv 和 staff.csv 範本中，person_id 必須在所有位置都是獨一無二。
【重要事項】如果你使用 SFTP 上傳新的使用者，且你指派的 person_id 已經指派至其他使用者，新的使用者會覆寫 Apple 校務管理中的現有使用者。覆寫完成後，你只能透過 SFTP 更新該使用者。
若要編輯範本，請用你的資料取代範例資料。請勿變更每個檔案中標題列的內容，也不要在任何檔案內建立重複直欄。你可以為特定範本新增直欄。
在所有範本中，每一列必須代表一個獨有值。例如，students.csv 檔案中，每一列須為某一特定學生。該學生的某些值可以為空白。文字值，如名稱中的斷行標記或引號，必須以反斜線 (\) 跳脫，例如：\"。輸入的任何識別碼須為英數字元，可包含連字號 (-)。
若值包含空格 ( ) 或逗號 (,)，請在前後加上半形引號 (")。若值未包含這些任何特殊字元，請不要使用引號。若沒有在必要的位置使用引號，或使用彎曲引號，上傳過程會出現錯誤。
無論以何種方式建立檔案，檔案中的值都必須以逗號 (,) 或分號 (;) 分隔。請勿在逗號或分號與下個值間使用空白鍵或 tab 鍵。每個檔案皆必須編碼為 UTF-8。請使用 UNIX 換行編碼 \n 代表行尾。
若先前上傳的項目有缺漏，會將使用者帳號停用並在 120 天後自動刪除，除非：
使用者因職務關係購買了大量 App 或書籍
使用者在 120 天的限制內遭手動刪除
CSV 檔案名稱必須完全符合原始檔案名稱。
所有檔案必須壓縮成一個 ZIP 封存檔，才能上傳。
檔案不能放在 ZIP 封存檔中的檔案夾內。
其他參考到 CSV 檔案的所有外部索引鍵必須在被參考的檔案中加以定義。
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 |