Integrera Adobe Learning Manager med AEM
Adobe Learning Manager (ALM) integreras med Adobe Experience Manager-webbplatser (AEM). Det gör att du kan skapa en egen webbplats och responsiva mobilgränssnitt för Adobe Learning Manager med minimal kodning. Med denna integrering kan du skapa anpassade utbildningsupplevelser för dina användare.
För att skapa en sådan upplevelse tillhandahåller ALM ett Adobe Learning Manager-referenspaket för webbplats (ALM-referenspaket för webbplats) för AEM Sites i form av en ZIP-fil som du kan installera på din AEM Sites-instans.
Paketet innehåller webbsidesmallar och webbplatskomponenter från AEM Sites tillsammans med inbäddningsbara widgetar, t.ex. Utbildningskatalog, inbäddade widgetar, kalender och så vidare.
När du har installerat ALM-referenspaketet kan du börja skapa en webbplats för Adobe Learning Manager som du kan vara värd för på din AEM Sites-instans. Användarna kan sedan dra och släppa komponenterna på webbplatsen.
Installera ALM-referensplatspaket
Krav
- Licenser för AEM Sites och Adobe Commerce.
- AEM On-premise 6.5 eller Adobe Experience Manager - Cloud Service
- Adobe Commerce 2.4.3
När du har skyddat AEM Sites-miljön måste du installera ALM-referenspaketet. Detta paket innehåller AEM-webbsidor och webbplatskomponenter som hjälper dig att konstruera utbildningsplattformen.
Referenswebbplatspaketet finns på GitHub-databasen.
Mer information finns i filen VIKTIGT.
Hämta innehållspaketet downloadthecontentpackage
Installationsprogrammet levereras som ett AEM-innehållspaket. Hämta paketet.
Innehållspaketet, som finns som en zip-fil, är kompatibelt med AEM 6.4 och AEM 6.5.
Installera Learning Manager-komponent installcaptivateprimecomponent
Installera Learning Manager-innehållspaketet med hjälp av AEM Package Manager:
-
Öppna AEM Package Manager när du är AEM-författare.
-
Klicka på knappen Upload Package.
-
Klicka på Browse och överför innehållspaketet.
-
Klicka på Upload.
-
När paketet har överförts installerar du innehållspaketet genom att markera det och klicka på Install.
Installera innehållspaketet
Skapa ett program i Adobe Learning Manager
När du har installerat AEM-webbplatspaketet måste du konfigurera ett ALM-program för att ansluta utbildningsportalen till AEM-webbplatsen.
Detta scenario gäller när AEM används med Adobe Learning Manager.
Följ stegen nedan:
-
Klicka på Applications som integreringsadministratör.
-
Om du vill skapa ett nytt program klickar du på Register i det övre högra hörnet på sidan.
-
Ange följande information på skärmen Registrera ett nytt program:
- Programnamn: Namnet på programmet som du skapar.
- URL: Din organisations URL.
- Omdirigeringsdomäner: Värddomänerna för AEM-webbplatsen. Du kan även använda jokertecken.
- Beskrivning: Beskrivning av programmet.
- Omfång: Välj läsåtkomst för elevrollen och elevrollen skrivåtkomst.
- Endast för det här kontot?: Välj Ja om du vill använda programmet för det befintliga ALM-kontot.
-
När du har gjort ändringarna klickar du på Spara.
Anteckna programautentiseringsuppgifterna från skärmen.
Programautentiseringsuppgifter
Klicka på Approve för att godkänna programmet.
Hämta token
-
Klicka på Access Tokens for Testing and Development på fliken Utvecklarresurser.
Välj åtkomsttoken för testning och utveckling
-
Ange följande uppgifter:
Ange tokeninformation- Hämta OAuth-kod: Ange klient-ID från föregående avsnitt och ändra omfånget. Klicka på Skicka för att få OAuth-koden.
- Hämta uppdateringstoken: Ange klient-ID:t och hemligheten från föregående avsnitt. Ange även OAuth-koden som du fick från föregående steg. Klicka på Skicka.
- Hämta åtkomsttoken: Ange klient-ID:t och hemligheten från föregående avsnitt. Ange även uppdateringstoken som du fick från föregående steg. Klicka på Skicka.
- Hämta information om åtkomsttoken: Ange den åtkomsttoken som du fick i det föregående steget. Klicka på Skicka.
-
Du kan hämta informationen från JSON-svaret som följer. Svaret består av åtkomsttoken, uppdateringstoken, användarroll, konto-ID, användar-ID och hur lång tid som förfaller. Notera uppdateringstoken eftersom du kommer att återanvända den.
Konfigurera ALM-konto i AEM
-
Starta din AEM-instans.
-
Klicka på Inställningar > Cloud Service.
-
Klicka på Konfiguration av Adobe Learning Manager.
Välj Adobe Learning Manager-konfiguration -
Klicka på Skapa > Konfigurationsmapp. Ge mappen ett namn.
Skapa konfiguration -
Välj den konfiguration du skapade i utbildningsprojektet.
-
Ange konfigurationsinformation.
Skapa konfigurationsmappen- Adobe Learning Manager-läge: Välj hur du vill att elever som är inloggade och inte är det ska lära sig.
- Adobe Learning Manager-URL: Ange URL:en till ALM-instansen där utbildningstjänsterna finns.
- Konto-ID: ID för ALM-kontot.
- Klient-ID, Klienthemlighet och Författarens uppdateringstoken: Ange de autentiseringsuppgifter du fick när du skapade programmet i ALM.
- Anpassning av widget: Mer information finns i Integrera med AEM
.
-
Spara och stäng konfigurationen.
AEM + Adobe Learning Manager (inloggade/ej inloggade användare)
Med Adobe Learning Manager kan du nu visa upp dina produkter och utbildningar för befintliga och potentiella kunder och partner utan att behöva skapa eller logga in konton. Den här funktionen hjälper dig att anpassa produkter och utbildningar genom att ge elever en snabb och enkel förhandsvisning av utbildningen, vilket hjälper till att framhäva och främja produktfunktioner. Därför kan du effektivt visa upp dina produkter och erbjudanden, särskilt för potentiella kunder och partners, vilket resulterar i ökad produktmedvetenhet. Enkel åtkomst och bättre åtkomlighet leder till ökat intresse, vilket hjälper till att driva utbildningsregistreringar och inlärningsanpassning.
Med hjälp av det här arbetsflödet kan en elev förhandsgranska en utbildning, få tillgång till utbildningsinformation eller söka efter utbildning utan att logga in på Adobe Learning Manager. Det här arbetsflödet gäller inte det inbyggda Learning Manager-gränssnittet (gäller ENDAST AEM Sites och andra fjärradministrerade gränssnitt).
Konfigurera och aktivera anslutningen för utbildningsplattformen
I det här avsnittet beskrivs de steg som krävs för att konfigurera och aktivera följande anslutning:
Åtkomst till utbildningsdata
Med den här anslutningen kan ditt AEM Sites-baserade eller något annat anpassat användargränssnitt hämta och återge utbildningsinformation till eleverna och göra en sömlös sökning efter utbildningsinformation antingen före eller efter att en elev loggar in.
Den här anslutningen krävs bara om du använder AEM Sites-baserade eller andra fjärradministrerade gränssnitt.
Kopplingen exporterar utbildningsmetadata till en datalagrings- och hämtningslösning samt ett sökaktiveringssystem. Du kan därför konfigurera ditt AEM Sites-baserade eller något annat anpassat användargränssnitt för användning av dessa två tjänster för att hämta utbildningsdata, återge webbsidor och ge eleverna tillgång till optimerade sökfunktioner för utbildning. Ett gränssnitt som inte är inloggat i AEM Sites kan till exempel använda de exporterade metadata som är till hjälp för en elev att söka efter, bläddra bland och komma åt utbildningssidor som visar utbildningsinformation.
Aktivera den här anslutningen för att skapa och återge dina AEM Sites-baserade webbsidor och leverera anpassade upplevelser till dina elever både före och efter inloggningen. Aktivera den här anslutningen för att skapa och återge dina AEM Sites-baserade webbsidor och leverera anpassade upplevelser till dina elever både före och efter inloggningen.
- Bas-URL för Adobe Learning Manager CDN - Ange bas-URL:en för CDN-tjänstsökvägen för datahämtning från anslutningssidan för utbildningsdataåtkomst.
- Uppdateringstoken för administratör - Ange den uppdateringstoken som du fastställde i det tidigare avsnittet.
- Bas-URL för utbildningsmetadata - ange bas-URL:en för sökaktiveringen och sökvägen till sökdatahämtningstjänsten från sidan Anslutning av utbildningsdata.
- URL för Adobe Learning Manager-registrering - ange URL för självregistrering som genererats av kontots integreringsadministratör och som används av elever för att registrera sig för utbildning.
AEM + Adobe Learning Manager + Adobe Commerce (inloggade/ej inloggade användare)
Adobe Learning Manager tillhandahåller nu lösningar som hjälper dig att sömlöst integrera utbildningsplattformen med Adobe Commerce. Med den här versionen kan du enkelt ansluta dina inbyggda AEM-platsbaserade eller andra Headless Learning Manager-gränssnitt till Adobe Commerce. Med integreringen kan du förverkliga e-handelsmöjligheter inom utbildningsplattformen. Du kan nu erbjuda kunder och affärspartners betald utbildning samt enkelt möjliggöra inköp av utbildning i både inbyggda och icke-inbyggda Learning Manager-gränssnitt. En elev kan även förhandsgranska en utbildning, få tillgång till utbildningsinformation eller söka efter utbildning utan att logga in på Adobe Learning Manager.
En användare kan använda det redan befintliga AEM-programmet och godkänna det i stället för att skapa ett.
- Bas-URL för Adobe Learning Manager CDN - Ange bas-URL:en för CDN-tjänstsökvägen för datahämtning från anslutningssidan för Adobe Commerce.
- Adobe Commerce-URL - Ange URL:en till den Adobe Commerce-instans du använder.
- GraphQL-proxysökväg - Komponenterna för Learning Manager på klientsidan kommer åt Adobe Commerce GraphQL-slutpunkten direkt, och därför kan CORS-fel uppstå. För att undvika det här felet måste alla anrop antingen skickas från samma slutpunkt som AEM eller skickas via en proxy som lägger till CORS-rubriker.
- Adobe Commerce-butiksnamn - Ange det Adobe Commerce-butiksnamn som du fastställde i det tidigare avsnittet.
- Livslängd för Adobe Commerce-kundtoken (i sekunder) - Ange livstid för kundtoken som anger den förutbestämda perioden för en inloggningssession.
- Uppdateringstoken för administratör - Ange den uppdateringstoken som du fastställde i det tidigare avsnittet.
Anpassa webbsidor
Anpassa dina webbsidor med hjälp av webbplatsen AEM-referenser och de tillgängliga widgetarna.
-
Starta din AEM-instans.
-
Klicka på Webbplatser och öppna konfigurationssidan.
-
Klicka på Learning Site > Language Masters > English. Alla webbsidor i projektet ingår i mappen.
Visa alla webbsidor -
Välj en mall och klicka på Edit.
-
På sidan klickar du på knappen Komponentinställningar och ändrar komponentens egenskaper.
Knappen Välj inställningar -
Förhandsgranska ändringarna eller publicera sidan.
Skapa webbsidor
Förutom de mallar du kan använda som tillhandahålls av referenspaketet för webbplatser kan du också skapa webbsidor baserade på mallarna i AEM.
-
På AEM-huvudsidan klickar du på Skapa > Sida.
-
Välj den mall som du vill anpassa. Klicka på Nästa.
-
Ange sidegenskaper.
Sidegenskaper -
Klicka på Create för att skapa sidan.
-
Välj den nya sidan och klicka på Edit.
-
Infoga en komponent på sidan, till exempel Utbildningsinnehåll.
Filtrera efter plats -
Välj de katalogfilter som ska visas på sidan.
Skapa webbplats från utkast
ALM-referenspaketet innehåller en plan för utbildningswebbplatsen som du kan använda för att skapa en webbplats för utbildningsplattformen. Med AEM-ritningar kan du skapa webbsidor direkt från AEM Sites-komponenter. Du behöver inte använda några mallar.
-
Klicka på Sites på AEM-startsidan.
-
Klicka på Create > Site.
-
Klicka på Utskrift av utbildningswebbplats.
Skapa en webbplats från utkast
-
Klicka på Nästa.
-
På egenskapssidan anger du sidans metadata. Klicka på Skapa.
Välj plan för utbildningswebbplats -
Klicka på hyperlänken Hem om du vill gå till startsidan för webbplatsen som du har skapat. På den här sidan kan du anpassa widgetarna och katalogkomponenterna.
Koda din webbplats
Förutom att använda de inbyggda mallarna och skapa din webbplats från grunden med hjälp av WYSIWYG-komponenterna, kan du också skriva kod och bygga webbplatsen.
Koden finns i GitHub-referensplatsen så att du kan komma igång.
Huvuddelarna i mallen är:
- kärna: Java-paket som innehåller alla kärnfunktioner som OSGi-tjänster, lyssnare eller schemaläggare, samt komponentrelaterad Java-kod som servlets eller begärandefilter.
- ui.apps: innehåller /apps (och /etc) delar av projektet, dvs JS&CSS-klientbibliotek, komponenter, mallar.
- ui.content: Innehåller exempelinnehåll med komponenterna från ui.apps
- ui.frontend: Innehåller React-komponenter.
All kod finns i rapporten så att du kommer igång.
Importera och lägg till Learning Manager-komponenter på befintlig webbsida eller i befintlig mall
När du installerar AEM-referensplatspaket läggs Learning Manager-komponenterna till i din AEM Sites-instans. Som standard kan du lägga till de här komponenterna på webbprojektets (webbplats) utbildningswebbplats, som vi tillhandahåller direkt i lådan. Dessa komponenter finns även på webbplatsen som du skapar från planen för utbildningswebbplatsen.
Om du vill använda dessa nyligen tillagda Learning Manager-komponenter i ditt befintliga webbprojekt eller på din webbplats bör du importera dem på följande sätt.
-
Installera ALM-referensplatspaketet.
-
Öppna webbprojektet och gå till HTML-filen (för den webbsida eller webbmall där du vill lägga till komponenterna i Learning Manager).
-
Ansluta till ett möte
Öppna HTML-filen och lägg till följande kodfragment i sidkomponenten så att koden körs innan utbildningskomponenterna som finns i sidåtergivningen.
<sly data-sly-use.configModel="com.adobe.learning.core.models.GlobalConfigurationModel"/>
<meta name="cp-config" content="${configModel.config}" />
Föregående kod lägger till den mappade konfigurationen i metataggen på sidan, vilket krävs för att utbildningskomponenterna ska återges. Mer information finns på referenswebbplatsen för Adobe Learning Manager.
-
Se till att du har mappat konfigurationen till webbprojektet.
-
Öppna AEM Sites-mallen där du vill importera Learning Manager-komponenterna.
-
På mallsidans redigerare går du till behållaren Tillåtna komponenter och väljer Policy.
-
På sidan Policy går du till Egenskaper > Tillåtna komponenter och väljer följande komponenter: Utbildning - innehåll, Utbildning - formulär och Utbildning - struktur
Följande procedur gör att mallen kan uppfylla klientbiblioteksberoendena för de importerade Learning Manager-komponenterna.
Webbsidorna som innehåller dessa komponenter bör läsa in dessa bibliotek för att kunna återge och använda komponenterna.
-
På mallsidans redigerare klickar du på Sidinformation och sedan på Sidpolicy.
-
På sidan Policy går du till Egenskaper > Klientbibliotek och lägger till dessa på mallsidan:
- learning.site
- learning.ui
- learning.commerce
När du har sparat den här mallen kan du lägga till Learning Manager-komponenterna på alla webbsidor som härleds från mallen.
Konfigurera widgeten i AEM configurethewidgetinaem
För widgetkonfiguration behöver AEM-skaparen bara den uppdateringstoken som tillhandahålls av integreringsadministratören för Learning Manager.
Du kan också ange flera kontokonfigurationer på flera sidor.
- Klicka på Tools > Cloud Services > Learning Manager Widget Configuration.
- Klicka på Create.
- Ange uppdateringstoken här. Förbered de andra inställningarna.
- Värdnamn bör ändras till "learningmanagereu" för EU-regioner.
- Spara och stäng konfigurationen.
- Välj en konfiguration och publicera den.
AEM Author aemauthor
AEM-skaparen måste först lägga till komponenten i AEM-mallen
AEM-utvecklaren kan sedan dra och släppa Adobe Learning Manager-komponenten och konfigurera därefter.
Learning Manager-komponenten kräver att den konfiguration som skapades i ovanstående steg mappas till sidan. Författaren kan mappa konfigurationen genom att redigera sidegenskaper under Advanced > Configuration > Cloud Configuration och ange sökvägen till konfigurationen. På så sätt kan författaren skapa konfigurationer för flera Learning Manager-konton och mappa var och en till olika webbplatser-sidor. Om en konfiguration inte mappas till sidan läser komponenten konfigurationen från mallsidan rekursivt tills den hittar en.
Elev learner
Eleven kan ta kurserna från sidan.
För att kunna komma åt Learning Manager-widgeten måste eleven vara en inloggad AEM-användare. Egenskapen email ska också finnas i noden /profile i elevens rep:User-nod. Denna e-postadress ska vara exakt densamma som den som finns i Learning Manager-kontot.
Eleven kan ta kurserna från sidan.
Kursens förlopp sparas också.
Följande widgetar finns:
- Spelifiering
- Utbildningskalender
- Social widget
- Katalogwidget
- Mitt lärande
- Rekommendation baserad på kollegialt lärande
- Recommendations efter administratör
- Rekommendation baserat på elevintressen
Om det inte finns några rekommendationer visas widgeten tom.
Stöd för Skyline
Skyline är molnversionen av AEM. Du måste först installera Skyline från pakethanteraren. För att kunna använda Skyline-komponenten i AEM måste en användare finnas i Learning Manager-kontot. Med andra ord måste användarens e-postadress finnas i kontot.
Distribuera Stadssilhuett
Stegen för att konfigurera Skyline nämns i GitHub-rapporten.
Min utbildningswidget
Med widgeten My Learning kan du visa utbildning från en viss katalog eller en uppsättning kataloger för en användare.
Välj Properties bland alternativen i avsnittet Catalog i sidegenskaperna.
Katalogalternativen innehåller följande alternativ:
-
Catalog ids: Kommaavgränsade katalog-ID:n som utbildningen måste visas för.
-
Sort: Sorteringsordning för utbildningen. Följande sorteringsalternativ finns:
- namn: Sorterar utbildningsobjekt i bokstavsordning från A till Ö.
- -name: Sorterar utbildningsobjekt alfabetiskt från Ö till A.
- datum: sorterar efter datum i stigande ordning.
- -date: Sorterar efter datum i fallande ordning (senaste först).
- dateCreated: Sorterar efter det datum då utbildningsobjektet skapades (äldsta först).
- -dateCreated: Sorterar efter skapelsedatum (senaste först).
- dateEnrolled: Sorterar efter elevens registreringsdatum (tidigaste först).
- -dateEnrolled: Sorterar efter registreringsdatum (senaste först).
- rating: Sorterar efter elevbetyg (lägsta till högsta).
- -rating: Sorterar efter betyg (högsta till lägsta).
- dueDate: sorterar efter kursens förfallodatum (den tidigaste deadline först).
- effektivitet: Sorterar efter effektivitetspoäng baserat på elevfeedback.
- framsteg: Sorterar på elevframsteg (minst framsteg till de flesta).
-
Learner State: Returnerar all utbildning som använder följande som filter: registrerad, påbörjad, slutförd och inte registrerad. Sökresultaten visas inte om sorteringsalternativet är dateEnrolled, dueDate eller dateEnrolled.
-
Skill name: Den kompetens som används för att filtrera exakt utbildning.
-
Tag name: Taggen som används för att filtrera exakta resultat.
Här är några ytterligare komponenter som du kan anpassa:
Learning Object Types: Filter enligt typen för utbildningsobjektet. De typer som stöds är: kurs, certifiering, jobAid och learningProgram.
I AEM kommer korttiteln i en remsa att vara tom från början. I Egenskaper skriver du titeln i widgets.html.
Anpassning
Du kan anpassa utseendet och känslan på layouten med hjälp av widgets.html. Du kan ändra utseendet på korten som visas och anpassa temat.
I avsnittet General Settings kan du välja primär- och sekundärfärger för korten och ange egenskaper för att anpassa temat.
{
"globalCssText":"@import url('https://fonts.googleapis.com/css2?family=Grandstander:ital,wght@0,100;0,200;0,300;0,400;0,500;0,600;0,700;0,800;0,900;1,100;1,200;1,300;1,400;1,500;1,600;1,700;1,800;1,900&family=Montserrat:ital,wght@0,100;0,200;0,300;0,400;0,500;0,600;0,700;0,800;0,900;1,100;1,200;1,300;1,400;1,500;1,600;1,700;1,800;1,900&display=swap');",
"fontNames":"Grandstander",
"cardLayout":{
"cardLayoutName":"compact",
"cardPrimaryColor":"#376BA4",
"cardSecondaryColor":"#F98EB0",
"startedStateTextColor":"#ffffff",
"continueStateTextColor":"#ffffff",
"revisitStateTextColor":"#ffffff",
"startedStateColor":"#a0a0a0",
"continueStateColor":"#f9a122",
"revisitedStateColor":"#7fbc64",
"textPrimaryColor":"#ffffff",
"textSecondaryColor":"#d93f3f",
"navIconColor":"#a0a0a0"
}
}
Konfigurera sparade kurswidgetar på AEM-webbplatser
Med widgeten Sparade kurser kan elever visa bokmärkta eller sparade kurser direkt på sina utbildningssidor, vilket ger enkel åtkomst till kurser de vill gå igenom eller slutföra senare.
Så här konfigurerar du widgeten Mina sparade kurser på AEM-webbplatser:
- Starta AEM-webbplatserna.
- Öppna sidan i läget Edit.
- Gå till Components Browser och lägg till My Learning widget på sidan.
- Markera komponenten och välj sedan Configure.
- Välj My Saved Courses i listrutan i Properties.
- Välj Done och uppdatera sedan sidan i läget Preview eller Publish.
Elever kan visa sina sparade kurser i remsan Saved by Me på elevens startsida. Om du väljer remsan Saved by Me kommer eleverna till katalogsidan och visar det exakta antalet bokmärkta kurser.
När du använder ett annat filter i katalogen visas bara de resultat som matchar det filtret. Bokmärkta objekt inkluderas inte automatiskt.
Ignorera högre ordning för LO-registrering
Om kryssrutan Ignorera registrering av högre ordningsföljd är aktiverad och en användare registreras direkt i ett utbildningsprogram eller en certifiering, kommer kurserna för det certifieringen eller utbildningsprogrammet att visas för användaren i widgetarna.
Om kryssrutan är inaktiverad visas inte de kurser som finns i utbildningsprogrammet eller certifieringen där användaren inte har registrerat sig direkt.
*Markera kryssrutan Ignorera registrering till högre order-LO.
Inställningen används sedan på widgeten.
Säkerhet
Fälten Klient-ID och Klienthemlighet läggs till. Dessutom maskeras uppdateringstoken. När en användare har skapat hela konfigurationen, om användaren öppnar konfigurationen igen för att redigera den eller om någon annan användare öppnar den här konfigurationen, maskeras uppdateringstoken.