02 Co sprawdza walidator
Testy, ich znaczenie i sposoby naprawy
W kolejności, w jakiej trafia na nie LMS przy wgrywaniu: ZIP, manifest, struktura, plik startowy, pliki, ścieżki i zasady zaliczenia.
imsmanifest.xml w głównym katalogu ZIP-a
Co to znaczy: LMS szuka pliku imsmanifest.xml tylko na najwyższym poziomie archiwum. Spakuj folder zamiast jego zawartości, a manifest wyląduje w kurs/imsmanifest.xml i LMS uzna, że to nie jest paczka SCORM. IMSManifest.xml nie przejdzie na serwerach, które rozróżniają wielkość liter.
Jak naprawić: Zaznacz wszystko w środku folderu i spakuj to zaznaczenie. Nazwa pliku małymi literami: imsmanifest.xml.
ZIP w ZIP-ie i pliki systemowe
Co to znaczy: Niektóre portale pakują paczkę w drugie archiwum, więc LMS widzi plik .zip i żadnego manifestu. Foldery __MACOSX i pliki Thumbs.db tylko zaśmiecają paczkę.
Jak naprawić: Wgraj wewnętrzny ZIP; walidator poda jego nazwę.
Poprawny XML i właściwy schemat
Co to znaczy: Jeden niezakodowany znak & albo niezamknięty znacznik sprawia, że manifest jest nieczytelny. Elementem głównym musi być <manifest> w przestrzeni nazw IMS Content Packaging: imscp_rootv1p1p2.xsd i adlcp_rootv1p2.xsd w SCORM 1.2 oraz imscp_v1p1.xsd, adlcp_v1p3.xsd, adlseq_v1p3.xsd, adlnav_v1p3.xsd i imsss_v1p0.xsd w SCORM 2004.
Jak naprawić: W tytułach zapisuj & jako &, zamiast poprawiać XML ręcznie wyeksportuj kurs ponownie i zostaw pliki .xsd obok manifestu.
Wersja SCORM
Co to znaczy: Element <schemaversion> mówi LMS, które środowisko uruchomieniowe włączyć: 1.2 albo CAM 1.3, 2004 3rd Edition lub 2004 4th Edition. Gdy go brakuje albo przeczy przestrzeniom nazw, LMS zgaduje i może dać kursowi niewłaściwe API.
Jak naprawić: Ustaw tę samą wersję w schemaversion i w przestrzeniach nazw.
Organizacje, elementy i SCO
Co to znaczy: Elementy (item) wskazują zasoby przez identifierref, a co najmniej jeden zasób musi być SCO: adlcp:scormtype="sco" w SCORM 1.2 i adlcp:scormType="sco" z wielkim T w 2004. Bez SCO kurs się otwiera, ale niczego nie raportuje. Powtórzone identyfikatory zrywają powiązania.
Jak naprawić: Używaj unikalnych identyfikatorów i oznacz jako SCO zasób, który rozmawia z LMS.
Plik startowy
Co to znaczy: Plik startowy to href zasobu SCO. Jeśli go brakuje, kursant zobaczy „nie znaleziono strony”. Index.html zamiast index.html działa w Windows, ale nie na linuksowych serwerach większości platform LMS. Href zaczynający się od / wskazuje poza paczkę.
Jak naprawić: Wpisz nazwę pliku dokładnie, z wielkością liter, jako ścieżkę względną wobec manifestu.
Pliki z listy i brakujące pliki
Co to znaczy: Każdy <file href> powinien istnieć. Brakujące pliki to puste miejsca po zdjęciach, nieme filmy albo błąd skryptu w połowie kursu. Pliki niewymienione w manifeście są tylko uwagą. Ścieżki wychodzące z paczki przez ../ zawodzą wszędzie. Walidator uwzględnia xml:base.
Jak naprawić: Zamiast ręcznie usuwać pliki, wyeksportuj kurs ponownie.
Spacje, znaki specjalne i ukośniki wsteczne
Co to znaczy: „Film wstęp.mp4” trzeba zakodować w adresie URL, a serwery nie robią tego jednakowo. Polskie znaki, # i ? psują adresy. Ukośniki wsteczne to separatory z Windows, które niektóre programy zapisują w archiwum.
Jak naprawić: Nazywaj pliki małymi literami bez polskich znaków, cyframi, myślnikami i podkreśleniami, a pakuj programem, który zapisuje zwykłe ukośniki.
Próg zaliczenia i zasady ukończenia
Co to znaczy: adlcp:masteryscore (0–100) w SCORM 1.2 i imsss:minNormalizedMeasure (od −1 do 1) w 2004 pozwalają LMS samodzielnie ustalić zaliczenie z wyniku. Wartości spoza zakresu to błąd. satisfiedByMeasure="true" bez minNormalizedMeasure oznacza 1.0, czyli do zaliczenia trzeba 100%.
Jak naprawić: Ustaw próg w narzędziu autorskim albo go pomiń, jeśli o zaliczeniu decyduje sam kurs.
Rozmiar i paczki, które nie są SCORM
Co to znaczy: Walidator pokazuje największe pliki i ostrzega powyżej 100 MB, bo to częsty limit przesyłania; Twój zależy od platformy i jej ustawień. Rozpoznaje też paczki xAPI (tincan.xml) i cmi5 (cmi5.xml) i sprawdza ich podstawy: poprawność pliku, identyfikatory aktywności w postaci prawidłowych adresów (IRI), plik startowy, a w cmi5 także ustawienia ukończenia i zaliczenia. Paczki AICC rozpoznaje, ale ich nie sprawdza.
Jak naprawić: Skompresuj filmy i zmniejsz zdjęcia. Paczkę xAPI, cmi5 albo AICC wgraj do LMS, który ją obsługuje, albo wyeksportuj SCORM.