多語系的學習路徑手動設定

Microsoft 365 學習路徑為需要下列其中一個案例支援的組織提供手動設定：

• 您的組織已建立專供訓練使用的 SharePoint Online 新式通訊網站，而且您想要將學習路徑新增至該網站。 在此案例中，尚未在網站上設定學習路徑網頁元件。

• 您想要在組織的其中一個 SharePoint 通訊網站中安裝多語系支援的學習路徑。 網站具有或將會具有非英文的預設語言，而且是學習路徑所支援的其中一種語言。 以下是學習路徑支援的語言：

• 英文

• 中文 (簡體)

• 法文

• 德文

• 義大利文 (義大利)

• 日本 (日)

• 葡萄牙 (巴西)

• 俄文 (俄文)

• 西班牙文

手動設定學習路徑需要使用Windows PowerShell和 SharePoint Online 管理命令介面的經驗。 以下是手動設定學習路徑的步驟概觀：

• 驗證您已符合所有必要條件。
• 檢查網站的預設語言設定。 如果確定，請繼續手動安裝。 如果您需要不同的預設語言設定，則必須建立新的網站。
• 在 SharePoint 租使用者應用程式目錄中安裝 customlearning.sppkg 檔案。
• 布建/識別要作為 Microsoft 365 學習路徑首頁網站的新式通訊網站。
• 執行 PowerShell 腳本，以使用學習路徑相依的成品來設定您的租使用者。
• 流覽至 CustomLearningAdmin.aspx 網站頁面以載入管理網頁元件，以初始化自訂內容組態。

先決條件

若要確保學習路徑網頁元件的手動設定成功，必須符合下列必要條件。

• 您必須已設定並設定整個租使用者的應用程式類別目錄。 請參閱設定您的Office 365租使用者，並遵循網站一節。
• 如果您已布建整個租使用者的應用程式類別目錄，您將需要存取有權將套件上傳至該目錄的帳戶。 一般而言，此帳戶具有 SharePoint 系統管理員角色。
• 如果具有該角色的帳戶無法運作，請移至 SharePoint 系統管理中心，並尋找應用程式類別目錄網站集合的網站集合管理員，並以其中一個網站集合管理員身分登入，或將失敗的 SharePoint 系統管理員帳戶新增至網站集合管理員。
• 您也需要存取 SharePoint 租使用者管理員帳戶。

步驟 1 - 檢查您的語言設定

在手動安裝程式的第一個步驟中，檢查您的網站語言設定。 以下是可能的選項：

選項 1 - 您不想要多語系支援

如果您不想要網站的多語系支援，請確定已關閉。

1. 從 SharePoint 通訊網站，選取 [設定>網站資訊>檢視所有網站設定>語言設定]。
2. 將 [ 啟用要翻譯成多種語言的頁面和新聞 ] 切換為 [關閉]。
3. 按一下 [儲存]。
4. 繼續進行步驟 2。

選項 2 - 您想要多語系支援，而且您可以使用預設語言

SharePoint 通訊網站具有預設語言。 預設語言會決定您檢視學習路徑的語言，包括學習路徑 [管理] 頁面。 預設語言設定是在月臺第一次建立時設定，之後無法變更。 繼續進行手動設定之前，請確定您已使用目標網站的預設語言。

1. 從 SharePoint 通訊網站，選取 [設定>網站資訊>檢視所有網站設定>語言設定]。
2. 將 [ 啟用要翻譯成多種語言的頁面和新聞 ] 切換為 [ 開啟]。
   • 如果您確定 [ 語言] 下清單頂端出現的語言，您可以新增其他語言，然後按一下 [ 儲存]。 繼續進行步驟 2。
   • 如果您想要不同于為網站選取的預設語言，則必須使用您想要的語言建立新的 SharePoint 通訊網站。 繼續進行選項 3。

選項 #3 - 您想要多語系支援，但想要不同的網站預設語言

使用此選項，您可以使用您想要的預設語言建立新的 SharePoint Online 通訊網站，然後設定網站的語言設定。

1. 若要建立新的 SharePoint 通訊網站，請參閱 在 SharePoint Online 中建立通訊網站。 建立網站時，請務必將語言設定為您想要用於學習路徑的預設語言。
2. 從您建立的網站中，選取 [設定>網站資訊>檢視所有網站設定>語言設定]。
3. 將 [ 啟用要翻譯成多種語言的頁面和新聞 ] 切換為 [ 開啟]。
4. 視需要新增其他語言，然後按一下 [ 儲存]。
5. 繼續進行步驟 2。

![注意]如果您需要將自訂內容從網站移轉至新建立的網站，請參閱本檔稍後的一節。

步驟 2 - 從 GitHub 取得網頁元件套件和設定腳本

在安裝程式中，您需要 Microsoft 365 學習路徑 Web 元件套件和 PowerShell 安裝腳本。

• 移至 學習路徑 GitHub 存放庫。
• 按一下 [下載 ] 將網頁元件套件和腳本儲存至本機磁片磁碟機。 在此程式的後續步驟中，您將使用腳本和網頁元件套件。

步驟 2 - 將網頁元件上傳至租使用者應用程式目錄

若要設定 Microsoft 365 學習路徑，您可以將 customlearning.sppkg 檔案上傳至整個租使用者的應用程式類別目錄，並加以部署。 如需如何將應用程式新增至應用程式類別目錄的詳細指示，請參閱 使用應用程式類別目錄讓自訂商務應用程式可供 SharePoint Online 環境 使用。

步驟 3 - 布建/識別新式通訊網站

識別現有的 SharePoint 通訊網站，或在 SharePoint Online 租使用者中布建新的網站。 如需如何布建通訊網站的詳細資訊，請參閱 在 SharePoint Online 中建立通訊網站 ，並遵循建立通訊網站的步驟。

步驟 4 - 將 Microsoft 365 學習路徑應用程式新增至網站

1. 從 SharePoint 網站，按一下 [系統] 功能表，然後按一下 [ 新增應用程式]。
2. 在[您的應用程式]底下，按一下 [從您的組織]，然後按一下[Office 365的學習路徑] 。

步驟 5 - 設定網站的許可權

請確定已為網站設定下列許可權：

• 網站集合管理員或擁有者群組的一部分 - 初始化 CustomConfig 清單專案所需的許可權，以設定第一次使用的學習路徑。
• 成員群組 - 管理學習路徑所需的許可權，包括隱藏和顯示內容，以及管理自訂播放清單
• 訪客群組 - 檢視網站內容所需的許可權。

步驟 6- 執行 PowerShell 設定腳本

隨附 PowerShell 腳本，您必須執行此腳本 CustomLearningConfiguration.ps1 ，才能建立解決方案所使用的三個 租使用者屬性 。 此外，腳本會在網站頁面庫中建立兩 個單一元件應用程式頁面 ，以在已知位置裝載系統管理員和使用者網頁元件。

1. 如果您尚未下載 SharePoint Online 管理命令介面，請立即下載。 請參閱 SharePoint Online 管理命令介面下載。
2. 您可能需要設定 PowerShell 執行原則來執行腳本。 如需詳細資訊，請 參閱關於執行原則。
3. CustomLearningConfiguration.ps1執行腳本。 除了您的租使用者管理員認證之外，腳本也會提示您輸入租使用者名稱和網站名稱。 針對您的網站 URL 考慮下列範例， https://contoso.sharepoint.com/sites/O365CLcontoso 是租使用者名稱，而 O365CL 是月臺名稱。

停用遙測收集

此解決方案的一部分包含匿名遙測追蹤加入宣告，預設為開啟。 如果您要手動安裝，而且想要關閉遙測追蹤，請變更 CustomlearningConfiguration.ps1 腳本，將$optInTelemetry變數設定為 $false並執行腳本。

驗證布建成功並初始化 CustomConfig 清單

成功執行 PowerShell 腳本之後，您可以流覽至網站、初始化 CustomConfig 清單專案，以設定第一次使用的學習路徑，並驗證網站是否正常運作。

• 移至<YOUR-SITE-COLLECTION-URL>/SitePages/CustomLearningAdmin.aspx。 開啟 CustomLearningAdmin.aspx 來初始化 CustomConfig 清單項目，該清單項目會為第一次使用設定學習路徑。 您應該會看到如下所示的頁面：

將擁有者新增至網站

租使用者管理員，您不太可能是自訂網站的人員，因此您必須將一些擁有者指派給網站。 擁有者具有網站的系統管理許可權，因此他們可以修改網站頁面並重新命名網站。 他們也可以隱藏及顯示透過學習路徑網頁元件傳遞的內容。 此外，他們將能夠建置自訂播放清單，並將它們指派給自訂子類別。

1. 從 [SharePoint 設定] 功能表中，按一下 [ 網站許可權]。
2. 按一下 [進階許可權設定]。
3. 按一下[Office 365 擁有者] 的學習路徑。
4. 按一下[新增>使用者] 至此群組，然後新增您想要成為擁有者的人。
5. 在 [共用] 訊息中新增 [ 探索網站 ] 的連結，然後按一下 [ 共用]。

移轉自訂內容

遵循上述步驟重新建立學習路徑網站之後，您必須移動 CustomPlaylists 清單和 CustomAssets 清單的內容。 如果您的自訂資產位於現有的學習路徑網站中，您也可以選擇移動組成自訂資產的實際自訂頁面，而您的目的是要刪除它。 工作可能很困難，因為對於 CustomPlaylists 清單中的所有專案， CustomAssets 清單中的清單專案識別碼會被儲存在每個播放清單清單專案的 JSONData 欄位中。 因此，只要將 CustomPlaylists 清單的內容從一個網站移到另一個網站就不夠用。 此外， CustomAssets 清單包含清單專案 JSONData 欄位中自訂資產頁面的絕對 URL。 如果資產未移動，且網站未重新命名 (因此將絕對 URL 變更為資產的頁面) ，則 CustomAssets 可以保留。 但您必須手動更正專案。 由於這種移轉的複雜性，建議您考慮登記其中一個學習路徑合作夥伴，以協助您進行這項轉換。

後續步驟

• 請參閱 自訂學習路徑。
• 請參閱 翻譯網站頁面。