年級 Sync-PowerSchool APIGrade Sync- PowerSchool API

注意

年級同步處理是以目前登入的使用者/教師和其連結的 PowerSchool 帳戶在 PowerSchool 內具有存取權的許可權為基礎。Grade Sync is based off of the currently signed-in User/Teacher and what their linked PowerSchool account has access to within PowerSchool itself. 只是以類別為基礎。It is NOT based solely on the class. 如果您在教師能夠建立工作分派時遇到問題,請確定他們在 PowerSchool 內具有適當的存取權。If you are experiencing issues with Teachers being able to create assignments, please ensure they have appropriate access within PowerSchool.

啟用與 PowerSchool API 的評分同步處理Enable Grade Sync with PowerSchool API

若要啟用評分同步,請完成下列步驟:To Enable Grade Sync, complete the steps below:

  1. 使用POWERSCHOOL API connection 方法部署 SDS。Deploy SDS using the PowerSchool API connection method.

  2. 將所有類別同步處理為您想要的評分同步處理以支援。Sync all Classes to O365 you intend Grade Sync to support.

  3. 在 PowerSchool 中新增 Microsoft 年級同步處理增益集。Add the Microsoft Grade Sync add-in in PowerSchool. 新增此功能會啟用 Office 365 和 PowerSchool 之間的讀取/寫入權限。Adding this will enable read/write permissions between Office 365 and PowerSchool.

    a.a. 下載 Microsoft 年級同步增益集 [microsoft-gradesync-powerschool]Download the Microsoft Grade Sync add-in [microsoft-gradesync-powerschool.zip]

    b.b. 使用管理員帳戶登入 PowerSchool。Login on PowerSchool with an administrator account.

    c.c. 流覽至系統 -> 系統設定 -> 外掛程式管理設定Navigate to System -> System Settings -> Plugin Management Configuration

    • 若尚未安裝 Microsoft 年級同步增益集,請按一下 [安裝],選取步驟1的 ZIP 檔,然後按一下 [安裝]。If the Microsoft Grade Sync add-in is not already installed, click Install, select the ZIP file from step 1 and click Install.
    • 若已安裝舊版 Microsoft 年級同步增益集,請按一下增益集,按一下 [更新],然後選取步驟1中的 ZIP 檔案,然後按一下 [提交]。If the legacy Microsoft Grade Sync add-in is installed, click on the Add-in, click Update, select the ZIP file from step 1, and click Submit.

    d.d. 確認 [Microsoft 年級同步處理] 增益集顯示在 [外掛程式] 清單中,且已啟用Verify the Microsoft Grade Sync add-in is shown in the plugin list and is enabled. 目前的版本應該是1.0.0.8。The current version should be 1.0.0.8.

    e.e. 選擇 [資料設定],並記錄列出的用戶端識別碼用戶端密碼Choose Data Configuration and record the Client ID and Client Secret listed.

注意

如果您收到「外掛程式檔案包含已存在的檔案」的錯誤: queries_root/com.microsoft.educonnect.addin. named_queries .xml」,您將需要移除名為 "EduConnect 增益集" 的先前增益集,然後再試一次步驟3c。If you get the error "Plugin file contains a file that already exists: queries_root/com.microsoft.educonnect.addin.named_queries.xml", you will need to remove our previous add-in named "EduConnect Add-in" and try again from step 3c. 您將需要使用新的用戶端識別碼和用戶端密碼重新登錄類別筆記本。You will then need to re-register Class Notebook with the new Client ID and Client Secret.

  1. 流覽 https://sds.microsoft.com 並以您的全域系統管理員認證登入。Navigate to https://sds.microsoft.com and sign in with your Global Admin credentials.

  2. 在 [年級同步處理] 頁面上,按一下右側導覽功能表上的 [設定]。Click on the Grade Sync page option, on the left-hand navigation menu right above Settings.

  3. SIS 提供者下拉式清單中選擇 [ PowerSchool ]。Choose PowerSchool from the SIS Provider drop down.

  4. 輸入您的 SIS 連線詳細資料。Enter your SIS connection details.

grade-sync-1 .png

  • 端點 URL-用於 PowerSchool SIS 的基礎 URL。Endpoint URL - Base URL for your PowerSchool SIS. 必須可供網際網路存取。Must be internet accessible.
  • 用戶端識別碼-當您安裝 Microsoft 年級 Sync 外掛程式時所記錄的用戶端識別碼。Client ID - Client ID recorded when you installed your Microsoft Grade Sync plugin.
  • 當您安裝 Microsoft 年級 Sync 外掛程式時,會記錄用戶端密碼-用戶端密碼。Client Secret - Client Secret recorded when you installed your Microsoft Grade Sync plugin.
  • 教師電子郵件地址–存在且在這兩個系統內授權之老師的電子郵件地址。Teacher Email Address – Email Address of a Teacher that exists and is licensed within both systems.

注意

Microsoft 年級同步處理需要任何存在且在這兩個系統內授權的任何教師的電子郵件地址。Microsoft Grade Sync requires the Email Address of any Teacher that exists and is licensed within both systems. 當您在下一個步驟中按一下 [提交] 時,Microsoft 年級同步處理增益集就會確認此電子郵件地址是否有效。When you click Submit in the next step, the Microsoft Grade Sync add-in will confirm that this email address is valid. 如果無法確認,連線將無法完成。If it cannot be confirmed, the connection will not complete. 只會啟用相同網域的教師進行等級同步。Only Teachers of the same domain will be enabled for Grade Sync.

您可以在下列位置找到其他教師資訊:將新的和現有的工作分派同步處理至 PowerSchoolAdditional information for teachers can be found at: Sync new and existing assignments to PowerSchool.