使用 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 會產生上傳檔案時需要使用的 URL、使用者名稱和密碼。請使用這些資訊來設定 SFTP 用戶端。
  6. 按一下「下載樣板」。
  7. 請參閱「填寫資料檔案」一節中的樣板使用說明。
  8. 填寫完資料檔案後,請建立一個包含所有六個檔案的 Zip 封存檔。在 Finder 中選取這些檔案,然後前往「檔案」選單選擇「壓縮 6 個項目」。您可以隨意命名這份 Zip 封存檔。
  9. 將 Zip 檔上傳至 Apple School Manager。使用 SFTP 用戶端連線至「設定輔助程式」中顯示的 URL。若系統詢問登入資訊,請輸入您按一下「設定 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 中的唯一識別碼(如果有的話)相符。在 Apple School Manager 中,此 person_id 是學生的唯一識別碼,您將使用這個值來表示「名冊」檔中的學生和「班級」檔中的教師。 

必填
person_number 可識別學校學生的另一個值。這個值可能為學生識別號碼。  選填
first_name 學生的名字。 必填
middle_name 學生的中間名。 選填
last_name 學生的姓氏。 必填
grade_level 學生的年級。 選填
email_address 學生的電子郵件位址。 選填
sis_username 學生在 SIS 中的使用者名稱。  選填
password_policy 使用 password_policy 欄位為每個特定學生指定密碼規則。這個值會覆寫位置密碼規則以及您之前為該學生設定的任何密碼規則。如果將 password_policy 欄位留空,位置的預設密碼規則會用於新學生,原有學生則維持不變。 選填
location_id 學生的 location_id。這個值必須與「位置」檔中的 location_id 對應。如果此輸入項目與「位置」檔中的輸入項目不符,上傳程序就會出錯。 必填

 

指定多個位置

只要在「學生」檔案中加入更多位置直欄,即可為一個學生指定多個位置。您最多可以再加入 14 個位置直欄,並將它們命名為 location_id_2、location_id_3,以此類推直到 location_id_15。對於每個學生,您可以選擇在其中一個直欄輸入另一個 location_id。這個值必須與「位置」檔中的 location_id 對應。如果此輸入項目與「位置」檔中的輸入項目不符,上傳程序就會出錯。

職員檔案

如果您使用 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 職員的姓氏。 必填
email_address 此職員的電子郵件位址。  選填
sis_username 職員在 SIS 中的使用者名稱。 選填
location_id 職員的 location_id。這個值應與「位置」檔中的 location_id 對應。如果此輸入項目與「位置」檔中的輸入項目不符,上傳程序就會出錯。 必填

所有職員均採用標準密碼規則(8 個以上英數字元)。

 

指定多個位置

只要在「職員」檔案中加入更多位置直欄,即可為一個職員指定多個位置。您最多可以再加入 14 個位置直欄,並將它們命名為 location_id_2、location_id_3,以此類推直到 location_id_15。對於每個職員,您可以選擇在其中一個直欄輸入另一個 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。
 

更新檔案

當您想要新增或編輯學生、職員和班級時,請編輯資料檔案並上傳新拷貝。上傳檔案時,您必須將六個檔案全部上傳,每個檔案必須包含每一類別的完整列表,而非只有想要新增的項目。

第一次上傳之後,新的帳號和班級會在上傳時自動建立。如果之前上傳的輸入項目遺失,該項目在 Apple School Manager 中就會被停用。如果出現錯誤,Apple School Manager 將傳送電子郵件給您。

對於非 Apple 製造之產品相關資訊,或是非 Apple 控制或測試之獨立網站,不得解釋 Apple 為其推薦或背書。Apple 對於協力廠商網站或產品的選擇、效能或使用,概不負責。Apple 對於協力廠商網站的準確性或可靠性不具有任何立場。使用 Internet 本具風險。如需更多資訊,請聯絡廠商。其他公司及產品名稱可能是其各自擁有者的商標。

發佈日期: