LMS-integrationer och öppet API: en köpguide

En lärplattform blir aldrig bättre än systemen den är kopplad till. Det märks första gången synken mot HR-systemet slutar fungera. Någon i teamet öppnar ett kalkylark för att hålla koll på vem som har gått vilken utbildning, och veckan efter är det två personer som uppdaterar det. Problemet är sällan en funktion som saknas. Problemet är att det manuella arbetet du köpte plattformen för att slippa har kommit tillbaka.

Kanske är det du som ska koppla in plattformen i systemmiljön. Eller så är det du som får frågan från revisorn om vem som har åtkomst till vad. I båda fallen leder frågan ”Har den ett API?” ingenstans, eftersom nästan alla leverantörer svarar ja. Ställ hellre tre andra frågor. Är det ett riktigt, öppet API eller en kort lista med färdiga kopplingar? Kan teamet läsa dokumentationen utan att först boka ett säljmöte? Och finns det en människa att få tag på när något slutar fungera klockan fyra en fredagseftermiddag?

Vi går igenom vad öppet API och bra utvecklarstöd innebär och vilka fyra integrationslager du behöver bedöma vart för sig. Sedan kommer frågorna som skiljer en plattform du kan bygga vidare på från en som du får brottas med i flera år. Sist berättar vi hur vi har löst det på Learnifier.

Vad betyder ”öppet API” och ”bra utvecklarstöd” egentligen?

Ett öppet API är ett dokumenterat och publikt tillgängligt gränssnitt som låter dina egna system läsa och skriva data i lärplattformen med vanliga webbanrop. ”Öppet” syftar på att kunderna och deras utvecklare kommer åt gränssnittet och kan läsa dokumentationen själva. Det har inget med öppen källkod att göra.

Ett bra API är RESTful. URL:erna är alltså förutsägbara och byggda kring resurser, och anropen görs med standardiserade HTTP-metoder. Datan skickas i ett strukturerat format som JSON och autentiseringen är säker. Uppfyller API:t de kraven kan en utvecklare som aldrig har sett just din plattform ofta gissa sig till hur det fungerar.

Utvecklarstöd är allt som finns runt omkring API:t, och det avgör om ditt team blir klart på några dagar eller får hålla på i veckor. Dit hör tydlig dokumentation och ett säkert ställe att testa på. Dit hör också en autentiseringsmodell som går att leva med, förutsägbar versionshantering och människor som hjälper till när dokumentationen inte räcker.

Orden integration och API används ofta om vartannat, men de betyder olika saker. En integration är en färdig koppling som leverantören bygger och underhåller, till exempel en synk mot ett visst HR-system. API:t är verktygslådan som dina utvecklare använder för att bygga de kopplingar leverantören aldrig räknade med. De starka plattformarna har båda. En lista med färdiga kopplingar är bekväm ända tills du behöver just den som saknas, och då är det bara ett öppet API som hjälper.

De fyra integrationslagren du ska utvärdera

Integrationer är fyra olika saker. En plattform kan vara riktigt bra på en av dem och svag på en annan, så bedöm dem vart för sig.

1. Identitet: single sign-on och provisionering

Det är här de flesta införanden antingen tar fart eller kör fast. Med single sign-on (SSO) loggar deltagarna in via den identitetsleverantör organisationen redan använder och slipper hålla reda på ännu ett lösenord. Leta efter de standarder som IT-avdelningen redan har: SAML, OpenID Connect och en koppling till katalogtjänsten, oftast Active Directory eller Microsoft Entra.

Provisionering är minst lika viktigt men glöms oftare bort. Det handlar om hur konton skapas, uppdateras och avaktiveras. Standarden SCIM (System for Cross-domain Identity Management) sköter det automatiskt. Utan SCIM behåller den som har slutat sitt aktiva konto tills någon kommer ihåg att ta bort det för hand. Med SCIM avaktiveras kontot automatiskt. Utbildar du fler än några hundra personer är SCIM ett ska-krav. Det är också en av skiljelinjerna när du gör en fullständig utvärdering av LMS för stora företag.

2. Data och själva API:t

Börja med grunderna i API-lagret: är API:t RESTful, är det dokumenterat och går det att förstå hur autentiseringen fungerar? Gå sedan vidare till tre frågor som tunn dokumentation sällan svarar rakt på.

• Webhooks: Skickar plattformen händelser till dig i samma stund som de sker, till exempel när någon genomför en kurs eller registrerar sig? Eller måste ditt system fråga API:t enligt ett schema, så kallad pollning? Pollning är långsammare, drar mer resurser och ligger alltid lite efter. Med webhooks kan du automatisera i realtid.
• Anropsgränser: Hur många anrop får du göra innan plattformen börjar strypa dem (rate limits)? Svaret avgör om en engångssynk av hela användarbasen blir ett rutinjobb eller kostar dig en helg.
• Täckning: Vilka resurser kommer du faktiskt åt? ”Vi har ett API” kan betyda full läs- och skrivåtkomst, men det kan också betyda en handfull endpoints som bara går att läsa från. Kontrollera att datan du behöver för rapportering och beslutsunderlag finns med, och inte bara användarposterna.

3. Innehållsstandarder

Bygger du kurser i externa verktyg, eller kan du tänka dig att byta plattform någon gång, är det standarderna som skyddar det du har lagt ner. SCORM är den etablerade standarden, och en kurs som byggts i ett verktyg kan köras i vilken kompatibel plattform som helst. xAPI (Experience API, tidigare Tin Can API) spårar fler sorters lärande och skickar datan till en Learning Record Store. cmi5 är en nyare specifikation som förenar SCORM:s kursstruktur med xAPI:s flexibla spårning. ADL står bakom båda och beskriver cmi5 som SCORM:s efterträdare. LTI 1.3 är standarden för att koppla in externa lärverktyg direkt i plattformen.

Ställ sedan två separata frågor, eftersom leverantörer gärna bara svarar på den första. Vilka standarder kan plattformen köra? Och kan du få ut ditt material igen den dag du lämnar? Det praktiska provet på portabilitet är att du kan ladda ner det du har laddat upp. Tänk också på att stöd för en standard är något annat än konvertering till den. De flesta plattformar kan köra innehåll i SCORM, xAPI eller cmi5, men väldigt få gör om ditt befintliga material till de formaten åt dig.

4. Färdiga kopplingar

Det sista lagret handlar om bekvämlighet. Här hittar du färdiga kopplingar till verktyg du redan har: HR-system (HRIS), lönesystem, rekryteringsverktyg, CRM, samarbetsverktyg och kalender- och videoverktyg för livepass. Kopplingarna sparar ordentligt med tid, men de täcker bara det leverantören har valt att bygga. Behöver din systemmiljö något som leverantören inte räknade med är det öppna API:t reservvägen.

Hur kopplar du lärplattformen till systemen du redan har?

Tre integrationer dyker upp i nästan varje utvärdering: HR-systemet, CRM:et och samarbetsverktygen. De fyller olika syften och väcker olika frågor, så de får var sitt avsnitt.

Koppla ditt LMS till ditt HR-system (HRIS)

Kopplingen till HR-systemet håller deltagaruppgifterna korrekta. När den är på plats skapas nyanställda automatiskt i lärplattformen och byten av roll eller avdelning följer med. Den som slutar avaktiveras utan att någon behöver komma ihåg det. Den manuella inmatningen försvinner, risken för fel minskar och utbildningsdatan visar vem som faktiskt jobbar var. Kopplingen är också grunden för en automatiserad onboarding. Den nyanställda läggs in i HR-systemet, och rätt utbildning ligger redan och väntar första dagen.

Den tråkigaste frågan är den du ska ställa först. Fältmappningen kan vänta. Fråga i stället vem som avaktiverar kontot när någon slutar. Är svaret namnet på en person har du ingen integration än. Du har en påminnelse i någons kalender.

Koppla ditt LMS till ditt CRM

Utbildar du personer utanför organisationen, som kunder, partners eller återförsäljare, finns relationerna i CRM:et och utbildningen i lärplattformen. När systemen är ihopkopplade hamnar utbildnings- och certifieringsdata på rätt kontakt eller kundkonto. Sälj och customer success ser vem som har gått utbildningen, vem som är certifierad och hur långt kunden har kommit. Inom kund- och partnerutbildning är det så du visar vad utbildningen betyder för förnyelser och merförsäljning. Mer om det läser du i guiden om hur du kopplar ditt LMS till ditt CRM.

Microsoft Teams och andra samarbetsverktyg

Många vill att lärandet ska finnas där arbetet redan pågår. Med en koppling till Microsoft Teams eller Slack kan kursnotiser, påminnelser och länkar dyka upp i kanalerna som folk ändå har öppna. Då blir påminnelsen läst i stället för att bli liggande oöppnad i inkorgen. Har du liveutbildningar eller blandat lärande bör du också kolla hur plattformen fungerar ihop med video- och kalenderverktygen, så att passen bokas och synkas utan krångel. Kopplingarna gör nytta, men identitet och data väger tyngre.

Så utvärderar du utvecklarstödet (delen leverantörerna hoppar över)

Ett API med bra funktioner men dåligt stöd kostar dig ändå veckor. Gå igenom den här checklistan innan du skriver på.

• Publik dokumentation: Kan dina utvecklare läsa dokumentationen och testa API:t innan du har bundit dig? Interaktiv dokumentation, till exempel ett Swagger- eller OpenAPI-gränssnitt, är ett starkt tecken. Måste du boka ett säljmöte bara för att få se dokumentationen säger det också något.
• Ett säkert ställe att testa: Finns det en sandbox eller testmiljö där teamet kan bygga utan att röra riktig deltagardata?
• En rimlig autentiseringsmodell: API-nycklar eller tokens som är enkla att utfärda och hålla ordning på.
• Förutsägbar versionshantering: Versionerar leverantören sina ändringar i API:t och varnar i god tid, eller slutar dina integrationer fungera utan förvarning? Be att få se policyn för utfasning och ändringsloggen.
• Riktiga människor: Det är den här punkten köpare underskattar, och sedan ångrar de sig. Dokumentationen räcker för de flesta rutinfrågor. Men de udda specialfallen under driftstarten kräver någon som kan plattformen och svarar snabbt. Ett bra API utan någon bakom är ett bra API som du får felsöka på egen hand.

Utvecklarstöd handlar alltså lika mycket om människor som om dokumentation. De team som blir klara med sina integrationer snabbast är de som når någon som verkligen kan systemet. Stödet är lätt att förbise i en funktionsjämförelse och svårt att klara sig utan när lanseringen närmar sig.

Vilka frågor ska du ställa som köpare?

Ta med de här frågorna till nästa leverantörsdemo. Både svaren och hur villigt leverantören ger dem säger det mesta du behöver veta.

1. Kartlägg systemmiljön först. Vilka system måste plattformen prata med från dag ett, och vilka kan vänta? Bestäm det före demon, så att du bedömer leverantören mot din egen verklighet.
2. Skilj ska-krav från bör-krav. Har du fler än några hundra användare är SSO och automatisk provisionering oftast ska-krav. En specifik koppling kan vara ett bör-krav om det öppna API:t klarar samma sak.
3. Fråga vem som underhåller varje integration. En färdig koppling underhålls av leverantören. Bygger du själv på API:t blir det oftast ditt jobb. Klargör vem som är ansvarig för underhållet innan du bestämmer dig.
4. Välj mellan eget bygge och färdig koppling. Avgör för varje integration om det finns en färdig koppling eller om du ska bygga på API:t. Båda vägarna fungerar bra, så länge du vet i förväg vilken du har valt.
5. Testa hur portabelt innehållet är. Kan du få ut kurserna som SCORM eller xAPI? Följer materialet med om du byter plattform nästa år?
6. Granska säkerheten kring API-åtkomsten. Hur autentiserar leverantören anropen, hur avgränsas åtkomsten och var lagras din data? För europeiska organisationer, och för alla som har utbildning som måste hålla vid en revision, hör de svaren till kraven i upphandlingen.

Vilka misstag är vanligast?

Samma mönster återkommer i de integrationsprojekt som spårar ur.

• Att tro att ”har ett API” betyder ”har ett användbart API”: Ordet finns på varenda leverantörs webbplats. Dokumentationen, sandboxen och stödet bakom är betydligt ovanligare.
• Att glömma avaktiveringen: Teamen beskriver noga flödet för nyanställda men hoppar över flödet för dem som slutar. Utan automatisk provisionering blir avaktiveringen ett manuellt jobb, och en säkerhetslucka som ingen ser.
• Att strunta i innehållets portabilitet: Det känns oviktigt första dagen och avgörande den dag du vill byta plattform.
• Att underskatta underhållet: En integration är inte klar bara för att den är levererad. API:er ändras och system uppdateras, och någon måste se till att kopplingen fortsätter fungera.
• Att välja efter logotyper: En lång rad integrationslogotyper ser tryggt ut. Men en djup, väldokumenterad integration gör mer nytta än tio ytliga som du inte kan konfigurera.

Så arbetar vi på Learnifier med öppet API och utvecklarstöd

Vi byggde Learnifier för att passa in i den systemmiljö du redan har, så att du slipper möblera om efter oss. Flexibilitet är en av våra kärnprinciper, och det öppna API:t är en stor del av hur vi lever upp till den. Så här ser det ut i praktiken.

• Ett RESTful, öppet API. API:t har förutsägbara, resursorienterade URL:er, standardiserade HTTP-metoder (GET, POST, PUT och DELETE) och JSON över HTTPS. Det är dokumenterat i ett interaktivt Swagger-gränssnitt där utvecklarna kan utforska det direkt. Autentiseringen sker med HTTP Basic, med nyckel och secret.
• Webhooks, så att du slipper polla. Learnifier skickar händelser till dina system när de inträffar, som JSON över HTTPS till en endpoint du själv konfigurerar. Det finns fler än 20 dokumenterade händelsetyper, bland annat registrering, åtkomst, framsteg, genomförda kurser och moment, närvaro, certifikat, nya konton, väntelistor och ändringar i projekt. Svarar inte din endpoint gör Learnifier nya försök med allt längre mellanrum under flera dygn.
• Inga anropsgränser att planera runt. Vi har inga publicerade anropsgränser, bara en fair use-policy. Vill du synka hela användarbasen på en gång är det en ren teknisk uppgift som du kan köra när det passar dig.
• Sandbox för enterprise-kunder. Som enterprise-kund får du en sandbox-miljö där utvecklarna kan bygga och testa utan att röra riktig deltagardata.
• Identitet som fungerar. Du lägger till och synkar deltagare via det publika API:t och provisionerar användare automatiskt med SCIM. Vi stödjer SAML, OpenID Connect, Active Directory och Microsoft Entra, även i hybridlösningar där flera inloggningsmetoder körs parallellt med manuell inloggning.
• Innehållsstandarderna som spelar roll. Plattformen stödjer SCORM 1.2, xAPI och cmi5, plus LTI 1.3 för externa lärverktyg. Allt du laddar upp kan du ladda ner igen, så materialet förblir ditt. Däremot konverterar plattformen inte ditt befintliga innehåll mellan formaten, och det säger vi hellre rakt ut nu än att du upptäcker det senare.
• Ett riktigt bibliotek med kopplingar. Teamtailor och Jobylon för rekrytering, Hailey HR, Simployer och FlexHRM för HR, SD Worx för lön och Genially och WeAre för innehållsproduktion, med flera. Den aktuella listan hittar du på vår sida med integrationer.
• Hjälp att bygga integrationen. Utöver API:t finns Integration Services. Vårt team hjälper dig att kartlägga, bygga och underhålla integrationerna, så att dina utvecklare inte behöver bära allt själva.
• Europeiskt som standard. Learnifier är ett svenskt, europeiskt ägt företag och data lagras på EU-servrar. Vill du att datan ska stanna i Sverige kan du välja svensk hosting. GDPR ser vi som den självklara miniminivån.

Det som inte får plats i en API-referens är människorna. När ditt team integrerar Learnifier sitter de inte ensamma med en dokumentationssida.

”Vårt öppna API ger kunderna friheten att integrera Learnifier med de system och arbetsflöden de redan använder. Men vi vet också att ett API bara är halva ekvationen. Vårt tekniska team hjälper kunderna att förstå möjligheterna, hitta rätt angreppssätt och få integrationen på plats, oavsett om de bygger den själva eller behöver mer handfast stöd från oss.” - Simon Söderdahl, Technical Project Manager på Learnifier

Ditt nästa steg

Innan du pratar med någon leverantör: skriv ner de tre system som plattformen måste prata med från dag ett, och vem som är ansvarig för varje koppling. Be sedan varje leverantör om två länkar: API-dokumentationen och policyn för utfasning. Hur snabbt länkarna kommer säger mer än demon.

Vill du pröva listan mot ett riktigt API är du välkommen att ta med den till oss. Boka en demo och berätta vilka system som ska kopplas ihop, så går vi igenom exakt hur Learnifiers API och integrationer skulle fungera i din systemmiljö. Har du inte kommit så långt än och jämför fortfarande plattformar kan du börja med vår guide om hur du väljer rätt LMS.