使用 SFTP 將學生、職員和班級資料上傳至 Apple 校務管理
如果 Apple 校務管理不支援你的學生資訊系統（SIS），或是你沒有學生資訊系統，可以使用 SFTP 將學生、職員和班級資料上傳至 Apple 校務管理。
在「SIS/SFTP 輔助程式」中設定 SFTP 時，Apple 校務管理會提供你 CSV 範本檔案和專用 SFTP 伺服器的存取資訊。你可以從支援的 SIS 匯出資料，或在試算表應用程式（例如 Numbers）中建立檔案。從 SIS 匯出資料以前，請與 SIS 聯繫，以確保匯出的格式適用於 Apple 校務管理。
SFTP 上傳需要在 macOS 上使用第三方應用程式。如果你尚未安裝 SFTP 用戶端，可以在 Mac App Store 中尋找一個來安裝。
如需設定 SFTP 檔案的相關說明，請使用下列按鈕。如果你尚未使用 SFTP 上傳資料到 Apple 校務管理，請先從「設定第一次 SFTP 上傳」一節開始。
設定第一次 SFTP 上傳
以管理員、機構經理或成員經理身分登入 Apple 校務管理。
在側邊欄底部按一下你的姓名，按一下「偏好設定」，按一下「帳號」，按一下「同步目錄」，然後在「SIS/SFTP」區段中選取「啟用」。你必須先驗證網域
按一下「尋找學生、教師和班級」。
/locale/zh-tw/2022-asm-sftp-upload-data-setup-assistant-step-3.png)
按一下「設定 SFTP」。
/locale/zh-tw/2022-asm-sftp-upload-data-find-students-staff-classes-step-4.png)
Apple 校務管理會產生上傳檔案時需要使用的 URL、使用者名稱和密碼。請使用這些資訊來設定 SFTP 用戶端。
/locale/zh-tw/2022-asm-sftp-upload-data-sftp-info-step-5.png)
按一下「下載樣板」。
請參閱「填寫資料檔案」一節中的樣板使用說明。
填寫完資料檔案後，請建立一個包含所有六個檔案的 Zip 封存檔。在 Finder 中選取這些檔案，然後前往「檔案」選單並選擇「壓縮 6 個項目」。你可以隨意命名這份 Zip 封存檔。
將 Zip 檔上傳至 Apple 校務管理。使用 SFTP 用戶端連線至「SIS/SFTP 輔助程式」中顯示的 URL。若系統詢問登入資訊，請輸入你按一下「設定 SFTP」時收到的使用者名稱和密碼。將 Zip 檔拷貝至 Dropbox 目錄。
在「SIS/SFTP 輔助程式」中按一下「繼續」。如果上傳資料有誤，你可以檢視記錄檔來找出內含錯誤的檔案和資料行。修正資料檔案中的任何錯誤，然後重複步驟 8 和 9。你不需要從 SFTP 伺服器移除先前的檔案。
SFTP 輸入完畢後，請按一下「檢視 SFTP 資料」。如果發現任何錯誤，請按一下「取消」。修正資料檔案中的任何錯誤，然後重複上傳程序。如果資料正確且毫無缺漏，請按一下「繼續」。
/locale/zh-tw/2022-asm-sftp-upload-data-review-sftp-data-step-11.png)
在「建立帳號和班級」下，選擇學生、教師和職員的管理式 Apple ID 格式。按一下「預覽帳號和班級」。如果 ID 格式正確，請按一下「建立帳號和班級」。 管理式 Apple ID 格式只能使用已驗證的網域
/locale/zh-tw/2022-asm-sftp-upload-data-preview-accounts-step-12.png)
帳號建立完成後，請將登入資訊分發給使用者，並為職員指派職務。
/locale/zh-tw/2022-asm-sftp-upload-data-done-step-13.png)
填寫資料檔案
樣板下載包含「班級」、「課程」、「位置」、「名冊」、「學生」和「職員」的六個逗點分隔值（CSV）檔案。如果在 Apple 校務管理中找不到樣板，或是原始樣板遺失，你可以重新下載。
你可以使用 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 校務管理，則新人員將會覆寫 Apple 校務管理中原有的使用者。覆寫完成後，你只能透過 SFTP 更新該使用者。
person_id | 特定學生的唯一識別碼。此 person_id 應與 SIS 中的唯一識別碼（如果有的話）相符。在 Apple 校務管理中，此 person_id 是學生的唯一識別碼，你將使用這個值來表示「名冊」檔中的學生和「班級」檔中的教師。 | 必填 |
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 校務管理，則新人員將會覆寫 Apple 校務管理中原有的使用者。覆寫完成後，你只能透過 SFTP 更新該使用者。所有職員均採用標準密碼規則（8 個以上英數字元）。
person_id | 特定職員的唯一識別碼。此 person_id 應與 SIS 中的唯一識別碼（如果有的話）相符。此 person_id 是職員在 Apple 校務管理中的唯一識別碼。請使用這個值在「班級」檔案中表示教師。 | 必填 |
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 不同的是，在 CSV 名冊中 class_number 並非用來表示此班級。 | 選填 |
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 校務管理內中斷連接 SFTP 連線，則你的帳號和班級會更改為手動。 如要解決此問題，請回復 SFTP 連線並執行新上傳。
第一次上傳之後，新的帳號和班級會在上傳時自動建立。如果出現錯誤，Apple 校務管理將傳送電子郵件給你。
如果缺少先前上傳的項目
如果缺少先前上傳的項目，則該帳號將在 120 天之後停用並自動刪除，除非該帳號已購買大量採購內容。
如果課程或班級遭移除
如果從上傳移除課程或班級，學生也會移出班級，並將來源變更為「手動」。如果「課業」仍在使用課程，則會移除班級名冊，且必須建立新課程以供重新註冊。如果「課業」仍在使用班級，則會自動刪除進度資料，而且不再提供教師或學生使用。
具有手動來源的課程與班級仍會繼續與你的 MDM 解決方案保持同步，但可能不會再出現在「課堂」App 中。如需從同步處理中移除手動班級，可在 Apple 校務管理中刪除手動班級。
對於非 Apple 製造之產品相關資訊，或是非 Apple 控制或測試之獨立網站，不得解釋 Apple 為其推薦或背書。Apple 對於第三方網站或產品的選擇、效能或使用，概不負責。Apple 對於第三方網站的準確性或可靠性不做任何保證。如需其他資訊，請聯絡廠商。
