Pomoc — panel importu SCORM
Instrukcja dla operatorów · wersja GUI
Ten panel nie edytuje lekcji w EdTool i nie tworzy kursów w Moodle.
Jego zadanie to: wziąć gotową paczkę SCORM z EdTool i wgrać ją do właściwej sekcji kursu Moodle —
albo podmienić istniejącą paczkę, gdy lekcja została zaktualizowana.
Wszystko opiera się na pliku mapy CSV (eksport z Google Sheets) oraz na
lesson_id z EdTool — to ten numer jest „dowodem osobistym” lekcji, nie sam tytuł.
1. Słowniczek
| Pojęcie | Co to znaczy w praktyce |
|---|
lesson_id | Stały numer lekcji w EdTool (z adresu URL lub kolumny w CSV). Po tym ID system pobiera paczkę SCORM. |
cmid | ID modułu SCORM w Moodle (course module id). Przy aktualizacji podmieniamy paczkę w tym samym cmid — student widzi tę samą aktywność, tylko z nową treścią. |
sekcja | Numer sekcji w kursie Moodle (1, 2, 3…). W CSV to docelowa sekcja, do której trafia lekcja. |
D22, D43… | Kod kursu (shortname) w Moodle i w CSV. |
| Mapa CSV | Plik z listą: który kurs, która sekcja, jaki tytuł, które lesson_id. Eksport z Google Sheets. |
| Preflight | „Suchy bieg” — sprawdzenie bez wgrywania niczego do Moodle. Tylko odczyt EdTool + Moodle + CSV. |
| Job | Zlecenie do wykonania: eksport z EdTool → import do Moodle. Ma ID typu JABC123…. |
| UPDATE | Podmiana paczki w istniejącym SCORM (znany cmid). |
| IMPORT | Wgranie nowego modułu SCORM w pustej sekcji (tam, gdzie jeszcze nie ma aktywności). |
| Operator | Przygotowuje preflight i tworzy job. |
| Approver / admin | Zatwierdza job — dopiero wtedy worker zaczyna pracę. |
2. Aktualizacja czy nowy import?
Użyj Aktualizacje SCORM gdy:
- kurs już jest w Moodle,
- w sekcji jest dokładnie jeden moduł SCORM,
- w EdTool wyszła nowa wersja tej samej lekcji (nowe lesson_id w CSV lub ta sama lekcja po poprawkach).
Użyj Nowy import SCORM gdy:
- sekcja w Moodle jest pusta (brak SCORM),
- wgrywasz kurs po raz pierwszy lub dodajesz nową lekcję w nowej sekcji.
Złota zasada: jeśli w sekcji coś już jest — nie rób IMPORTU. Zrób UPDATE albo najpierw skonsultuj z administratorem Moodle.
3. Dlaczego trzy różne tytuły? (CSV / EdTool / Moodle)
To najczęstsze źródło zamieszania — wygląda na to samo, a system widzi trzy źródła:
| Źródło | Skąd się bierze | Po co jest |
|---|
| CSV | Wasz arkusz Google Sheets — kolumna „tytuł” | Oficjalna nazwa lekcji w kampanii |
| EdTool | API EdTool — pole tytułu przy lesson_id | Często krótszy skrót wewnętrzny (np. „Test” zamiast „Test końcowy”) |
| Moodle | Nazwa sekcji / modułu SCORM w kursie | To, co widzi student; admin może je zmieniać ręcznie |
Ważne przy UPDATE:
- System nie blokuje aktualizacji, gdy tytuł EdTool ≠ tytuł CSV — eksport i tak idzie po
lesson_id.
- Różnica tytułu Moodle vs CSV przy podmianie cmid też nie blokuje — podmieniasz tylko plik SCORM.
- W tabeli „Pokaż SCORM-y” kolumna Tytuł EdTool pokazuje, co faktycznie zwraca EdTool. Oznaczenie ≠ CSV to informacja, nie błąd blokujący UPDATE.
Przy nowym imporcie różnica CSV vs EdTool może zablokować preflight — wtedy zaznacz Wyjątek tytułu i wpisz powód (np. numer ticketu).
4. Mapa CSV — wgrywanie i wymiana
- W Google Sheets: Plik → Pobierz → CSV (bieżący arkusz).
- W panelu: sekcja Mapa CSV → wybierz plik → Sprawdź i dodaj CSV.
- Przeczytaj walidację:
czerwone = ten kurs się nie zaimportuje, popraw arkusz;
żółte = ostrzeżenie (np. duplikat lesson_id), ale import możliwy.
- Kliknij Użyj tej mapy — dopiero wtedy nowe joby biorą dane z tego pliku.
- Stare mapy można Usunąć (nie usuwa się aktywnej — najpierw aktywuj inną).
Szczegóły kolumn: instrukcja formatu CSV.
Job już utworzony pamięta mapę z momentu utworzenia — zmiana aktywnego CSV go nie zmienia w trakcie pracy.
5. Aktualizacja SCORM — krok po kroku
Wybierz kurs → Pokaż SCORM-y → zaznacz sekcje
→ potwierdź podmianę (checkbox) → Preflight aktualizacji
→ Utwórz job UPDATE → Zatwierdź (approver) → czekaj na COMPLETED
- Upewnij się, że właściwa mapa CSV jest aktywna (nowe lesson_id po aktualizacji lekcji w EdTool).
- Aktualizacje SCORM → wybierz kurs (np. D43) → Pokaż istniejące SCORM-y w Moodle.
- Sprawdź tabelę:
- Status „ok” = jeden SCORM w sekcji, można aktualizować.
- „missing” = brak SCORM → potrzebny IMPORT, nie UPDATE.
- „multiple” = kilka SCORM w sekcji → skontaktuj się z adminem Moodle.
- Zaznacz Aktualizuj przy wybranych sekcjach — lub użyj Zaznacz wszystkie (ok), żeby jednym kliknięciem wybrać cały kurs (tylko wiersze ze statusem ok).
- Zaznacz: „Podmieniam paczkę w istniejącym module Moodle (cmid)…”
- Preflight aktualizacji — wynik powinien mieć status PREFLIGHT_OK przy każdej sekcji.
- Utwórz job UPDATE do zatwierdzenia.
- Osoba z rolą approver: w tabeli Joby → Zatwierdź.
- Worker wykonuje: eksport EdTool (~1–3 min na lekcję) → import Moodle → status COMPLETED.
- Otwórz szczegóły joba — sprawdź VERIFIED i ewentualnie pobierz raport CSV/JSON.
Przycisk „1 sekcja” (Smoke) szybko zaznacza jedną sekcję do testu przed większą kampanią.
6. Nowy import SCORM — krok po kroku
- Nowy import SCORM → wyszukaj / wybierz kurs.
- Zaznacz sekcje do importu (domyślnie wszystkie zaznaczone).
- Jeśli tytuł EdTool ≠ CSV — zaznacz Wyjątek tytułu i wpisz powód w polu ticketu.
- Uruchom preflight → tylko wiersze PREFLIGHT_OK trafią do joba.
- Utwórz job do zatwierdzenia → approver Zatwierdź.
- Po COMPLETED sprawdź kurs w Moodle.
Jeśli sekcja ma już SCORM, preflight pokaże błąd EXISTING_SCORM — użyj ścieżki UPDATE zamiast importu.
7. Joby, zatwierdzanie i statusy
Przepływ joba
DRAFT → AWAITING_APPROVAL → (Zatwierdź) → QUEUED → RUNNING → COMPLETED
↘ PAUSED (można Wznów)
↘ FAILED
| Status | Znaczenie | Co robić |
|---|
| AWAITING_APPROVAL | Czeka na zatwierdzenie | Approver klika Zatwierdź |
| QUEUED | W kolejce workera | Poczekaj — worker bierze joby po kolei |
| RUNNING | Trwa eksport / import | Odśwież szczegóły joba; można Pauza po bieżącym etapie |
| PAUSED | Zatrzymany bezpiecznie | Wznów gdy można kontynuować |
| COMPLETED | Sukces | Sprawdź Moodle; kolumna Lekcje w liście jobów podsumowuje co zrobiono |
| FAILED | Błąd krytyczny | Przeczytaj błąd w szczegółach; zgłoś administratorowi z ID joba |
Kolumna Lekcje w tabeli jobów pokazuje np. D43 — §14: Test końcowy (cmid 1353) — nie trzeba zgadywać, co job robił.
Ustawienie „Otwórz pakiet w nowym oknie” dotyczy pola popup w Moodle (zalecane: włączone).
8. Co robi preflight (i czego nie robi)
Preflight ROBI:
- Sprawdza, czy lesson_id istnieje w EdTool.
- Sprawdza, czy sekcja istnieje w Moodle.
- Porównuje tytuły (informacyjnie / z możliwością wyjątku przy imporcie).
- Przy UPDATE sprawdza, czy cmid w sekcji zgadza się z planem.
Preflight NIE ROBI:
- Nie wgrywa plików do Moodle.
- Nie zmienia tytułów w Moodle.
- Nie eksportuje SCORM (to dopiero po zatwierdzeniu joba).
9. Najczęstsze pytania i błędy
- Moodle ma ten sam tytuł co CSV, a preflight krzyczy o EdTool — dlaczego?
- Bo to osobne sprawdzenie. EdTool ma własny krótki tytuł w API. Przy UPDATE to nie blokuje. Zobacz kolumnę Tytuł EdTool w tabeli.
- Co to jest cmid i skąd się bierze?
- To wewnętrzny numer modułu SCORM w Moodle. Panel wykrywa go automatycznie po kliknięciu „Pokaż SCORM-y”. Przy UPDATE musisz podmieniać właśnie ten moduł — stąd mapa
D43:14=1353.
- Preflight: 0 OK, 1 zablokowanych — co teraz?
- Otwórz tabelę wyników — kolumna Błąd mówi dlaczego. Najczęściej: sekcja ma już SCORM (IMPORT zamiast UPDATE), zły lesson_id w CSV, brak sekcji w Moodle.
- Długo nic się nie dzieje po zatwierdzeniu
- Eksport z EdTool trwa — nawet kilka minut na lekcję. Status RUNNING + szczegóły joba pokazują postęp. Odświeżanie jest co kilka sekund.
- Czy mogę zaktualizować wiele sekcji naraz?
- Tak — zaznacz wiele wierszy w tabeli SCORM, jeden preflight, jeden job UPDATE. Worker robi je po kolei.
- Duplikat lesson_id w CSV (żółte ostrzeżenie)
- Often „atrapa” w arkuszu — ten sam ID w dwóch wierszach. Import możliwy, ale upewnij się, który wiersz jest właściwy.
- Sekcja 0 w Moodle
- Panel ignoruje sekcję 0 (ogólna sekcja kursu). Lekcje numerujemy od 1.
- Test końcowy — sekcja 14, a EdTool ma pozycję 13
- Normalne w BCU. Przy UPDATE pozycja EdTool nie blokuje — ważne są lesson_id i cmid.
- Kto zatwierdza joby?
- Użytkownik z rolą approver lub admin. Operator bez tej roli widzi „Wymaga approver”.
- Gdzie są pobrane paczki ZIP?
- Na serwerze w katalogu
exports/ (admin). W GUI można pobrać raport joba (JSON/CSV).
10. Czego nie robić
- Nie rób IMPORTU do sekcji, która już ma SCORM — użyj UPDATE.
- Nie zmieniaj aktywnej mapy CSV w trakcie działającego joba „bo może zadziała” — stary job ma starą mapę.
- Nie pomijaj preflightu — to jedyny moment, kiedy wszystko sprawdzamy za darmo.
- Nie zatwierdzaj joba, jeśli preflight ma zablokowane sekcje, których nie chciałaś pominąć.
- Przy wątpliwościach co do tytułów w Moodle — popraw je ręcznie w Moodle po udanej aktualizacji paczki; panel podmienia plik SCORM, nie edytuje nazw sekcji.
Nadal coś nie gra? Zapisz: ID joba, kod kursu, numer sekcji, lesson_id, komunikat błędu ze szczegółów joba — i prześlij administratorowi.
Wróć do panelu · Format CSV