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:
Uniwersalny format wymiany danych. Idealny do:
- Archiwizacji quizów
- Udostępniania quizów innym użytkownikom
- Integracji z innymi systemami
- Edycji strukturalnej quizu
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
Jak eksportować quiz?
Kliknij "Moje quizy" w menu nawigacyjnym.
Znajdź quiz, który chcesz wyeksportować.
Wybierz format: JSON lub Excel
Plik zostanie automatycznie pobrany na Twoje urządzenie.
Import quizów
Jak importować quiz?
W menu "Moje quizy" kliknij "Importuj quiz".
Kliknij "Wybierz plik" i wybierz plik JSON lub Excel.
System zaimportuje quiz i wyświetli potwierdzenie.
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 |
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:
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) |
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 wyborumultiple- pytanie wielokrotnego wyborutruefalse- pytanie prawda/fałszordering- pytanie typu uporządkuj
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ź poprawna0- odpowiedź niepoprawna
Walidacja importu
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
- 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
- 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