← Cloudflare Waiting Room / waiting-room / additional-options

Vytvoření naplánovaných událostí

Pokud chcete přizpůsobit chování čekárny na určité časové období, například změnit metodu řazení do fronty nebo zvýšit celkový počet aktivních uživatelů, nastavte naplánovaná událost. Můžete to provést z dashboardu nebo přes rozhraní API.

Jakékoli vlastnosti nastavené u události po dobu jejího trvání přepíší výchozí vlastnosti čekárny.

1. Ve své aplikaci přejděte na Provoz > Waiting Room.

2. Rozbalte čekárnu a vyberte Naplánovat událost.

3. Upravte podrobnosti své události: pojmenujte ji, volitelně přidejte popis a vyberte hodnoty Start Date Time a End Date Time.

4. Můžete také povolit předřazení do fronty (pre-queueing), v takovém případě je nutné definovat dobu předřazení. Dále můžete zvolit Promíchat při zahájení události a všichni uživatelé v předřazené frontě budou na začátku události vpouštěni náhodně.

5. Vyberte Next.

6. V Nastavení můžete definovat nové hodnoty pro Total active users, New users per minute, Session duration, Session Renewal a Queueing Method. U každého z těchto nastavení máte rovněž možnost vždy dědit hodnoty definované ve vaší čekárně. Pokud tuto možnost zvolíte, změna nastavení základní čekárny se automaticky projeví i v odpovídajícím nastavení události.

7. Vyberte Next.

8. V sekci přizpůsobení můžete zvolit možnost Always inherit your waiting room’s template (výchozí), nebo ji přepsat pomocí Custom Event Template. V takovém případě je nutné importovat vlastní šablonu. Před pokračováním si nezapomeňte zobrazit náhled výsledku.

9. Vyberte Next a zkontrolujte podrobnosti a nastavení své události.

10. Vyberte Save.

Na stránce čekárny v Next Event sloupci vidíte datum další naplánované události. V tomto sloupci se zobrazí N/A pro případ, že pro danou čekárnu není naplánovaná žádná událost. Svou událost můžete kdykoli pozastavit, upravit nebo odstranit.

Chcete-li vytvořit událost, odešlete Požadavek POST včetně povinné a volitelné parametry. Jakékoli vlastnosti nastavené u události přepíší výchozí vlastnost čekárny po dobu trvání události.

Pokud používáte vlastní šablona, možná budete chtít přidat relevantní proměnné do šablony (uvedené v části json_response_enabled parametr).

Většina parametrů je stejná jako u běžné čekárny, ale několik jich je specifických pro vytváření události. Úplný seznam nastavení události naleznete v Vytvoření události.

• name (povinné): Jedinečný název obsahující alfanumerické znaky, spojovníky a podtržítka.
• event_start_time (povinné): Časové razítko ve formátu ISO 8601, které označuje začátek události. V tomto okamžiku se uživatelé ve frontě začnou zpracovávat podle konfigurace události. Musí nastat alespoň 1 minutu před event_end_time.
• event_end_time (povinné): Časové razítko ve formátu ISO 8601, které označuje konec události.
• shuffle_at_event_start: Pokud true a prequeue_start_time není null, uživatelé v předřazené frontě budou náhodně přeřazeni v event_start_time. Běžně se používá k zajištění spravedlnosti, pokud vaše událost využívá FIFO metoda řazení do fronty.
• prequeue_start_time: Časové razítko ve formátu ISO 8601 určující, kdy se má začít řadit všechny uživatele do fronty před zahájením události. Musí nastat alespoň 5 minut předem event_start_time.
• description: Textový popis poskytující více podrobností o události.
• suspended: Pokud true, je událost ignorována a provoz se zpracovává podle běžné konfigurace čekárny.

Při nastavování událostí možná budete chtít upravit také výchozí metody řazení do fronty pro vaši čekárnu.

Nastavte metodu řazení do fronty waiting roomu na Passthrough pokud chcete provoz běžně povolovat, ale během plánované události ho chcete omezit.

Nastavte metodu řazení do fronty waiting roomu na Reject pokud chcete běžně blokovat veškerý provoz, ale během speciálních událostí, jako je registrace nebo prodej vstupenek, ho chcete povolit.

Vytvořte systém "loterie", který odmění všechny uživatele, kteří se zařadí do fronty ještě před začátkem vaší události.

Uživatelé, kteří se dostanou do vaší aplikace během období před frontou jsou náhodně přiřazeno místo ve frontě, jakmile událost začne. Pokud událost používá Řazení FIFO, uživatelé, kteří se dostanou do vaší aplikace, po skončení období předřazení do fronty se přidělují místa až po uživatelích z předřazené fronty.

Chcete-li nastavit takzvanou „loterii", zahrňte následující parametry v požadavku API:

• prequeue_start_time
• shuffle_at_event_start

Vzhledem k tomu, že některé vlastnosti nastavené u události po dobu jejího trvání přepíší výchozí vlastnost waiting roomu, měli byste pomocí API náhled konfigurace události před jejím začátkem.

Tento příkaz zobrazí konfiguraci události, jako by byla aktivní, což znamená, že zděděná pole z waiting roomu zobrazí své aktuální hodnoty.

Chcete-li upravit událost, použijte Požadavek PATCH.

Událost můžete deaktivovat nastavením jejího suspended parametr na true.

Události se navíc nestanou aktivními, pokud je samotná čekárna Disabled.

Pokud chcete nasadit plánovanou stránku údržby bez řazení do fronty před oknem údržby nebo po něm, postupujte podle těchto kroků.

1. Vytvoření čekárny hodnotou Passthrough metoda řazení do fronty povolena.
2. Vytvořte událost pro tuto čekárnu pomocí Reject metoda řazení do fronty povolena.

Po skončení naplánované události budou mít uživatelé přístup na váš web. Okno údržby můžete ukončit i před koncem naplánované události tak, že událost nastavíte na disabled.