Files
twenty/packages/twenty-docs/l/af/user-guide/workflows/workflow-troubleshooting.mdx
T
github-actions[bot] 9bc5486d0d i18n - translations (#15803)
Created by Github action

---------

Co-authored-by: github-actions <github-actions@twenty.com>
2025-11-13 17:12:39 +01:00

130 lines
5.5 KiB
Plaintext
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
---
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