適用於AEM Sites的Adobe Learning Manager參考站台(ALM參考站台)套件

Adobe Learning Manager (ALM)與Adobe Experience Manager (AEM)網站整合。 這可讓您以最少的編碼工作量,為Adobe Learning Manager建立自己的網站和回應式行動介面。 透過這項整合,您可以為使用者建立自訂的學習體驗。

為了建立這樣的體驗,ALM以ZIP檔案的形式,提供適用於AEM Sites的Adobe Learning Manager參考站台套件(ALM參考站台套件),您可以安裝在您的AEM Sites執行個體上。

此套件包含AEM Sites網頁範本和網站元件以及內嵌的Widget,例如學習目錄、內嵌的Widget、日曆等。

安裝ALM參考站台套件後,您就可以開始建立Adobe Learning Manager的網站,以便在AEM Sites執行個體上託管。 之後,您的使用者可以將元件拖放至網站上。

安裝ALM參照站台套件

先決條件

  • AEM Sites和Adobe Commerce的授權。
  • AEM on-premise 6.5或Adobe Experience Manager -Cloud Service
  • Adobe Commerce 2.4.3

保護AEM Sites環境後,您必須安裝ALM參考站台套件。 此套件包含協助建構學習平台的AEM網頁和網站元件。

參考站台封裝裝載於​ GitHub存放庫

如需詳細資訊,請參閱README。

在Adobe Learning Manager中建立應用程式

安裝AEM網站套件後,您必須設定ALM應用程式,將學習入口網站與AEM網站連線。

此情境適用於AEM搭配Adobe Learning Manager使用時。

請遵循下列步驟:

  1. 以整合管理員的身分,按一下​ Applications

  2. 若要建立新的應用程式,請按一下頁面右上角的​ Register

  3. 在註冊新應用程式畫面中,輸入下列詳細資訊:

    1. 應用程式名稱:您正在建立的應用程式名稱。
    2. URL:您組織的URL。
    3. 重新導向網域: AEM網站的代管網域。 您也可以指定萬用字元。
    4. 說明:應用程式的說明。
    5. 範圍:選取學習者角色讀取存取權和學習者角色寫入存取權。
    6. 僅針對此帳戶?:如果您要將應用程式用於現有的ALM帳戶,請選取「是」。
  4. 進行變更後,按一下「儲存」 。

從畫面中記下應用程式認證。


應用程式認證

若要核准應用程式,請按一下​ Approve

取得權杖

  1. 在[開發人員資源]索引標籤中,按一下​ Access Tokens for Testing and Development

    選取用於測試和開發的存取權杖

  2. 輸入下列明細:


    輸入權杖詳細資料

    1. 取得OAuth代碼:輸入上一節的使用者端ID並變更範圍。 按一下「提交」以取得Oauth代碼。
    2. 取得重新整理Token:輸入上一節中的使用者端ID和密碼。 同時輸入您在上一步得到的OAuth程式碼。 按一下「提交」。
    3. 取得存取Token:輸入上一節中的使用者端ID和密碼。 同時輸入您在上一步驟中取得的重新整理Token。 按一下「提交」。
    4. 取得存取Token詳細資料:輸入您在上一步驟中取得的存取Token。 按一下「提交」。
  3. 您可以透過以下的JSON回應取得詳細資料。 回應包含存取權杖、重新整理權杖、使用者角色、帳戶ID、使用者ID和到期時間。 記下重新整理權杖,因為您將重複使用它。

在AEM中設定ALM帳戶

  1. 啟動您的AEM執行個體。

  2. 按一下「設定>Cloud Service」。

  3. 按一下「Adobe Learning Manager設定」 。


    選取Adobe Learning Manager設定

  4. 按一下「建立>組態資料夾」。 為資料夾命名。


    建立設定

  5. 在學習專案中,選取您建立的設定。

  6. 輸入設定的詳細資料。


    建立設定資料夾

    1. Adobe Learning Manager模式:選擇您希望登入和未登入學習者的學習體驗。
    2. Adobe Learning Manager URL:輸入託管學習服務之ALM執行個體的URL。
    3. 帳戶ID: ALM帳戶ID。
    4. 使用者端ID、使用者端密碼和作者重新整理權杖:輸入您在ALM中建立應用程式時獲得的認證。
    5. 自訂Widget:如需詳細資訊,請參閱與AEM整合 .
  7. 儲存並關閉設定。

AEM + Adobe Learning Manager (已登入/未登入的使用者)

Adobe Learning Manager現在可讓您向現有和潛在客戶及合作夥伴展示您的產品和訓練,而不需要建立或登入帳戶。 此功能可為學習者提供訓練的快速輕鬆預覽,有助於強調和推廣產品功能,進而協助您促進產品和訓練的採用。 因此,您可以有效地展示您的產品和方案,尤其是向潛在客戶和合作夥伴展示,進而提升產品知名度。 輕鬆存取和更好的可及性帶來更高的興趣,有助於推動培訓註冊和學習採用。

學習者使用此工作流程即可預覽訓練、存取訓練資訊,或搜尋訓練,而無需登入Adobe Learning Manager。 此工作流程不適用於原生Learning Manager介面(僅適用於AEM Sites和其他Headless介面)。

設定並啟用學習平台聯結器

本節將說明設定和啟用以下聯結器所需的步驟:

訓練資料存取

此聯結器可讓您的AEM Sites式或其他自訂的Headless使用者介面擷取訓練資訊並將資訊呈現給學習者,並在學習者登入之前或之後實現無縫的訓練資訊搜尋。

只有在您使用AEM Sites或其他Headless介面時,才需要使用此聯結器。

聯結器會將訓練中繼資料匯出至資料儲存和擷取解決方案,以及搜尋啟用系統。 因此,您可以設定AEM Sites式或其他自訂的Headless使用者介面,使用這兩項服務來擷取訓練資料、轉譯網頁,並為學習者提供最佳化的訓練搜尋功能。 例如,未登入AEM Sites型介面可使用匯出的中繼資料,協助學習者搜尋、瀏覽及存取顯示訓練資訊的訓練頁面。

啟用此聯結器可建置及轉譯您的AEM Sites網頁,並在登入前後為學習者提供自訂體驗。 啟用此聯結器可建置及轉譯您的AEM Sites網頁,並在登入前後為學習者提供自訂體驗。

  • Adobe Learning Manager CDN基底URL — 從訓練資料存取連線頁面輸入資料擷取CDN服務路徑的基底URL。
  • 管理員重新整理Token — 輸入您在前一節中決定的重新整理Token。
  • 訓練中繼資料基底URL — 從「訓練資料存取」連線頁面,輸入搜尋啟用與搜尋資料擷取服務路徑的基底URL。
  • Adobe Learning Manager註冊URL — 輸入整合管理員為帳戶產生的自助註冊URL,學習者可使用此帳戶註冊培訓。

AEM + Adobe Learning Manager + Adobe Commerce (已登入/未登入的使用者)

Adobe Learning Manager現在提供解決方案,協助您將學習平台與Adobe Commerce緊密整合。 此版本可讓您輕鬆地將原生、AEM網站型或其他Headlearning Manager介面連線到Adobe Commerce。 此整合可讓您在學習平台中實現電子商務功能。 您現在可以為客戶和業務合作夥伴提供付費培訓,並讓您在原生和非原生Learning Manager介面上輕鬆購買培訓。 學習者也可預覽訓練、存取訓練資訊,或搜尋訓練,而不需要登入Adobe Learning Manager。

使用者可以使用已經的AEM應用程式並核准它,而不是建立一個應用程式。

  • Adobe Learning Manager CDN基底URL — 輸入來自Adobe Commerce連線頁面之資料擷取CDN服務路徑的基底URL。
  • Adobe Commerce URL — 輸入您使用的Adobe Commerce執行個體的URL。
  • GraphQL Proxy路徑 — 使用者端Learning Manager元件會直接存取Adobe Commerce GraphQL端點,因此可能會發生CORS錯誤。 若要避免此錯誤,所有呼叫都必須從與AEM相同的端點提供服務,或是透過新增CORS標題的Proxy提供服務。
  • Adobe Commerce商店名稱 — 輸入您在前一節中判斷的Adobe Commerce商店名稱。
  • Adobe Commerce客戶權杖存留期(以秒為單位) — 輸入客戶權杖存留期,表示登入工作階段的預先確定期間。
  • 管理員重新整理Token — 輸入您在前一節中決定的重新整理Token。

自訂網頁

使用AEM參考網站和可用的Widget來自訂您的網頁。

  1. 啟動您的AEM執行個體。

  2. 按一下Sites並開啟設定頁面。

  3. 按一下​ Learning Site > Language Masters > English。 專案中的所有網頁都包含在資料夾中。


    檢視所有網頁

  4. 選取任何範本並按一下​ Edit

  5. 在頁面上,按一下元件設定按鈕並變更元件的屬性。


    選取設定按鈕

  6. 預覽您的變更,或者您可以發佈頁面。

建立網頁

除了參考網站套件所提供的可用範本以外,您也可以根據範本ibn AEM建立網頁。

  1. 在AEM首頁面上,按一下「建立>頁面」 。

  2. 選擇要自訂的範本。 按一下「下一步」。

  3. 輸入頁面屬性。


    頁面屬性

  4. 若要建立頁面,請按一下​ Create

  5. 選取新頁面並按一下​ Edit

  6. 在頁面上插入元件,例如​ 學習 — 內容


    依網站篩選

  7. 選擇要在頁面上顯示的必要目錄篩選器。

從藍圖建立網站

ALM參考網站套件提供「學習網站藍圖」,可讓您為學習平台建立網站。 AEM藍圖可讓您直接從AEM Sites元件建置網頁。 您不需要使用任何範本。

  1. 在AEM起始頁上,按一下​ Sites

  2. 按一下​ Create > Site

  3. 按一下學習網站Blueprint。

    從Blueprint建立網站

  4. 按一下「下一步」。

  5. 在屬性頁面上,輸入頁面中繼資料。 按一下「建立」。


    選取學習網站Blueprint

  6. 按一下「首頁」超連結,以導覽至您已建立之網站的首頁。 您可以在此頁面上自訂Widget和目錄元件。

為您的網站編碼

除了使用內建範本並使用WYSIWYG元件從頭開始建立您的網站外,您還可以撰寫程式碼並建置網站。

程式碼位於參考網站GitHub存放庫中,可供您開始使用。

範本的主要部分為:

  • core:Java套件組合包含所有核心功能(例如OSGi服務、接聽程式或排程器)以及與元件相關的Java程式碼(例如servlet或請求篩選器)。
  • ui.apps:包含專案的/apps (和/etc)部分,即JS&CSS clientlibs、元件、範本。
  • ui.content:此變數包含使用ui.apps中的元件的範例內容
  • ui.frontend:包含React元件。

所有程式碼都位於存放庫中,可供您啟動和執行。

將學習管理員元件匯入並新增至現有網頁或範本

安裝AEM參考網站套件會將Learning Manager元件新增至您的AEM Sites執行個體。 預設情況下,您可以將這些元件新增到我們提供的現成可用的Web專案(網站)學習網站。 這些元件也可在您從學習網站Blueprint建立的網站中使用。

不過,如果您想要將這些新新增的Learning Manager元件用於您現有的Web專案或網站,則應使用下列程式匯入元件。

  1. 安裝ALM參照站台套件。

  2. 開啟Web專案,並導覽至HTML檔案(針對您要新增Learning Manager元件的網頁或網頁範本)。

  3. 加入會議

    開啟HTML檔案,並將下列程式碼片段新增至頁面元件,讓程式碼在頁面轉譯器中呈現的學習元件之前執行。

    <sly data-sly-use.configModel="com.adobe.learning.core.models.GlobalConfigurationModel"/>
    <meta name="cp-config" content="${configModel.config}" />

    上述程式碼會將對應的設定新增至頁面的meta標籤中,這是學習元件轉譯的必要條件。 如需詳細資訊,請參閱Adobe Learning Manager參考網站

  4. 確認您已對應組態與Web專案。

  5. 開啟要匯入AEM Sites元件的Learning Manager範本。

  6. 在範本頁面編輯器上,瀏覽至「允許的元件」容器,並選取​ 原則

  7. 在「原則」頁面中,導覽至「屬性>允許的元件」,並選取下列元件「學習 — 內容」、「學習 — 表單」和「學習 — 結構」

下列程式可讓範本完成匯入Learning Manager元件的使用者端資料庫相依性。

包含這些元件的網頁應載入這些程式庫,才能成功轉譯和使用元件。

  1. 在範本頁面編輯器上,按一下頁面資訊,然後按一下頁面原則。

  2. 在「原則」頁面中,導覽至「屬性>使用者端程式庫」,並將它們新增至您的範本頁面:

    1. learning.site
    2. learning.ui
    3. learning.commerce

儲存此範本後,即可在衍生自此範本的所有網頁中新增Learning Manager元件。

recommendation-more-help
d5e5961a-141b-4c77-820e-8453ddef913d