Masowe poświadczenia

Masowe poświadczenia pozwalają wystawić odznaki setkom lub tysiącom odbiorców naraz poprzez wczytanie pliku CSV. Proces składa się z czterech kroków z wbudowanym śledzeniem postępu, pauzą/wznowieniem i obsługą błędów.

Przegląd

Proces masowego wystawiania poświadczeń składa się z czterech kroków:

1. Konfiguracja — wybierz odznakę i opcje
2. Wczytanie — przygotuj i wczytaj plik CSV
3. Przetwarzanie — śledź postęp tworzenia poświadczeń
4. Wyniki — sprawdź rezultaty i pobierz raporty

Krok 1: Konfiguracja

1. Otwórz stronę Masowe poświadczenia z paska bocznego (ma własną ścieżkę, oddzielną od strony Poświadczenia).
2. Wybierz odznakę, którą chcesz wystawić, za pomocą selektora odznak.
3. Opcjonalnie skonfiguruj:
   • Data wystawienia — data użyta dla wszystkich poświadczeń (domyślnie dzisiaj)
   • Wygasa — opcjonalna data wygaśnięcia dla wszystkich poświadczeń
   • Wyślij e-mail — czy automatycznie wysłać e-mail do każdego odbiorcy po utworzeniu jego poświadczenia
4. Kliknij Dalej.

Krok 2: Wczytanie pliku CSV

Format CSV

Plik CSV musi zawierać kolumnę name i kolumnę email oraz wiersz nagłówka. Nazwy nagłówków nie rozróżniają wielkości liter, a recipient_name / recipient_email są akceptowane jako aliasy dla name / email.

name,email
Jane Smith,jane@example.com
John Doe,john@example.com
Maria Garcia,maria@example.com

Pobierz szablon

Kliknij Pobierz szablon, aby otrzymać pusty plik CSV z poprawnymi nagłówkami. Uzupełnij go danymi odbiorców i wczytaj.

Wczytywanie

1. Kliknij Wczytaj CSV lub przeciągnij i upuść plik.
2. Plik jest sprawdzany przed rozpoczęciem przetwarzania.

Zasady walidacji

Każdy wiersz jest sprawdzany zaraz po przetworzeniu pliku:

• Imię i nazwisko musi mieć co najmniej 5 znaków
• E-mail musi być prawidłowym adresem e-mail
• Puste wiersze są pomijane

Tabela podglądu wyświetla każdy wiersz wraz z zielonym znacznikiem lub czerwonym powodem odrzucenia. Nieprawidłowe wiersze nie blokują procesu — są po prostu pomijane, a licznik pokazuje, ilu prawidłowych odbiorców zostanie przetworzonych (np. „18 prawidłowych odbiorców, 2 nieprawidłowych (zostaną pominięci)"). Możesz kontynuować, o ile co najmniej jeden wiersz jest prawidłowy; nie musisz najpierw poprawiać i ponownie wczytywać pliku.

3. Kliknij Dalej, aby rozpocząć przetwarzanie.

Krok 3: Przetwarzanie

Po rozpoczęciu przetwarzania zobaczysz pasek postępu i liczniki na żywo:

• Pasek postępu — odsetek przetworzonych wierszy
• Utworzone — ile poświadczeń zostało utworzonych
• Nieudane — ile wierszy zakończyło się niepowodzeniem
• Pozostałe — ile wierszy nadal czeka w kolejce

Pod paskiem, w trakcie działania partii, wypełniają się na żywo tabele Utworzone, Nieudane i Oczekujące.

Pauza i wznowienie

• Kliknij Pauza, aby tymczasowo zatrzymać przetwarzanie. W trakcie pauzy nie są tworzone nowe poświadczenia.
• Kliknij Wznów, aby kontynuować od miejsca, w którym przerwano.

Anulowanie

• Kliknij Anuluj, aby całkowicie zatrzymać przetwarzanie. Poświadczenia, które już zostały utworzone, zostają zachowane.

Obsługa błędów

Gdy wiersz kończy się niepowodzeniem z przyczyny dotyczącej tylko tego wiersza (np. nieprawidłowa wartość odrzucona przez backend):

• Błąd jest zapisywany przy tym wierszu
• Przetwarzanie automatycznie przechodzi do następnego wiersza
• Nieudane wiersze są gromadzone na potrzeby kroku wyników, a tekst błędu jest widoczny w tabeli niepowodzeń na ekranie

Wiersze ograniczone limitem szybkości są automatycznie ponawiane z krótkim opóźnieniem. Błąd kredytów lub limitu wygląda inaczej — zamiast pomijać wiersz, partia zostaje wstrzymana, aby nie zużyć reszty pliku. Pojawia się czerwony komunikat „Niewystarczająca liczba kredytów"; doładuj konto lub zmień plan, a następnie kliknij Wznów, aby kontynuować od miejsca zatrzymania.

Odzyskiwanie po odświeżeniu strony

Jeśli podczas przetwarzania przypadkowo zamkniesz przeglądarkę lub odświeżysz stronę, sesja masowych poświadczeń zostanie odzyskana po powrocie. Postęp jest wznawiany od miejsca, w którym został przerwany.

Krok 4: Wyniki

Po zakończeniu przetwarzania (lub jego anulowaniu) ekran wyników pokazuje cztery karty podsumowania:

• Razem — liczba odbiorców w partii
• Utworzone — liczba utworzonych poświadczeń
• Nieudane — liczba wierszy, które zakończyły się niepowodzeniem
• Pominięte — odbiorcy, którzy nie zostali przetworzeni (np. pozostałe wiersze po anulowaniu)

Pod kartami tabela Utworzone wyświetla każde nowe poświadczenie wraz z linkiem do jego podglądu, a tabela Nieudane wymienia niepowodzenia wraz z tekstem błędu.

Pobieranie raportów

• Pobierz CSV z wynikami — każdy wiersz partii, z kolumnami row, name, email, status, award_url (adres URL poświadczenia jest wypełniony dla utworzonych wierszy).
• Pobierz CSV z niepowodzeniami — tylko nieudane wiersze, z kolumnami name, email, error.

Ponawianie nieudanych

Jeśli część wierszy zakończyła się niepowodzeniem, kliknij Ponów nieudane. Rozpocznie to nowy przebieg tylko dla nieudanych odbiorców — bez konieczności ponownego wczytywania pliku CSV. Przydaje się to po usunięciu przejściowego problemu, np. po doładowaniu kredytów po wstrzymaniu partii.