輸入記錄至 Apple 校務管理的範本資訊
Apple 提供六種範本,供您將資料新增至位置時使用:
學生 (Students):包含學生帳號的資訊。
職員 (Staff):包含職員帳號的資訊,例如教師。
課程 (Courses):課程定義內容。
班級 (Classes):包含課程、教師(職員)的資訊。
名冊 (Rosters):包含班級、學生和位置的資訊。
位置 (Locations):包含位置的資訊。
範本和管理式 Apple ID
如果你的管理式 Apple ID 格式包含 person_number 或 sis_username 等選填欄位,該欄位將變成必填欄位。如果你將欄位留空,SFTP 將上傳失敗,並發生ANAGED_ID_GENERATION_FAILED」錯誤。
準備範本
製作範本時,必須符合以下條件:
在 students.csv 和 staff.csv 範本中,person_id 必須在所有位置都是獨一無二。
【重要事項】如果你使用 SFTP 上傳新的使用者,且你指派的 person_id 已經指派至其他使用者,新的使用者會覆寫 Apple 校務管理中的現有使用者。覆寫完成後,你只能透過 SFTP 更新該使用者。
若您要編輯範本,請用您的資料取代範例資料。請勿變更每個檔案中標題列的內容,也勿在任何檔案內建立重複直欄。你可以為特定範本新增直欄。
在所有範本中,每一列必須代表一個獨有值。例如,students.csv 檔案中,每一列須為某一特定學生。該學生的某些值可以為空白。文字值,如名稱中的斷行標記或引號,必須以反斜線 (\) 跳脫,例如:\"。輸入的任何識別碼須為英數字元,可包含連字號 (-)。
若您的值包含空格 ( ) 或逗號 (,),請在前後加上半形引號 (")。若您的值未包含這些任何特殊字元,請不要使用引號。若您沒有在必要的位置使用引號,或您使用的是彎曲引號,上傳過程會出現錯誤。
無論您以何種方式建立檔案,檔案中的值都必須以逗號 (,) 或分號 (;) 分隔。請勿在逗號或分號與下個值間使用空白鍵或 tab 鍵。每個檔案皆必須編碼為 UTF-8。請使用 UNIX 換行編碼 \n 代表行尾。
如果缺少稍早上傳的項目,帳號將會停用並於 120 天後自動刪除,除非該帳號已採購大量內容。
CSV 檔案名稱必須完全符合原始檔案名稱。
所有檔案必須壓縮成一個 ZIP 封存檔,才能上傳。
檔案不能放在 ZIP 封存檔中的檔案夾內。
其他參考到 CSV 檔案的所有外部索引鍵必須在被參考的檔案中加以定義。
CSV 範本的字元限制
CSV 範本中的部分欄位針對允許的字元數設有限制。
欄位 | 範本 | 字元限制 |
---|---|---|
first_name | 學生、職員 | 32 |
middle_name | 學生、職員 | 32 |
last_name | 學生、職員 | 64 |
grade_level | 學生 | 64 |
email_address | 學生 | 256 |
person_number | 學生、職員 | 64 |
person_id | 學生、職員、班級、名冊 | 256 |
sis_username | 學生、職員 | 256 |
class_id | 班級、名冊 | 256 |
class_number | 班級 | 64 |
course_id | 課程、班級 | 256 |
course_name | 課程 | 128 |
course_number | 課程 | 64 |
location_name | 位置 | 256 |
location_id | 學生、職員、課程、班級、位置 | 256 |