使用 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. 如果你是首次登入,「設定輔助程式」就會出現。如果「設定輔助程式」沒有出現,請按一下右上角你的名稱。選擇 Setup Assistant (設定輔助程式)。
  3. 按一下「尋找學生、職員和班級」。
  4. 按一下 Set Up SFTP (設定 SFTP)。
  5. Apple School Manager 會產生網址、使用者名稱和密碼,讓你上載檔案時使用。請使用這些資料設定 SFTP 用戶端。
  6. 按一下 Download Templates (下載範本)。
  7. 請參閱「填寫資料檔案」部分的範本使用說明。
  8. 填寫資料檔案後,請建立含全部六個檔案的 zip 封存檔。在 Finder 中,你可以選擇檔案,然後前往 File (檔案) 選單,並選擇 Compress 6 Items (壓縮 6 個項目)。Zip 封存檔並無命名準則。
  9. 將 zip 檔上載至 Apple School Manager。使用 SFTP 用戶端連線至「設定輔助程式」顯示的網址。如果系統要求輸入登入資料,請輸入你點擊 Set Up SFTP (設定 SFTP) 時收到的使用者名稱和密碼。將 zip 檔複製至 dropbox 目錄。
  10. 在「設定輔助程式」按一下 Continue (繼續)。如果上載項目有誤,系統記錄會顯示有錯誤的檔案和行數。請修正資料檔案的任何錯誤,然後重複步驟 8 和 9。你毋須從 SFTP 伺服器移除之前的檔案。
  11. SFTP 輸入完成時,請按一下 Review SFTP Data (檢視 SFTP 資料)。如果發現任何錯誤,請按一下 Cancel (取消)。修正資料檔案中的任何錯誤,然後重複上載程序。如果資料準確且完整,請按一下 Continue (繼續)。
  12. 在 Create Accounts and Classes (建立帳戶和班級) 下,選擇學生、教師和職員的受管理 Apple ID 格式。按一下「預覽帳户和班級」。若 ID 格式正確,請按一下 Create Accounts and Classes (建立帳戶和班級)。
  13. 建立帳戶後,請將登入資料分發給使用者,並為職員指派職務。

填寫資料檔案

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

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

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

設定值的格式

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

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

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

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

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

Locations (位置) 檔案

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

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

Students (學生) 檔案

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

 

person_id

特定學生的唯一識別碼。此 person_id 應與 SIS 中的唯一識別碼 (如有) 相符。此 person_id 是學生在 Apple School Manager 中的唯一識別碼,你可使用此值在 Rosters (名單) 檔案中參照學生,以及在 Classes (班級) 檔案中參照教師。 

必填
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。此值必須與 Locations (位置) 檔案中的 location_id 對應。如果與 Locations 檔案中的輸入內容不符,會導致上載程序出錯。 必填

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

指定多個位置

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

Staff (職員) 檔案

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

person_id

特定職員的唯一識別碼。此 person_id 應與 SIS 中的唯一識別碼 (如有) 相符。此 person_id 是職員在 Apple School Manager 中的唯一識別碼。此值可在 Classes (班級) 檔案中用於參照教師。 

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

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

指定多個位置

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

Courses (課程) 檔案

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

Classes (班級) 檔案

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

指定多位教師

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

Rosters (名單) 檔案

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

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

更新檔案

如要新增或編輯學生、職員和班級,請編輯資料檔案並上載新副本。上載檔案時,你必須將六個檔案全部上載。每個檔案必須包含各個類別的完整列表,而非只有你打算新增的項目。

首次上載後,系統會在你上載時自動建立新的帳戶和班級。如果之前上載的輸入內容遺失,Apple School Manager 就會停用有關內容。如有任何錯誤,Apple School Manager 會傳送電郵給你。

發佈日期: