Hromadná pověření

Hromadná pověření vám umožňují vydat odznaky stovkám či tisícům příjemců najednou nahráním souboru CSV. Proces má čtyři kroky s vestavěným sledováním průběhu, pozastavením/pokračováním a zpracováním chyb.

Přehled

Proces hromadných pověření probíhá ve čtyřech krocích:

1. Konfigurace — vyberte odznak a možnosti
2. Nahrání — připravte a nahrajte soubor CSV
3. Zpracování — sledujte průběh vytváření pověření
4. Výsledky — projděte výsledky a stáhněte si reporty

Krok 1: Konfigurace

1. Otevřete stránku Hromadná pověření v bočním panelu (má vlastní cestu, oddělenou od stránky Pověření).
2. Pomocí výběru odznaků vyberte odznak, který chcete vydat.
3. Volitelně nastavte:
   • Vydáno dne — datum použité pro všechna pověření (výchozí je dnes)
   • Platnost do — volitelné datum vypršení platnosti všech pověření
   • Odeslat e-mail — zda se má každému příjemci po vytvoření jeho pověření automaticky odeslat e-mail
4. Klikněte na Další.

Krok 2: Nahrání CSV

Formát CSV

Soubor CSV musí obsahovat sloupec name a sloupec email a řádek záhlaví. Názvy záhlaví nerozlišují velikost písmen a recipient_name / recipient_email jsou přijímány jako aliasy pro name / email.

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

Stažení šablony

Kliknutím na Stáhnout šablonu získáte prázdný soubor CSV se správným záhlavím. Vyplňte ho svými příjemci a nahrajte.

Nahrání

1. Klikněte na Nahrát CSV nebo soubor přetáhněte myší.
2. Soubor se před zahájením zpracování zvaliduje.

Pravidla validace

Každý řádek se validuje ihned po zpracování souboru:

• Jméno musí mít alespoň 5 znaků
• E-mail musí být platná e-mailová adresa
• Prázdné řádky se přeskakují

Náhledová tabulka uvádí každý řádek se zelenou fajfkou nebo červeným důvodem. Neplatné řádky nejsou překážkou — jsou jednoduše přeskočeny a počítadlo ukazuje, kolik platných příjemců bude zpracováno (např. „18 platných příjemců, 2 neplatní (budou přeskočeni)"). Pokračovat můžete, pokud je platný alespoň jeden řádek; není třeba nejprve nic opravovat a znovu nahrávat.

3. Kliknutím na Další zahájíte zpracování.

Krok 3: Zpracování

Jakmile zpracování začne, uvidíte ukazatel průběhu a živá počítadla:

• Ukazatel průběhu — procento zpracovaných řádků
• Vytvořeno — kolik pověření bylo vytvořeno
• Selhalo — kolik řádků selhalo
• Zbývá — kolik řádků stále čeká ve frontě

Živé tabulky Vytvořeno, Selhalo a Čekající se pod ukazatelem plní v průběhu zpracování dávky.

Pauza a pokračování

• Kliknutím na Pozastavit zpracování dočasně zastavíte. Během pozastavení se nevytvářejí žádná nová pověření.
• Kliknutím na Pokračovat navážete tam, kde jste skončili.

Zrušení

• Kliknutím na Zrušit zpracování úplně zastavíte. Již vytvořená pověření zůstanou zachována.

Zpracování chyb

Když řádek selže z důvodu specifického pro daný řádek (např. neplatná hodnota, kterou backend odmítne):

• Chyba se zaznamená k danému řádku
• Zpracování automaticky pokračuje dalším řádkem
• Selhané řádky se shromáždí pro krok výsledků a text jejich chyby se zobrazí v tabulce selhání na obrazovce

Řádky omezené limitem četnosti se automaticky opakují s krátkou prodlevou. Chyba kreditů nebo kvóty je jiná — dávka se nepřeskočí dál, ale pozastaví se, abyste nespotřebovali zbytek souboru. Zobrazí se červené upozornění „Nedostatek kreditů"; dobijte kredity nebo přejděte na vyšší plán a poté kliknutím na Pokračovat navažte tam, kde zpracování skončilo.

Obnovení po obnovení stránky

Pokud během zpracování omylem zavřete prohlížeč nebo obnovíte stránku, relace hromadných pověření se po návratu obnoví. Průběh pokračuje od místa, kde se zastavil.

Krok 4: Výsledky

Po dokončení zpracování (nebo jeho zrušení) zobrazí obrazovka výsledků čtyři souhrnné karty:

• Celkem — počet příjemců v dávce
• Vytvořeno — počet vytvořených pověření
• Selhalo — počet řádků, které selhaly
• Přeskočeno — nezpracovaní příjemci (např. zbývající řádky po zrušení)

Pod kartami tabulka Vytvořeno uvádí každé nové pověření s odkazem na jeho zobrazení a tabulka Selhalo uvádí selhání s textem chyby.

Stažení reportů

• Stáhnout CSV s výsledky — každý řádek dávky se sloupci row, name, email, status, award_url (URL pověření je vyplněna u vytvořených řádků).
• Stáhnout CSV se selháními — pouze selhané řádky se sloupci name, email, error.

Opakování selhání

Pokud některé řádky selhaly, klikněte na Opakovat selhání. Tím se spustí nový průchod pouze selhanými příjemci — není třeba znovu nahrávat CSV. Hodí se po odstranění přechodného problému, například po dobití kreditů po pozastavené dávce.