Konfigurera integrationen av LinkedIn Learning

Denna integration gör det möjligt för webbplatsadministratörer och innehållsskapare att bläddra och importera innehåll från LinkedIn Learning till en Totara-webbplats. Elever kan sömlöst bläddra och få tillgång till LinkedIn Learning-kurser inifrån Totara, och slutförande och spårning av denna utbildning är integrerad i Totaras rapportering.

Förutsättningar

Förutsättningar för att använda Totara / LinkedIn Learning integration:  

• Totara 15 (och högre) Lär dig

• Professionellt LinkedIn Learning-abonnemang

Inställning av integration

Innan du konfigurerar integrationen i Totara måste du först få ditt klient-ID och klienthemlighet från LinkedIn.

1. Som administratör, navigera till admingränssnittet för LinkedIn Learning .

2. Från den vänstra sidomenyn, expandera Inställningar, klicka sedan på Integration. 

   

3. Välj fliken Åtkomst till innehåll och rapporter via API , och expandera sektionen Generera LinkedIn Learning REST API-applikation .

   

4. Klicka på Lägg till applikation .

5. Fyll i formuläret, förklara hur integrationen kommer att användas och hänvisa till din Totara-webbplats.

6. Välj Innehåll för alternativet Välj nycklar.

7. Klicka på Nästa . När du har sparat applikationen kan du kopiera och klistra in Klient-ID och Klienthemlighet.

För att börja konfigurera LinkedIn Learning-integrationen i Totara, följ dessa steg:

1. Navigera till Snabbåtgärdsmeny > Innehållsmarknadsplatser. 

2. Klicka på Konfigurera bredvid LinkedIn Learning och välj sedan Aktivera .

3. Klicka på kugghjulsikonen ( ) bredvid LinkedIn Learning.
   

   

4. Ange ditt kund-ID och kundhemlighet från LinkedIn Learning.

5. Klicka på Spara ändringar.

Du kan redigera dessa inställningar genom att klicka på kugghjulsikonen () bredvid LinkedIn Learning, eller så kan du inaktivera integrationen genom att klicka på ögonikonen ().

Aktivera spårning av framsteg och genomförande av utbildningstillfällen

Därefter måste du konfigurera integrationen för att möjliggöra spårning av framsteg och genomförande av utbildning.

1. Gå till snabbåtkomstmenyn > Server > OAuth 2 > OAuth 2-leverantörsuppgifter .

2. Klicka på Lägg till leverantör .

3. Ge leverantören ett namn (t.ex. 'LinkedIn Learning') och Beskrivning , klicka sedan på Lägg till leverantör .

4. Notera detaljerna i den nya sektionen (LinkedIn Learning, eller namnet du gav i steg 2), eller lämna denna flik öppen.

   

5. I LinkedIn Learning, gå till Konfigurera rapportintegreringar, och expandera sektionen Konfigurera xAPI .
   

6. Expandera avsnittet Konfigurera xAPI .

7. Välj Lägg till integration .

8. Välj ett integrationsnamn och ställ in användartypen på E-post .

9. Ange webbadresser, klient-ID och klienthemlighet från steg 4.

   Notera: De URL-etiketter som LinkedIn Learning använder jämfört med vad Totara betecknar matchar inte när anslutningar ställs in (särskilt xAPI-URL:en).

   Tabellen nedan beskriver vad webbadresserna hänvisas till i Totara vs hur de är märkta i LinkedIn Learning:

   Totara-namn	LinkedIn Learning-namn
   Oauth-server URL	OAuth-server URL
   URL till xAPI-server	Tenance-server URL

10. Klicka på Aktivera.

    

För att säkerställa att dina resultat återspeglas korrekt i Totara måste du ha genomfört följande steg:

1. Konfiguration inom LinkedIn Learning admin slutförd.

2. Totara-användarens e-postadress måste exakt matcha e-postadressen för LinkedIn Learning-användaren som genomförde en kurs.

3. Användarens e-postadress får inte användas av flera olika användare på Totaras webbplats (e-postadressen måste unikt identifiera en användare).

4. Totara-användaren måste vara registrerad på kursen i Totara.

OAuth-leverantörskapacitet

Du kanske vill tilldela en användare för att hantera din webbplats OAuth-leverantörer (t.ex. LinkedIn Learning), utan att ge dem bredare administratörsfunktioner och behörigheter. Vid behov kan du ge specifika användare kapaciteten totara/oauth2:manageproviders på systemnivå. En användare med denna funktion i systemkontexten kommer att kunna se listan över OAuth2-leverantörer, skapa nya och radera befintliga.

Gör så här för att lägga till denna funktion till en roll:

1. Navigera till snabbåtkomstmenyn > Behörigheter > Definiera roller .

2. Redigera den roll som du vill lägga till kapaciteten för eller skapa en ny roll om så krävs.

3. Bläddra ner till och markera rutan Tillåt för Hantera OAuth 2-leverantörer (totara/oauth2:manageproviders).

4. Bläddra nedåt och klicka på Spara ändringar .

5. Tilldela rollen till den/de användare(er) som du vill hantera OAuth-leverantörer.

Felsökning

Den initiala konfigurationen av Totara och LinkedIn för att stödja denna integration innefattar några olika steg. Vi rekommenderar att du går igenom dessa steg, och om du fortfarande behöver hjälp, vänligen skapa ett supportärende (inklusive relevanta detaljer och skärmdumpar enligt beskrivningen nedan).

För att LinkedIn Learns slutförande ska fungera finns det ett antal förutsättningar. 

För det första måste sidan vara på det offentliga internet (så att LinkedIn kan kontakta den). Om webbplatsen är bakom en brandvägg måste åtminstone följande URL:er göras offentligt tillgängliga:

• SITE_URL/totara/oauth2/token.php

• SITE_URL/totara/xapi/receiver.php

För att ett slutförandehändelse ska kunna spåras, måste följande vara sant vid tidpunkten för händelsen i LinkedIn Learning:

• Organisationen måste ha konfigurerat spårningen av lärandehändelsets framsteg och slutförande.

• E-postadressen för användaren som slutför innehåll i LinkedIn Learning måste matcha e-postadressen för Totara-användaren. Observera att det måste vara e-postadressen för LinkedIn Learning-kontot, inte något LinkedIn-konto som är kopplat till LinkedIn Learning-kontot.

• E-postadressen får inte användas av flera olika användare på Totara-webbplatsen (e-posten måste unikt identifiera en Totara-användare).

• Totara-användaren måste vara aktiv (inte avstängd eller raderad).

• En Totara-kurs som innehåller den associerade LinkedIn Learning-innehållet måste finnas på Totara-webbplatsen.

• Kurs och aktivitets slutförande måste vara aktiverat och korrekt konfigurerat i den kursen (det blir fallet om aktiviteten importerades via LinkedIn Learning).

• Totara-användaren med den matchande e-postadressen måste vara inskriven i Totara-kursen som innehåller LinkedIn Learning-aktiviteten.

Om allt ovanstående är sant bör slutförandehändelsen skickas och behandlas av Totara-sajten och slutförandet tas emot.

Ytterligare felsökningssteg

Det finns några ytterligare situationer där Totara-slutförande kan ske efter slutförande i LinkedIn har skett. Tänk på ett exempel där en användare arbetar igenom LinkedIn Learning-innehåll som senare läggs till i Totara:

1. LinkedIn Learning-integrationen har redan konfigurerats.

2. Framsteg eller slutförande sker i ett stycke LinkedIn Learning-innehåll.

3. Detta innehåll importeras sedan till Totara.

4. Användaren med samma e-postadress blir senare inskriven i den kursen.

5. Från och med Totara 16 kommer slutförande att markeras vid tidpunkten för anmälan.

För att webbplatsen ska kunna ta emot 'framstegsrapporter' (d.v.s. delvis slutförande som en procentandel snarare än endast när innehållet är slutfört), måste organisationens LinkedIn Learning-konto vara konfigurerat för att ha denna funktion aktiverad. Vänligen kontakta din LinkedIn Learning-representant och be om att xAPI framstegshändelser aktiveras för ditt konto.

Vi rekommenderar att du kontrollerar och förser Totara Support-teamet med följande skärmdumpar:

• OAuth2-leverantörens detaljer sidan på Totara-sidan (Snabbåtkomstmeny > Server > OAuth2 > Oauth2-leverantörens detaljer). Den specifika klienten bör expandera, men klient-ID och hemlighet kan suddas ut.

• xAPI-konfigurationen på LinkedIn-sidan (Jag > Integrera > Konfigurera rapporteringsintegrationer > Konfigurera xAPI expanderat, klicka sedan på redigeringsikonen bredvid den specifika integrationen och ta en skärmdump av dialogrutan.

• LinkedIn-användarens Lärhistorik sidan (Min Lärande > Lärhistorik) som visar kursen som är slutförd.

• Aktivitetssidan i Totara som visar samma innehållsstycke som ej slutfört, inklusive hela sidan så vi kan se vem som är inloggad uppe i högra hörnet.

• Totara-användarens profil, som visar deras Totara e-postadress.

• Användarens profil på LinkedIn Learning, som visar deras e-postadress för LinkedIn Learning. Detta kan nås genom att gå till LinkedIn Learning Admin > Personer > Användare, och sedan klicka på användarens namn.

• Inskrivningssidan för Totara-kursen, som visar att användaren är inskriven (med inskrivningsdatum om möjligt).

Ge ytterligare stöd och identifiera fler problem

Om integrationen verkar vara korrekt konfigurerad, och nya avslut fortfarande inte tas emot, behöver vi ytterligare information för att undersöka vad som händer.

Vi kommer behöva HTTP-åtkomst och fel-loggar för de fem minuterna runt tiden för en sluthändelse inträffade i LinkedIn, tillsammans med den exakta tiden då LinkedIn-slutet inträffade. Vi kommer att leta efter förekomsten och HTTP-statuskoden för begäranden av formatet:

• POST SITE_URL/totara/oauth2/token.php

• POST SITE_URL/totara/xapi/receiver.php

Om dessa begäranden inte existerar tyder det på att det är ett problem på LinkedIn Learning-sidan, antingen med konfigurering av integrationen eller ett tillfälligt problem med LinkedIn Learning.

Om förfrågningarna finns men har HTTP-statuskoder andra än 200, tyder det på att det finns ett problem med att ta emot data. Du kommer att behöva aktivera felsökning och skicka oss de fullständiga stackspåren för alla misslyckade förfrågningar för dessa filer.

Om förfrågningarna finns och har HTTP-statuskoder på 200, tyder det på att datan mottogs korrekt. Detta indikerar antingen ett konfigurationsproblem med kursens slutförande eller något annat problem lokalt på webbplatsen. För att felsöka detta behöver vi tillgång till en kopia av dessa databastabeller (eller åtminstone raderna från omkring den tidpunkt för de lyckade händelserna som beskrivs ovan):

• totara_xapi_statement

• marketplace_linkedin_user_progress

Nästa steg

• Konfigurera deltagare i LinkedIn Learning

• Importera innehåll från LinkedIn Learning