Stel de LinkedIn Learning-integratie in

Met deze integratie kunnen sitebeheerders en contentmakers door inhoud van LinkedIn Learning bladeren en deze importeren naar een Totara-site. Cursisten kunnen naadloos door LinkedIn Learning-cursussen bladeren en er toegang toe krijgen vanuit Totara, en voltooiing en het volgen van deze cursussen zijn geïntegreerd in de rapportage van Totara.

Voorwaarden

Voorwaarden voor het gebruik van de Totara / LinkedIn Learning-integratie:  

• Totara 15 (en hoger) Learn
• Professioneel LinkedIn Learning-abonnement

Integratie setup

Voordat je de integratie in Totara opzet, moet je eerst je Client ID en Client secret verkrijgen van LinkedIn.

1. Navigeer als beheerder naar de LinkedIn Learning admin interface.
2. Ga met de muis over Mij in de rechterbovenhoek en selecteer Integreren. 
3. Selecteer het tabblad Toegang tot inhoud en rapporten via API.
   
4. Vouw de sectie Genereer LinkedIn Learning REST API-toepassing uit.
5. Klik op Aanvraag toevoegen.
6. Vul het formulier in en leg uit hoe de integratie zal worden gebruikt en refereer naar je Totara-site.
7. Selecteer Inhoud voor de Kies  sleutels optie.
8. Klik op Volgende. Zodra je de aanvraag hebt opgeslagen, kun je de Client ID en  Client secret kopiërenen plakken.

Doe het volgende om de LinkedIn Learning-integratie in Totara op te zetten:

1. Navigeer naar het snelmenu > Content Marketplaces. 
2. Klik op Instellen naast LinkedIn Learning en selecteer vervolgens Inschakelen.
3. Klik op het tandwielicoontje () naast LinkedIn Learning.
   
4. Geef je Client ID en Client secret van LinkedIn Learning.
5. Klik op Wijzigingen opslaan.

Je kunt deze instellingen bewerken door op het tandwielicoontje () naast LinkedIn Learning te klikken of je kunt de integratie uitschakelen door op het oogicoontje () te klikken.

Schakel het bijhouden van de voortgang en voltooiing van de uitvoering in

Nu moet je de integratie configureren om het volgen van de voortgang en voltooiing van de studie mogelijk te maken.

1. Ga naar het snelmenu > Server > OAuth 2 > OAuth 2 provider details.
2. Klik op Voeg provider toe.
3. Geef de provider een naam (bijv. 'LinkedIn Learning') en Omschrijving, klik dan op Voeg provider toe.
4. Maak een notitie van de details in de nieuwe sectie (LinkedIn Learningof de naam die je in stap 2 gegeven hebt), of laat dit tabblad open.
5. Ga in LinkedIn Learning naar Configureer rapportage-integraties.
   
6. Vouw de sectie Configure xAPI uit.
7. Selecteer Integratie toevoegen.
8. Kies een integratienaam en stel het gebruikerstype in op E-mail.
9. Vul de URL's, Client ID en Client secret in van stap 4.
10. Klik op Inschakelen.

Om ervoor te zorgen dat de voltooiingsresultaten van je cursisten correct worden weergegeven in Totara, moet je de volgende stappen hebben voltooid:

1. Configuratie binnen LinkedIn Learning-beheerder voltooid.
2. Het e-mailadres van de Totara-gebruiker moet exact overeenkomen met het e-mailadres van de LinkedIn Learning-gebruiker die een cursus heeft voltooid.
3. Het e-mailadres van de gebruiker mag niet gebruikt worden door meerdere verschillende gebruikers op de Totara-site (het e-mailadres moet een gebruiker uniek identificeren).
4. De Moodle-gebruiker moet aangemeld zijn voor de cursus in Moodle.

OAuth provider mogelijkheid

Je kunt een gebruiker toewijzen om de OAuth-providers van je site te beheren (zoals LinkedIn Learning), zonder hen bredere beheerdersmogelijkheden en privileges te geven. Indien nodig kun je specifieke gebruikers de totara/oauth2:manageproviders mogelijkheid geven op systeemniveau. Een gebruiker met deze mogelijkheid in de systeemcontext kan de lijst met OAuth2-providers zien, nieuwe maken en bestaande verwijderen.

Volg deze stappen om deze mogelijkheid aan een rol toe te voegen:

1. Navigeer naar het snelmenu > Rechten Rollen > definiëren.
2. Bewerk de rol waarvoor je de mogelijkheid wil toevoegen of maak een nieuwe rol indien nodig.
3. Scrol naar beneden en vink het vakje Toestaan aan voor OAuth 2-providers beheren (totara/oauth2:manageproviders).
4. Scrol omlaag en klik op Wijzigingen opslaan.
5. Wijs de rol toe aan de gebruiker(s) die je wil beheren OAuth-providers.

Troubleshooting

De initiële configuratie van Totara en LinkedIn om deze integratie te ondersteunen, omvat een aantal verschillende stappen. We raden je aan om deze stappen door te nemen. Als je nog steeds hulp nodig hebt, maak dan een ondersteuningsticket aan (inclusief de relevante details en schermafbeeldingen, zoals hieronder beschreven).

Om de voltooiing van LinkedIn Learning te laten werken, zijn er een aantal voorwaarden. 

Ten eerste moet de site op het openbare internet staan (zodat LinkedIn er contact mee kan opnemen). Als de site zich achter een firewall bevindt, moeten ten minste de volgende URL's openbaar toegankelijk worden gemaakt:

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

Om een voltooiingsgebeurtenis te kunnen volgen, moet het volgende waar zijn op het moment dat de voltooiing plaatsvond in LinkedIn Learning:

• De organisatie moet het bijhouden van de voortgang en voltooiing van de leeractiviteit hebben geconfigureerd.
• Het e-mailadres van de gebruiker die de inhoud in LinkedIn Learning voltooit, moet overeenkomen met het e-mailadres van de Totara-gebruiker. Let op dat het het e-mailadres van de LinkedIn Learning-account moet zijn, niet van een LinkedIn-account die is gekoppeld aan de LinkedIn Learning-account.
• Het e-mailadres mag niet gebruikt worden door meerdere verschillende gebruikers op de Totara-site (het e-mailadres moet een Moodle-gebruiker uniek identificeren).
• De Totara-gebruiker moet actief zijn (niet geblokkeerd of verwijderd).
• Een Totara-cursus met het bijbehorende deel van de LinkedIn Learning-inhoud moet bestaan op de Totara-site.
• Cursus en activiteit voltooien moet ingeschakeld en juist geconfigureerd zijn in die cursus (dat zal het geval zijn als de activiteit geïmporteerd is via LinkedIn Learning).
• De Totara-gebruiker met het bijpassende e-mailadres moet aangemeld zijn in de Totara-cursus die de LinkedIn Learning-activiteit bevat.

Als al het bovenstaande waar is, moet de voltooiing worden verzonden en verwerkt door de Totara-site en moet de voltooiing worden ontvangen.

Verdere stappen voor het oplossen van problemen

Er zijn enkele bijkomende situaties waarin voltooiing van Totara kan plaatsvinden nadat voltooiing in LinkedIn heeft plaatsgevonden. Overweeg een voorbeeld waarbij een gebruiker werkt via LinkedIn Learning-inhoud die later aan Totara wordt toegevoegd:

1. De LinkedIn Learning-integratie is al geconfigureerd.
2. Voortgang of voltooiing vindt plaats in een deel van LinkedIn Learning-inhoud.
3. Die inhoud wordt dan geïmporteerd in Totara.
4. De gebruiker met hetzelfde e-mailadres is later ingeschreven voor die cursus.
5. Vanaf Totara 16 wordt voltooiing gemarkeerd op het moment van inschrijving.

Om de site 'voortgangsverklaringen' te laten ontvangen (d.w.z. gedeeltelijk voltooien als percentage in plaats van alleen wanneer de inhoud is voltooid), moet het LinkedIn Learning-account van de organisatie zijn geconfigureerd om deze functie te activeren. Neem contact op met je LinkedIn Learning-vertegenwoordiger en vraag of xAPI-voortgangsevenementen zijn ingeschakeld voor je account.

We raden aan om de volgende schermafdrukken te controleren en te verstrekken aan het Totara-ondersteuningsteam:

• De detailpagina van de OAuth2-provider aan de Totara-zijde (snelmenu > Server > OAuth2 > Oauth2-providerdetails). De specifieke client moet worden uitgevouwen, maar de client ID en het geheim kunnen onscherp gemaakt worden.
• De xAPI-configuratie aan de LinkedIn-zijde (Me > Integreren > Rapportage-integraties configureren > Configure xAPI uitgevouwen , klik vervolgens op het bewerk-icoontje naast de specifieke integratie en maak een schermafbeelding van het dialoogvenster.
• De pagina Studiegeschiedenis van de LinkedIn-gebruiker (Mijn studie > Studiegeschiedenis ) die de voltooide cursus toont.
• De activiteitspagina in Totara die hetzelfde deel van de inhoud toont als niet voltooid, inclusief de volledige pagina, zodat we kunnen zien wie ingelogd is in de rechterbovenhoek.
• Het profiel van de Totara-gebruiker, waarop zijn e-mailadres wordt getoond.
• De profielpagina van de LinkedIn Learning-gebruiker die zijn LinkedIn Learning e-mailadres toont. Je kunt dit openen door naar LinkedIn Learning Admin > Mensen > Gebruikers te gaan en vervolgens op de naam van de gebruiker te klikken.
• De inschrijvingspagina van de Totara-cursus, die toont dat de gebruiker is ingeschreven (met indien mogelijk de inschrijvingsdatum).

Extra ondersteuning bieden en verdere problemen identificeren

Als de integratie juist lijkt te zijn geconfigureerd en nieuwe voltooiingen nog steeds niet zijn ontvangen, hebben we aanvullende informatie nodig om te onderzoeken wat er gebeurt.

We hebben de HTTP-toegangs- en foutlogboeken nodig voor de vijf minuten rond de tijd van een voltooiingsgebeurtenis die heeft plaatsgevonden in LinkedIn, samen met de exacte tijd waarop de LinkedIn-voltooiing heeft plaatsgevonden. We zullen kijken naar het bestaan en de HTTP-statuscode van verzoeken van het formaat:

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

Als deze verzoeken niet bestaan, suggereert dit dat er een probleem is aan de LinkedIn Learning-zijde, ofwel met de configuratie van de integratie of met een tijdelijk LinkedIn Learning-probleem.

Als de verzoeken wel bestaan maar HTTP-statuscodes hebben die niet 200 zijn, dan wijst dat op een probleem met het ontvangen van de gegevens. Je moet foutopsporing inschakelen en ons de volledige stack sporen sturen van eventuele mislukte aanvragen voor die bestanden.

Als de verzoeken wel bestaan en HTTP-statuscodes 200 hebben, dan suggereert dat dat de gegevens correct zijn ontvangen. Dit geeft een configuratieprobleem aan met het voltooien van de cursus of een ander probleem binnen de site. Om te debuggen dat we toegang nodig hebben tot een kopie van deze databanktabellen (of minstens de rijen van rond de tijd van de geslaagde gebeurtenissen hierboven beschreven):

• totara_xapi_statement
• marketplace_linkedin_user_progress

Volgende stappen

• Stel cursisten in LinkedIn Learning in
• Importeer inhoud van LinkedIn Learning