API-Änderungen in der Version April 2026

Die Adobe Learning Manager-Version vom April 2026 enthält Verbesserungen der öffentlichen API für Alternativen und Entsprechungen, Zugriff im Zeitfenster auf Inhalte, inhaltsbasierte Quizversuche, nicht angemeldete Erlebnisse und die Verarbeitung von Arbeitshilfen. Die Änderungen sind weitgehend abwärtskompatibel ausgelegt und ermöglichen gleichzeitig präzisere Integrationen.

Adaptives Lernen für Lernpfade

Diese Version bietet vollständige Unterstützung für adaptive Lernpfade durch die öffentliche API. Lernpfade (LPs) können jetzt adaptive Regeln definieren, die steuern, welche Abschnitte und Sub-Lernobjekte (Sub-LOs) für verschiedene Teilnehmergruppen sichtbar sind. Die öffentliche API spiegelt dieses Verhalten wider.

Die folgenden Endpunkte sind betroffen:

Das neue boolesche Attribut "attributes.isAdaptive" gibt an, dass ein Lernprogramm adaptive Regeln verwendet. Wenn dieses Flag true ist, wird das section-Attribut adaptiv interpretiert.

Bei Teilnehmeranrufen werden nur Abschnitte zurückgegeben, die für den aktuellen Teilnehmer sichtbar sind. Jeder Abschnitt enthält die Liste der Lernobjekt-IDs (loIds), ein obligatorisches Flag und ein mandatoryLOCount, die basierend auf der adaptiven Konfiguration für diesen Teilnehmer berechnet werden, sowie die sectionId. Die Relation relations.subLOs wird jetzt ebenfalls gefiltert, sodass sie nur die Sub-Lernobjekte enthält, die für diesen Teilnehmer sichtbar sind.

Bei Admin-Aufrufen können Abschnitte zusätzlich ein adaptiveConfig-Array verfügbar machen. Hier werden die adaptiven Regeln pro Benutzergruppe beschrieben, einschließlich userGroupId, userGroupName und ob der Abschnitt für diese Gruppe obligatorisch ist. Admin-orientierte Tools können dies nutzen, um adaptive Regeln zu visualisieren und zu verwalten.

Abschluss für Lernprogramme zurücksetzen

Mit der Version wird eine API für die Aktualisierung (Zurücksetzen) des Abschlusses für Lernobjekte, einschließlich adaptiver Lernprogramme, eingeführt. Dies unterstützt Szenarien wie Umschulungen, regelmäßige Compliance-Aktualisierungen oder Programmneustarts.

Ein neuer Endpunkt ist verfügbar:

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

Dieser Vorgang erfordert entsprechende Schreibberechtigungen und setzt den Abschlussstatus für die angegebene Lernobjektinstanz im angegebenen Benutzerkontext zurück. Es ist für die Verwendung durch Admin-seitige Automatisierungen oder sorgfältig ausgewählte Teilnehmer-Tools vorgesehen.

Eine Massenversion dieser Funktion wird über eine Jobs-API geplant. Die Anforderungsform wurde entwickelt, um Benutzer per E-Mail, Benutzer-ID oder Benutzergruppen-ID anzusprechen, z. B.:

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

Integrationen sollten diese API verwenden, wenn sie die Teilnehmer in jedem Programm oder Kurs neu starten müssen. Clients müssen Fehlerantworten ordnungsgemäß verarbeiten: Die API kann Aktualisierungsanforderungen ablehnen, wenn eine Zurücksetzung nicht anwendbar ist (z. B. wenn kein Abschluss vorhanden ist oder nicht unterstützte Lernobjekttypen).

Äquivalente und alternative Abschlüsse

Um Implementierungen zu unterstützen, bei denen mehrere Lernobjekte dieselbe Anforderung erfüllen können, enthält die Version Entsprechungen und Alternativen als öffentliche APIs.

Die Lernobjektendpunkte enthalten jetzt diese Informationen:

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

Ein neues boolesches Attributattribut .isAlternateComplete gibt an, ob der Abschluss des Teilnehmers für ein bestimmtes Lernobjekt das Ergebnis eines alternativen oder gleichwertigen Lernobjekts ist und nicht das Objekt selbst. Wenn dies wahr ist, listet die Beziehung relations.alternativeCompletions die Lernobjekte auf, die als Alternativen fungierten. Dadurch können nachgelagerte Berichte und Dashboards zwischen direkten und alternativen Abschlüssen unterscheiden und zeigen, welche Alternative die Anforderung erfüllt hat.

Darüber hinaus ermöglicht eine Ansicht verwandter Lernobjekte die Erkennung potenzieller Alternativen, die ein Lernobjekt erfüllen können. Dies wird angezeigt über:

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

Die Antwort gibt Lernobjekte zurück, die als Alternativen fungieren können, und enthält ein meta.count-Feld, das die Gesamtzahl dieser Alternativen unabhängig vom aktuellen Grenzwert angibt. Integrationen können dies verwenden, um empfohlene Entsprechungen anzuzeigen oder administrative Ansichten alternativer Zuordnungen zu erstellen.

Nutzungsszenarien für Reporting und Analysen

Benutzer, die Berichte oder Analysen generieren, sollten ihre Logik aktualisieren, um isAlternateComplete und alternativeCompletions in ihre Berichterstellungs-Workflows einzufügen.

Berichtsintegrationen, die Abschlussdaten nutzen (z. B. LT-Export, benutzerdefinierte Data Warehouse-Feeds oder BI-Dashboards), sollten ihre Logik auf das Lesen und Beibehalten beider Attribute erweitern.isAlternateComplete und relations.alternativeCompletions von den LO-APIs:

Typische Anwendungsfälle:

Ohne die Einbeziehung dieser beiden Felder behandeln nachgelagerte Berichte alternative Abschlüsse als regelmäßige Abschlüsse und können warum nicht erklären, wenn ein Teilnehmer eine Schulung als abgeschlossen anzeigt, die er nie direkt absolviert hat.

Verhalten der Teilnehmer im Vergleich zur Admin-LO-API

Die Struktur der mehrsprachigen Arbeitshilfe ist sowohl in Teilnehmer- als auch in Administrator-LO-APIs identisch. Im Teilnehmerbereich werden nur die Arbeitshilfen zurückgegeben, die für den Teilnehmer sichtbar sind. Für jede sichtbare Arbeitshilfe werden jedoch alle konfigurierten Gebietsschemas über mehrere Ressourcenentitäten (eine pro Gebietsschema) und mehrere Gebietsschemas mit lokalisierten Metadaten verfügbar gemacht. Der Bereich "Administrator" gibt alle Arbeitshilfen zurück, die der Administrator verwalten kann, mit demselben LO-Modell und den gleichen gebietsschemaspezifischen Ressourcen-IDs. Kunden mit Teilnehmerbereich sollten die Ressource auswählen, deren attribute.locale am besten der Inhaltssprache des Teilnehmers entspricht, während Admin-Tools alle Gebietsschemas für die Berichterstellung und Verwaltung auflisten können.

Checkliste mit Kommentarfunktion

Um Arbeitsabläufe zu unterstützen, in denen Reviewer strukturiertes Feedback zu Aktivitäten auf der Grundlage von Checklisten freigeben können, werden in dieser Version Checklistenkommentare und Steuerelemente zur Reviewersichtbarkeit über die Lernobjektressourcen-API angezeigt.

Checklistenbezogene Metadaten werden für learningObjectResource-Entitäten (JApiLOResource, "type": "learningObjectResource") verfügbar gemacht, die Checklistenressourcen innerhalb eines Kurses oder eines anderen Lernobjekts darstellen.

Die Informationen sind abrufbar unter:

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

Wenn die Lernobjektinstanz Ressourcen vom Typ Checkliste enthält, werden die entsprechenden learningObjectResource-Einträge im enthaltenen Array unter Attributen die Attribute comment und reviewer-visibility und unter Beziehungen die Identität des Reviewers verfügbar machen.

Neue Kommentarattribute für Checkliste

Bei Ressourcen für Checklisten können die folgenden Attribute auf learningObjectResource vorhanden sein:

Andere checklistenspezifische Kontexte wie checklistEvaluationStatus, isChecklistMandatory, resourceSubType: "CHECKLIST" und submissionDate sind ebenfalls für dieselbe learningObjectResource verfügbar, um umfangreichere Checklisten-UIs und Berichte zu unterstützen.

Identitätsbeziehung des Überprüfers

Wenn Reviewernamen sichtbar sein sollen, enthält learningObjectResource eine Beziehung, die auf den Reviewerbenutzer verweist:

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

Diese Beziehung ist nur mit aufgefüllt, wenn:

Client-Anwendungen sollten:

Zugriff auf Ressourcen und Kommentare für Checkliste

Um Checklistenressourcen und ihre Kommentare für ein bestimmtes Lernobjekt abzurufen, sollten Clients:

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

Dieses Muster ermöglicht es Headless- oder benutzerdefinierten Clients, eine umfassende Checkliste zu rendern, einschließlich Status, obligatorischen/optionalen Flags und Prüfer-Feedback direkt von den Prime-APIs.

Reporting und UX.

Mehrsprachige Unterstützung für Arbeitshilfen

Um Implementierungen zu unterstützen, bei denen Arbeitshilfen in mehreren Sprachen sowohl für Teilnehmer als auch für Administratoren bereitgestellt werden müssen, erweitert diese Version die Arbeitshilfebehandlung auf eine Ressource pro Gebietsschema anstelle einer einzelnen hartcodierten en-US-Ressource.

Mehrsprachige Arbeitshilfen verwenden weiterhin die vorhandene Hierarchie:

Lernobjekt (lo) → learningObjectResource (loResource) → Ressource

Es sind keine Änderungen am API-Vertrag erforderlich. Jede lokalisierte Arbeitshilfe passt auf natürliche Weise in diese Struktur, mit separaten Ressourcenentitäten pro Gebietsschema und freigegebenen lokalisierten Metadaten auf den Ebenen learningObject/learningObjectResource.

Daten zur Arbeitshilfe werden angezeigt über:

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

Wenn eine Arbeitshilfe mehrere Sprachvarianten enthält, enthält das enthaltene Array mehrere "type": "resource"-Einträge - einen für jedes Gebietsschema (z. B. en-US, fr-FR, es-ES), die alle von einem einzigen learningObjectResource verknüpft sind.

Mehrsprachige Struktur der Arbeitshilfe

Mehrsprachige Arbeitshilfen verwenden:

Bei einer mehrsprachigen Arbeitshilfe ist ein typisches Muster:

Clients können die entsprechende Ressource auswählen, indem sie das Gebietsschema des Teilnehmers mit dem Feld resource.attributes.locale abgleichen.

Neues Ressourcen-ID-Format für Arbeitshilfen

Um mehrere lokalisierte Varianten einer Arbeitshilferessource richtig zu unterscheiden, hat sich das Ressourcen-ID-Format geändert.

Altes (veraltetes) Ressourcen-ID-Format

Früher verwendeten Arbeitshilferessourcen ein undurchsichtiges ID-Format wie:

jobAid:131032_-1_-1_2_resource

Dieses Format codierte das Gebietsschema nicht, und APIs würden tatsächlich nur eine einzelne Ressource (normalerweise en-US) verfügbar machen.

Neues Ressourcen-ID-Format (Unterstützung für mehrere Sprachen)

Das neue Format lautet:

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

Beispiele:

Visuelle Aufschlüsselung:

jobAid:131032_2_fr_FR

        │      │ │ │

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

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

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

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

Diese Struktur ermöglicht Clients Folgendes:

Abwärtskompatibilität:

/resources/{resourceId}

Der Endpunkt der alten Ressource bleibt verfügbar:

Es ist jetzt abwärtskompatibel mit dem alten und dem neuen ID-Format:

Integrationen, die derzeit die alten Ressourcen-IDs speichern oder auf sie verweisen, können weiterhin ohne Änderungen funktionieren, während neuere Implementierungen empfohlen werden, das neue ID-Format für gebietsschemaspezifische Operationen zu übernehmen.

Integration und UX

Zeitschlitzbeschränkungen für das Starten von Modulen

Einige Lernerlebnisse dürfen nur innerhalb eines festgelegten Zeitfensters verfügbar sein. In der Version werden Zeitfensterinformationen zu Lernobjektressourcen angezeigt und ein Validierungsendpunkt wird eingeführt, der überprüft, ob ein Teilnehmer eine Ressource zur aktuellen Zeit starten kann.

Zeitfenster-Metadaten sind über den Endpunkt verfügbar:

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

Auf der Lernobjektressourcenebene kann jetzt ein timeSlot-Objekt in den Attributen vorhanden sein, wobei die Werte startTime und endTime in UTC angegeben werden. Hier wird das Fenster angegeben, in dem die Ressource gestartet werden kann.

Vor dem Starten eines Moduls können Integrationen einen neuen Validierungsendpunkt aufrufen:

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

Dieser Endpunkt, der für Szenarien mit Lesevorgängen durch Teilnehmer vorgesehen ist, gibt unter Berücksichtigung des konfigurierten Zeitfensters, des Bereitstellungstyps und anderer Back-End-Regeln zurück, ob der Teilnehmer die Ressource derzeit starten darf.

Benutzerdefinierte Player und Clientanwendungen sollten canStart verwenden, um einen zeitbasierten Zugriff zu erzwingen, und die timeSlot-Metadaten verwenden, um klare Nachrichten darüber anzuzeigen, wann Inhalt verfügbar wird oder abläuft. Negative Antworten von canStart sollten explizit behandelt werden, um die Teilnehmer darüber zu informieren, warum der Inhalt noch nicht oder nicht mehr gestartet werden kann.

Inhaltsbasierte Tests mit mehreren Versuchen

Manche Inhaltspakete nutzen nicht nur Adobe Learning Manager, sondern implementieren auch eigene Funktionen zur Verfolgung von Versuchen. Die Version enthält ein Flag, das angibt, wenn Versuche vom Inhalt selbst gesteuert werden.

Über:

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

Lernobjektressourcen können jetzt ein boolesches Attribut hasContentDrivenAttemptTracking verfügbar machen. Wenn dies der Fall ist, verwaltet das Quiz oder Modul Versuche intern (z. B. über SCORM oder xAPI-Logik), und die Standardversuchszähler der Plattform geben möglicherweise die Erfahrung des Teilnehmers nicht vollständig wieder.

Integrationen, die die Anzahl der Versuche anzeigen oder das Wiederholungsverhalten steuern, sollten dieses Flag aktivieren. Wenn es aktiviert ist, sollten sie keine Versuchsbeschränkungen ausschließlich aus Plattform-Metadaten ableiten und sich auf Content-Side-Reporting (z. B. über xAPI-Anweisungen) oder unternehmensspezifische Regeln verlassen.

Verhaltensänderung im Format der Arbeitshilferessourcen-ID

Diese Version enthält eine wichtige Verhaltensänderung im Format der Arbeitshilferessourcen-IDs. Auch wenn kein neuer Endpunkt betroffen ist, hat dies direkte Auswirkungen auf Systeme, die diese IDs speichern oder analysieren.

Früher verwendeten Arbeitshilferessourcen-IDs ein Format wie:

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

In der Version vom April 2026 wird dies durch ein vereinfachtes und expliziteres Format ersetzt:

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

Beispiel:

jobAid:131032_2_fr_FR

Die Komponenten sind:

Jede Integration, die Ressourcen indiziert oder in Arbeitshilferessourcen-IDs verbleibt, muss ihre Analyse- und Speicherlogik aktualisieren, um das neue Format zu erkennen. Da sich die Bezeichner selbst ändern, wird dringend empfohlen, alle lokalen Indizes, die von Arbeitshilferessourcen-IDs nach dem Upgrade auf die Version vom April 2026 neu zu erstellen.

Kursbannerbilder über Migration festlegen

Sie können jetzt Kursbannerbilder in Adobe Learning Manager als Teil Ihres Standardmigrations-Workflows festlegen oder aktualisieren. Auf diese Weise können Sie große Kataloge starten und bereinigen und gleichzeitig die Konsistenz Ihrer Kursseiten beibehalten, ohne sie manuell bearbeiten zu müssen

Definition von Bannerbildern

Bannerbilder werden in der course.csv-Migrationsdatei konfiguriert, die Sie bereits verwenden, um Kursmetadaten bereitzustellen, z. B.:

Mit dieser Verbesserung enthält die "course.csv"-Spezifikation eine zusätzliche optionale Spalte für das Kursbannerbild. Der genaue Kopfzeilenname ist in der CSV-Spezifikation definiert, die Sie von Ihrem Learning Manager-Konto herunterladen (sie kann z. B. als bannerUrl oder bannerImageUrl angezeigt werden).

Die Bannerspalte:

Vorbereiten von Bannerbildern für die Migration

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

Banner während eines Migrationslaufs anwenden

Sobald Ihre "course.csv" aktualisiert wurde, ist der Ablauf wie bei jeder anderen Migration:

Neue Kurse und vorhandene Kurse

Das Bannerfeld funktioniert in beiden Fällen:

Die tatsächlichen Spaltennamen und Pfade müssen mit der heruntergeladenen CSV-Spezifikation und dem Layout Ihres Inhalts-Repositorys übereinstimmen.

Entfernen der Bestellspalte in LearningProgramCourse

Adobe Learning Manager unterstützt jetzt ein vereinfachtes Modell für die Kursbestellung innerhalb von Lernpfaden (Lernprogramme) während der Migration. Als Teil dieser Änderung wird die Order-Spalte aus der Migrationsdatei learning_program_course.csv entfernt.

Zuvor enthielt die Datei learning_program_course.csv eine Spalte (häufig als "order" oder ähnlich bezeichnet), in der die folgenden Aktionen ausgeführt wurden:

Adobe Learning Manager verwendet jetzt nicht mehr die Bestellspalte in learning_program_course.csv, um die Kursreihenfolge zu bestimmen. Stattdessen konzentriert sich die Migrations-CSV auf , welche Kurse zu welchem Lernprogramm gehören, und nicht darauf, wie sie numerisch sortiert werden.

Auswirkungen auf CSVs der Migration

learning_program_course.csv

Sie sollten die alte Spalte mit der Reihenfolge als entfernt oder ignoriert behandeln:

Lesen Sie immer die neuesten CSV-Spezifikationen aus Ihrem Learning Manager-Konto (über csv_specifications.zip), um den aktuellen Headersatz und die aktuellen Anforderungen zu bestätigen.

timeZoneCode für Kursinstanzen

Ab dieser Version macht das Kursinstanzmodell (learningObjectInstance) ein neues Attribut verfügbar:

timeZoneCode - ein Zeichenfolgenfeld, das eine Kursinstanz explizit mit einer der konfigurierten Zeitzonen des Kontos verknüpft.

Dies ermöglicht Clients Folgendes:

Wo timeZoneCode angezeigt wird

Das Feld wird den Attributen des learningObjectInstance-Modells hinzugefügt.
nur für Kursinstanzen.

Beispiel:

{
  "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"
      }
    ]
  }
}

So lösen Sie timeZoneCode auf

Der numerische timeZoneCode ist ein Suchschlüssel im Zeitzonenkatalog des Kontos, der über die Konto-API angezeigt wird:

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

Innerhalb der Antwort sind Zeitzonen aufgeführt in:

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

Empfohlener Client-Flow:

Asynchrone öffentliche APIs für die Mitgliedschaft in einer Benutzergruppe

Einführung

Adobe Learning Manager stellt zwei asynchrone Admin-APIs zur Verwaltung der Benutzergruppenmitgliedschaft bereit:

Anstatt die Mitgliedschaft in derselben Anforderung zu aktualisieren, akzeptieren diese APIs Ihren Stapel und geben eine Ereignis-ID zurück. Das tatsächliche Ergebnis wird später über webhooks geliefert.

Verwenden Sie sie, wenn:

Bei kleinen, interaktiven Administratoraktionen können Sie die synchronen /userGroups/{id}/users-APIs weiterhin verwenden.

Authentifizierung und Basis-URL

Diese APIs sind Teil der standardmäßigen v2 Admin-API-Oberfläche.

Das allgemeine Verhalten der Admin-API und die Bereiche finden Sie unter:

Anforderungsformat

Sowohl add als auch remove verwenden exakt die gleiche Körperform.

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" }
  ]
}

Daten (erforderlich)

data ist die Liste der Benutzerressourcen-IDs für diesen Stapel.

Einschränkungen

Wenn eine dieser Bedingungen fehlschlägt, gibt die API einen Fehler zurück und es befindet sich nichts in der Warteschlange.

Metadaten (optional)

metadata sind alle zusätzlichen Korrelationsdaten, die Sie im Webhook wiedergeben möchten.

Typische Verwendung:

Der Dienst gibt dieses Objekt unverändert in der Webhook-Antwort zurück, sodass Sie den Rückruf mit Ihrem internen Auftrag abgleichen können.

Einschränkungen:

Antwortformat

Beide Endpunkte reagieren synchron mit einer Ereignis-ID:

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

Verhalten:

Sie sollten immer:

Weitere Informationen finden Sie unter Webhooks zum Hinzufügen und Entfernen von Benutzergruppenmitgliedschaft.

Häufige Fragen

Wie ändert die Version vom April 2026 die learningObjects-API für adaptive Lernprogramme?

Diese Version fügt ein isAdaptive-Flag für Lernprogramme hinzu und macht Abschnitte und Sub-LOs lernerorientiert. In adaptiven Programmen sehen Teilnehmer nur die Abschnitte und Sub-Lernobjekte, die für sie basierend auf adaptiven Regeln sichtbar sind, während Administratoren die zugrunde liegende adaptive Konfiguration für eine Benutzergruppe sehen können.

Muss ich meine Integration aktualisieren, wenn davon ausgegangen wird, dass alle Abschnitte und untergeordneten LOs immer zurückgegeben werden?

Ja. Bei adaptiven Lernprogrammen gibt die API jetzt nur die Abschnitte und untergeordneten LOs zurück, die für den aktuellen Teilnehmer sichtbar sind. Clientcode sollte die Antwort als autoritative, möglicherweise gefilterte Ansicht behandeln, anstatt eine vollständige Liste anzunehmen.

Wie kann ich den Abschluss eines Teilnehmers für einen Kurs oder ein Lernprogramm programmgesteuert zurücksetzen?

Verwenden Sie den neuen Endpunkt:

POST /primeapi/v2/learningObjects/{loId}/instances/{loInstanceId}/refreshCompletion
Dadurch wird die Fertigstellung für die Zielinstanz zurückgesetzt, wenn Berechtigungen und Status dies zulassen.

Wie erkenne ich, ob ein Teilnehmer etwas über ein alternatives oder gleichwertiges Lernobjekt abgeschlossen hat?

Überprüfen Sie das isAlternateComplete-Attribut auf dem Lernobjekt. Wenn dieser Wert wahr ist, listet die alternativeCompletions-Beziehung die Lernobjekte auf, die als Alternativen für den Abschluss dieses Teilnehmers fungierten.

Wie finde ich alle Alternativen, die ein bestimmtes Lernobjekt erfüllen können?

Verwenden Sie den folgenden Endpunkt:

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

und verwenden Sie das Datenarray (für die Stellvertreter) und meta.count (für die Gesamtzahl der Stellvertreter).

Woher weiß ich, ob ein Teilnehmer derzeit ein Modul starten darf?

Rufen Sie zunächst den timeSlot der Ressource aus:

GET /primeapi/v2/learningObjects/{loId}?include=instances.loResources
und verwenden Sie dann:

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

Was bedeutet "hasContentDrivenAttemptTracking" für eine Ressource?

Es gibt an, dass die Verfolgung von Versuchen durch den Inhalt selbst gesteuert wird (z. B. über SCORM/xAPI-Logik) und nicht nur durch Plattformzähler. Wenn das stimmt, verlassen Sie sich nicht nur auf die Anzahl der Versuche auf der Plattform oder die Begrenzungen für Ihre Benutzererfahrung und Ihr Reporting.

Wie erhalte ich Menüs, die für nicht angemeldete Benutzer geeignet sind (öffentliche Erfahrungen)?

Verwendung:

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

Dies gibt für anonyme Benutzer gefilterte Menü- und Seitenstrukturen zurück, die für Experience Builder oder andere Headless-Sites geeignet sind.

Was hat sich bei der Filterung von Arbeitshilfen mit effectModifiedDate geändert?

Anforderungen, die filter.effectModifiedDate mit filter.loTypes=jobAid kombinieren, geben jetzt korrekt nur Arbeitshilfen innerhalb des angegebenen Datumsfensters zurück.

Was hat sich im Format der Arbeitshilferessourcen-ID geändert, und wie sollte ich damit umgehen?

Das ID-Format wurde von Werten wie:

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

an:

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

Beispiel: jobAid:131032_2_fr_FR. Jedes System, auf dem Arbeitshilferessourcen-IDs gespeichert oder analysiert werden, muss aktualisiert werden, und Sie sollten nach dem Upgrade auf die Version vom April 2026 die Neuerstellung lokaler Indizes planen, die von diesen IDs codiert werden.