Rozwiązywanie problemów z wtyczką Integracja Credentium® dla Moodle

Ten przewodnik pomoże Ci zdiagnozować i rozwiązać typowe problemy z wtyczką Integracja Credentium®.

Szybka diagnostyka

Sprawdź status wtyczki

1. Czy wtyczka jest włączona?

   • Administracja witryny > Wtyczki > Wtyczki lokalne > Integracja Credentium®
   • Zweryfikuj, że "Włącz integrację Credentium" jest zaznaczone

2. Czy dane API są skonfigurowane?

   • Sprawdź, czy URL API i Klucz API są wypełnione
   • Kliknij "Testuj połączenie", aby zweryfikować

3. Czy kurs jest skonfigurowany?

   • Kurs > Więcej > Ustawienia Credentium
   • Zweryfikuj, że "Włącz Credentium dla tego kursu" jest zaznaczone
   • Zweryfikuj, że szablon jest wybrany

4. Czy śledzenie ukończenia kursu jest włączone?

   • Administracja witryny > Funkcje zaawansowane > Włącz śledzenie ukończenia
   • Ustawienia kursu > Śledzenie ukończenia = Tak

Raport wystawień

Dostęp do raportu

Lokalizacja: Administracja witryny > Raporty > Raport Credentium

Raport pokazuje wszystkie próby wystawienia poświadczeń z:

• Informacjami o użytkowniku i kursie
• Statusem (Oczekujące, Wystawione, Niepowodzenie, Ponawianie)
• Wartościami ocen
• Komunikatami o błędach
• Znacznikami czasu

Zrozumienie kolorów statusu

Akcje ponowienia

Dla poświadczeń nieudanych lub oczekujących:

1. Kliknij przycisk Ponów w wierszu
2. Lub kliknij Przetwórz oczekujące, aby ponowić wszystkie oczekujące elementy
3. Sprawdź raport ponownie po kilku minutach

Typowe problemy

Brak wystawianych poświadczeń

Objawy: Ukończenia kursów nie wyzwalają poświadczeń

Lista kontrolna:

1. ✓ Wtyczka włączona globalnie
2. ✓ Kurs włączony dla Credentium
3. ✓ Szablon wybrany dla kursu
4. ✓ Śledzenie ukończenia kursu włączone
5. ✓ Kryteria ukończenia ustawione dla kursu
6. ✓ Cron działa regularnie (sprawdź Zaplanowane zadania)
7. ✓ Kategoria nie wstrzymana (jeśli używasz trybu kategorii)

Kroki debugowania:

1. Włącz logowanie debugowania w ustawieniach wtyczki
2. Ukończ kurs testowy
3. Sprawdź log błędów PHP pod kątem wpisów [Credentium]
4. Sprawdź raport wystawień pod kątem nowych wpisów

Test połączenia kończy się niepowodzeniem

Objawy: "Testuj połączenie" pokazuje błąd

Typowe przyczyny:

Weryfikacja danych API:

1. Zaloguj się do Credentium Issuer
2. Przejdź do Ustawienia organizacji > Klucze API
3. Skopiuj klucz API i URL
4. Wklej do ustawień Moodle

Poświadczenia utknęły w "Oczekuje"

Objawy: Poświadczenia pozostają oczekujące przez długi czas

Typowe przyczyny:

1. Cron nie działa

   • Sprawdź: Administracja witryny > Serwer > Zaplanowane zadania
   • Znajdź "Przetwarzaj oczekujące poświadczenia"
   • Zweryfikuj, że czas ostatniego uruchomienia jest niedawny
   • Uruchom ręcznie: php admin/cli/scheduled_task.php --execute=\\local_credentium\\task\\process_pending_credentials

2. Ocena nie jest gotowa

   • Jeśli "Wyślij ocenę" jest włączone, wtyczka czeka na agregację ocen
   • Sprawdź dziennik ocen dla studenta
   • Poczekaj do 45 minut na próby ponowienia

3. Przekroczony limit częstotliwości

   • Jeśli ustawiony jest limit kategorii, poświadczenia są kolejkowane
   • Sprawdź ustawienia kategorii pod kątem limitu
   • Poczekaj na reset okna godzinnego

4. Kategoria wstrzymana

   • Sprawdź ustawienia kategorii pod kątem "Wstrzymaj wszystkie wydania"
   • Odznacz, aby wznowić przetwarzanie

Poświadczenia niepowodzenie

Objawy: Poświadczenia pokazują status "Niepowodzenie"

Sprawdź komunikaty o błędach:

1. Przejdź do raportu wystawień
2. Najedź na czerwoną plakietkę, aby zobaczyć błąd
3. Kliknij przycisk "Debug" dla szczegółowych informacji

Typowe błędy:

Oceny nie pojawiają się w poświadczeniach

Objawy: Poświadczenie wystawione, ale ocena jest pusta

Lista kontrolna:

1. ✓ "Wyślij ocenę" włączone w ustawieniach kursu
2. ✓ Kurs ma element oceny
3. ✓ Student ma końcową ocenę
4. ✓ Agregacja ocen jest zakończona

Debugowanie:

1. Sprawdź dziennik ocen: Kurs > Oceny > Wyświetl dziennik ocen
2. Zweryfikuj, że student ma całkowitą ocenę kursu
3. Sprawdź, czy dziennik ocen wymaga przeliczenia

Szablony nie są wyświetlane

Objawy: Lista rozwijana szablonów jest pusta lub brakuje oczekiwanych szablonów

Rozwiązania:

1. Kliknij Odśwież szablony na stronie ustawień kursu
2. Sprawdź, czy szablon jest "Aktywny" w Credentium
3. Zweryfikuj, czy dane API są prawidłowe
4. Sprawdź szablony z wieloma ocenami (pokazywane jako nieobsługiwane)

Ustawienia kategorii nie pojawiają się

Objawy: Nie można znaleźć opcji ustawień kategorii

Lista kontrolna:

1. ✓ "Włącz tryb kategorii" zaznaczone w ustawieniach globalnych
2. ✓ Masz uprawnienie local/credentium:managecategory
3. ✓ Jesteś w prawidłowej kategorii (nie w kursie)

Narzędzia debugowania

Logowanie debugowania

Włącz:

1. Administracja witryny > Wtyczki > Wtyczki lokalne > Integracja Credentium®
2. Zaznacz "Włącz logowanie debugowania"
3. Zapisz zmiany

Przeglądaj logi:

• Logi zapisywane do logu błędów PHP
• Lokalizacja zależy od konfiguracji serwera (zazwyczaj /var/log/apache2/error.log lub /var/log/php-fpm/error.log)
• Szukaj prefiksu [Credentium]

Informacje w logach:

• Szczegóły przetwarzania zdarzeń
• Żądania i odpowiedzi API
• Obliczenia ocen
• Ślady błędów

Ważne: Wyłącz logowanie debugowania w produkcji po rozwiązaniu problemów.

Strona debugowania

Dostęp: Kliknij "Debug" na dowolnym rekordzie wystawienia w raporcie

Pokazuje:

• Pełne szczegóły rekordu wystawienia
• Konfigurację kursu
• Wyniki testu połączenia API
• Sprawdzenie dostępności szablonu

Strona testowania połączenia

Dostęp:

• Strona ustawień > przycisk Testuj połączenie
• Lub: /local/credentium/testconnection.php?sesskey=...

Testuje:

• Dostępność URL API
• Ważność klucza API
• Pobieranie szablonów

Ręczne przetwarzanie

Przetwórz pojedyncze poświadczenie

1. Przejdź do raportu wystawień
2. Kliknij "Debug" na poświadczeniu
3. Kliknij "Przetwórz to poświadczenie teraz"

Przetwórz wszystkie oczekujące

1. Przejdź do raportu wystawień
2. Kliknij przycisk "Przetwórz oczekujące (N)" u góry
3. Poczekaj na zakończenie przetwarzania

Z wiersza poleceń

# Uruchom zaplanowane zadanie ręcznie
php admin/cli/scheduled_task.php \
  --execute=\\local_credentium\\task\\process_pending_credentials

# Sprawdź status zadania
php admin/cli/scheduled_task.php --list | grep credentium

Problemy z wydajnością

Wolne wystawianie

Objawy: Poświadczenia długo się wystawiają

Przyczyny:

• Cron działa rzadko
• Wolna odpowiedź API
• Wiele oczekujących poświadczeń

Rozwiązania:

1. Upewnij się, że cron działa co najmniej co 5 minut
2. Sprawdź łączność sieciową z Credentium
3. Przetwarzaj oczekujące poświadczenia w mniejszych partiach

Wysokie obciążenie bazy danych

Objawy: Moodle zwalnia przy wielu poświadczeniach

Rozwiązania:

1. Upewnij się, że indeksy bazy danych są na miejscu (automatyczne przy instalacji)
2. Archiwizuj stare rekordy wystawień, jeśli potrzeba
3. Monitoruj rozmiary tabel

Zgodność z RODO

Wtyczka implementuje pełną zgodność z RODO poprzez API prywatności Moodle.

Kluczowe punkty:

• Automatyczne przechowywanie danych z konfigurowalnym okresem (domyślnie: 365 dni)
• Dane użytkownika automatycznie usuwane przy usunięciu użytkowników z Moodle
• Obsługa żądań eksportu danych przez narzędzia prywatności Moodle
• Dane osobowe przesyłane do zewnętrznego API Credentium® w celu wystawiania certyfikatów

Pełne szczegóły znajdziesz w dedykowanym artykule Prywatność i zgodność z RODO.

Uzyskiwanie pomocy

Przed kontaktem ze wsparciem

Zbierz te informacje:

1. Wersja Moodle
2. Wersja wtyczki (Administracja witryny > Wtyczki > Przegląd wtyczek)
3. Komunikaty o błędach (dokładny tekst)
4. Wpisy logu debugowania (jeśli dostępne)
5. Kroki do odtworzenia problemu

Informacje kontaktowe

Wsparcie Credentium Email: support@credentium.com

Zgłoszenia GitHub Dla raportów o błędach: GitHub Issues

Ostatnia aktualizacja: Styczeń 2026