Instellingen
- Field. Het Select field-vak. Typ om te zoeken: “2: Answer” vindt “Question 2: Answer”. De lijst bevat de velden van het event en de outputs van eerdere stappen.
- Operator. Het Select-vak naast het veld. Uitgeschakeld tot er een veld is gekozen. De aangeboden operators hangen af van het type van het veld, hieronder opgesomd.
- Value. Een vak dat verschijnt voor operators die met iets vergelijken. is empty en is not empty hebben er geen.
- Add Filter. Voegt een rij toe aan dezelfde set.
- Add New Set. Begint een nieuwe set onder de eerste.
- AND / OR. Een toggle die tussen twee rijen verschijnt, en nog een die tussen twee sets verschijnt. Standaard AND. Binnen een set bepaalt deze of elke rij of een willekeurige rij moet slagen. Tussen sets bepaalt deze of elke set of een willekeurige set moet slagen.
- Unique Constraints. Op het tabblad Advanced. Kies velden, en het Filter slaagt slechts één keer voor elke combinatie van hun waarden. Met een identifier en een statusveld geselecteerd, slaagt een record voor een gegeven status één keer, hoeveel events het ook produceert met die status.
Operators
Velden die een bereik of een set waarden bevatten bieden ook between, one of en not one of.
Op het canvas
De kaart toont een Filter-badge, het setnummer, en elke rij als veld, operator, waarde.
Wat het oplevert
Niets nieuws. De variabelen die na een Filter beschikbaar zijn, zijn dezelfde als ervoor. Op de runpagina draagt een geslaagd Filter de regel “Completed” met de tijd. De timeline registreert “Filter: Run Moved”, daarna “Filter: Completed” met elke set gemarkeerd als Valid en de waarde die het verwachtte tegenover de waarde die het vond.
Wat de run stopt
Condities die niet slagen. De timeline registreert “Filter: Cancelled” met het bericht “Filter not passed.” gevolgd door “Filter: Run Cancelled”. Stappen na het Filter tonen geen statusregel, en in de runs-lijst toont de Step-kolom van de run “Filter”.
Patronen
- Bewaak de start. Een Filter als eerste stap stopt runs die de start zelf niet kan uitsluiten, zoals een reactie met een leeg antwoord op de vraag die ertoe doet.
- Controleer opnieuw na een wachttijd. Een Delay en dan een Filter bevestigt dat het record nog steeds kwalificeert zodra het wachten voorbij is. Een kandidaat die intussen is geplaatst krijgt de follow-up nooit.
- Eén keer per status. Een unique constraint op het id van het record en het statusveld ervan laat een statuswijziging één keer door, ook wanneer de app dezelfde update meer dan eens verstuurt.
- Kies Split voor twee uitkomsten. Een Filter beëindigt de run bij een nee. Wanneer zowel ja als nee stappen nodig hebben, gebruik dan een Split met een Filter-branch voor elk.
Veelgemaakte fouten
- Een rij opslaan zonder operator. De drawer slaat hem op en het canvas toont de ruwe key
enums.conditions.undefinedop de plek van de operator. Open het Filter opnieuw en kies er een. - Alleen op nummer zoeken. “Question 2” matcht ook “Question 12”. Typ ook een deel van de titel van de vraag.
- Een overgeslagen stap verwachten. Een Filter dat niet slaagt annuleert de run, het springt niet naar de volgende stap.
- AND en OR mengen zonder sets. Rijen in één set delen één toggle. Om “A en B” te combineren met “C”, zet je A en B in één set, C in een andere, en zet je de toggle tussen de sets op OR.
Gerelateerd
- Split draait een Filter per branch in plaats van de run te stoppen.
- Setup bevat het startfilter, dat bepaalt of een run überhaupt begint.
- Redenen voor run-annuleringen legt uit waar je het bericht leest dat een gestopte run achterlaat.