Baza Wiedzy

Znajdź odpowiedzi na swoje pytania i odkryj pełen potencjał platformy ZTWS Quiz.

Import i eksport quizów

Dowiedz się, jak importować quizy z plików JSON i Excel oraz eksportować swoje quizy do ponownego użycia.

Eksport quizów

ZTWS Quiz umożliwia eksport quizów do dwóch formatów:

Format JSON

Uniwersalny format wymiany danych. Idealny do:

  • Archiwizacji quizów
  • Udostępniania quizów innym użytkownikom
  • Integracji z innymi systemami
  • Edycji strukturalnej quizu
Zalecany
Format Excel (XLSX)

Arkusz kalkulacyjny do analizy danych. Idealny do:

  • Łatwej edycji w Excel/Google Sheets
  • Masowej edycji pytań
  • Współpracy z innymi osobami
  • Przeglądu quizu w formie tabeli
Wygodny

Jak eksportować quiz?

1
Przejdź do listy swoich quizów

Kliknij "Moje quizy" w menu nawigacyjnym.

2
Wybierz quiz do eksportu

Znajdź quiz, który chcesz wyeksportować.

3
Kliknij przycisk eksportu

Wybierz format: JSON lub Excel

4
Pobierz plik

Plik zostanie automatycznie pobrany na Twoje urządzenie.

Import quizów

Jak importować quiz?

1
Przejdź do strony importu

W menu "Moje quizy" kliknij "Importuj quiz".

2
Wybierz plik

Kliknij "Wybierz plik" i wybierz plik JSON lub Excel.

3
Kliknij "Importuj"

System zaimportuje quiz i wyświetli potwierdzenie.

4
Sprawdź quiz

Przejrzyj zaimportowany quiz i wprowadź ewentualne poprawki.

Format JSON

Struktura pliku JSON

Plik JSON quizu składa się z następujących pól:

{
  "version": "1.0",
  "export_date": "2023-10-27T10:00:00+02:00",
  "quiz": {
    "title": "Tytuł quizu",
    "description": "Opis quizu (opcjonalny)",
    "lobby_music_enabled": true
  },
  "questions": [
    {
      "question_text": "Treść pytania",
      "type": "single",
      "time_limit": 20,
      "points": 1000,
      "explanation": "Dodatkowe wyjaśnienie (opcjonalne)",
      "display_delay": 5,
      "question_order": 1,
      "answers": [
        {
          "answer_text": "Odpowiedź 1",
          "is_correct": true
        },
        {
          "answer_text": "Odpowiedź 2",
          "is_correct": false
        }
      ]
    }
  ]
}

Opis pól

Pole Typ Opis Wymagane
version string Wersja formatu eksportu Tak
export_date string Data i czas eksportu (ISO 8601) Tak
quiz object Główne informacje o quizie Tak
quiz.title string Tytuł quizu Tak
quiz.description string Opis quizu Nie
quiz.lobby_music_enabled boolean Czy muzyka w lobby jest włączona Nie
questions array Tablica pytań Tak

Struktura pytania

Pole Typ Opis Wymagane
question_text string Treść pytania Tak
type string Typ pytania: single, multiple, true_false, ordering Tak
time_limit integer Czas na odpowiedź w sekundach (5-300) Nie
points integer Punkty za pytanie (domyślnie: 1000) Nie
explanation string Wyjaśnienie do pytania, wyświetlane po zakończeniu rundy (opcjonalne) Nie
display_delay integer Opóźnienie w sekundach przed wyświetleniem pytania (opcjonalne) Nie
question_order integer Kolejność pytania w quizie (automatycznie przypisywana) Tak
answers array Tablica odpowiedzi Tak

Struktura odpowiedzi

Pole Typ Opis Wymagane
answer_text string Treść odpowiedzi Tak
is_correct boolean Czy odpowiedź jest poprawna Tak
correct_order integer Pozycja w kolejności (tylko dla typu ordering) Dla ordering
Typ Ordering: Dla pytań typu ordering wszystkie odpowiedzi powinny mieć unikalną wartość correct_order (1, 2, 3, 4...) określającą właściwą kolejność. Pole is_correct jest ignorowane dla tego typu pytania.

Przykład kompletnego quizu JSON

{
  "version": "1.0",
  "export_date": "2023-10-27T10:00:00+02:00",
  "quiz": {
    "title": "Quiz z historii Polski",
    "description": "Podstawowe pytania z historii Polski",
    "lobby_music_enabled": true
  },
  "questions": [
    {
      "question_text": "W którym roku Polska odzyskała niepodległość?",
      "type": "single",
      "time_limit": 20,
      "points": 1000,
      "explanation": "Polska odzyskała niepodległość po I wojnie światowej.",
      "display_delay": null,
      "question_order": 1,
      "answers": [
        {"answer_text": "1918", "is_correct": true},
        {"answer_text": "1920", "is_correct": false},
        {"answer_text": "1945", "is_correct": false},
        {"answer_text": "1989", "is_correct": false}
      ]
    },
    {
      "question_text": "Które z poniższych miast były stolicami Polski?",
      "type": "multiple",
      "time_limit": 30,
      "points": 1500,
      "explanation": "Kraków i Warszawa to historyczne stolice Polski.",
      "display_delay": 5,
      "question_order": 2,
      "answers": [
        {"answer_text": "Kraków", "is_correct": true},
        {"answer_text": "Warszawa", "is_correct": true},
        {"answer_text": "Gdańsk", "is_correct": false},
        {"answer_text": "Poznań", "is_correct": false}
      ]
    },
    {
      "question_text": "Polska jest członkiem Unii Europejskiej",
      "type": "true_false",
      "time_limit": 15,
      "points": 500,
      "explanation": null,
      "display_delay": null,
      "question_order": 3,
      "answers": [
        {"answer_text": "Prawda", "is_correct": true},
        {"answer_text": "Fałsz", "is_correct": false}
      ]
    },
    {
      "question_text": "Ułóż polskich królów w kolejności chronologicznej",
      "type": "ordering",
      "time_limit": 30,
      "points": 2000,
      "explanation": "Prawidłowa kolejność to: Bolesław Chrobry, Kazimierz Wielki, Jan III Sobieski, Stanisław August Poniatowski.",
      "display_delay": 10,
      "question_order": 4,
      "answers": [
        {"answer_text": "Bolesław Chrobry", "is_correct": false, "correct_order": 1},
        {"answer_text": "Kazimierz Wielki", "is_correct": false, "correct_order": 2},
        {"answer_text": "Jan III Sobieski", "is_correct": false, "correct_order": 3},
        {"answer_text": "Stanisław August Poniatowski", "is_correct": false, "correct_order": 4}
      ]
    }
  ]
}

Format Excel (XLSX)

Struktura arkusza Excel

Plik Excel składa się z dwóch arkuszy:

Arkusz 1: Quiz Info

Zawiera podstawowe informacje o quizie:

Pole Wartość
Tytuł Nazwa quizu
Opis Opis quizu
Tryb punktowania standard/Dokładność/Seria poprawnych/Przetrwanie
Liczba żyć 1-10 (dla trybu survival)
Arkusz 2: Questions

Zawiera pytania i odpowiedzi:

Kolumna Opis
A Treść pytania
B Typ pytania
C Czas (s)
D Punkty
E-H Odpowiedzi
I-L Poprawne (1/0)

Przykład arkusza Questions

Pytanie Typ Czas Punkty Odp. 1 Odp. 2 Odp. 3 Odp. 4 Popr. 1 Popr. 2 Popr. 3 Popr. 4
Ile wynosi 2+2? single 20 1000 3 4 5 6 0 1 0 0
Polska jest w UE truefalse 15 500 Prawda Fałsz 1 0

Typy pytań w Excel

  • single - pytanie jednokrotnego wyboru
  • multiple - pytanie wielokrotnego wyboru
  • truefalse - pytanie prawda/fałsz
  • ordering - pytanie typu uporządkuj
Pytania typu ordering w Excel: Dla pytań typu ordering kolejność odpowiedzi w kolumnach E-H określa poprawną kolejność. Pierwsza odpowiedź (kolumna E) powinna być na pozycji 1, druga (F) na pozycji 2, itd.

Oznaczanie poprawnych odpowiedzi

  • 1 - odpowiedź poprawna
  • 0 - odpowiedź niepoprawna

Walidacja importu

Automatyczna walidacja: System automatycznie sprawdza poprawność importowanych danych i wyświetla ewentualne błędy.

Najczęstsze błędy importu

Błąd Przyczyna Rozwiązanie
Nieprawidłowy format pliku Plik nie jest poprawnym JSON/Excel Sprawdź składnię JSON lub format Excel
Brak tytułu quizu Pole title jest puste Dodaj tytuł quizu
Brak pytań Tablica questions jest pusta Dodaj co najmniej jedno pytanie
Nieprawidłowy typ pytania Wartość inna niż single/multiple/truefalse/ordering Użyj prawidłowego typu pytania
Brak poprawnej odpowiedzi Żadna odpowiedź nie jest oznaczona jako poprawna Zaznacz co najmniej jedną poprawną odpowiedź
Za mało odpowiedzi Pytanie ma mniej niż 2 odpowiedzi Dodaj co najmniej 2 odpowiedzi

Najlepsze praktyki

Zalecane
  • Używaj JSON dla długoterminowej archiwizacji
  • Używaj Excel dla masowej edycji pytań
  • Sprawdzaj importowane quizy przed uruchomieniem
  • Twórz kopie zapasowe ważnych quizów
  • Nazywaj pliki w sposób opisowy
Unikaj
  • Edycji plików JSON ręcznie (używaj edytora JSON)
  • Usuwania nagłówków w arkuszu Excel
  • Importowania quizów z niezaufanych źródeł
  • Modyfikacji struktury pliku Excel
  • Używania polskich znaków w nazwach pól JSON