9bc5486d0d
Created by Github action --------- Co-authored-by: github-actions <github-actions@twenty.com>
321 lines
12 KiB
Plaintext
321 lines
12 KiB
Plaintext
---
|
|
title: Werkstroom functies
|
|
info: Volledige referentie voor alle beschikbare werkstroomtriggers, acties en beheerfuncties.
|
|
image: /images/user-guide/workflows/robot.png
|
|
sectionInfo: Processen automatiseren en integreren met externe tools
|
|
---
|
|
|
|
<Frame>
|
|
<img src="/images/user-guide/workflows/robot.png" alt="Header" />
|
|
</Frame>
|
|
|
|
## Werkstroom Triggers
|
|
|
|
Werkstromen starten altijd met een enkele trigger die bepaalt wanneer de automatisering moet worden uitgevoerd.
|
|
|
|
### Record is Aangemaakt
|
|
|
|
Start de werkstroom wanneer een nieuw record wordt aangemaakt in een geselecteerd object (Mensen, Bedrijven, Kansen of elk aangepast object).
|
|
|
|
**Configuratie**: Selecteer het objecttype om te monitoren voor nieuwe records.
|
|
|
|
### Record is Bijgewerkt
|
|
|
|
Start de werkstroom wanneer er wijzigingen worden aangebracht aan een bestaand record.
|
|
|
|
**Configuratie**:
|
|
|
|
- Selecteer het objecttype
|
|
- Geef eventueel op welke velden voor wijzigingen moeten worden gemonitord
|
|
|
|
### Record is Bijgewerkt of Aangemaakt
|
|
|
|
Start de werkstroom wanneer een record wordt aangemaakt of bijgewerkt in een geselecteerd object.
|
|
|
|
**Waarom Dit Belangrijk Is**: Deze trigger is bijzonder nuttig omdat records die via verschillende methoden zijn aangemaakt, verschillend gedrag vertonen:
|
|
|
|
- **API/CSV-imports**: Records worden aangemaakt met alle velden onmiddellijk ingevuld
|
|
- **Handmatige aanmaak**: Records worden eerst aangemaakt, daarna worden velden in latere updates toegevoegd
|
|
|
|
**Configuratie**:
|
|
|
|
- Selecteer het objecttype om te monitoren
|
|
- Geef eventueel op welke velden voor wijzigingen moeten worden gemonitord
|
|
- De werkstroom wordt geactiveerd bij zowel de eerste aanmaak als latere updates
|
|
|
|
### Record is Verwijderd
|
|
|
|
Start de werkstroom wanneer een record uit een object wordt verwijderd.
|
|
|
|
**Configuratie**: Selecteer het objecttype om te monitoren voor verwijderingen.
|
|
|
|
### Handmatig Starten
|
|
|
|
Start de werkstroom wanneer deze door een gebruikersactie wordt geactiveerd. Deze trigger is toegankelijk via het Cmd+K menu of via een aangepaste knop in de bovenste navigatiebalk.
|
|
|
|
**Beschikbaarheidsconfiguratie**:
|
|
Kies hoe de werkstroom om moet gaan met de recordselectie:
|
|
|
|
- **Global**: No record is required to trigger this workflow. De werkstroom wordt overal geactiveerd (vanuit elk object) en gebruikt geen record(s) als invoer.
|
|
|
|
- **Single**: The selected record(s) will be passed to your workflow. Dit is geconfigureerd voor een gegeven object. Verschillende records kunnen worden geselecteerd voordat de werkstroom wordt geactiveerd. De werkstroom zal net zo vaak worden uitgevoerd als er records zijn geselecteerd.
|
|
|
|
<Warning>
|
|
You cannot run more than 100 workflows in parallel at any given time.
|
|
</Warning>
|
|
|
|
- **Bulk**: De geselecteerde records worden naar uw workflow doorgestuurd. Dit is geconfigureerd voor een gegeven object. Verschillende records kunnen worden geselecteerd voordat de werkstroom wordt geactiveerd. De workflow wordt één keer uitgevoerd en voert de complete lijst van records als input in. Dit betekent dat de workflow een Iterator-actie moet bevatten. Dit is het beste voor mensen die het aantal workflow-uitvoeringen willen optimaliseren/beperken.
|
|
|
|
**Aanvullende Configuratie**:
|
|
|
|
- Selecteer het doelobject (voor enkelvoudige en bulkbeschikbaarheid)
|
|
- Kies een commando-icoon voor de workflow-trigger
|
|
- Configureer navigatiebalk plaatsing (Vastgemaakt of Niet Vastgemaakt)
|
|
|
|
**Access Methods**:
|
|
|
|
- Cmd+K menu om handmatige workflows te vinden en te starten
|
|
- Aangepaste knop in de bovenste navigatiebalk (als geconfigureerd)
|
|
|
|
### On a Schedule
|
|
|
|
Start de workflow op een terugkerende basis die je definieert.
|
|
|
|
**Configuratie**:
|
|
|
|
- Selecteer tijdseenheid (minuten, uren, dagen)
|
|
- Voer een waarde in of gebruik aangepaste cron-expressies voor geavanceerde planning
|
|
|
|
### Webhook
|
|
|
|
Start de workflow wanneer een GET of POST-verzoek wordt ontvangen van een externe service.
|
|
|
|
**Configuratie**:
|
|
|
|
- Receive a unique webhook URL
|
|
- Definieer de verwachte structuur van het berichtlichaam voor POST-verzoeken
|
|
- Configureer authenticatie indien nodig
|
|
|
|
## Workflow Actions
|
|
|
|
Acties bepalen wat er gebeurt nadat een trigger wordt geactiveerd. U kunt meerdere acties aan elkaar koppelen.
|
|
|
|
### Creëer een record
|
|
|
|
Voegt een nieuw record toe aan een geselecteerd object.
|
|
|
|
**Configuratie**:
|
|
|
|
- Selecteer het doelobject
|
|
- Vul de vereiste en optionele velden in
|
|
- Gebruik gegevens van eerdere stappen om velden in te vullen
|
|
|
|
**Uitvoer**: De nieuw aangemaakte recordgegevens zijn beschikbaar voor gebruik in volgende stappen.
|
|
|
|
### Record bijwerken
|
|
|
|
Wijzigt een bestaand record in een geselecteerd object.
|
|
|
|
**Configuratie**:
|
|
|
|
- Selecteer het doelobject
|
|
- Kies het specifieke record om bij te werken
|
|
- Selecteer velden om te wijzigen en voer nieuwe waarden in
|
|
|
|
**Uitvoer**: De bijgewerkte recordgegevens zijn beschikbaar voor gebruik in volgende stappen.
|
|
|
|
### Record verwijderen
|
|
|
|
Verwijdert een record uit een geselecteerd object.
|
|
|
|
**Configuratie**:
|
|
|
|
- Selecteer het doelobject
|
|
- Kies het specifieke record om te verwijderen
|
|
|
|
**Uitvoer**: De verwijderde recordgegevens blijven beschikbaar voor gebruik in volgende stappen.
|
|
|
|
### Records zoeken
|
|
|
|
Zoekt records in een geselecteerd object met behulp van filtervoorwaarden.
|
|
|
|
**Configuratie**:
|
|
|
|
- Selecteer het object om te doorzoeken
|
|
- Stel filtercriteria in om resultaten te verfijnen
|
|
- Configureer sortering en limieten
|
|
|
|
**Uitvoer**: Geeft overeenkomende records terug die in volgende stappen kunnen worden gebruikt.
|
|
|
|
**Goede Praktijk**: Gebruik takken na Zoeken naar Records om "gevonden" vs "niet-gevonden" scenario's te verwerken.
|
|
|
|
### Iterator
|
|
|
|
Doorloopt een reeks records teruggegeven uit een vorige stap, zodat u acties op elk record individueel kunt uitvoeren.
|
|
|
|
**Configuratie**:
|
|
|
|
- Selecteer de reeks records uit een vorige stap (bijv. resultaten van Zoeken naar Records)
|
|
- Definieer de acties die op elk record in de lus moeten worden uitgevoerd
|
|
- Configureer de variabelenaam om naar elk record in de iteratie te verwijzen
|
|
|
|
**Voorbeeld**: Zoeken naar Records geeft 5 mensen terug, gebruik dan Iterator om een e-mail naar elke persoon te sturen of elk record individueel bij te werken.
|
|
|
|
**Opmerking**: Iterator is momenteel in bèta. Activeer het onder Instellingen > Releases > Laboratorium.
|
|
|
|
### Filteren
|
|
|
|
Filtert een reeks records op basis van specifieke voorwaarden, waarbij alleen records worden doorgegeven die aan de criteria voldoen.
|
|
|
|
**Configuratie**:
|
|
|
|
- Selecteer de reeks records om te filteren
|
|
- Definieer filtervoorwaarden en criteria
|
|
- Configureer welke records moeten worden doorgelaten naar volgende stappen
|
|
|
|
**Uitvoer**: Alleen de records die voldoen aan de gespecificeerde filtervoorwaarden worden teruggegeven.
|
|
|
|
### E-mail verzenden
|
|
|
|
Verzendt een e-mail vanuit uw workflow.
|
|
|
|
**Voorwaarden**: Voeg een e-mailaccount toe in Instellingen > Accounts
|
|
|
|
**Configuratie**:
|
|
|
|
- Voer een e-mailadres van de ontvanger in
|
|
- Stel de onderwerpregel in
|
|
- Stel de berichteninhoud samen
|
|
- Verwijs naar variabelen van vorige stappen voor personalisatie
|
|
|
|
**Opmerking**: E-mailbijlagen zijn beschikbaar in Q1 2026.
|
|
|
|
### Code
|
|
|
|
Voert aangepaste JavaScript uit binnen uw workflow.
|
|
|
|
**Configuratie**:
|
|
|
|
- Schrijf JavaScript-code in de editor
|
|
- Toegang tot variabelen van eerdere stappen
|
|
- Geef variabelen terug voor gebruik in volgende stappen
|
|
- Test de code direct in de stap
|
|
|
|
**Toegang**: Beheer API-sleutels in Instellingen → API & Webhooks
|
|
|
|
### Formulier
|
|
|
|
Geeft een formulier weer tijdens de uitvoering van de workflow om gebruikersinvoer te verzamelen.
|
|
|
|
**Configuratie**:
|
|
|
|
- Definieer invoervelden met types, labels en placeholders
|
|
- Configureer validatieregels
|
|
- Stel formulier titel en beschrijving in
|
|
|
|
**Uitvoer**: Formulier reacties zijn beschikbaar voor gebruik in latere stappen.
|
|
|
|
<Warning>
|
|
Formulieren zijn momenteel alleen ontworpen voor handmatige triggers. Voor workflows met andere triggers (Record Aangemaakt, Bijgewerkt, etc.), zijn formulieren alleen toegankelijk via de workflow-uitvoeringsinterface, wat niet de verwachte gebruikerservaring is. Er zal in 2026 een meldingscentrum worden uitgebracht om formulieren in geautomatiseerde workflows goed te ondersteunen.
|
|
</Warning>
|
|
|
|
### HTTP-aanvraag
|
|
|
|
Verzendt een verzoek naar een externe API als onderdeel van uw workflow.
|
|
|
|
**Configuratie**:
|
|
|
|
- Voer het API-eindpunt-URL in
|
|
- Selecteer HTTP-methode (GET, POST, PUT, PATCH, DELETE)
|
|
- Voeg vereiste headers en waarden toe
|
|
- Voeg verzoeklichaam toe voor POST/PUT/PATCH-verzoeken
|
|
- Geef voorbeeldantwoord voor structuurweergave
|
|
|
|
## Workflowbeheer
|
|
|
|
### Workflows maken
|
|
|
|
1. Klik op "+ Een workflow toevoegen" om te beginnen
|
|
2. Click "Untitled" to name your workflow
|
|
3. Kies en configureer uw workflow-trigger
|
|
4. Voeg acties toe aan uw workflow
|
|
5. Test en herhaal
|
|
6. Activeer uw workflow (momenteel in conceptmodus) zodra u klaar bent met bewerken.
|
|
|
|
**Opmerking**: Als u de Workflows-sectie niet ziet, is dit te wijten aan een toestemmingskwestie. Neem contact op met uw workspacebeheerder om u toegang te geven tot workflows.
|
|
|
|
### Workflow Statuses
|
|
|
|
- **Concept**: Wordt bewerkt, nog niet gepubliceerd
|
|
- **Active**: Live version responding to triggers
|
|
- **Deactivated**: Previously active but manually stopped
|
|
- **Archived**: Past versions kept for history
|
|
|
|
### Workflows activeren
|
|
|
|
Klik op **Activeren** om uw concept als een nieuwe versie te publiceren. Dit maakt de workflow in aanmerking komende om te draaien wanneer deze wordt geactiveerd, maar voert deze niet onmiddellijk uit.
|
|
|
|
### Workflows testen
|
|
|
|
Test workflows voordat u activeert met behulp van:
|
|
|
|
- Handmatige triggers (wanneer er geen record is geselecteerd)
|
|
- Individuele actie testen (vooral Code-acties)
|
|
- Concept-modus testen dat de workflow niet activeert
|
|
|
|
### Workflow Runs
|
|
|
|
Een **Run** is een record van workflow uitvoering welke bevat:
|
|
|
|
- Status (succes, mislukt, wordt uitgevoerd)
|
|
- Output data from each step
|
|
- Auteur en tijdstempels
|
|
- Foutmeldingen indien van toepassing
|
|
|
|
**Bekijken van Runs**:
|
|
|
|
- Controleer het **Runs**-paneel in de workfloweditor
|
|
- Open **Workflow Runs** weergave voor monitoring over alle workflows
|
|
|
|
**Prestatie Tip**: Verberg workstroom uitvoeringen van de "Alle workflows" pagina en andere workflow pagina's om de laadtijd van de pagina te verbeteren, aangezien grote aantallen uitvoeringen de laadtijd kunnen vertragen.
|
|
|
|
### Versiegeschiedenis
|
|
|
|
- Bekijk alle versies onder het veld **Versies**
|
|
- Klik op een versie om details te bekijken
|
|
- Gebruik **Gebruik als concept** om eerdere versies te herstellen
|
|
- Los conceptconflicten op met overschrijd- of terugkeeropties
|
|
|
|
## Beste praktijken
|
|
|
|
### Workfloworganisatie
|
|
|
|
- **Beschrijvende Namen**: Gebruik duidelijke, specifieke workflow namen
|
|
- **Stapnaamgeving**: Geef stappen namen om hun functie te beschrijven
|
|
- **Documentatie**: Voeg notities toe in Code-acties
|
|
- **Categorisatie**: Groepeer gerelateerde workflows logisch
|
|
- **Aangepaste Velden**: Voeg velden toe aan het Workflow-object in uw datamodel (vergelijkbaar met andere objecten) om workflows te organiseren en categoriseren met aangepaste eigenschappen
|
|
|
|
### Prestatieoptimalisatie
|
|
|
|
- **Minimaliseer API-verzoeken**: Groepeer operaties waar mogelijk
|
|
- **Efficiënte Zoekacties**: Gebruik specifieke filtercriteria
|
|
- **Foutenbeheer**: Plan voor faalscenario's
|
|
- **Tarieflimieten**: Respecteer limieten van externe API's
|
|
|
|
### Gegevensstroombeheer
|
|
|
|
- **Branch Logic**: Use branches after Search Records
|
|
- **Variabel gebruik**: Benut gegevens van eerdere stappen
|
|
- **Gegevensvalidatie**: Valideer invoer in Code-acties
|
|
- **Veldmapping**: Plan gegevensoverdrachten zorgvuldig
|
|
|
|
### Monitoring en onderhoud
|
|
|
|
- **Regelmatige monitoring**: Controleer workflow-uitvoeringen op fouten
|
|
- **Prestaties Review**: Analyseer uitvoeringstijden en successpercentages
|
|
- **Updatebeheer**: Test wijzigingen in concept voor activering
|
|
- **Teamcoördinatie**: Documenteer workflows voor teamleden
|
|
|
|
Voor praktische voorbeelden van deze functies in actie, zie onze [Interne Automatiseringen](/l/nl/user-guide/workflows/internal-automations) en [Externe Tool Integratie](/l/nl/user-guide/workflows/external-tool-integration) handleidingen.
|