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. Vid behov kan du ge specifika användare totara/oauth2:manageproviders rättighet 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 innebär några olika steg. Vi rekommenderar att du går igenom dessa steg, och om du fortfarande behöver hjälp, skapa ett supportärende (inklusive relevanta detaljer och skärmdumpar enligt beskrivningen nedan).

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

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

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

För att en slutförandehändelse ska spåras måste följande vara sant vid tidpunkten då slutförandehändelsen inträffade i LinkedIn Learning:

• Organisationen måste ha konfigurerat spårning av framsteg och slutförande av utbildningstillfällen .
• Ee-postadress för användare som fyller i innehållet i LinkedIn Learning måste matcha e-postadressen för Totara-användare. Observera att det måste vara LinkedIn Learning-kontots e-postadress, inte något LinkedIn-konto som är kopplat till LinkedIn Learning-kontot.
• Ee-postadress får inte användas av flera olika användare på Totaras webbplats (e-postadressen måste unikt identifiera en Totara-användare).
• Totara-användare måste vara aktiv (inte avstängd eller raderad).
• En Totara-kurs som innehåller tillhörande innehåll för LinkedIn Learning måste finnas på Totaras webbplats.
• aktivitetsgenomförande måste vara aktiverat och korrekt konfigurerat i den kursen (det kommer att vara fallet om aktiviteten importerades via LinkedIn Learning).
• Totara-användare med den matchande e-postadress måste vara registrerad i Totara-kursen som innehåller LinkedIn Learning-aktiviteten.

Om allt ovanstående är sant ska slutförandehändelsen skickas och bearbetas av Totara-centret och slutförandet tas emot.

Ytterligare felsökningssteg

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

1. Integreringen av LinkedIn Learning har redan konfigurerats.
2. Framsteg eller slutförande sker i en del av LinkedIn Learning-innehåll.
3. Detta innehåll importeras sedan till Totara.
4. användare med samma e-postadress registreras senare på den kursen.
5. Från och med Totara 16 kommer slutförande att markeras vid tidpunkten för registrering .

För att webbplatsen ska kunna ta emot ”framstegsutdrag” (dvs. delvis slutförande i procent snarare än endast när innehållet är slutfört) måste organisationens LinkedIn Learning-konto konfigureras så att den här funktionen är aktiverad. Kontakta din LinkedIn Learning-representant och be om att xAPI-förloppshändelser aktiveras för ditt konto.

Vi rekommenderar att du kontrollerar och tillhandahåller följande skärmdumpar till Totaras supportteam:

• Informationssidan för OAuth2-leverantör på Totaraadministrationsmeny > Server > OAuth2 > Information om Oauth2-leverantör ). Den specifika klienten bör utökas, men klient-ID och hemlighet kan suddas ut.
• xAPI-konfigurationen på LinkedIn-sidan (Me > Integrate > Configure reporting integrations > Configure xAPI expand , klicka sedan på redigeringsikonen bredvid den specifika integrationen och ta en skärmdump av dialogen.
• LinkedIn-användare  Inlärningshistoriksida (Min Inlärning > Inlärningshistorik ) visar kursen som är slutförd.
• Aktivitetssidan i Totara som visar samma innehåll som inte slutfört, inklusive hela sidan så att vi kan se vem som är inloggad i det övre högra hörnet.
• Totaraanvändare profil som visar deras Totara-e-postadress .
• LinkedIn Learning-användare profilsida, som visar deras LinkedIn Learning-e-postadress . Detta kan nås genom att gå till LinkedIn Learning Admin > Personer > användare sedan klicka på användare namn.
• Totara registrering, som visar att användare är registrerad (med registrering om möjligt).

Ge ytterligare stöd och identifiera ytterligare problem

Om integrationen verkar vara korrekt konfigurerad, och nya genomfö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 felloggarna för de fem minuterna runt tidpunkten för en slutförandehändelse inträffade i LinkedIn, tillsammans med den exakta tiden som LinkedIn-slutförandet inträffade. Vi kommer att leta efter existens- och HTTP-statuskod för 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 detta 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 andra HTTP-statuskoder än 200, vilket tyder på att det finns ett problem med att ta emot data. Du måste aktivera felsökning och skicka oss alla stackspår av eventuella misslyckade förfrågningar för dessa filer.

Om förfrågningarna finns och har HTTP-statuskoder på 200, så tyder det på att data mottogs korrekt. Detta indikerar antingen ett konfigurationsproblem med genomförande av kurs eller något annat problem lokalt på webbplatsen. För att felsöka att vi kommer att behöva tillgång till en kopia av dessa databastabeller (eller åtminstone raderna från 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