Scormbee

Najczęstsze błędy SCORM w Moodle, Canvas i TalentLMS: jak je naprawić

10 min czytania Read in English

Z zewnątrz problemy z SCORM wyglądają tajemniczo: kurs, który „nie zapisuje”, wynik, który nigdy nie dociera, kursant po raz trzeci zablokowany na „nieukończonym”. Z bliska okazuje się jednak, że przyczyn jest niewiele i ciągle się powtarzają. Ten poradnik omawia je w kolejności, w jakiej je spotkasz (od wgrania paczki po raport), z dokładnymi komunikatami i ustawieniami w Moodle, Canvas i TalentLMS. Nazwy ustawień Moodle podaję w wersji angielskiej, bo polskie tłumaczenia interfejsu różnią się między wersjami.

Zacznij tutaj: diagnoza w pięć minut

Najpierw odtwórz problem poza platformą. Jeśli kurs zachowuje się tak samo w neutralnym odtwarzaczu, winna jest paczka. Jeśli tam działa, szukaj w ustawieniach platformy.

  • Walidator SCORM sprawdza ZIP: manifest w katalogu głównym, plik startowy na miejscu, pliki wymienione w manifeście naprawdę istnieją.
  • Odtwarzacz SCORM uruchamia paczkę z symulowaną platformą i zapisuje każde wywołanie API, więc widzisz, co i kiedy kurs wysyła.
  • SCORM Cloud oferuje bezpłatne konto próbne i prowadzi szczegółowy log każdej rejestracji.
  • Konsola przeglądarki (F12, potem Konsola) pokazuje błędy skryptów, gdy kurs działa na twojej platformie.

Potem dopasuj objaw:

Objaw Najczęstsza przyczyna Sekcja
Platforma odrzuca paczkę, „missing imsmanifest.xml” Manifest nie leży w katalogu głównym ZIP-a 1
„Unable to acquire LMS API” lub podobny komunikat Kurs nie znajduje obiektu API 2
Status stale „nieukończony” albo „nierozpoczęty” Brak wywołania zakończenia, rozbieżna reguła ukończenia, nieobsługiwana wersja 3
Brak wyniku albo „niezaliczony” mimo zaliczenia Pola wyniku, różne progi, ustawienia oceniania 4
Kursanci zaczynają od początku Tryb wyjścia, przepełnione suspend data, wymuszane nowe podejścia 5
Kliknięcie „Wejdź” nic nie robi Zablokowane okno wyskakujące 6
W Chrome działa, w Safari nie Ciasteczka stron trzecich 7

1. Paczka się nie wgrywa: manifest nie jest w katalogu głównym

Moodle w wersji angielskiej pokazuje komunikat „Incorrect file package - missing imsmanifest.xml or AICC structure”, inne platformy piszą o „nieprawidłowej paczce” albo „braku manifestu”. Platforma szuka pliku imsmanifest.xml w katalogu głównym archiwum i go nie znajduje.

Zawartość sprawdzisz bez rozpakowywania:

unzip -l kurs.zip | head

Powinieneś zobaczyć imsmanifest.xml bez żadnego folderu przed nazwą. Jeśli widzisz kurs/imsmanifest.xml, spakowano folder zamiast jego zawartości.

Typowe przyczyny i rozwiązania:

  • Skompresowano folder. Polecenie „Kompresuj” w macOS i „Wyślij do → Folder skompresowany” w Windowsie użyte na folderze dodają ten folder do archiwum. Otwórz folder, zaznacz wszystko w środku i skompresuj zaznaczenie.
  • ZIP w ZIP-ie. Niektóre pobrane pliki zawierają paczkę razem z innymi plikami. Rozpakuj raz i wgraj wewnętrzny ZIP.
  • Zły eksport. Eksport „web” albo „HTML” w ogóle nie ma manifestu. Wyeksportuj ponownie i wybierz SCORM.
  • Za duży plik. W Moodle limit wynika z maksymalnego rozmiaru pliku dla serwisu i kursu oraz z ustawień PHP upload_max_filesize i post_max_size; zapytaj administratora. Poradniki uczelni korzystających z Canvas podają limit 500 MB dla paczek SCORM. Skompresuj wideo i duże obrazy.
  • Nieobsługiwana wersja. Centrum pomocy TalentLMS wymienia SCORM 1.2, a nie SCORM 2004 ani paczki z wieloma SCO. Paczka SCORM 2004 może się wgrać, a potem nie raportować; wyeksportuj SCORM 1.2.

2. „Unable to acquire LMS API”

Ten komunikat (albo jego odmiana) pojawia się, gdy kurs przeszukuje otaczające go okna w poszukiwaniu obiektu API SCORM (API w SCORM 1.2, API_1484_11 w SCORM 2004) i niczego nie znajduje. Odtwarzacze Articulate wyświetlają go jako „Unable to acquire LMS API, content may not play properly and results may not be recorded”.

Przyczyna Jak rozpoznać Rozwiązanie
Kurs otwarty poza platformą Pasek adresu pokazuje ścieżkę do pliku, udział sieciowy albo bezpośredni link Uruchamiaj kurs wyłącznie z aktywności na platformie
Pliki kursu w innej domenie Konsola pokazuje „Blocked a frame with origin … from accessing a cross-origin frame” Wgraj paczkę na platformę albo użyj paczki przystosowanej do pracy między domenami
Okno platformy z API zamknięto lub przeładowano Zdarza się, gdy kursant klika dalej w karcie platformy, a kurs jest otwarty w nowym oknie Otwieraj kurs w bieżącym oknie albo poproś kursantów, żeby nie ruszali karty platformy
Niezgodność wersji Manifest deklaruje jedną wersję SCORM, a kurs szuka API drugiej Wyeksportuj kurs w wersji obsługiwanej przez platformę
Rozszerzenie przeglądarki blokuje skrypty W oknie prywatnym bez rozszerzeń działa Dodaj domenę platformy do wyjątków rozszerzenia

Komunikat o cross-origin warto umieć rozpoznać. Oznacza, że kurs i platforma działają w różnych domenach, i żadne ustawienie w samym kursie tego nie naprawi.

3. Kurs stale „nieukończony”

Platforma zapisuje tylko to, co wysyła kurs. Jeśli status się nie zmienia, to albo kurs go nie wysłał, albo platforma oczekuje czegoś innego.

Kurs nie zakończył sesji. Kurs powinien wywołać LMSFinish (SCORM 1.2) lub Terminate (SCORM 2004) i regularnie zapisywać dane przez LMSCommit albo Commit. Przeglądarki oparte na Chromium blokują synchroniczne żądania podczas zamykania strony, więc kurs, który zapisuje dane dopiero przy zamknięciu okna, może stracić ostatni zapis. W logu odtwarzacza szukaj wywołania zakończenia i ostatniego statusu wysłanego przed nim.

Nie spełniono reguły ukończenia w kursie. „Wszystkie slajdy obejrzane” nie zadziała, jeśli kursant pominął jeden slajd, a w SCORM 1.2 oblany test zastępuje completed wartością failed.

Reguła platformy różni się od tego, co wysyła kurs. W Moodle ustawienia ukończenia aktywności mogą wymagać statusu („Passed” albo „Completed”) albo minimalnego wyniku. Kurs bez testu wysyła wyłącznie completed, więc aktywność wymagająca „Passed” nigdy nie zostanie ukończona. Ustaw jedno i drugie tak, żeby do siebie pasowały.

Wersja nie jest w pełni obsługiwana. Moodle implementuje SCORM 2004 tylko częściowo, a TalentLMS wymienia wyłącznie SCORM 1.2. Jeśli paczka 2004 sprawia problemy, wyeksportuj SCORM 1.2 i przetestuj ponownie.

Ustawienie „Force completed” w Moodle oznacza podejścia jako ukończone niezależnie od tego, co wysyła kurs. Traktuj je jako ostateczność, bo ukrywa prawdziwy problem, zamiast go rozwiązać.

4. Brak wyniku albo „niezaliczony” mimo zaliczenia

Wynik jest poza zakresem. W SCORM 2004 cmi.score.scaled przyjmuje wartości od -1 do 1, więc 85% to 0.85. Wysłanie 85 kończy się błędem 407 („Data Model Element Value Out Of Range”) i wynik nie zostaje zapisany. Przecinek dziesiętny (0,85) to z kolei niezgodność typu, błąd 406, bo specyfikacja nie zna polskiego zapisu liczb. W SCORM 1.2 wysyłaj cmi.core.score.raw razem z score.min i score.max, żeby platforma nie musiała zgadywać skali.

Progi zaliczenia się różnią. Manifest może mieć własny próg: adlcp:masteryscore w SCORM 1.2, imsss:minNormalizedMeasure w SCORM 2004. Jeśli kurs zalicza od 70%, a manifest mówi 80, kursant z wynikiem 75% widzi w kursie „Zaliczony”, a w raporcie „Niezaliczony”. Ustawienie „Mastery score overrides status” w Moodle robi dokładnie to: gdy wynik jest niższy od progu z manifestu, status zmienia się na niezaliczony. Wszędzie używaj jednej wartości. Szczegóły w artykule SCORM 1.2 czy 2004.

Platforma ocenia coś innego. W Moodle sprawdź w aktywności SCORM „Grading method”. „Learning objects” liczy ukończone lub zaliczone obiekty, więc kurs z jednym SCO pokazuje 1 zamiast 85. „Highest grade” pokazuje wynik. Ustawienie „Attempts grading” decyduje potem, które podejście się liczy: najwyższe, średnie, pierwsze czy ostatnie ukończone.

Canvas nie utworzył kolumny w dzienniku ocen. W narzędziu SCORM w Canvas wybierasz typ importu: zadanie oceniane, zadanie nieoceniane albo strona. Kolumnę w dzienniku ocen dostaje tylko zadanie oceniane, a typu importu nie da się później zmienić. Usuń paczkę z narzędzia SCORM i wgraj ją ponownie z właściwym typem.

5. Kursanci zaczynają od początku

Tryb wyjścia nie jest ustawiony na suspend. Gdy kursant wychodzi przed końcem, kurs musi ustawić cmi.core.exit (1.2) albo cmi.exit (2004) na suspend. W przeciwnym razie wiele platform przy następnym uruchomieniu zaczyna nowe podejście i odrzuca zapisany stan.

Przepełnione suspend data. Zapisany stan ma limit: 4096 znaków w SCORM 1.2, 4000 w SCORM 2004 2nd i 3rd edition oraz 64 000 w 4th edition. Po jego przekroczeniu część platform odrzuca zapis, a część go ucina. W obu przypadkach kurs nie odczyta już swojego stanu. W logu API szukaj nieudanego SetValue na cmi.suspend_data albo wartości urwanej dokładnie na 4096 znakach. Rozwiązanie: eksport SCORM 2004 4th edition albo podział długiego kursu na moduły.

Platforma wymusza nowe podejścia. Ustawienie „Force new attempt” w Moodle może rozpoczynać nowe podejście przy każdym uruchomieniu („Always”) albo po podejściu ukończonym, zaliczonym lub oblanym. Przy „Always” wznawianie nigdy nie zadziała. Sprawdź też maksymalną liczbę podejść.

Kursant zmienił urządzenie. Postęp sięga tylko ostatniego udanego zapisu. Jeśli kurs zapisuje rzadko, drugie urządzenie startuje od wcześniejszego miejsca.

6. Kliknięcie „Wejdź” nic nie robi: zablokowane okno wyskakujące

Wiele platform otwiera kursy w nowym oknie, a przeglądarki blokują okna, które nie wynikają bezpośrednio z kliknięcia. Szukaj ikony zablokowanego okna na końcu paska adresu.

  • Dla jednego kursanta: zezwól na wyskakujące okienka dla domeny platformy. W Chrome: Ustawienia, Prywatność i bezpieczeństwo, Ustawienia witryn, Wyskakujące okienka i przekierowania.
  • Dla całej firmy: dział IT może zezwolić na okna dla domeny platformy zasadą, np. PopupsAllowedForUrls w Chrome.
  • Na platformie: w Moodle ustaw „Display package” na „Current window”, a okno wyskakujące nie będzie potrzebne.

7. W Chrome działa, w Safari nie: ciasteczka stron trzecich

Gdy treść kursu albo odtwarzacz SCORM działa w ramce serwowanej z innej domeny niż strona platformy, wszystkie używane przez nią ciasteczka są ciasteczkami stron trzecich. Safari domyślnie blokuje je od wersji 13.1 z 2020 roku, Firefox izoluje je dla każdej witryny, a każda przeglądarka może je blokować przez ustawienia albo zasady firmowe. Dotyczy to treści hostowanych zewnętrznie, części odtwarzaczy SCORM opartych na LTI oraz paczek dynamicznych, które wczytują cały kurs w ramce z innej domeny.

Objawy: pusta ramka, ekran logowania wewnątrz kursu albo postęp ginący między sesjami, i to tylko w niektórych przeglądarkach.

Rozwiązania, od najlepszego:

  1. Wgraj kurs bezpośrednio na platformę, żeby wszystko działało w jednej domenie.
  2. Używaj treści, które w ramce z innej domeny nie zależą od ciasteczek.
  3. Otwieraj kurs w nowym oknie lub karcie, gdzie przeglądarka traktuje jego ciasteczka jako własne, a nie zewnętrzne.

Żeby potwierdzić przyczynę, możesz na urządzeniu testowym chwilowo wyłączyć w Safari zapobieganie śledzeniu między witrynami. To krok diagnostyczny, a nie rozwiązanie do wdrożenia u kursantów.

Ściągawka dla platform

Moodle Canvas TalentLMS
Wersje SCORM 1.2 w pełni, 2004 częściowo Przez narzędzie SCORM 1.2 według centrum pomocy; bez 2004 i wielu SCO
Gdzie wgrać Dodaj aktywność, pakiet SCORM Link SCORM w nawigacji kursu, jeśli jest włączony Kurs, Dodaj, SCORM / xAPI / cmi5
Ustawienia do sprawdzenia Display package, Grading method, Attempts grading, Force new attempt, Mastery score overrides status, ukończenie aktywności Typ importu (nie da się go później zmienić) Wersja paczki
Limit rozmiaru Limity serwisu i kursu, ustawienia PHP 500 MB w poradnikach uczelni Sprawdź aktualną dokumentację

Jak zapobiec temu następnym razem

Zanim kurs trafi do kursantów:

  • imsmanifest.xml w katalogu głównym, sprawdzony walidatorem
  • Wersja SCORM, którą platforma obsługuje w pełni
  • Jeden próg zaliczenia, identyczny w kursie i w manifeście
  • Reguła ukończenia na platformie zgodna z tym, co wysyła kurs
  • Test jako kursant: ukończenie, oblanie, przerwanie w połowie, wznowienie
  • Jedno uruchomienie w Safari i jedno na telefonie
  • Wiersz testowego kursanta w raporcie wygląda poprawnie

Kursy wyeksportowane ze Scormbee zapisują dane na platformie chwilę po każdej zmianie, biorą próg zaliczenia dla kursu i manifestu z jednego ustawienia i ustawiają tryb wyjścia na suspend, gdy kursant wychodzi przed końcem. Jeśli masz kurs z innego narzędzia, który ciągle nie przechodzi tych sprawdzeń, i wolisz go odbudować, niż łatać, możliwości opisuje artykuł Jak edytować paczkę SCORM bez pliku źródłowego.

Najczęstsze pytania

Co oznacza komunikat „Unable to acquire LMS API”?

Kurs szukał obiektu API SCORM w otaczających go oknach i go nie znalazł. Najczęściej kurs otwarto poza platformą, jego pliki są serwowane z innej domeny niż platforma albo okno platformy, w którym było API, zostało zamknięte lub przeładowane.

Dlaczego kurs działa w SCORM Cloud, a w Moodle nie?

Paczka jest zapewne w porządku, a różni się ustawienie platformy: reguła ukończenia wymaga zaliczenia, a kurs wysyła tylko ukończenie, sposób oceniania liczy obiekty zamiast wyników, wymuszane są nowe podejścia albo kurs otwiera się w zablokowanym oknie.

Dlaczego dziennik ocen w Moodle pokazuje 1 zamiast wyniku?

W aktywności SCORM sposób oceniania (Grading method) jest ustawiony na Learning objects, czyli liczbę ukończonych lub zaliczonych obiektów, a nie wynik. Zmień go na Highest grade.

Jaki jest limit suspend_data w SCORM?

4096 znaków w SCORM 1.2, 4000 w SCORM 2004 2nd i 3rd edition oraz 64 000 w SCORM 2004 4th edition. To minimalne wartości, które platforma musi obsłużyć; wiele platform przyjmuje więcej, ale kurs nie powinien na to liczyć.

Czy kursy SCORM działają w Safari?

Tak, jeśli kurs jest serwowany z domeny platformy. Problemy pojawiają się, gdy treść z innej domeny działa w ramce i zależy od ciasteczek, bo Safari domyślnie blokuje ciasteczka stron trzecich.

Więcej artykułów

12 listopada 2026 · 4 min czytania

Jak zaktualizować kurs Dynamic SCORM

Opublikuj zmianę w kursie Dynamic SCORM w trzech krokach: popraw kurs, kliknij Opublikuj aktualizację, a każdy LMS pokaże nową wersję przy następnym uruchomieniu.

Czytaj →

10 listopada 2026 · 7 min czytania

Co platforma LMS naprawdę zapisuje z kursu SCORM

Co kurs SCORM wysyła do platformy LMS: ukończenie, zaliczenie, wynik, czas, zakładka, suspend data i interakcje, a także dlaczego kurs zostaje „nieukończony”.

Czytaj →