Flows whitelisten
Welke flows een formulier bij verzenden mag starten, inclusief on-demand en package-flows.
Voor Salesforce-beheerders.
Elke purpose heeft een onderdeel Flows met de flows die een formulier met die purpose mag starten vanuit een submission action.
Er een toevoegen
- Klik op Add Flow. De kiezer opent op een lijst met actieve autolaunched flows. Typ in Search flows om op label of API-naam te matchen, en kies er een. Orgs kunnen veel meer flows bevatten dan één lijst kan tonen, dus de kiezer geeft een pagina per keer, staat er "More flows match than are shown", typ dan verder om te beperken.
- De tool leest automatisch de input- en outputvariabelen van de flow en toont ze ter controle.
- Klik op Whitelist Flow om op te slaan. Het variabelencontract wordt met de flow vastgelegd, en dat is wat de formulierbouwer in staat stelt inputs en outputs op naam te mappen.
Onderhoud
- Refresh leest de variabelen van een flow opnieuw en het triggertype, in één keer. Gebruik het nadat de flow is gewijzigd, een verouderd variabelencontract is een veelvoorkomende oorzaak van een mislukte submit action.
- Het prullenbakicoon haalt de flow van de whitelist.
Welke flows gewhitelist kunnen worden
Alleen autolaunched flows, dus flows zonder trigger. Record-triggered, geplande en platform-event flows zijn verborgen in de kiezer, omdat ze een triggercontext verwachten en de submit-engine ze helemaal niet kan starten.
Whitelist altijd uit deze lijst in plaats van een naam met de hand te typen, zodat de whitelist en de action Invoke flow van het formulier naar dezelfde naam verwijzen.
On-demand flows
Een flow die is aangemaakt met de start "no trigger, invoked on demand" kan niet rechtstreeks door Flux Forms worden gestart, Salesforce staat dat niet toe. Flux Forms herkent deze automatisch en draait ze via een Apex-klasse in je eigen org.
Whitelist er een precies zoals elke andere flow. De routering gaat vanzelf, hier hoef je niets anders te doen.
Wat wel nodig is, is een eenmalige inrichting: een Apex handler geregistreerd in Apex Handler Settings, en Flow Access voor de Automated Process-gebruiker op die flow. Zolang dat niet is gebeurd:
- meldt de kiezer dat zodra je een on-demand flow selecteert, je kunt hem nog steeds whitelisten;
- markeert de flowlijst die rijen met Needs Apex handler, zodat een lange whitelist precies laat zien welke regels nog niet kunnen draaien;
- verdwijnt de markering vanzelf zodra er een handler is geregistreerd;
- mislukt de action bij verzenden met een melding die het Setup-scherm noemt.
De Form Builder zwijgt hier bewust over. Het is een inrichtingsklus, en alleen een configuratiebeheerder kan het zien of oplossen. Een waarschuwing gericht aan een marketeer zou ruis zijn.
De twee inputs die je niet hebt gedeclareerd
On-demand flows krijgen ook twee inputs van Salesforce zelf, emailAddress en individualId, die
de flow niet bij zijn eigen variabelen vermeldt. Flux Forms voegt ze automatisch toe aan het vastgelegde
contract, dus ze verschijnen in de controlestap met een notitie over hun herkomst, en ze kunnen vanuit
formulierwaarden worden gemapt in de action Invoke flow.
Definieert de flow toevallig zelf een variabele met een van die namen, dan blijft die definitie staan zoals hij is. Hoe dan ook niets in te stellen.
Flows uit geïnstalleerde packages
Die werken ook. De kiezer toont ze met hun packageprefix (acme__Send_Welcome), en Flux Forms bewaart
die prefix bij de flow zodat de juiste wordt gestart. Kies hem gewoon uit de lijst.
Bij een flow die vóór versie 0.8.0 is gewhitelist, is geen prefix vastgelegd, dus behandelt Flux Forms hem als een flow in je eigen org. Voor je eigen flows klopt dat en hoef je niets. Voor een flow uit een geïnstalleerd package: haal hem weg en voeg hem opnieuw toe uit de kiezer, zodat de prefix wordt vastgelegd.
Wat de marketeer ziet
Zodra een flow is gewhitelist en de purpose aan een formulier is toegewezen, biedt de action Invoke flow die flow in een dropdown, met zijn eigen variabelen in de pickers voor inputs en outputs.
Is er geen flow voor een formulier gewhitelist, dan zijn het flowveld en de pickers helemaal verborgen, met een melding om eerst een flow te whitelisten. Save weigert ook een formulier dat een flow start die zijn purposes niet toestaan.
Apex, niet alleen flows
Een purpose kan op dezelfde manier Apex-klassen goedkeuren. Zie Apex handlers goedkeuren.
