共用方式為

多語系學習路徑的設定選項

  • 發行項

隨著 SharePoint Online 通訊網站的多語系功能發行，學習路徑現在支援最新版本 v4 中的多種語言。

安裝案例

案例 1：我們不需要多語系支援

好消息是，即使您未在網站集合中啟用多語系頁面功能，v4 也適用於您。 藉由升級，您會取得一些可能對您有用的更新，例如影像選取器 UI，以便選擇自定義播放清單的影像，以及新增 UI 以將預設影像變更為自定義子類別。 此外，也會對查看器網頁元件進行一些其他小型修正。 請參閱 更新方案中所述的升級指示。

案例 2：我們需要多語系支持，網站集合的默認語言是我們的默認語言

好消息是，v4 將支援您在網站集合中啟用多語系頁面功能！ 如需最佳體驗，請遵循下列步驟來升級解決方案：

  1. 流覽至您的 Microsoft 365 學習路徑主要網站集合，這是網站頁面庫中具有CustomLearningAdmin.aspx頁面的網站集合。
  2. 在現有的 Microsoft 365 學習路徑網站中啟用多語系發佈功能。 如需詳細資訊，請參閱下列指示： 建立多語系通訊網站、頁面和新聞。 您只需要啟用您想要支援的語言。 請小心 ，不要啟 用解決方案不支持的語言。 如果您這樣做，用戶最後會獲得部分體驗，其中功能表和Microsoft提供的內容會以默認語言顯示，而您的自定義內容會以不支援的語言顯示，假設使用者已選取該語言作為其默認語言。 如需學習路徑所支援的語言完整清單，請參閱 學習路徑的多語系支援概觀。
  3. 請遵循 更新解決方案的指示，此解決方案會安裝 4.x.x 版的 Microsoft 365 學習路徑解決方案。
  4. 流覽至Microsoft 365 學習路徑網站集合網站頁面庫中的 [CustomLearningAdmin.aspx] 頁面，以起始升級程式。 4.x 版包含新的升級體驗，可記錄正在處理的每個升級步驟。 升級程式可以隨時重新執行，方法是將 新 ?forceUpdate=v3 增至管理頁面 URL 的結尾。 值 v3 會指出您要升級的學習路徑版本。 例如：https://contoso.sharepoint.com/sites/M365LP/SitePages/CustomLearningAdmin.aspx?forceUpdate=v3。

案例 3：我們需要多語系支援，而網站集合的默認語言不是我們的默認語言

好消息和壞新聞。 好消息是 v4 將支援您的案例;好消息是您無法在網站集合建立之後變更其默認語言。 如果您沒有自訂內容，則轉送路徑相當簡單：

建立新的 Microsoft 365 學習路徑網站 - 沒有自定義內容

  1. 建立新的網站集合，請務必根據學習內容的默認語言選擇網站集合的默認語言， (稱為 /NewLP) 。
  2. 在 /NewLP 網站中啟用多語系發佈功能。 如需詳細資訊，請參閱下列指示： 建立多語系通訊網站、頁面和新聞。 您只需要啟用您想要支援的語言。 請小心 ，不要啟 用解決方案不支持的語言。 如果您這樣做，用戶最後會獲得部分體驗，其中功能表和Microsoft提供的內容會以默認語言顯示，而您的自定義內容會以不支援的語言顯示，假設使用者已選取該語言作為其默認語言。 如需學習路徑所支援的語言完整清單，請參閱 學習路徑的多語系支援概觀。
  3. 遵循更新方案中所述的升級指示，安裝新的 customlearning.sppkg檔案。
  4. M365lpConfiguration.ps1執行 PowerShell 腳本，確保傳入 /NewLP 網站作為網站集合。

    注意事項

    您需要應用程式類別目錄網站和 /NewLP 網站的網站集合管理員存取權，才能順利執行此腳本。

  5. 假設 PowerShell 腳本順利完成，您應該能夠流覽至起始升級程式的 /NewLP/網站頁面/CustomLearningAdmin.aspx 頁面。 第 4 版包含新的升級體驗，可記錄正在處理的每個升級步驟。 升級程式可以隨時重新執行，方法是將 新 ?forceUpdate=v3 增至管理頁面 URL 的結尾。 值 v3 會指出您要升級的學習路徑版本。 例如：https://contoso.sharepoint.com/sites/M365LP/SitePages/CustomLearningAdmin.aspx?forceUpdate=v3。

注意事項

如果您不再需要舊的學習路徑網站，一旦新網站的系統管理頁面 CustomLearningAdmin.aspx 正常運作，就可以將其刪除。

建立新的 Microsoft 365 學習路徑網站 - 自定義播放清單和資產

遵循上述步驟重新建立學習路徑網站之後，您必須努力移動 CustomPlaylists 清單和 CustomAssets 清單的內容。 如果自定義資產位於現有的學習路徑網站中，您也可以選擇移動組成自定義資產的實際自定義頁面，而您的目的是要刪除這些頁面。

這項工作的困難在於，對於 CustomPlaylists 清單中的所有專案，CustomAssets 清單中的清單專案標識符會被儲存在每個播放清單清單專案的欄位中 JSONData 。 因此，只要將 CustomPlaylists 清單的內容從一個網站移至另一個網站就不夠用。 此外，CustomAssets 清單包含清單專案欄位中 JSONData 自定義資產頁面的絕對 URL。 如果資產未移動，且網站未重新命名 (因此將絕對 URL 變更為資產的頁面) 則可以保留。 不過，如果發生上述任一情況，您必須手動更正專案。

由於這種移轉的複雜性，建議您考慮登記其中一個學習路徑合作夥伴，以協助您進行這項轉換。