Op deze pagina
> bronnen > documentatie > expressies > Expression Editor

Expression Editor

Expression Editor

De Expression Editor is de ingebouwde tool van ProcessMind voor het schrijven van expressies. Je opent hem overal waar expressies worden gebruikt, zoals bij datasetattributen, datasetfilters en metriekdefinities. De werkwijze is steeds hetzelfde: schrijf, valideer en bekijk een voorbeeld voordat je opslaat.

Expression Editor in ProcessMind

Waar kun je de editor openen?

Geopend vanuit Wat je bewerkt
Dataset → Attributen → Datamapping / expressie-cel een berekend attribuut
Dataset → Algemeen → Globaal datasetfilter → Filterexpressie toevoegen… een rijfilter dat vóór mining wordt toegepast
Grafiekinstellingen → Metriekexpressie → Metriekexpressie gebruiken… een metriekexpressie die per rij wordt geëvalueerd
Grafiekinstellingen → Secundaire metrieken → Expressie… een expressie voor een secundaire metriek
Grafiekinstellingen → Tekst / Html-chip grafiektekst: letterlijke tekst en HTML met ${ ... }expressies
Grafiekinstellingen → Norminstellingen → ƒ → Starten / Stoppen-expressie een normgrens die wordt bepaald aan de hand van constanten uit Procesinstellingen

De titel van het dialoogvenster laat zien wat je bewerkt, bijvoorbeeld Edit Expression: {attribute name} of Rijfilterexpressie.

Een expressie schrijven

  • De invoer markeert de syntax terwijl je typt: functies, attributen, constanten, case-eigenschappen en rijverwijzingen krijgen elk hun eigen kleur. Parsefouten worden rood onderstreept.
  • Druk op Ctrl/Cmd+Space om aanvullingen te openen. Ze verschijnen niet automatisch. Enter of Tabblad past het geselecteerde item toe; Esc sluit de lijst.
  • Beweeg de muis over een token voor documentatie: functies tonen hun signature, beschrijving en een voorbeeld; attributen tonen hun type.
  • In een functieaanroep toont signature help de parameter die je invult.
  • Ongedaan maken en Opnieuw staan als knoppen in de kop. Je kunt ook Ctrl/Cmd+Z, Shift+Ctrl/Cmd+Z en Ctrl/Cmd+Y gebruiken.

Het referentiepaneel

In het paneel Elementen selecteren om je expressie op te bouwen staat alles wat je kunt gebruiken, ingedeeld in secties:

  • Attributen: attributen van de dataset. Klik op een attribuut om het in te voegen.
  • Constanten: constanten voor het hele proces die zijn gedefinieerd in Procesinstellingen.
  • Functies: ingedeeld per categorie. Elke functie heeft een tooltip met de signature, beschrijving en een voorbeeld. Als je klikt, wordt de functienaam met haakjes ingevoegd.
  • Case-eigenschappen en rijverwijzingen: klik op een rijverwijzing om previous. in te voegen en een vergelijking met de vorige rij op te bouwen.

Het zoekvak doorzoekt namen, signatures, beschrijvingen en voorbeelden. Het begrijpt ook je bedoeling: als je “dagen tussen” of “som met voorwaarde” typt, verschijnen de bijbehorende functies. Met het helpicoon in de kop open je de documentatie over de expressietaal.

Voorbeeld

Voor attributen en metrieken toont de editor een live voorbeeld van Meest voorkomende waarden dat tijdens het typen wordt bijgewerkt: de meest voorkomende resultaten met hun aantallen, plus de buckets null en other, met maximaal 20 waarden. Tijdens het laden van het voorbeeld zie je Voorbeeld van expressie wordt uitgevoerd…. Bij fouten verschijnt Corrigeer de expressie om een voorbeeld te zien. Rijfilters ondersteunen geen voorbeeld. De editor geeft dat in plaats daarvan aan.

Templates voor grafiektekst

Grafiektekst, zoals Tekst-grafieken, KPI’s, meters en HTML-frames, is een template: letterlijke tekst blijft staan zoals die is geschreven en elk ${ ... }-segment wordt geëvalueerd. De editor valideert elk segment en markeert het terwijl je typt. Tekst, Html, metriekexpressies en normexpressies worden pas toegepast wanneer je de editor sluit met Opslaan. Met Annuleren verwerp je het concept. Gewone grafiektekst en HTML kunnen niet per rij worden geëvalueerd. Daarom toont de editor Voorbeeld niet beschikbaar voor grafiektekst in plaats van het waardevoorbeeld.

Normexpressies worden bepaald aan de hand van constanten uit Procesinstellingen, bijvoorbeeld slaTargetDays * 86400000. Daarom biedt de editor daar constanten en functies aan, maar geen datasetattributen.

Valideren en opslaan

Tijdens het bewerken vindt voortdurend validatie plaats. De statusregel onderaan het dialoogvenster toont een groen vinkje met Expressie is geldig of een rode foutmelding, zoals Fout op positie 12: ‘)’ verwacht, maar … gevonden. Veelvoorkomende fouten zijn onbekende functies of variabelen, een verkeerd aantal argumenten, niet-afgesloten tekenreeksen en typeverschillen.

Opslaan blijft uitgeschakeld zolang de expressie ongeldig is of er beperkingen voor rijfilters gelden. Als je het veld leegmaakt en opslaat, wordt de expressie verwijderd. Druk op Ctrl/Cmd+Enter om via het toetsenbord op te slaan, of op Annuleren om te sluiten zonder op te slaan.

Gerelateerde expressies openen in tabbladen

Expressies kunnen verwijzen naar andere berekende attributen. Als je er tijdens het bewerken een wilt bekijken, houd je Ctrl/Cmd ingedrukt en klik je op de attribuutverwijzing in je expressie. Het attribuut wordt geopend in een eigen tabblad, alleen-lezen. De tabbladbalk verschijnt zodra er een tweede tabblad is en het voorbeeld volgt het tabblad dat je bekijkt.

Rijfilters: toegestaan en geblokkeerd

Een rijfilter wordt toegepast op elke onbewerkte eventrij wanneer de data wordt geladen, vóór process mining. Alleen rijen waarvoor de expressie waar is, blijven behouden. Onware, lege en null-resultaten worden verwijderd. Daardoor kun je niet alles gebruiken:

  • Toegestaan: de eigen waarden van de rij, dus de attributen van de dataset plus de ingebouwde kolomaliassen (caseid, time, activity, cost, user, start_time en co2).
  • Geblokkeerd: alles waarvoor context op case- of rijniveau nodig is, zoals case-eigenschappen, case-aggregaties en windowfuncties, rijverwijzingen (previous.), activity-lookups zoals first() en followedBy-expressies.

Als je een geblokkeerd element gebruikt, is Opslaan uitgeschakeld en verschijnt de melding: “Rijfilters kunnen alleen onbewerkte rijdata gebruiken. Verwijder case-eigenschappen, case-aggregaties, rijverwijzingen, activity-lookups of followed-by-expressies.”

Gerelateerde onderwerpen