Algemene eigenschappen Orchestra blokken

De naam (ook wel label) is de zichtbare titel van het blok in het procesdiagram. Dit is meestal het eerste wat iemand leest bij het bekijken of bespreken van een proces.

Waarvoor is de naam bedoeld?

• Om in één oogopslag te begrijpen wat dit blok doet
• Om het proces leesbaar en logisch te maken
• Als referentiepunt in gesprekken, reviews en overdracht

Richtlijnen voor goede namen

• Beschrijf de actie of stap, niet de techniek
• Gebruik een actieve formulering
• Houd het kort, maar betekenisvol

Goede voorbeelden

• Aanvraag beoordelen
• Klantgegevens controleren
• E-mail bevestiging versturen

Minder goede voorbeelden

• Stap 3
• Check
• Handmatige taak
• API call

Veelgemaakte fouten

• Hetzelfde label gebruiken voor meerdere blokken
• Te generieke namen waardoor je in het diagram niet meer ziet wat er gebeurt
• Namen die alleen voor de maker logisch zijn

Het type geeft aan wat voor soort blok dit is, bijvoorbeeld een handmatige taak, een e-mailstap of een gateway.

Belangrijk om te weten

• Het type wordt bepaald door het gekozen blok in de editor
• Het type is niet aanpasbaar via het properties panel
• Het type beïnvloedt:
  • welke opties beschikbaar zijn
  • hoe het blok zich gedraagt tijdens uitvoering

Waarom staat dit hier?

Het type helpt je bij:

• controle of je het juiste blok hebt gekozen
• het herkennen van verschillen tussen blokken met een vergelijkbare naam

Deze pagina beschrijft niet de werking per type. Volg daarvoor onderstaande knop.

Het documentatieveld is bedoeld om extra uitleg vast te leggen over deze specifieke stap in het proces.

Waarvoor is documentatie bedoeld?

• Toelichting op waarom deze stap bestaat
• Afspraken of context die niet uit het diagram zelf blijkt
• Uitleg voor collega’s die het proces later aanpassen of beoordelen

Documentatie is aanbevolen, maar niet verplicht. Juist bij minder voor de hand liggende stappen is dit veld vaak van grote waarde.

Wat zet je hier wel in?

• Beslisregels in woorden
• Uitleg over uitzonderingen
• Verwachtingen bij handmatige taken

Voorbeeld

Deze stap wordt uitgevoerd door Finance.
Alhoewel er een koppeling is met het boehoudpakket gebeurd dit niet automatisch omdat een groot deel van de cijfers nog per post binnenkomt.

Wat zet je hier niet in?

• Technische details
• Processtappen die al duidelijk in het diagram staan
• Tijdelijke notities

Veelgemaakte fouten

• Documentatie helemaal leeg laten bij complexe stappen
• Documentatie gebruiken als vervanging van een duidelijke naam
• Te vage teksten zoals “zie proces” of “standaard controle”