Documentation Index
Fetch the complete documentation index at: https://docs.twenty.com/llms.txt
Use this file to discover all available pages before exploring further.
Běžné problémy a řešení
Workflow se nespouští
Příznaky: Váš pracovní postup se nespustí, když to očekáváte. Možné příčiny:- Pracovní postup není aktivován: Ujistěte se, že je pracovní postup nastaven na “Active”, ne na “Draft”
- Podmínky spouštěče nesplněny: Ověřte, že spouštěč odpovídá očekávané události
- Pole není sledováno: U spouštěčů “Record is Updated” se ujistěte, že je dané pole sledováno
- Oprávnění: Zkontrolujte, že máte oprávnění spouštět pracovní postupy
- Ověřte stav pracovního postupu v seznamu pracovních postupů
- Otestujte to konkrétní akcí, u které očekáváte, že jej spustí
- Zkontrolujte konfiguraci spouštěče
- Kontaktujte svého administrátora ohledně oprávnění
Spouštění pracovního postupu příliš brzy (prázdná pole)
Příznaky: Při ručním vytváření záznamu v UI se váš pracovní postup spustí dříve, než máte čas vyplnit všechna pole. Pracovní postup běží převážně s prázdnými hodnotami polí. Proč k tomu dochází: Twenty ukládá vše v reálném čase — neexistuje oddělený režim “edit” vs “read”. Když vytvoříte záznam, ihned se uloží, což vyvolá událost “Record is created” dříve, než stihnete vyplnit další pole. Kdy se “Record is created” hodí:- Záznamy vytvořené přes volání API (pole jsou vyplněna v jednom požadavku)
- Záznamy vytvořené pomocí importu
- Automatické vytváření záznamů z jiných pracovních postupů
- Pracovní postup se spustí poté, co uživatel dokončí vyplňování polí a jejich uložení
- Získáte kompletní data namísto prázdných hodnot
Selhávající akce
Příznaky: Pracovní postup běží, ale některé akce selhávají. Možné příčiny:- Chybějící data: Povinná pole jsou prázdná
- Neplatné odkazy: Proměnné z předchozích kroků neexistují
- Chyby API: Externí služby vracejí chyby
- Problémy s oprávněními: Akce vyžaduje oprávnění, která nemáte
- Zkontrolujte podrobnosti běhu pracovního postupu kvůli chybovým zprávám
- Ověřte, že všechna povinná pole mají hodnoty
- Otestujte připojení k API samostatně
- Projděte oprávnění rolí
Chyby požadavků HTTP
Příznaky: Akce HTTP Request selhávají nebo vracejí neočekávané výsledky. Běžné chybové kódy:- 400: Neplatný požadavek - zkontrolujte formát těla požadavku
- 401: Neautorizováno - ověřte klíč API
- 403: Zakázáno - zkontrolujte oprávnění API
- 404: Nenalezeno - ověřte URL endpointu
- 429: Příliš mnoho požadavků - zaveďte omezení četnosti požadavků
- 500: Chyba serveru - problém v externí službě
- Ověřte URL endpointu API
- Zkontrolujte autentizační hlavičky
- Nejprve otestujte volání API mimo Twenty
- Přidejte zpracování chyb v akcích Code
Chyby akcí Code
Příznaky: Kód JavaScriptu se nedaří spustit. Běžné problémy:- Syntaktické chyby: Překlepy nebo neplatný JavaScript
- Nedefinované proměnné: Odkazování na proměnné, které neexistují
- Chyby typů: Operace na nesprávných datových typech
- Vypršení časového limitu: Kód se spouští příliš dlouho
- Použijte vestavěnou validaci editoru kódu
- Nejprve otestujte logiku kódu v konzoli JavaScriptu
- Přidejte výpisy console.log pro ladění
- Zjednodušte složité operace
E-mail se neodesílá
Příznaky: Akce Send Email nedoručuje e-maily. Možné příčiny:- Není připojen e-mailový účet: Zkontrolujte Nastavení → Účty
- Neplatná e-mailová adresa: E-mail příjemce má neplatný formát
- Limity odesílání: Byly dosaženy limity poskytovatele e-mailu
- Spamové filtry: E-maily jsou blokovány
- Ověřte připojení e-mailového účtu
- Ověřte e-mailové adresy příjemců
- Zkontrolujte limity poskytovatele e-mailu
- Zkontrolujte obsah e-mailu kvůli spouštěčům spamu
Ladění pracovních postupů
Používání běhů pracovního postupu
- Přejděte do editoru pracovního postupu
- Otevřete panel Runs
- Najděte neúspěšný běh
- Klikněte pro zobrazení podrobných informací krok za krokem
- Projděte chybové zprávy a výstupní data
Testování jednotlivých kroků
- U akcí Code použijte tlačítko Test
- U požadavků HTTP otestujte endpoint samostatně
- Vytvářejte testovací záznamy pro spuštění pracovních postupů
- Pro řízené testování použijte manuální spouštěče
Běžné vzory ladění
Přidejte logování: Použijte akce Code k zaznamenávání mezilehlých hodnot pro ladění. Izolujte kroky: Testujte každý krok samostatně, abyste identifikovali selhání. Zkontrolujte tok dat: Ověřte, že každý krok dostává očekávaná vstupní data.Osvědčené postupy k předcházení problémům
Před aktivací
- Důkladně testujte v režimu konceptu
- Ověřte všechna připojení k API
- Pečlivě zkontrolujte podmínky spouštěče
- Zdokumentujte očekávané chování
Během vývoje
- Používejte výstižné názvy kroků
- Přidejte komentáře v akcích Code
- Testujte s realistickými daty
- Plánujte i okrajové případy
Po aktivaci
- Pečlivě sledujte počáteční běhy
- Nastavte upozornění na selhání
- Pravidelně procházejte historii běhů
- Udržujte pracovní postupy co nejjednodušší