Occorrenze

La cronologia duratura di ogni fronte di occorrenza, osservato dal giudice di una prova o dal sorvegliante Always fuori prova, con la condizione congelata che sta dietro a ciascuno.

Visualizza come Markdown

La scheda Occorrenze di Eventi (/events?view=occurrences) è la cronologia duratura di ciò che hanno fatto gli oggetti sotto prova: una riga per fronte di occorrenza, che l'abbia osservato il giudice di una prova o il sorvegliante Always fuori prova. Vederla richiede Visualizzare gli eventi; esportare richiede Esportare/importare gli storici. Le occorrenze si definiscono per modello sotto Process > Setup > Occurrences; questa scheda ne legge lo storico e non cambia nulla.

Segue la condotta comune alle tre cronologie descritta su Eventi: 500 righe per pagina con un impaginatore sotto, un periodo, una ricerca ritardata, l'aggiornamento in tempo reale, un solo pannello di dettaglio, l'esportazione in CSV e JSON dell'intero periodo.

Che cos'è una riga

Un'occorrenza è una condizione booleana sui canali di un modello, con un ritardo di attivazione e un ritardo di disattivazione. Una riga è una delle quattro transizioni di una sessione di osservazione:

Transizione	Significato
Attivata	La condizione è salita e si è mantenuta per il ritardo di attivazione.
Rientrata	La condizione è caduta e si è mantenuta per il ritardo di disattivazione.
Non disponibile	Uno o più canali richiamati dalla condizione hanno smesso di consegnare un valore. Il giudice tiene la sua ultima condizione confermata e non inventa mai un rientro.
Ripristinata	Ogni canale richiamato consegna di nuovo; la condizione è valutata da capo e il suo ritardo riparte.

Ogni riga dice anche in quale ambito è stata osservata e perché la sua sessione è cominciata:

Campo	Valori	Significato
Ambito	Prova, Fuori prova	Prova: il giudice proprio di una prova, armato dalla procedura; il fronte è scritto anche nel file di quella prova. Fuori prova: il sorvegliante Always che legge i collegamenti dell'unità fra una prova e l'altra.
Motivo	Esecuzione avviata, Esecuzione ripresa, Sorveglianza avviata, Osservazione fuori esecuzione ripresa, Definizione modificata	Perché è cominciata una nuova sessione di osservazione: una prova è partita; una prova è stata ripresa dopo il riavvio dell'applicazione; il sorvegliante Always è partito per questa occorrenza e questa unità; l'unità è tornata all'osservazione fuori prova dopo una prova; oppure la condizione, i ritardi, i canali richiamati, lo stato di abilitazione o il modo di armamento sono stati modificati.

Una sessione nuova comincia dal nulla: nessuno stato di condizione, di disponibilità o di antirimbalzo attraversa un intervallo non osservato, quindi una condizione già vera può produrre un'altra Attivata quando parte una prova o quando l'applicazione ritorna, e in questa cronologia non c'è alcuna riga sintetica di "sessione iniziata". Il file proprio della prova registra il confine della sessione anche quando non segue alcuna transizione; Storici e rapporti lo usano per classificare come Interrotta un'attivazione aperta più vecchia. Quel segno resta fuori da questa cronologia e non solleva alcuna notifica. Le modifiche di sola visualizzazione (nome, messaggio, gravità) mantengono la sessione e cambiano solo le istantanee successive.

Ricerca e filtro

Comando	Valori	Che cosa fa
Ricerca	Testo segnaposto "Cerca nome, messaggio, modello, unità o procedura"	Confronto "contiene" sul nome dell'occorrenza, sul suo messaggio, sul nome del modello, sul nome dell'unità e sul nome della procedura, come fotografati in quel momento.
Gravità	Tutte le gravità (predefinito), Critica, Avviso, Info	Tiene solo le transizioni di occorrenze che portavano quella gravità quando sono avvenute.
Aggiorna		Rilegge il diario; suggerimento "Aggiorna le occorrenze".
Esporta	Esporta in CSV…, Esporta in JSON…	Scrive le righe attualmente elencate. Disegnato solo con Esportare/importare gli storici; in grigio finché l'elenco è vuoto.

Le righe

Parte della riga	Contenuto
Ora	Data e ora in cui il giudice ha osservato il fronte (per una prova, l'istante proprio del campione giudicato).
Punto	Il tono della gravità: critico per Critica, cautela per Avviso, neutro per Info.
Nome	Il nome dell'occorrenza in quel momento.
Riepilogo	"Transizione · oss N (Motivo) · Modello / Unità · contesto", dove N è la posizione del fronte nella sua sessione e il contesto è "Prova · " seguito dal nome della procedura (o soltanto "Prova" quando non è stato registrato alcun nome di procedura) oppure "Fuori prova". Esempio: "Attivata · oss 1 (Esecuzione avviata) · Furnace / Line 2 · Prova · Bake 180".
Livello	La parola della gravità.

Il messaggio che una riga porta è il messaggio proprio dell'occorrenza per Attivata e Rientrata (vuoto quando la definizione non ne ha, mostrato come "Nessun messaggio acquisito." nel pannello) e, per i fronti di disponibilità, "Segnale non disponibile:" o "Segnale ripristinato:" seguito dai nomi dei canali interessati, separati da virgole.

Il pannello di dettaglio

Selezionare una riga apre il pannello con il distintivo della gravità e il nome, l'istante completo, la riga di riepilogo, il messaggio e quattro riquadri:

Riquadro	Campo	Contenuto
EVENTO	Livello	La gravità.
EVENTO	ID evento	L'identità di questo fronte nel diario. Per un'osservazione di prova è lo stesso id che tiene il file della prova.
ISTANTANEA DELL'OCCORRENZA	Transizione	Attivata, Rientrata, Non disponibile o Ripristinata.
ISTANTANEA DELL'OCCORRENZA	Modello	Il nome del modello in quel momento.
ISTANTANEA DELL'OCCORRENZA	Unità	Il nome dell'unità in quel momento.
ISTANTANEA DELL'OCCORRENZA	Ambito	Prova o Fuori prova.
ISTANTANEA DELL'OCCORRENZA	Procedura	Solo per l'ambito Prova: il nome della procedura, o un trattino quando non ne è stato registrato alcuno.
ISTANTANEA DELL'OCCORRENZA	ID prova	Solo per l'ambito Prova: l'id della prova, lo stesso che mostra Storici.
ISTANTANEA DELL'OCCORRENZA	ID modello, ID unità, ID occorrenza	Gli id stabili dietro ai nomi, che una rinomina non cambia.
SESSIONE DI OSSERVAZIONE	Sequenza nel diario	Il numero di inserimento della riga nel diario, che ordina le righe con lo stesso istante.
SESSIONE DI OSSERVAZIONE	ID osservazione	L'identità della sessione che ha osservato il fronte; ogni fronte di una sessione la condivide.
SESSIONE DI OSSERVAZIONE	Sequenza della transizione	La posizione del fronte nella sessione, a partire da uno. Un salto significa un fronte che il diario non è riuscito a rendere persistente.
SESSIONE DI OSSERVAZIONE	Iniziata	Quando è cominciata la sessione, come istante completo.
SESSIONE DI OSSERVAZIONE	Motivo	Esecuzione avviata, Esecuzione ripresa, Sorveglianza avviata, Osservazione fuori esecuzione ripresa o Definizione modificata.
CONFIGURAZIONE CONGELATA	Condizione	La condizione JavaScript che la sessione ha effettivamente giudicato.
CONFIGURAZIONE CONGELATA	Ritardo di attivazione / disattivazione	"x ms / y ms", l'antirimbalzo che la sessione ha usato.
CONFIGURAZIONE CONGELATA	ID dei canali richiamati	Gli id dei canali che condizionavano l'espressione, separati da punti e virgola.

Colonne dell'esportazione

CSV e JSON portano gli stessi campi, in questo ordine: Timestamp (l'intestazione del CSV aggiunge il riferimento temporale, "Timestamp (UTC-03:00)"), JournalSequence, Severity, Name, Transition, Scope, Model, ModelId, Unit, UnitId, Procedure, RunId, Message, EventId, OccurrenceId, ObservationId, ObservationSequence, ObservationStartedAt, ObservationReason, Condition, OnDelayMs, OffDelayMs e ReferencedChannelIds (separati da punto e virgola nel CSV, un array nel JSON). Il JSON è una busta con TimeZone ed Events. I nomi dei file sono occurrence-history-<yyyyMMdd-HHmmss>.csv e .json. Il CSV segue la preferenza di separatore decimale della stazione come ogni altra esportazione: con i decimali a punto il separatore di elenco è ,, con i decimali a virgola è ;. Una cella che comincia con =, +, - o @ è preceduta da un apostrofo perché un foglio di calcolo la legga come testo.

Dove altro un'occorrenza è registrata

Un'osservazione di prova è scritta prima nel file proprio della prova, poi copiata qui con lo stesso id di evento e il contesto della prova; se la copia fallisce, il file della prova tiene comunque il fronte e Console porta una riga Errore che lo dice. Un'osservazione fuori prova esiste soltanto qui. Ogni fronte lascia anche una riga in Console sotto l'area Process: un'attivazione al livello della sua gravità (Critica come errore, Avviso come avviso, Info come informazione), una perdita di segnale allo stesso livello, un rientro e un ripristino come informazione. Un'attivazione solleva in più una notifica dentro la finestra intitolata "Occorrenza · " seguita dal nome dell'unità e, per un'attivazione Avviso o Critica osservata durante una prova, una notifica del sistema operativo mentre la finestra è nascosta o ridotta a icona.

Stati vuoti e riga di stato

"Nessuna occorrenza finora" con "Le transizioni di occorrenza delle prove e della sorveglianza Always fuori prova compariranno qui."
"Nessuna occorrenza corrisponde a questi filtri" con "Modifica la gravità o i termini di ricerca per allargare questo storico."
La riga di stato dice "N mostrate · pagina 1", poi " · filtrate" quando una ricerca, una gravità o un periodo è in vigore; a destra, "1 selezionata" e "Aggiornato hh:mm:ss".

Che cosa la scheda Occorrenze non fa

Non definisce, non arma e non modifica un'occorrenza (Process > Setup > Occurrences).
Non appaia i fronti in episodi con una durata: quella vista derivata, con le sue classificazioni Interrotta e Incompleta, sta in Storici per una prova e sui pannelli propri dell'unità.
Non ha filtro per unità, prova, ambito o data; cerca per nome di unità, di modello o di procedura, oppure apri la prova in Storici.
Non mostra alcuno stato dal vivo: se un'occorrenza è attiva adesso si legge sul pannello dell'unità, non qui.