API-ändringar i aprilversionen 2026

I aprilversionen 2026 av Adobe Learning Manager introduceras fokuserade förbättringar av det offentliga API:t kring alternativ och motsvarigheter, tidsbegränsad åtkomst till innehåll, innehållsdrivna frågeformulärsförsök, icke-inloggade upplevelser och arbetsstödshantering. Ändringarna är utformade för att i stor utsträckning vara bakåtkompatibla samtidigt som de möjliggör mer exakta integreringar.

Adaptiv utbildning för utbildningsvägar

Den här versionen innehåller komplett stöd för offentligt API för anpassningsbara utbildningsvägar. Utbildningsvägar (LP) kan nu definiera anpassningsbara regler som styr vilka avsnitt och underutbildningsobjekt (sub-LO:er) som är synliga för olika elevgrupper, och det offentliga API:t återspeglar detta beteende.

Följande slutpunkter påverkas:

Ett nytt booleskt attribut, attributes.isAdaptive, indikerar att ett utbildningsprogram använder adaptiva regler. När flaggan är true tolkas section-attributet adaptivt.

För elevanrop returneras bara avsnitt som är synliga för den aktuella eleven. Varje avsnitt innehåller en lista över utbildningsobjekt-ID:n (loID:n), en obligatorisk flagga och ett obligatorisktLOCcount som beräknas baserat på den adaptiva konfigurationen för den eleven samt ett sectionId. Relationen relations.subLOs filtreras nu också, så den innehåller endast de underutbildningsobjekt som är synliga för den eleven.

För administratörsanrop kan avsnitt dessutom visa en adaptiveConfig-matris. Detta beskriver de adaptiva reglerna per användargrupp, inklusive userGroupId, userGroupName och huruvida avsnittet är obligatoriskt för den gruppen. Administratörsinriktade verktyg kan använda det för att visualisera och hantera anpassningsbara regler.

Återställ slutförande för utbildningsprogram

Versionen introducerar ett API för att uppdatera (återställa) slutförande för utbildningsobjekt, inklusive adaptiva utbildningsprogram. Detta stöder scenarier som omskolning, periodiska uppdateringar av regelefterlevnad eller programomstarter.

En ny slutpunkt är tillgänglig:

POST /primeapi/v2/learningObjects/{loId}/instances/{loInstanceId}/refreshCompletion

Den här åtgärden kräver lämpliga skrivbehörigheter och återställer slutförandeläget för den angivna instansen av utbildningsobjekt i den angivna användarkontexten. Det är avsett att användas i automatiseringar på administratörssidan eller av elevverktyg med noggrann omfattning.

En gruppversion av den här funktionen planeras via ett jobb-API. Formen för begäran är utformad för att nå användare via e-post, användar-ID eller användargrupp-ID, till exempel:

{
  "emails": ["[user1@example.com](mailto:user1@example.com)", "[user2@example.com](mailto:user2@example.com)"],
  "userIds": ["12345", "67890"],
  "userGroupIds": ["ug1", "ug2"]
}

Integreringar bör använda detta API när de behöver starta om elever i varje program eller kurs. Klienter måste hantera felsvar på ett smidigt sätt: API:t kan avvisa uppdateringsbegäranden där en återställning inte är tillämplig (t.ex. när inget slutförande finns eller utbildningsobjekttyper som inte stöds).

Motsvarigheter och alternativa kompletteringar

För att stödja implementeringar där flera utbildningsobjekt kan uppfylla samma krav introducerar versionen ekvivalenter och alternativa slutföranden som offentliga API:er.

Slutpunkterna för utbildningsobjektet innehåller nu denna information:

- GET /primeapi/v2/learningObjects
- GET /primeapi/v2/learningObjects/{loId}

Ett nytt booleskt attribut, attributes.isAlternateComplete, indikerar om elevens slutförande för ett givet utbildningsobjekt är resultatet av ett alternativt eller likvärdigt utbildningsobjekt i stället för själva objektet. När detta är sant visar relationen relations.alternateCompletions de utbildningsobjekt som fungerade som alternativ. Detta gör det möjligt för efterföljande rapporter och instrumentpaneler att skilja mellan direkta och alternativa slutföranden och att visa vilket alternativ som uppfyllde kravet.

Dessutom möjliggör en vy med relaterade utbildningsobjekt identifiering av potentiella alternativ som kan tillfredsställa ett utbildningsobjekt. Detta visas via:

GET /primeapi/v2/learningObjects/{loId}/relatedLOs?type=sourceAlternateLOs&limit={n}

Svaret returnerar utbildningsobjekt som kan fungera som alternativ och innehåller ett meta.count-fält som anger det totala antalet sådana alternativ, oberoende av den aktuella gränsen. Integreringar kan använda detta för att visa rekommenderade motsvarigheter eller för att skapa administrativa vyer av alternativa mappningar.

Användningsfall för rapportering och analys

Användare som genererar rapporter eller analyser bör uppdatera sin logik för att lägga till isAlternateComplete och alternateCompletions i sina rapporteringsarbetsflöden.

Rapporteringsintegreringar som förbrukar slutförandedata (till exempel LT-export, anpassade datalagerfeeds eller BI-instrumentpaneler) bör utöka sin logik för att läsa och behålla båda attributen.isAlternateComplete och relations.alternateCompletions från LO API

Typiska användningsfall:

Utan att inkludera dessa två fält kommer nedströmsrapporter att behandla alternativa slutföranden som vanliga slutföranden och kommer inte att kunna förklara varför en elev visar sig ha slutfört en utbildning som hen aldrig slutfört direkt.

Elevers beteende jämfört med Admin LO API

Den flerspråkiga arbetsstödsstrukturen är identisk i både elev- och administratörs LO API:er. Elevomfattning returnerar bara de arbetsstöd som är synliga för eleven, men för varje synligt arbetsstöd visar den alla konfigurerade språkinställningar via flera resursenheter (en per språkinställning) och flera lokaliserade metadata. Administratörsomfånget returnerar alla jobbinslag som administratören kan hantera, med samma LO-modell och språkspecifika resurs-ID. Kunder med elevomfattning bör välja den resurs vars attribut.språkområde bäst matchar elevens innehållsspråk, medan administratörsverktyg kan räkna upp alla språk för rapportering och hantering.

Checklista med kommentarsfunktion

För att stödja arbetsflöden där granskare kan dela strukturerad feedback om checklistebaserade aktiviteter tar den här versionen fram checklista med kommentarer och granskarens synlighetskontroller via resurs-API:et för utbildningsobjekt.

Checklisterrelaterade metadata visas på enheter learningObjectResource (JApiLOResource, "type": "learningObjectResource") som representerar checklisteresurser inom en kurs eller annat utbildningsobjekt.

Informationen är tillgänglig via:

GET /primeapi/v2/learningObjects/{loId}?include=instances.loResources

När utbildningsobjektinstansen innehåller resurser av checklisttyp visar motsvarande learningObjectResource-poster i den inkluderade arrayen kommentars- och granskarsynlighetsattribut under attribut och granskaridentitet under relationer.

Nya kommentarsattribut för checklista

För checklistresurser kan följande attribut finnas i learningObjectResource:

Annan checklistspecifik kontext, som checklistEvaluationStatus, isChecklistMandatory, resourceSubType: "CHECKLIST" och submissionDate finns också tillgängliga på samma learningObjectResource för att stödja mer omfattande checklista för användargränssnitt och rapportering.

Granskarens identitetsrelation

När granskarens namn ska vara synliga innehåller learningObjectResource en relation som pekar på granskarens användare:

"relationships": {
  "checklistReviewedBy": {
    "data": {
      "id": "user_id",
      "type": "user"
    }
  }
}

Den här relationen fylls i bara om:

Klientprogram bör:

Åtkomst till resurser och kommentarer för checklistor

För att hämta checklisteresurser och deras kommentarer för ett visst utbildningsobjekt ska klienterna:

GET /primeapi/v2/learningObjects/{loId}?include=instances.loResources

Det här mönstret gör att fjärradministrerade eller anpassade klienter kan återge en omfattande checklista, inklusive status, obligatoriska/valfria flaggor och granskarens feedback, direkt från Prime API:er.

Överväganden gällande rapportering och användarupplevelser

Flerspråkigt stöd för arbetsstöd

För att stödja implementeringar där arbetsstöd måste levereras på flera språk till både elever och administratörer, utökar den här versionen hanteringen av arbetsstöd så att en resurs per plats returneras i stället för en enda hårdkodad en-US-resurs.

Flerspråkiga arbetsstöd fortsätter att använda den befintliga hierarkin:

utbildningsobjekt (lo) → learningObjectResource (loResource) → resurs

Inga ändringar krävs i API-avtalet. Allt lokaliserat arbetsstöd passar in i den här strukturen naturligt, med separata resursenheter per språkområde och delade lokaliserade metadata på nivåerna learningObject/learningObjectResource.

Arbetsstödsdata visas via:

GET /primeapi/v2/learningObjects/jobAid:{jobAidId}?include=instances.loResources.resources

När ett arbetsstöd har flera språkvarianter innehåller den inkluderade arrayen flera "type": "resource"-poster - en för varje språk (till exempel en-US, fr-FR, es-ES), alla länkade från en enda learningObjectResource.

Arbetsstödsstruktur på flera språk

Flerspråkigt arbetsstöd:

Ett typiskt mönster för flerspråkiga arbetsstöd är:

Klienter kan välja lämplig resurs genom att matcha elevens språkinställning med fältet resource.attributes.locale.

Nytt resurs-ID-format för arbetsstöd

Om du vill kunna skilja mellan flera lokaliserade varianter av en jobbbiståndsresurs har resurs-ID-formatet ändrats.

Gammalt resurs-ID-format

Tidigare användes ett ogenomskinligt ID-format för arbetsstödsresurser, till exempel:

arbetsstöd:131032_-1_-1_2_resource

Det här formatet kodade inte nationella inställningar, och API:er visade endast en resurs (vanligtvis en-US).

Nytt resurs-ID-format (flerspråksanpassat)

Det nya formatet är:

jobAid:<jobAidId>_<version>_<localeCode>

Exempel:

Visuell nedbrytning:

jobAid:131032_2_fr_FR

        │      │ │ │

        │      │ │ └──► Locale Code (fr_FR, en_US, es_ES, etc.)

        │      │ └────► Version (2)

        │      └──────► JobAid ID (131032)

        └─────────────► Resource Type Prefix ("jobAid:")

Med den här strukturen kan klienter:

Bakåtkompatibilitet:

/resources/{resourceId}

Den äldre resursslutpunkten är fortfarande tillgänglig:

Nu är den bakåtkompatibel med både gamla och nya ID-format:

Integreringar som för närvarande lagrar eller refererar till gamla resurs-ID:n kan fortsätta att fungera utan ändringar, medan nyare implementeringar uppmuntras att använda det nya ID-formatet för språkspecifika åtgärder.

Överväganden om integrering och användarupplevelser

Tidsbegränsningar för startmoduler

Vissa utbildningsupplevelser måste endast vara tillgängliga inom ett angivet tidsintervall. Versionen visar information om tid och plats för utbildningsobjekt och introducerar en valideringsslutpunkt som kontrollerar om en elev kan starta en resurs vid den aktuella tidpunkten.

Metadata för tid/plats är tillgängliga via slutpunkten:

GET /primeapi/v2/learningObjects/{loId}?include=instances.loResources

På utbildningsobjektets resursnivå kan ett timeSlot-objekt nu finnas i attributen, med startTime- och endTime-värden i UTC. Detta anger under vilket fönster som resursen kan startas.

Innan du startar en modul kan integreringar anropa en ny valideringsslutpunkt:

GET /primeapi/v2/learningObjects/{loId}/instances/{loInstanceId}/loResources/{loResourceId}/canStart

Denna slutpunkt, som är avsedd för scenarier som läses av elever, returnerar huruvida eleven för närvarande får starta resursen med hänsyn till konfigurerad tid, leveranstyp och andra backend-regler.

Anpassade spelare och klientapplikationer bör använda canStart för att tvinga fram tidsbaserad åtkomst och använda timeSlot-metadata för att visa tydliga meddelanden om när innehåll blir tillgängligt eller upphör att gälla. Negativa svar från canStart bör hanteras uttryckligen för att informera elever om varför innehållet inte kan startas än eller längre.

Innehållsdrivna frågeformulär som körs på flera försök

Vissa innehållspaket implementerar sin egen försöksspårning i stället för att enbart förlita sig på Adobe Learning Manager. Versionen introducerar en flagga som indikerar när försök görs av själva innehållet.

Genom:

GET /primeapi/v2/learningObjects/{loId}?include=instances.loResources

Utbildningsobjektresurser kan nu visa ett booleskt attribut med attributet hasContentDrivenAttemptTracking. När detta är sant hanterar frågesporten eller modulen försök internt (till exempel via SCORM eller xAPI-logik), och plattformens standardräknare för försök kanske inte helt återspeglar elevens upplevelse.

Integreringar som visar antalet försök eller styr återförsöksbeteendet bör kontrollera den här flaggan. När det är aktiverat ska de inte sluta sig till försöksgränser enbart från plattformsmetadata och ska vara beredda att förlita sig på rapportering på innehållssidan (till exempel via xAPI-satser) eller företagsspecifika regler.

Beteendeförändring i ID-format för arbetsstödsresurs

Den här versionen introducerar en viktig beteendeförändring i formatet för resurs-ID:n för arbetsstöd. Även om det inte finns någon ny slutpunkt har det en direkt inverkan på system som lagrar eller parsar dessa ID:n.

Tidigare använde resurs-ID:n för arbetsstöd ett format som:

jobAid:<jobAidId>_-1_-1_2_resource

I aprilversionen 2026 ska detta ersättas med ett förenklat och mer explicit format:

jobAid:<jobAidId>_<version>_<localeCode>

Till exempel:

arbetsstöd:131032_2_fr_FR

Komponenterna är:

Alla integreringar som indexerar resurser eller finns kvar i resurs-ID:n för arbetsstöd måste uppdatera sin parsnings- och lagringslogik så att det nya formatet känns igen. Eftersom identifierarna i sig ändras rekommenderar vi starkt att du återskapar alla lokala index som är transparenta med resurs-ID:n för arbetsstöd efter uppgradering till versionen från april 2026.

Ställ in kursbannerbilder via migrering

Du kan nu ställa in eller uppdatera kursbannerbilder i Adobe Learning Manager som en del av ditt standardarbetsflöde för migrering. Det hjälper dig att starta eller rensa stora kataloger samtidigt som kurssidorna hålls visuellt konsekventa, utan manuell redigering

Där banderollbilder definieras

Banderollbilder konfigureras i migreringsfilen course.csv, som du redan använder för att tillhandahålla kursmetadata, till exempel:

Med den här förbättringen innehåller specifikationen course.csv ytterligare en valfri kolumn för kursbannerbilden. Det exakta rubriknamnet definieras i CSV-specifikationen som du hämtar från ditt Learning Manager-konto (den kan till exempel visas som bannerUrl eller bannerImageUrl).

Banderollkolumnen:

Förbereda banderollbilder för migrering

id,courseName,courseCreationDate,state,author,thumbnailUrl,bannerUrl
12345,DEMO1,2018-05-05T08:56:21.000Z,Published,Sudheer,pic1.png,banners/banner1.png
45678,DEMO2,2018-05-05T08:56:21.000Z,Published,Sudheer,pic2.png,banners/banner2.png

Använda banderoller under en migreringskörning

När course.csv har uppdaterats är flödet detsamma som all annan migrering:

Nya kurser jämfört med befintliga kurser

Banderollfältet fungerar i båda scenarierna:

De faktiska kolumnnamnen och sökvägarna måste matcha den hämtade CSV-specifikationen och innehållslagringslayouten.

Ta bort orderkolumn i LearningProgramCourse

Adobe Learning Manager har nu stöd för en förenklad modell för kursbeställning inuti utbildningsvägar (utbildningsprogram) under migrering. Som en del av den här ändringen tas kolumnen order bort från migreringsfilen learning_program_course.csv.

Tidigare innehöll filen learning_program_course.csv en kolumn (kallas ofta för order eller liknande) som användes för att:

Nu använder Adobe Learning Manager inte längre orderkolumnen i learning_program_course.csv för att avgöra kursordningen. Migreringens CSV-fil fokuserar i stället på vilka kurser som tillhör vilket utbildningsprogram, snarare än hur de ordnas numeriskt.

Inverkan på CSV-filer för migrering

learning_program_course.csv

Du bör behandla den äldre kolumnen för ordningsföljd som borttagen eller ignorerad:

Använd alltid de senaste CSV-specifikationerna från ditt Learning Manager-konto (via csv_fications.zip) för att bekräfta den aktuella rubrikuppsättningen och kraven.

timeZoneCode i kursinstanser

Från och med den här versionen visar kursinstansmodellen (learningObjectInstance) ett nytt attribut:

timeZoneCode - ett strängfält som uttryckligen länkar en kursinstans till en av kontots konfigurerade tidszoner.

Detta gör att klienter kan:

Där timeZoneCode visas

Fältet läggs till i attributen för modellen learningObjectInstance
endast för kursinstanser.

Exempel:

{
  "id": "course:1262748_1359228",
  "type": "learningObjectInstance",
  "attributes": {
    "dateCreated": "2019-08-06T13:50:39.000Z",
    "isAET": false,
    "isDefault": true,
    "timeZoneCode": "356",
    "isFlexible": false,
    "state": "Active",
    "localizedMetadata": [
      {
        "locale": "en-US",
        "name": "Default instance"
      }
    ]
  }
}

Så löser du timeZoneCode

Den numeriska timeZoneCode är en uppslagsnyckel i kontots tidszonskatalog, som visas via konto-API

GET /primeapi/v2/account
Authorization: Bearer <access_token>

I svaret anges tidszonerna i:

"data": {
  "attributes": {
    "timeZones": [
      {
        "name": "Etc/GMT+12",
        "timeZoneCode": "356",
        "utcOffset": -720,
        "utcOffsetCode": "UTC-12:00(Etc/GMT+12)",
        "zoneId": "Etc/GMT+12"
      },
      "..."
    ]
  }
}

Rekommenderat klientflöde:

Asynkrona offentliga API:er för medlemskap i användargrupper

Introduktion

Adobe Learning Manager visar två asynkrona API:er för administratörer för att hantera medlemskap i användargrupper (UG):

I stället för att uppdatera medlemskapet i samma begäran accepterar dessa API:er din batch och returnerar ett händelse-ID. Det faktiska resultatet levereras senare via webhooks.

Använd dem när

För små, interaktiva administratörsåtgärder kan du fortsätta använda de synkrona /userGroups/{id}/users API:erna.

Autentisering och bas-URL

Dessa API:er ingår i standardytan för v2 Admin API.

Allmänt beteende och omfattning i Admin API finns i:

Format för begäran

Både lägg till och ta bort använder exakt samma kroppsform.

Text

{
  "metadata": {
    "event_id": "my-optional-correlation-id",
    "sourceSystem": "HRIS",
    "batchId": "hr_2026_03_30_0001"
  },
  "data": [
    { "type": "user", "id": "11101219" },
    { "type": "user", "id": "11101220" }
  ]
}

data (obligatoriskt)

data är listan över användarresursidentifierare för den här batchen.

Begränsningar

Om något av dessa villkor misslyckas returnerar API ett fel och inget står i kö.

metadata (valfritt)

metadata är ytterligare korrelationsdata som du vill ska upprepas i webhooken.

Normal användning:

Tjänsten returnerar det här objektet oförändrat i webhook-svaret, så du kan matcha återanropet med ditt interna jobb.

Begränsningar:

Svarsformat

Båda slutpunkterna svarar synkront med ett händelse-ID:

{ "event_id": "cd2972c8-cb15-47a0-a23f-e4a16cb720f5" }

Beteende:

Du bör alltid:

Visa Webhookar för att lägga till och ta bort användargruppsmedlemskap om du vill ha mer information.

Vanliga frågor

Hur ändrar aprilversionen 2026 learningObjects API för adaptiva utbildningsprogram?

Denna version lägger till en isAdaptive-flagga på utbildningsprogram och gör avsnitt och subLO:er elevmedvetna. I adaptiva program ser eleverna bara de avsnitt och underutbildningsobjekt som är synliga för dem baserat på adaptiva regler, medan administratörer kan se den underliggande adaptiva konfigurationen för en användargrupp.

Behöver jag uppdatera integreringen om den förutsätter att alla avsnitt och underordnade LO:er alltid returneras?

Ja. För adaptiva utbildningsprogram returnerar API nu bara de avsnitt och sub-LO:er som är synliga för den aktuella eleven. Klientkoden bör behandla svaret som den auktoritativa, eventuellt filtrerade vyn i stället för att anta en fullständig lista.

Hur kan jag programmässigt återställa en elevs slutförande för en kurs eller ett utbildningsprogram?

Använd den nya slutpunkten:

POST /primeapi/v2/learningObjects/{loId}/instances/{loInstanceId}/refreshCompletion
Detta återställer slutförandet för målinstansen när behörigheter och tillstånd tillåter det.

Hur vet jag om en elev har slutfört något via ett alternativt eller motsvarande utbildningsobjekt?

Kontrollera attributet isAlternateComplete på utbildningsobjektet. Om det är sant visar relationen alternateCompletions de utbildningsobjekt som fungerade som alternativ för den elevens slutförande.

Hur hittar jag alla alternativ som kan uppfylla ett visst utbildningsobjekt?

Använd följande slutpunkt:

GET /primeapi/v2/learningObjects/{loId}/relatedLOs?type=sourceAlternateLOs&limit={n}

och använd datamatrisen (för alternativen) och meta.count (för det totala antalet alternativ).

Hur vet jag om en elev får starta en modul just nu?

Först hämtar du resursens timeSlot från:

GET /primeapi/v2/learningObjects/{loId}?include=instances.loResources
och använd sedan

GET /primeapi/v2/learningObjects/{loId}/instances/{loInstanceId}/loResources/{loResourceId}/canStart

Vad innebär ContentDrivenAttemptTracking för en resurs?

Det indikerar att försöksspårning styrs av själva innehållet (till exempel via SCORM/xAPI-logik) snarare än bara av plattformsräknare. När det är sant ska du inte bara förlita dig på antalet plattformsförsök eller begränsningar för din användarupplevelse och rapportering.

Hur hittar jag menyer som är lämpliga för användare som inte är inloggade (offentliga upplevelser)?

Användning:

GET /primeapi/v2/templates/menus?include=pages,subMenus.pages&isNonLoggedIn=true

Detta returnerar meny- och sidstrukturer som filtrerats för anonyma användare, och som lämpar sig för Experience Builder eller andra huvudlösa webbplatser.

Vad har ändrats i jobbstödsfiltreringen med effectiveModifiedDate?

Begäranden som kombinerar filter.effectiveModifiedDate med filter.loTypes=jobAid returnerar nu korrekt endast arbetsstöd inom det angivna datumfönstret.

Vad har ändrats i ID-formatet för arbetsstödsresursen och hur ska jag hantera det?

ID-formatet har ändrats från värden som:

jobAid:<jobAidId>_-1_-1_2_resource

till:

jobAid:<jobAidId>_<version>_<localeCode>

till exempel jobAid:131032_2_fr_FR. Alla system som lagrar eller parsar resurs-ID:n för arbetsstöd måste uppdateras och du bör planera för att återskapa lokala index som är transparenta med dessa ID:n efter uppgradering till versionen från april 2026.