Vooraf
Je hebt een backend-extensie gebouwd zoals beschreven op Backend-extensie bouwen. Ze draait als Spring bean met een expliciete naam, bijvoorbeeld mijnappSubsidieService. Op deze pagina koppel je die bean aan een stap in een workflow.
De workflow engine van Skryv is Camunda 7. De aanroepvormen hieronder zijn standaard Camunda-mechanismen. De volledige uitleg vind je in de Camunda-documentatie over Delegation Code en Expression Language.
Stap 1: kies een aanroepvorm
Je kunt een extensie op twee manieren vanuit de BPMN aanspreken:
|
|
Expressie |
Delegate |
|---|---|---|
|
Attribuut in de BPMN |
|
|
|
Wat je aanroept |
Een willekeurige publieke methode van een bean, met argumenten |
Een bean die |
|
Gegevens doorgeven |
Via de argumenten van de methode |
De delegate leest zelf procesvariabelen |
|
Resultaat teruggeven |
Via |
De delegate zet zelf procesvariabelen |
|
Sterk punt |
Flexibel: één bean kan veel stappen bedienen |
De BPMN blijft eenvoudig: alleen een beannaam |
|
Aandachtspunt |
Methodenamen en argumenten staan in de BPMN, dus een hernoemde methode breekt de workflow |
Je hebt een klasse per stap |
Stap 2: roep de extensie aan
Met een expressie
Je roept de methode aan op de service task en geeft execution mee, zodat de methode weet over welk dossier het gaat:
<bpmn:serviceTask id="berekenBedrag" name="Bereken bedrag"
camunda:expression="${mijnappSubsidieService.berekenBedrag(execution)}"
camunda:resultVariable="bedrag" />
Wat de methode teruggeeft, komt in de procesvariabele bedrag terecht. Volgende stappen in de workflow kunnen die variabele gebruiken.
In de bean neem je execution aan als parameter:
public Double berekenBedrag(DelegateExecution execution) {
String dossierId = DelegateDataUtil.getDossierId(execution);
// jouw logica
}
Als delegate
Je verwijst op de service task alleen naar de beannaam:
<bpmn:serviceTask id="verstuurMelding" name="Verstuur melding"
camunda:delegateExpression="${mijnappMeldingDelegate}" />
De bean implementeert JavaDelegate. Camunda roept de methode execute aan wanneer de workflow de stap bereikt:
@Component("mijnappMeldingDelegate")
@RequiredArgsConstructor
public class MeldingDelegate implements JavaDelegate {
@Override
public void execute(DelegateExecution execution) {
String dossierId = DelegateDataUtil.getDossierId(execution);
// jouw logica
execution.setVariable("meldingVerstuurd", true);
}
}
Stap 3: roep de extensie aan vanuit een taak
Een extensie hoeft niet alleen op een service task te draaien. Je kunt ze ook laten uitvoeren wanneer er iets gebeurt met een gebruikerstaak, bijvoorbeeld wanneer een behandelaar de taak oppakt. Daarvoor gebruik je een task listener, met task als argument:
<bpmn:userTask id="controle" name="Controle">
<bpmn:extensionElements>
<camunda:taskListener event="assignment"
expression="${mijnappSubsidieService.registreerBehandelaar(task)}" />
</bpmn:extensionElements>
</bpmn:userTask>
De gangbare events zijn create, assignment en complete.
Wil je dezelfde methode zowel vanuit een service task als vanuit een task listener aanroepen? Laat ze dan een VariableScope aannemen in plaats van een DelegateExecution of DelegateTask. Zowel execution als task is een VariableScope, en hulpfuncties zoals DelegateDataUtil.getDossierId(...) werken met beide.
Stap 4: let op deze valkuilen
-
De beannaam is een contract met de BPMN. Hernoem je de bean of de methode in de code, dan vindt de workflow ze niet meer. Dat merk je niet bij het bouwen van de applicatie, maar pas wanneer een dossier die stap bereikt. Pas daarom altijd beide tegelijk aan.
-
Gebruik in expressies alleen rechte aanhalingstekens (
'en"). Typografische aanhalingstekens (‘ ’of“ ”) geven een fout bij het uitvoeren. Ze sluipen er vaak in wanneer je een expressie kopieert uit een tekstverwerker, een chatprogramma of een webpagina. -
Een execution listener en een
inputOutput-blok op dezelfde stap worden uitgevoerd in de volgorde waarin ze in de XML staan. Zet een listener die een variabele klaarzet, dus vóór het blok dat die variabele gebruikt.
Resultaat
Je extensie wordt uitgevoerd wanneer de workflow de stap bereikt. Ze ontvangt de gegevens van het dossier via execution of task, en geeft haar resultaat terug als procesvariabele.