Run Apex actions
Draai bij verzenden een goedgekeurde Apex-klasse, met getypeerde inputs en outputs zoals bij een flow.
Run Apex is een type submission action dat een Apex-klasse draait die je beheerder heeft goedgekeurd, met inputs en outputs die je precies zo mapt als de variabelen van een flow.
Gebruik het als het werk makkelijker in code is uit te drukken dan in een flow: een berekening, een callout, een opzoeking met regels die een flow onhandig zouden maken.
Er een toevoegen
- Voeg in Submission Actions een stap toe, dan Add action, en kies Run Apex.
- Kies de Apex handler. De kiezer toont alleen de handlers die voor dit formulier zijn goedgekeurd, onder de naam die je beheerder ze gaf.
- Inputs en Outputs verschijnen als getypeerde rijen, opgebouwd uit het contract dat de klasse declareert.
- Map elke input vanuit een formulierveld, een constante, het resultaat van een eerdere action of een inzendingsveld, dezelfde bronnen als bij elke andere action. Zie Submission actions.
- Leg een output vast onder een Reference name als een latere action hem nodig heeft.
De rest gedraagt zich als elke andere action: condities, volgorde, reference names, en de terugdraaiing van de stap via All or nothing.
Er is geen vrij tekstveld
Je kunt geen klassenaam typen. Keuren de purposes van het formulier geen handlers goed, dan toont de action een melding die dat uitlegt en naar Purpose Manager verwijst, en valt er niets in te vullen.
Dat is bewust: een niet-goedgekeurde klasse mag niet uit te drukken zijn, niet alleen geblokkeerd bij uitvoering. Save weigert ook een formulier waarvan een action een klasse noemt die zijn purposes niet goedkeuren, met vermelding van die klasse.
Als het contract verandert
De inputs en outputs die je mapt, zijn die van het moment waarop de beheerder de klasse goedkeurde. Wijzigt een ontwikkelaar de signatuur, vraag je beheerder dan de klasse opnieuw goed te keuren zodat het contract wordt ververst, en controleer daarna je mappings. Zie Apex handlers goedkeuren.
Wat je er achteraf van ziet
Op de inzending toont Submit Action Result de action als Completed met de outputs die de handler teruggaf, of als Error met de melding van de handler zelf. Zie Inzendingen.
Verwant: on-demand flows
Een Invoke flow action die naar een on-demand flow wijst, gebruikt onderhuids dezelfde machinerie: hij draait via een Apex-klasse die een beheerder heeft geregistreerd. Jij configureert daar niets voor, de routering gaat vanzelf. Zie Apex Handler Settings.
