9bc5486d0d
Created by Github action --------- Co-authored-by: github-actions <github-actions@twenty.com>
130 lines
5.5 KiB
Plaintext
130 lines
5.5 KiB
Plaintext
---
|
||
title: Workflow Probleemoplossing
|
||
info: Ontfout en optimaliseer jou werkvloeie met probleemoplossingstegnieke en wenke vir prestasie-optimalisering.
|
||
image: /images/user-guide/what-is-twenty/20.png
|
||
sectionInfo: Outomatiseer prosesse en integreer met eksterne gereedskap
|
||
---
|
||
|
||
<Frame>
|
||
<img src="/images/user-guide/what-is-twenty/20.png" alt="Header" />
|
||
</Frame>
|
||
|
||
## Ontfouting met Workflow Runne
|
||
|
||
Gebruik die **Workflow Runne**-koppelvlak om probleme reg te stel:
|
||
|
||
- Verkry toegang via die **Lopies** paneel in die werksvloei redigeerder
|
||
- Klik op individuele runne om in- en uitsetdata vir elke stap te sien
|
||
- Kyk uitvoeringstatus, foutboodskappe, en data vloei tussen stappe
|
||
|
||
## Algemene Probleme en Oplossings
|
||
|
||
### Werkvloei Word Nie Geaktiveer Nie
|
||
|
||
**Probleem**: Werkvloei voer nie uit soos verwag nie.
|
||
|
||
**Oplossings**:
|
||
|
||
- Verifieer dat die werkvloei **Aktief** is (nie in Ontwerp-modus nie)
|
||
- Kyk of snellerkonfigurasie by jou datastruktuur pas
|
||
- Vir Rekord snellers, verseker dat die korrekte objekt en velde gekies word
|
||
- Vir Webhook snellers, verifieer die URL en verwagte data formaat
|
||
- Vir Geskeduleerde snellers, kyk die tydkonfigurasie
|
||
|
||
### Vorms Nie Toeganklik Nie
|
||
|
||
**Probleem**: Vormaksies is moeilik om te vind of toegang te verkry in outomatiese werkvloeie.
|
||
|
||
<Warning>
|
||
Vorms is tans slegs vir handmatige snellers ontwerp. Vir werkvloeie met ander koppelings (Rekord Geskape, Opgedateer, ens.), is vorms slegs toeganklik via die werkvloei-run-koppelvlak, wat nie die verwagte gebruikerservaring is nie. ’n Kennisgewing-sentrum sal in 2026 vrygestel word om vorms behoorlik in outomatiese werkvloeie te ondersteun.
|
||
</Warning>
|
||
|
||
**Omseiling**: Gebruik handmatige snellers wanneer vorms benodig word, of hervorm werkvloeie om vorms in geoutomatiseerde vloeie te vermy.
|
||
|
||
### Hoë Kredietverbruik
|
||
|
||
**Probleem**: Werkvloeie gebruik meer krediete as wat verwag is.
|
||
|
||
**Algemene Oorsake & Oplossings**:
|
||
|
||
- **Oneffektiewe API Oproepe**: Groepeer API oproepe wanneer moontlik in plaas van individuele versoeke
|
||
- **Verkeerde Handmatige Sneller Konfigurasie**: Gebruik `Massa` beskikbaarheid in plaas van `Enkel` om meerdere rekords in een werkvloei uitvoer te verwerk
|
||
- **Ontbrekende Filtreermiddels**: Voeg voorwaardelike logika by om werkvloeie te stop wanneer kriteria nie vervul is nie
|
||
- **Onoodsaaklike Stappe**: Verwyder oortollige aksies en optimaliseer werkvloei-logika
|
||
- **Regstreekse vs. Geskeduleerde**: Gebruik geskeduleerde werkvloeie vir nie-dringende prosesse
|
||
|
||
### Gelyktydige Werkvloei Beperkings
|
||
|
||
**Probleem**: Bereik die 100 gelyktydige werkvloei-limiet per werkspasie.
|
||
|
||
<Warning>Jy kan nie meer as 100 werkvloeie terselfdertyd parallel per werkspasie uitvoer nie.</Warning>
|
||
|
||
**Oplossings**:
|
||
|
||
- Gebruik `Massa` beskikbaarheid vir handmatige snellers om meerdere rekords in een uitvoering te verwerk
|
||
- Implementeer vertragings tussen werkvloeie-uitvoerings met behulp van geskeduleerde snellers
|
||
- Optimaliseer werkvloeie om vinniger te verloop en gelyktydige uitvoeringstyd te verminder
|
||
- Oorweeg massaverwerking gedurende stiltyd ure
|
||
|
||
### API Koers Beperking
|
||
|
||
**Probleem**: Eksterne API-oproepe wat misluk as gevolg van koersbeperkings.
|
||
|
||
**Oplossings**:
|
||
|
||
- Gebruik geskeduleerde werkvloeie in plaas van regstreekse koppelings waar moontlik
|
||
- Stel vertragings tussen API-oproepe in Kode-aksies
|
||
- Groepeer API versoeke wanneer die eksterne diens dit ondersteun
|
||
- Monitor werkvloei-runne vir koersbeperkingfoute en pas tydsberekeninge aan
|
||
|
||
### Iterator Probleme
|
||
|
||
**Probleem**: Iterator-aksies werk nie soos verwag nie.
|
||
|
||
**Oplossings**:
|
||
|
||
- **Nota**: Iterator is tans in beta. Aktiveer dit onder Instellings → Vrystellings → Laboratorium
|
||
- Verifieer dat die inset 'n versameling van rekords van 'n vorige stap is
|
||
- Kontroleer dat aksies binne die Iterator behoorlik gekonfigureer is
|
||
- Gebruik Iterator met `Bult` handkoppe vir optimale werkverrigting
|
||
|
||
### Ontbrekende Toestemmings
|
||
|
||
**Probleem**: Kan nie toegang tot die werkvloei-seksie kry nie.
|
||
|
||
<Warning>
|
||
As jy die Werkvloei-seksie nie sien nie, is dit te wyte aan 'n toestemmingsprobleem. Kontak jou werkspasie-administrateur om jou toegang tot werkvloeie te verskaf.
|
||
</Warning>
|
||
|
||
## Optimaliseringswenke
|
||
|
||
### Prestasie Beste Praktyke
|
||
|
||
- **Begin eenvoudig** en voeg geleidelik kompleksiteit by
|
||
- **Gebruik `Massa` beskikbaarheid** vir handmatige snellers om meerdere rekords doeltreffend te verwerk
|
||
- **Voeg filtreermiddels vroeg by** om werkvloeie te stop wanneer kriteria nie voldoen word nie
|
||
- **Batch API-oproepe** en gebruik geskeduleerde werkvloeie vir nie-dringende prosesse
|
||
- **Verberg werkvloei-runne** van bladsye wat alle werkvloeie wys om laaiprestasie te verbeter
|
||
- **Monitor kredietverbruik** gereeld in Instellings → Fakturering
|
||
|
||
### Foutvoorkoming
|
||
|
||
- **Toets in ontwerpmodus** voordat werkvloei geaktiveer word
|
||
- **Valideer API-reaksies** en implementeer terugvalaksies
|
||
- **Gebruik beskrywende stapname** vir maklike onderhoud
|
||
- **Dokumenteer komplekse logika** vir spanlede
|
||
|
||
## Hulp Kry
|
||
|
||
### Self-diens Hulpbronne
|
||
|
||
- Hersien [Werkvloei Kenmerke](/l/af/user-guide/workflows/workflow-features) vir tegniese besonderhede
|
||
- Kyk [Werkvloei Krediete](/l/af/user-guide/workflows/workflow-credits) vir optimaliseringswenke
|
||
- Verken [Interne Outomatiese Prosesse](/l/af/user-guide/workflows/internal-automations) en [Eksterne Gereedskap Integrasie](/l/af/user-guide/workflows/external-tool-integration) vir voorbeelde
|
||
|
||
### Professionele Ondersteuning
|
||
|
||
- Kontak ons [Professionele Dienste](/l/af/user-guide/workflows/professional-services) vir komplekse probleemoplossing
|
||
- Kontak ondersteuning via contact@twenty.com vir tegniese bystand
|
||
|