使用 SFTP 將學生、職員和班級資料上載至 Apple School Manager

如果 Apple School Manager 不支援你的學生資料系統 (SIS),或是你沒有學生資料系統,可以使用 SFTP 將學生、職員和班級資料上載至 Apple School Manager。

在「設定輔助程式」中設定 SFTP 時,Apple School Manager 會提供 CSV 範本檔案和專用 SFTP 伺服器的存取資料。你可以從 SIS 輸出資料,或在試算表應用程式 (例如 Numbers) 中建立檔案。

SFTP 在 macOS 中上載資料時需使用第三方應用程式。如果你尚未安裝 SFTP 用戶端,可以在 Mac App Store 中搜尋。

如需設定 SFTP 檔案的相關說明,請使用下列按鈕。如果你未曾使用 SFTP 上載資料到 Apple School Manager,請從先「設定第一次 SFTP 上載」一節開始。

設定第一次 SFTP 上載

  1. 以管理員、網站管理人員或用戶管理人員身分登入 Apple School Manager。
  2. 如果你是首次登入,系統便會顯示「設定輔助程式」。如果「設定輔助程式」沒有出現,請按一下右上角你的名稱。選擇「設定輔助程式」。
  3. 按一下「尋找學生、職員和班級」。
  4. 按一下「設定 SFTP」。
  5. Apple School Manager 會產生網址、使用者名稱和密碼,以供上載檔案之用。請使用這些資料設定 SFTP 用戶端。
  6. 按一下「下載範本」。
  7. 請參閱「填寫資料檔案」一節的範本使用說明。
  8. 填寫資料檔案後,請就全部六個檔案建立 zip 壓縮檔。你可在 Finder 中選取檔案,然後前往「檔案」選單,並選擇「壓縮 6 個項目」。Zip 壓縮檔並無命名準則。
  9. 將 zip 檔上載至 Apple School Manager。使用 SFTP 用戶端連線至「設定輔助程式」顯示的網址。如果系統要求輸入登入資料,請輸入你在點擊「設定 SFTP」時收到的使用者名稱和密碼。將 zip 檔複製至 dropbox 目錄。
  10. 在「設定輔助程式」中按一下「繼續」。如果上載資料有誤,系統記錄便會顯示出錯檔案和行數。請修正資料檔案的任何錯誤,然後重複步驟 8 和 9。你毋須從 SFTP 伺服器移除之前的檔案。
  11. 在 SFTP 完成輸入資料後,請按一下「檢視 SFTP 資料」。如有發現任何錯誤,請按一下「取消」。修正資料檔案中的任何錯誤,然後重複上載程序。如果資料準確且齊備,請按一下「繼續」。
  12. 在「建立帳戶和班級」下方,選擇學生、教師和職員的「管理式 Apple ID」格式。按一下「預覽帳户和班級」。若 ID 格式正確,請按一下「建立帳戶和班級」。
  13. 建立帳戶後,請向使用者轉發登入資料,並為職員指派職務。

填寫資料檔案

範本下載項目包含「班級」、「課程」、「位置」、「名單」、「學生」和「職員」的六個逗號分隔值 (CSV) 檔案。如果在 Apple School Manager 上找不到範本,或遺失原始範本副本,你可按此重新下載

你可以使用 SIS 按範本和本文所述的格式輸出資料,或在試算表程式 (例如 Numbers) 中編輯範本。

請參照本文的表格確認輸入的資料正確無誤,然後儲存每個檔案,但不要更改名稱。

設定值的格式

編輯範本時,請將範例資料換成你的個人資料。請勿更改各檔案的標題輸入格內容。除下述情況外,請勿在任何檔案中加入直欄。

在每個範本中,每列必須代表一個獨特的值。例如,在 students.csv 中,每一列都必須是不重複的學生,但學生的某些值可以留空。字元值 (例如姓名內的換行或引號字元) 必須加上反斜線 (\) 使其不具效力,例如 (\”)。輸入的任何識別碼必須為英數字元,並可包含「-」。

如果你的值包含空格 ( ) 或逗號 (,),請放在直引號 (") 之內。如果你的值不含任何這些特殊字元,則不必使用引號。如你未有在必要位置上使用引號,或使用了彎引號,便會導致上載程序出錯。

無論你以哪種方式建立檔案,檔案中的值都必須以逗號 (,) 或分號 (;) 隔開。請勿在逗號或分號和下一個值之間插入空格或定位字元。每個檔案都必須採用 UTF-8 編碼格式,並使用 Unix 換行符號 (\n)。 

如果其他選填欄位 (如 person_number 或 sis_username) 也屬於管理式 Apple ID 格式,該欄位就成為必填欄位。如果留空,便會上載失敗並顯示 MANAGED_ID_GENERATION_FAILED 的錯誤提示。

「位置」檔案

location_id 由不含空格的數字和/或字母組成的獨特識別碼。 必填
location_name 位置的名稱。  必填

你必須在「位置」檔案中界定至少一個位置。你不能使用 SFTP 在主要的「總部」位置中建立學生或職員帳戶。

「學生」檔案

如你使用 SFTP 上載新人員,而你指派的 person_id 已用於 Apple School Manager,新人員便會覆寫現有的 Apple School Manager 使用者。覆寫完成後,你只能透過 SFTP 更新該使用者。 

 

person_id

特定學生的唯一識別碼。此 person_id 應與 SIS 中的唯一識別碼(如果有的話)相符。person_id 是學生在 Apple School Manager 中的唯一識別碼。此值可以用於指代「名單」檔案中的學生及「班級」檔案中的教師。 

必填
person_number 或有另一個值可以用作識別學校學生,譬如學生識別號碼。  選填
first_name 學生的名字。 必填
middle_name 學生的中間名。 選填
last_name 學生的姓氏。 必填
grade_level 學生的年級。 選填
email_address* 學生的電郵地址。 選填
sis_username SIS 中的學生使用者名稱。  選填
password_policy 你可在 password_policy 欄位為每個特定學生設立指定密碼規則。password_policy 欄位必須填上 4、6、8 或留空。如選取 8,即表示你選用標準密碼規則 (8 個或以上英數字元)。此值會取代你之前為該學生設定的位置密碼規則和任何密碼規則。如將 password_policy 留空,預設密碼規則便會應用於新學生,現有學生則維持不變。 選填
location_id 學生的 location_id。此值必須對應「位置」檔案中的 location_id。如果輸入值與「位置」檔案中的內容不符,便會導致上載程序出錯。 必填

* 如已啟用 聯合驗證,便需提供電郵地址。如果電郵地址屬於聯合網域,使用者帳戶就會成為聯合網域的一部分。

指定多個位置

只要在「學生」檔案中加入更多位置欄,即可為一個學生指定多個位置。最多可以添加 998 個位置欄,並命名為 location_id_2、location_id_3 如此類推,直至 location_id_999。對於每個學生,你可以選擇在各個位置欄中輸入另一個不同 location_id。此值必須對應「位置」檔案中的 location_id。如果輸入值與「位置」檔案中的內容不符,便會導致上載程序出錯。

「職員」檔案

如你使用 SFTP 上載新人員,而你指派的 person_id 已用於 Apple School Manager,新人員便會覆寫現有的 Apple School Manager 使用者。覆寫完成後,你只能透過 SFTP 更新該使用者。所有職員均採用標準密碼規則 (8 個或以上英數字元)。

person_id

特定職員的唯一識別碼。此 person_id 應與 SIS 中的唯一識別碼 (如果有的話) 相符。person_id 是職員在 Apple School Manager 中的唯一識別碼。此值可以用於指代「班級」檔案中的教師。 

必填
person_number 或有另一個值可以用作識別學校職員,譬如職員證號碼。  選填
first_name 職員的名字。 必填
middle_name 職員的中間名。 選填
last_name 職員的姓氏。 必填
email_address* 職員的電郵地址。  選填
sis_username 職員在 SIS 中的使用者名稱。 選填
location_id 職員的 location_id。此值應該對應「位置」檔案中的 location_id。如果輸入值與「位置」檔案中的內容不符,便會導致上載程序出錯。 必填

* 如已啟用聯合認證,便需提供電郵地址。如果電郵地址屬於聯合網域,使用者帳戶就會成為聯合網域的一部分。

指定多個位置

只要在「職員」檔案中加入更多位置欄,即可為一個職員指定多個位置。最多可以添加 998 個位置欄,並命名為 location_id_2、location_id_3 如此類推,直至 location_id_999。對於每個職員,你可以選擇在各個欄位中輸入另一個不同 location_id。此值必須對應「位置」檔案中的 location_id。如果輸入值與「位置」檔案中的內容不符,便會導致上載程序出錯。

「課程」檔案

course_id 課程的唯一識別碼。此值必須對應「班級」檔案中的相應 course_id。  必填
course_number 課程編號。此值可以是 SIS 或課程指南中的課程編號。 選填
course_name 課程名稱。 選填
location_id 課程的 location_id。此值應該對應「位置」檔案中的 location_id。如果輸入值與「位置」檔案中的內容不符,便會導致上載程序出錯。
必填

「班級」檔案

class_id 班級的唯一識別碼。   必填
class_number 你的機構用於識別班級的號碼或代碼。有別於 class_id,class_number 在 CSV 名單中並非用於指代班級。  選填
course_id 班級所屬課程的 course_id。此值必須對應「課程」檔案中的 course_id。 必填
instructor_id 教師的 person_id。此值必須對應「職員」檔案中的 person_id。 選填
instructor_id_2 教師的 person_id。此值必須對應「職員」檔案中的 person_id。 選填
instructor_id_3 教師的 person_id。此值必須對應「職員」檔案中的 person_id。 選填
location_id 班級的 location_id。此值應該對應「位置」檔案中的 location_id。如果輸入值與「位置」檔案中的內容不符,便會導致上載程序出錯。 必填

指定多位教師

只要在「班級」檔案中加入更多教師欄,即可為一個班級指定多於三位教師。最多可以添加 12 個教師欄,並命名為 instructor_id_4、instructor_id_5 如此類推,直至 instructor_id_15。對於每個班級,你可以選擇為教師輸入另一個 person_id。此值必須對應「職員」檔案中的 person_id。

「名單」檔案

roster_id SIS 或其他課程資料庫 (如有) 中的名單唯一識別碼。  必填
class_id 班級的唯一英數識別碼。此值必須對應「班級」檔案中的 class_id。
必填
student_id 一名學生的 person_id。  必填

你可使用「名單」檔案加入學生至所屬班級。檔案中每一行都必須具備一個獨特的 roster_id,而且只含一個 class_id 和一個 person_id。

更新檔案

如要新增或編輯學生、職員和班級,請編輯資料檔案並上載新副本。上載檔案時,你必須上載全部六個檔案。每個檔案必須包含各個類別的完整列表,而非只是你擬新增的項目。只需選擇「設定」>「數據來源」,即可檢查 SFTP 帳戶資料。

如你意外中斷 Apple School Manager 中的 SFTP 連線,你的帳戶便會改為手動操作並會停用。如欲解決這個問題,只需恢復 SFTP 連線並重新上載,即可重新啟動帳戶,而毋須設立第二個帳戶。

首次上載後,系統便會在上載過程中自動建立新的帳戶和班級。  如有出錯,Apple School Manager 會向你發送電郵。

之前上載的資料如有遺漏輸入值

之前上載的資料如有遺漏輸入值,其來源便會改為 Apple School Manager 的「手動操作」。移除的附加效果或有不同。 如將學生或職員從上傳資料中移除,他們的帳戶會被 停用,並在 30 日後自動刪除 },除非帳戶經已購買大量儲存空間。

如果移除課程或班級

如將課程或班級從上傳資料中移除,學生亦會從有關課程中移除,且來源改為「手動操作」。如果曾在 iTunes U 或 Schoolwork 中使用課程,名單則會遭到移除,並須設立新課程以重新招生。如果曾在 Schoolwork 中使用班級,進度數據則會自動刪除,以致老師或學生無法再次使用有關數據。

附設手動來源的課程和班級繼續與你的 MDM 解決方案同步,但可能不再出現在 Classroom app 中。 你可在 Apple School Manager 中刪除手動課堂,從而取消課堂同步。

發佈日期: