用來將紀錄輸入 Apple School Manager 的範本資料
Apple 提供六種範本,供你將資料加入位置時使用:
學生:載有學生帳户資料
職員:載有職員(例如教師)帳户資料
課程:載有課程定義
班級:載有課程及教師(職員)資料
名單:載有班級、學生和位置資料
位置:載有位置資料
範本和管理式 Apple ID
如果選填欄位(例如 person_number 或 sis_username)是你管理式 Apple ID 格式的一部分,則會成為必填欄位。如果你將其留空,SFTP 上載將會失敗,並顯示錯誤 MANAGED_ID_GENERATION_FAILED。
準備範本
準備範本時須符合以下條件:
在 students.csv 和 staff.csv 範本中,person_id 必須在所有位置都是獨一無二。
重要事項:如果你使用 SFTP 上載新用户,同時你分派的 person_id 已分派給其他用户,則新用户會覆寫 Apple School Manager 中的現有用户。覆寫完成後,你只能透過 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 |