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. Håll muspekaren över mig i det övre högra hörnet och välj sedan Integrera . 
3. Välj fliken Access content and reports via API .
   
4. Expandera avsnittet Generera LinkedIn Learning REST API Application .
5. Klicka på Lägg till applikation .
6. Fyll i formuläret, förklara hur integrationen kommer att användas och hänvisa till din Totara-webbplats.
7. Välj Innehåll för alternativet Välj nycklar.
8. Klicka på Nästa. När du har sparat applikationen kommer du att kunna 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åtkomstmenyn > 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. Anteckna detaljerna i det nya avsnittet (LinkedIn Learning , eller det namn du gav i steg 2) eller lämna denna flik öppen.
5. I LinkedIn Learning, gå till Konfigurera rapporteringsintegrationer .
   
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.
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. Om det behövs kan du ge specifika användare totara/oauth2:manageproviders möjligheten 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 Tillåt rutan 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 inledande konfigurationen av Totara och LinkedIn för att stödja denna integration innebär några olika steg. Vi rekommenderar att arbeta igenom dessa steg, och om du fortfarande behöver hjälp, vänligen skapa ett supportärende (inklusive relevanta detaljer och skärmdumpar som beskrivs nedan).

För att LinkedIn Learning-avslutningen ska fungera finns det ett antal förutsättningar. 

Först måste webbplatsen 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

Sedan, för att en sluthändelse ska bli spårad, måste följande vara sant vid tidpunkten då sluthändelsen inträffade i LinkedIn Learning:

• Organisationen måste ha konfigurerat spårningen av framsteg och slutförande av lärandehändelser.
• E-postadressen till användaren som slutför innehåll i LinkedIn Learning måste matcha e-postadressen till Totara-användaren. Observera att det måste vara e-postadressen till LinkedIn Learning-kontot, inte något LinkedIn-konto som är associerat med LinkedIn Learning-kontot.
• E-postadressen får inte användas av flera olika användare på Totara-sajten (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 det associerade LinkedIn Learning-innehållet måste existera på Totara-sajten.
• Kurs- och aktivitetskomplettering måste vara aktiverad och korrekt konfigurerad i den kursen (så kommer det att vara om aktiviteten importerades via LinkedIn Learning).
• Totara-användaren med matchande e-postadress måste vara inskriven i Totara-kursen som innehåller LinkedIn Learning-aktiviteten.

Om allt ovan är sant, bör sluthä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 att slutförandet i LinkedIn har inträffat. 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 en del av LinkedIn Learning-innehållet.
3. Det innehållet importeras sedan till Totara.
4. Användaren med samma e-postadress skrivs senare in på den kursen.
5. Från och med Totara 16 kommer slutförandet att markeras vid inskrivningstillfället.

För att sajten ska ta emot "framstegsutlåtanden" (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 att xAPI-framstegshändelser aktiveras för ditt konto.

Vi rekommenderar att du kontrollerar och tillhandahåller följande skärmdumpar till Totara Support-teamet:

• Sidan OAuth2-providerns detaljer på Totara-sidan (Snabbåtkomstmeny > Server > OAuth2 > Oauth2-providerns 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 utökad, klicka sedan på redigeringsikonen bredvid den specifika integrationen och ta en skärmdump av dialogrutan.
• LinkedIn-användarens Inlärningshistorik sida (Min lärande > Inlärningshistorik) som visar kursen som är slutförd.
• Aktivitetssidan i Totara som visar samma innehåll som inte är slutfört, inklusive hela sidan så vi kan se vem som är inloggad i det övre högra hörnet.
• Totara-användarens profil, som visar deras Totara e-postadress.
• LinkedIn Learnings användarprofilssida, som visar deras LinkedIn Learning e-postadress. Detta kan nås genom att gå till LinkedIn Learning Admin > People > Användare, och sedan klicka på användarens namn.
• Totara kursanmälanssida, som visar att användaren är anmäld (med anmälningsdatum om möjligt).

Ge ytterligare support och identifiera fler problem

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

Vi kommer att behöva HTTP-åtkomst och fel-loggar för de fem minuter runt den tidpunkt då en slutförandehändelse inträffade i LinkedIn, tillsammans med den exakta tidpunkten för när LinkedIn-slutförandet inträffade. Vi kommer att leta efter förekomsten och HTTP-statuskoden av förfrågningar i formatet:

• POST SITE_URL/totara/oauth2/token.php
• POST SITE_URL/totara/xapi/receiver.php

Om dessa förfrågningar inte finns tyder det på att det finns ett problem på LinkedIn Learning-sidan, antingen med konfigurationen 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 behöver aktivera felsökning och skicka oss fullständiga stacktraces av alla misslyckade förfrågningar för dessa filer.

Om begärandena faktiskt existerar 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 inom webbplatsen. För att felsöka detta behöver vi tillgång till en kopia av dessa databastabeller (eller åtminstone raderna från runt tiden 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