Apex handlers goedkeuren
Laat een purpose Apex-klassen goedkeuren die een formulier bij verzenden mag draaien, net als flows.
Voor Salesforce-beheerders.
Naast de flows heeft elke purpose een onderdeel Apex actions: de Apex-klassen die een formulier met die purpose mag draaien vanuit een submission action.
Zo breid je Flux Forms uit met logica die makkelijker in code te schrijven is dan in een flow. Het is ook wat on-demand flows überhaupt bereikbaar maakt.
Er een toevoegen
- Open de purpose in Purpose Manager en klik op Add Apex handler.
- Het dialoogvenster toont de klassen in je org die de Flux Forms handler-interface implementeren. Je
typt nooit een klassenaam. Is de lijst leeg, dan noemt hij de interface die een ontwikkelaar moet
implementeren:
fluxforms.SubmitActionApexHandler. - Kies er een. Het venster toont de inputs en outputs die de klasse declareert, met hun types.
- Geef een Display name, dat is wat marketeers straks kiezen, en klik op Save.
De handler verschijnt in de tabel Apex actions, met het aantal inputs en outputs.
Onderhoud
- Dezelfde klasse nog eens toevoegen werkt de bestaande rij bij, er komt geen dubbele rij. Zo ververs je het contract: veranderen de inputs of outputs van een klasse, voeg hem dan opnieuw toe.
- De rij-actie verwijdert een handler. Hij wordt meteen niet meer aangeboden in de builder.
Een verouderd contract gedraagt zich als een verouderd flowcontract. De builder mapt inputs en outputs op de namen die zijn vastgelegd toen je de klasse goedkeurde. Een klasse waarvan de signatuur is gewijzigd en die nooit opnieuw is toegevoegd, is een veelvoorkomende oorzaak van een mislukte submit action.
Waarom goedkeuring nodig is
Apex draaien is minstens zo krachtig als een flow starten, dus het loopt via dezelfde whitelist. Een klasse die niet is goedgekeurd op een van de purposes van het formulier kan niet worden opgeslagen in een formulier en kan niet draaien. De builder biedt geen vrij tekstveld, en Save weigert een configuratie die een niet-goedgekeurde klasse noemt, ook als die met de hand is ingevoerd.
Een klasse goedkeuren vraagt configuratiebeheer-toegang, dezelfde lat als er een schrijven.
Wat de marketeer ziet
Zodra een handler is goedgekeurd en de purpose aan een formulier is toegewezen, biedt de action Run Apex hem aan, met zijn gedeclareerde inputs en outputs precies zoals bij de variabelen van een flow. Zie Run Apex actions.
Keuren de purposes van een formulier geen handlers goed, dan legt het actietype dat uit en verwijst het naar Purpose Manager.
Vertel je ontwikkelaar dit ene ding
De klasse en zijn methodes moeten global zijn. De klasse, beide interfacemethodes, en een expliciete
global constructor zonder argumenten.
Een public klasse compileert prima en verschijnt vervolgens nooit in de kiezer, zonder dat iets op
het scherm uitlegt waarom. Het is de meest gemaakte inrichtingsfout, en een lege kiezer is het symptoom.
