使用 SFTP 將學生、職員和班級資料上載至 Apple School Manager
如果 Apple School Manager 不支援你的學生資訊系統 (SIS)，或者你沒有學生資訊系統，你可以使用 SFTP 將學生、職員和班級資料上載至 Apple School Manager。
在「SIS/SFTP 輔助程式」中設定 SFTP 時，Apple School Manager 會提供 CSV 範本檔案和專用 SFTP 伺服器的存取資料。你可以從受支援的 SIS 輸出資料，或在試算表應用程式 (例如 Numbers) 中建立檔案。從 SIS 輸出資料之前，請聯絡 SIS，確認有關格式適用於 Apple School Manager。
SFTP 上載須使用 macOS 上的第三方應用程式。如果你尚未安裝 SFTP 用戶端，可以在 Mac App Store 中搜尋。
如需設定 SFTP 檔案的相關說明，請使用下列按鈕。如果你未曾使用 SFTP 上載資料到 Apple School Manager，請先從「設定第一次 SFTP 上載」一節開始。
設定第一次 SFTP 上載
以管理員、網站管理人員或用戶管理人員身分登入 Apple School Manager。
在側邊欄底部按一下你的名稱，然後按一下「偏好設定」>「帳戶」>「目錄同步」，然後在 SIS/SFTP 部分選擇「啟用」。你必須驗證網域
按一下「尋找學生、教師和班級」。
/locale/zh-hk/2022-asm-sftp-upload-data-setup-assistant-step-3.png)
按一下「設定 SFTP」。
/locale/zh-hk/2022-asm-sftp-upload-data-find-students-staff-classes-step-4.png)
Apple School Manager 會產生網址、使用者名稱和密碼，以供上載檔案之用。請使用這些資料設定 SFTP 用戶端。
/locale/zh-hk/2022-asm-sftp-upload-data-sftp-info-step-5.png)
按一下「下載範本」。
請參閱「填寫資料檔案」一節的範本使用說明。
填寫資料檔案後，請建立含全部六個檔案的 zip 封存檔。你可在 Finder 中選取檔案，然後前往「檔案」選單，並選擇「壓縮 6 個項目」。Zip 封存檔並無命名準則。
將 zip 檔上載至 Apple School Manager。使用 SFTP 用戶端連線至「SIS/SFTP 輔助程式」顯示的網址。如果系統要求輸入登入資料，請輸入你在點擊「設定 SFTP」時收到的使用者名稱和密碼。將 zip 檔複製至 dropbox 目錄。
在「SIS/SFTP 輔助程式」中按一下「繼續」。如果上載資料有誤，你可以檢視記錄檔來找出內含錯誤的檔案和資料行。請修正資料檔案的任何錯誤，然後重複步驟 8 和 9。你毋須從 SFTP 伺服器移除之前的檔案。
在 SFTP 完成輸入資料後，請按一下「檢視 SFTP 資料」。如有發現任何錯誤，請按一下「取消」。修正資料檔案中的任何錯誤，然後重複上載程序。如果資料準確且齊備，請按一下「繼續」。
/locale/zh-hk/2022-asm-sftp-upload-data-review-sftp-data-step-11.png)
在「建立帳戶和班級」下，選擇學生、教師和職員的「管理式 Apple ID」格式。按一下「預覽帳戶和班級」。當 ID 格式正確，請按一下「建立帳戶和班級」。「管理式 Apple ID」格式只可使用經驗證網域
/locale/zh-hk/2022-asm-sftp-upload-data-preview-accounts-step-12.png)
建立帳戶後，請向使用者轉發登入資料，並為職員指派職務。
/locale/zh-hk/2022-asm-sftp-upload-data-done-step-13.png)
填寫資料檔案
範本下載項目包含「班級」、「課程」、「位置」、「名單」、「學生」和「職員」的六個逗號分隔值 (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 會傳送電郵給你。
之前上載的資料如有遺漏輸入值
如果之前上載的資料有遺漏輸入值，帳戶將於 120 天後停用並自動刪除，除非該帳戶已購買批量內容。
如果移除課程或班級
如將課程或班級從上載資料中移除，學生亦會從有關課程中移除，且來源改為「手動操作」。如果曾在「功課」中使用課程，名單會被移除，並須建立新課程以供重新註冊。如果曾在「功課」中使用班級，進度資料則會自動刪除，無法再供老師或學生使用。
來源為手動的課程和班級會繼續與你的 MDM 解決方案同步，但可能不會再出現在「課堂」app 中。你可在 Apple School Manager 中刪除手動課堂，從而取消課堂同步。
對於非 Apple 製造產品，或者並非由 Apple 控制或測試的獨立網站，其相關資訊的提供不應詮釋為受到 Apple 所推薦或認可。Apple 對於第三方網站或產品的選擇、表現或使用，概不承擔任何責任。Apple 對於第三方網站的準確性或可靠性不作任何聲明。如需進一步資料，請聯絡相關供應商。
