Files
twenty/packages/twenty-docs/l/af/user-guide/workflows/workflow-features.mdx
T
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

321 lines
11 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: Werkvloeifunksies
info: Volledige verwysing vir alle beskikbare werkvloeisnellers, aksies en bestuursfunksies.
image: /images/user-guide/workflows/robot.png
sectionInfo: Outomatiseer prosesse en integreer met eksterne gereedskap
---
<Frame>
<img src="/images/user-guide/workflows/robot.png" alt="Header" />
</Frame>
## Werkvloeisnellers
Werkvloeie begin altyd met 'n enkele sneller wat vasstel wanneer die outomatisasie moet loop.
### Rekord is Geskep
Starts the workflow when a new record is created in a selected object (People, Companies, Opportunities, or any custom object).
**Konfigurasie**: Kies die objektipe om te monitor vir nuwe rekords.
### Rekord is Opgedateer
Starts the workflow when changes are made to an existing record.
**Konfigurasie**:
- Kies die objektipe
- Gee opsioneel aan watter velde gemonitor moet word vir veranderinge
### Rekord is Opgedateer of Geskep
Begin die werkvloeisneller wanneer 'n rekord óf geskep óf opgedateer word in 'n geselekteerde objek.
**Waarom Dit Saak Maak**: Hierdie sneller is veral nuttig omdat rekords wat via verskillende metodes geskep word, anders optree:
- **API/CSV invoere**: Rekords word geskep met alle velde onmiddellik ingevul
- **Manuele skepping**: Rekords word eers geskep, dan word velde in daaropvolgende opdaterings gevoeg
**Konfigurasie**:
- Kies die objektipe om te monitor
- Gee opsioneel aan watter velde gemonitor moet word vir veranderinge
- The workflow will trigger both on initial creation and any subsequent updates
### Rekord is Verwyder
Begin die werkvloeisneller wanneer 'n rekord van 'n objek verwyder word.
**Konfigurasie**: Kies die objektipe om te monitor vir verwyderings.
### Begin Handmatig
Starts the workflow when triggered by a user action. Hierdie sneller kan verkry word deur die Cmd+K menu of via 'n pasgemaakte knoppie in die boonste navigasiebalk.
**Beskikbaarheidskonfigurasie**:
Kies hoe die werkvloeisneller rekordseleksie hanteer:
- **Globaal**: Geen rekord is nodig om hierdie werkvloeisneller te begin nie. Die werkvloeisneller word oral van enige plek af begin (van enige objek) en gebruik nie rekords as invoer nie.
- **Single**: The selected record(s) will be passed to your workflow. Dit is gekonfigureer vir 'n gegewe objek. Verskeie rekords kan geselekteer word voordat die werkvloeisneller begin word. Die werkvloeisneller sal so baie kere loop as wat daar rekords geselekteer is.
<Warning>
You cannot run more than 100 workflows in parallel at any given time.
</Warning>
- **Massa**: Die geselekteerde rekord(s) sal na jou werksvloei gestuur word. Dit is gekonfigureer vir 'n gegewe voorwerp. Verskeie rekords kan gekies word voordat die werksvloei geaktiveer word. Die werksvloei sal een keer loop, en die hele lys van rekords as invoer gee. Dit beteken dat die werksvloei 'n Iterasie-aksie moet bevat. Dit is die beste vir mense wat die hoeveelheid werksvloeilope wil optimaliseer/beperk.
**Addisionele Konfigurasie**:
- Kies die teikenvoorwerp (vir Enkel en Massa beskikbaarheid)
- Kies 'n opdrag-ikoon vir die werksvloeisneller
- Konfigureer navigasiebalk plasing (Vasgespyker of Nie Vasgespyker)
**Toegang Metodes**:
- Cmd+K kieslys om handmatige werksvloei te vind en te begin
- Aangepaste knoppie in die boonste navigasiebalk (indien geconfigureer)
### Op 'n Skedule
Begin die werksvloei op 'n herhalende basis wat jy definieer.
**Konfigurasie**:
- Kies tydseenheid (minute, ure, dae)
- Voer 'n waarde in of gebruik pasgemaakte cron-strings vir gevorderde skedulering
### Webhaak
Begin die werksvloei wanneer 'n GET of POST versoek van 'n eksterne diens ontvang word.
**Konfigurasie**:
- Ontvang 'n unieke webhook URL
- Vir POST-vereistes, definieer die verwagte lyfstruktuur
- Konfigureer outhentisering indien nodig
## Werksvloei Aksies
Aksies definieer wat gebeur nadat 'n sneller geaktiveer is. Jy kan verskeie aksies saamketting.
### Skep 'n Rekord
Voeg 'n nuwe rekord by 'n gekose voorwerp by.
**Konfigurasie**:
- Kies die teikenvoorwerp
- Vul die vereiste en opsionele velde in
- Gebruik data van vorige stappe om velde in te vul
**Uitset**: Die nuutgeskepte rekorddata is beskikbaar vir gebruik in daaropvolgende stappe.
### Opdateer Rekord
Verander 'n bestaande rekord in 'n gekose voorwerp.
**Konfigurasie**:
- Kies die teikenvoorwerp
- Kies die spesifieke rekord om op te dateer
- Kies velde om aan te pas en voer nuwe waardes in
**Uitset**: Die opgedateerde rekorddata is beskikbaar vir gebruik in daaropvolgende stappe.
### Verwyder Rekord
Verwyder 'n rekord van 'n gekose voorwerp.
**Konfigurasie**:
- Kies die teikenvoorwerp
- Kies die spesifieke rekord om te verwyder
**Uitset**: Die verwyderde rekorddata bly beskikbaar vir gebruik in daaropvolgende stappe.
### Soek Rekords
Vind rekords binne 'n gekose voorwerp met behulp van filtertoestande.
**Konfigurasie**:
- Kies die voorwerp om te soek
- Stel filterkriteria op om resultate te beperk
- Konfigureer sortering en beperkings
**Uitset**: Gee gepaste rekords terug wat in daaropvolgende stappe gebruik kan word.
**Beste Praktyk**: Gebruik takke na Soek Rekords om "gevind" vs "nie gevind" scenario's te hanteer.
### Iterateur
Loop deur 'n reeks rekords wat van 'n vorige stap teruggestuur is, sodat jy aksies op elke rekord individueel kan uitvoer.
**Konfigurasie**:
- Kies die reeks rekords van 'n vorige stap (bv. resultate van Soek Rekords)
- Definieer die aksies om op elke rekord in die lus uit te voer
- Konfigureer die variabelenaam om elke rekord in die iterasie aan te dui
**Example**: Search Records returns 5 people, then use Iterator to send an email to each person or update each record individually.
**Nota**: Iterator is tans in beta. Activate it under Settings > Releases > Lab.
### Filtreer
Filtreer 'n reeks rekords gebaseer op spesifieke voorwaardes, wat slegs rekords toelaat wat aan die kriteria voldoen om deur te gaan.
**Konfigurasie**:
- Kies die reeks rekords om te filtreer
- Definieer filtervoorwaardes en kriteria
- Konfigureer watter rekords moet deurgaan na daaropvolgende stappe
**Uitset**: Gee slegs die rekords terug wat aan die gespesifiseerde filtervoorwaardes voldoen.
### Stuur e-pos
Stuur 'n e-pos vanaf jou werksvloei.
**Voorgeskrewe Stellings**: Voeg 'n e-posrekening in Instellings > Rekeninge by
**Konfigurasie**:
- Voer ontvanger se e-posadres in
- Stel onderwerpreël op
- Skryf die boodskapinhoud
- Verwys na veranderlikes van vorige stappe vir persoonlike aanpassings
**Nota**: E-pos-aanhegsels sal in K1 2026 beskikbaar wees.
### Kode
Runs custom JavaScript within your workflow.
**Konfigurasie**:
- Skryf JavaScript-kode in die redigeerder
- Toegang tot veranderlikes vanaf vorige stappe
- Gee veranderlikes terug vir gebruik in daaropvolgende stappe
- Toets kode direk in die stap
**Toegang**: Bestuur API-sleutels in Instellings → API & Webhooks
### Vorm
Vra 'n vorm tydens werksvloei-uitvoering om gebruiker se insette te versamel.
**Konfigurasie**:
- Definieer invoervelde met tipes, etikette, en voorbeelde
- Stel valideringsreëls op
- Set form title and description
**Uitset**: Vormresponse is beskikbaar vir gebruik in daaropvolgende stappe.
<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>
### HTTP Versoek
Stuur 'n versoek aan 'n eksterne API as deel van jou werksvloei.
**Konfigurasie**:
- Voer die API-eindpunt URL in
- Kies HTTP-metode (GET, POST, PUT, PATCH, DELETE)
- Voeg vereiste kopstukke en waardes by
- Sluit versoekinhoud in vir POST/PUT/PATCH versoeke
- Gee monsterantwoord vir struktuur voorskou
## Werksvloei Bestuur
### Werksvloei Skep
1. Klik "+ Voeg 'n Werksvloei By" om te begin
2. Klik "Ongenoemde" om jou werksvloei te benoem
3. Kies en konfigureer jou werksvloei sneller
4. Voeg aksies by jou werksvloei
5. Toets en verfyn
6. Aktiveer jou werksvloei (tans in konsepmodus) sodra jy klaar is met redigeer
**Note**: If you don't see the Workflows section, this is due to a permissions issue. Kontak jou werkspasie-administrateur om jou toegang tot werkvloeie te verskaf.
### Werksvloei Statusse
- **Draft**: Being edited, not yet published
- **Aktief**: Lewendige weergawe reageer op snellers
- **Deactivated**: Previously active but manually stopped
- **Gearchiveer**: Vorige weergawes wat vir geskiedenis gehou word
### Werksvloei Aktivering
Click **Activate** to publish your draft as a new version. This makes the workflow eligible to run when triggered but doesn't immediately execute it.
### Werkvloei Toetsing
Toets werksvloei voor aktivering met gebruik van:
- Handmatige snellers (wanneer geen rekord gekies is nie)
- Individuele aksietoetsing (veral Kode-aksies)
- Konsepmodus toetsing wat nie die werksvloei aktiveer nie
### Werksvloei Lopies
'n **Lopie** is 'n rekord van werksvloei-uitvoering wat insluit:
- Status (sukses, misluk, loop)
- Uitsetdata van elke stap
- Skrywer en tydstempels
- Foutboodskappe indien van toepassing
**Lopies Besigtig**:
- Kyk na die **Lopies** paneel in die werksvloei redigeerder
- Open **Werksvloei Lopies** siening vir monitering oor alle werksvloei
**Prestasiewenk**: Versteek werksvloei lopies vanaf die "Alle werksvloei" bladsy en ander werksvloeiblaaie om laaiprestasie te verbeter, aangesien groot getalle lopies bladsylaai kan vertraag.
### Weergeskiedenis
- Bekyk alle weergawes onder die **Weergawes** veld
- Klik op enige weergawe om besonderhede te sien
- Gebruik **Gebruik as konsep** om vorige weergawes te herstel
- Hanteer konsep konflikte met oorheers of terugkeer opsies
## Beste Praktyke
### Werksvloei Organisasie
- **Beskrywende Name**: Gebruik duidelike, spesifieke werksvloeiname
- **Stap Name**: Hernoem stappe om hul funksie te beskryf
- **Dokumentasie**: Voeg kommentaar in Kode-aksies by
- **Kategorisering**: Groepeer verwante werksvloei logies
- **Pasgemaakte Velde**: Voeg velde by die werksvloei-voorwerp in jou datamodel (soortgelyk aan ander voorwerpe) om werksvloei met pasgemaakte eienskappe te organiseer en te kategoriseer
### Prestasie Optimering
- **Minimum API-Oproepe**: Bondelaksies waar moontlik
- **Effektiewe Soektogte**: Gebruik spesifieke filterkriteria
- **Fout Hantering**: Beplan vir misluk scenario's
- **Rate Limiting**: Respect external API limits
### Data Vloei Bestuur
- **Tak Logika**: Gebruik takke na Soek Rekords
- **Veranderlike Gebruik**: Gebruik data van vorige stappe
- **Data Validasie**: Bevestig invoere in Kode-aksies
- **Field Mapping**: Plan data transformations carefully
### Monitering en Onderhoud
- **Regular Monitoring**: Check workflow runs for errors
- **Prestasie Oorsig**: Ontleed uitvoeringstye en sukseskoerse
- **Opdatering Bestuur**: Toets veranderinge in konsep voor aktivering
- **Span Koördinering**: Dokumenteer werksvloei vir spanlede
Vir praktiese voorbeelde van hierdie kenmerke in aksie, sien ons [Interne Outomasies](/l/af/user-guide/workflows/internal-automations) en [Eksterne Gereedskap Integrasie](/l/af/user-guide/workflows/external-tool-integration) gidse.