In questa pagina
> risorse > documentazione > espressioni > Expression Editor

Expression Editor

Expression Editor

L’Expression Editor è lo strumento integrato di ProcessMind per scrivere le espressioni. Si apre ovunque vengano utilizzate, negli attributi del dataset, nei filtri del dataset e nelle definizioni delle metriche, e funziona sempre allo stesso modo: scriva, convalidi e visualizzi l’anteprima prima di salvare.

Expression Editor in ProcessMind

Dove è possibile aprirlo

Apertura da Elemento modificato
Dataset → Attributi → cella Mappatura / Espressione un attributo calcolato
Dataset → Generale → Filtro globale del dataset → Aggiungi espressione del filtro… un filtro di riga applicato prima del Process Mining
Impostazioni del grafico → Espressione della metrica → Utilizza l’espressione della metrica… un’espressione della metrica valutata per ogni riga
Impostazioni del grafico → Metriche secondarie → Espressione… un’espressione della metrica secondaria
Impostazioni del grafico → chip Testo / Html testo del grafico: testo letterale e HTML con ${ ... } espressioni
Impostazioni del grafico → Impostazioni della norma → ƒ → espressione Inizia / Arresta un limite della norma determinato a partire dalle costanti delle Impostazioni del processo

Il titolo della finestra indica l’oggetto della modifica, ad esempio Edit Expression: {attribute name} o Espressione del filtro sulle righe.

Scrivere un’espressione

  • L’input evidenzia la sintassi durante la digitazione: funzioni, attributi, costanti, proprietà del caso e riferimenti alla riga hanno ciascuno un colore dedicato, mentre gli errori di analisi vengono sottolineati in rosso.
  • Premere Ctrl/Cmd+Space per aprire i suggerimenti, che non vengono visualizzati automaticamente. Invio o Scheda applica l’elemento selezionato, mentre Esc chiude l’elenco.
  • Passi con il mouse su un token per visualizzarne la documentazione: per le funzioni vengono mostrati firma, descrizione ed esempio; per gli attributi viene mostrato il tipo.
  • All’interno di una chiamata di funzione, l’assistenza sulla firma mostra il parametro che sta compilando.
  • I pulsanti Annulla e Ripeti si trovano nell’intestazione; le scorciatoie sono Ctrl/Cmd+Z, Shift+Ctrl/Cmd+Z e Ctrl/Cmd+Y.

Il pannello di riferimento

Il pannello Selezionare gli elementi per creare l’espressione elenca tutto ciò che è possibile utilizzare, organizzato in sezioni:

  • Attributi: gli attributi del dataset. Faccia clic su un attributo per inserirlo.
  • Costanti: costanti valide per l’intero processo, definite in Impostazioni del processo.
  • Funzioni: raggruppate per categoria, ciascuna con un suggerimento che mostra firma, descrizione ed esempio. Facendo clic, viene inserito il nome della funzione con le parentesi.
  • Proprietà dei casi e Riferimenti alle righe: faccia clic su un riferimento alla riga per inserire previous. e iniziare a creare un confronto con la riga precedente.

La casella di ricerca trova nomi, firme, descrizioni ed esempi e comprende l’intento: digitando “days between” o “sum with condition” vengono visualizzate le funzioni corrispondenti. L’icona della guida nell’intestazione apre la documentazione del linguaggio delle espressioni.

Anteprima

Per gli attributi e le metriche, l’editor mostra un’anteprima in tempo reale di Valori principali per occorrenza, che si aggiorna durante la digitazione: i risultati più frequenti con i relativi conteggi, oltre ai bucket null e other, fino a 20 valori. Durante l’elaborazione dell’anteprima viene visualizzato Anteprima dell’espressione in esecuzione…; in caso di errore viene mostrato Corregga l’espressione per visualizzare un’anteprima. I filtri sulle righe non supportano l’anteprima; l’editor lo segnala.

Template di testo del grafico

Il testo del grafico (Grafici testuali, KPI, indicatori e riquadri HTML) è un template: il testo letterale rimane invariato e ogni segmento ${ ... } viene valutato. L’editor convalida ogni segmento e lo evidenzia mentre Lei scrive. Testo, Html, le espressioni delle metriche e le espressioni norm vengono applicati solo quando Lei chiude l’editor con Salva; Annulla elimina la bozza. Il testo semplice dei grafici e l’HTML non possono essere valutati per riga, quindi l’editor mostra L’anteprima non è disponibile per il testo del grafico invece dell’anteprima del valore.

Le espressioni delle norme vengono risolte rispetto alle costanti delle Impostazioni del processo, ad esempio slaTargetDays * 86400000, quindi l’editor offre costanti e funzioni, ma non gli attributi del dataset.

Convalida e salvataggio

La convalida viene eseguita continuamente durante la modifica. La riga di stato nella parte inferiore della finestra mostra un segno di spunta verde L’espressione è valida oppure un errore in rosso, ad esempio Errore alla posizione 12: previsto ‘)’ ma trovato …. Tra gli errori tipici rientrano funzioni o variabili sconosciute, un numero errato di argomenti, stringhe non chiuse e incompatibilità tra tipi.

Salva resta disabilitato mentre l’espressione non è valida o si applicano restrizioni ai filtri sulle righe; se il campo viene svuotato e si salva, l’espressione viene rimossa. Premere Ctrl/Cmd+Enter per salvare dalla tastiera oppure Annulla per chiudere senza salvare.

Aprire le espressioni correlate in schede

Le espressioni possono fare riferimento ad altri attributi calcolati. Per esaminarne uno durante la modifica, fare clic con Ctrl/Cmd sul riferimento all’attributo nell’espressione: l’attributo si apre in una scheda separata di sola lettura. La barra delle schede viene visualizzata non appena sono presenti due schede e l’anteprima segue la scheda visualizzata.

Filtri sulle righe: consentiti e bloccati

Un filtro sulle righe viene applicato a ogni riga di evento non elaborata quando i dati vengono caricati, prima del Process Mining. Vengono mantenute solo le righe per cui l’espressione restituisce vero; i risultati falso, vuoti e null vengono rimossi. Questo contesto limita gli elementi utilizzabili:

  • Consentiti: i valori della riga stessa, ovvero gli attributi del dataset e gli alias integrati delle colonne (caseid, time, activity, cost, user, start_time e co2).
  • Bloccati: tutto ciò che richiede un contesto a livello di caso o tra più righe, ovvero proprietà dei casi, aggregazioni dei casi e funzioni di finestra, riferimenti alle righe (previous.), ricerche di attività come first() ed espressioni followedBy.

Se si utilizza un elemento bloccato, Salva viene disabilitato e viene visualizzato il messaggio: “I filtri sulle righe possono utilizzare solo i dati non elaborati della riga. Rimuova le proprietà dei casi, le aggregazioni dei casi, i riferimenti alle righe, le ricerche di attività o le espressioni followed-by.”

Argomenti correlati