@esfaenza/flow-builder 20.3.43 → 20.3.44

package/README.md

@@ -244,8 +244,15 @@ fuori dallo schermo, cioe' faceva sparire il contesto per cui l'elenco esiste. L
 sposta prendendola per l'intestazione, non ha «Annulla» — le modifiche sono già nel documento, e
 a tornare indietro e' l'annulla dell'editor — e si chiude da se' se la risorsa viene rimossa.
 
-*Quante volte e' usata.* Ogni risorsa porta il numero dei suoi usi, formule comprese; a zero
-occorrenze lo dice, ed e' l'unico modo di sapere quali delle venti variabili sono morte.
+*Quante volte e' usata.* Ogni risorsa porta il numero dei suoi usi; a zero
+occorrenze lo dice, ed e' l'unico modo di sapere quali delle venti variabili sono morte. Il
+conteggio comprende **tre** modi di citare un nome, e il `title` della riga dice quanti ce n'e'
+per ognuno, perche' sono tre posti diversi in cui andare a cercare: i campi di **riferimento**, le
+**espressioni** delle formule (`Importo * 1.22` usa `Importo`) e i **merge field** `{!…}` nei
+testi che il contratto dichiara — `interviewLabel`, il testo di un text template, `fieldText` e
+`helpText`, `choiceText`, `errorMessage` (§5.12). Senza i merge field una variabile citata da tre
+messaggi risultava «non usata», che e' esattamente l'informazione su cui si decide di
+cancellarla.
 Rimuovere una risorsa **usata** chiede conferma e dice quanti riferimenti resterebbero orfani:
 cancellare una variabile non fa sparire nessun arco dal canvas, e senza il numero il danno si
 scopriva alla validazione successiva.
@@ -704,8 +711,8 @@ versione attiva e' un avviso. Prima questi campi erano `<select>` con un'opzione
 «(non nel catalogo)» per non perdere il valore, oppure un `datalist` che accettava qualunque
 cosa in silenzio: il primo non si poteva cercare, il secondo non diceva niente.
 
-**Problemi.** Pannello con filtro per gravita', validazione su pausa di digitazione (debounce
-400 ms) e l'avvertenza che l'assenza di rilievi
+**Problemi.** Pannello con filtri per gravita', **testo** e **codice**, validazione su pausa di
+digitazione (debounce 400 ms) e l'avvertenza che l'assenza di rilievi
 non e' una garanzia di correttezza. Il `path` del rilievo si mostra **per nome**: il backend lo
 manda come percorso di campi e sugli screen dinamici spesso a indici
 (`fields[1].fields[1].fields[0]`), che e' esatto e inutile perche' per seguirlo si devono contare
@@ -716,6 +723,26 @@ leggendo. Ad aprire il form ci sono il bottone «✎» della riga e il doppio cl
 coppia di gesti del canvas. Per la stessa
 ragione il clic non si limita ad aprire l'elemento: **seleziona il campo** che il rilievo nomina.
 
+*I filtri.* Sono per la scala, come quelli delle risorse: il flow di produzione della demo ha 64
+rilievi e sette codici distinti, e a quella misura l'elenco si legge solo restringendolo. La
+casella cerca in cio' che la riga mostra — messaggio, codice, nome dell'elemento e **percorso
+tradotto per nome**, che e' quello che si legge sullo schermo: cercando il nome di un campo di
+screen dinamico un confronto sul path a indici non troverebbe niente. La tendina «Codici» e' una
+selezione **multipla**, perche' la domanda vera e' «fammi vedere questi tre codici» — sul flow di
+produzione i 47 errori sono quasi tutti cataloghi della demo che non conoscono quell'ambiente, e
+`OBJECT_UNKNOWN` piu' `STRUCTURE_TYPE_UNKNOWN` sono 23 righe da mettere da parte in un gesto.
+
+Tre scelte che si notano solo quando mancano. I codici elencati sono quelli **presenti** nel
+risultato, col loro conteggio, e non quelli della §7: l'elenco del contratto e' dichiarato aperto,
+e proporre codici che questo flow non ha vuol dire proporre filtri che danno zero righe. Un codice
+**selezionato** resta nell'elenco anche quando la gravita' scelta non ne contiene piu' nessuno —
+si vede a zero — altrimenti continuerebbe a filtrare senza che si possa vederlo ne' togliere. E i
+numeri sui chip della gravita' si ricalcolano sui filtri attivi, perche' il numero su un filtro
+deve essere quello che il filtro apre: «Errori 47» accanto a una casella che ne lascia passare
+tre promette quarantaquattro righe che non compariranno. L'unico numero che **non** segue i filtri
+e' quello della nota in fondo sugli errori che bloccano l'attivazione: filtrando per «Note»
+spariva proprio quando serve.
+
 **Il tipo di flow si sceglie alla creazione.** Su un flow nuovo — quello che l'editor apre senza
 `flowName` — il `processType` e' una scelta nella barra in cima; da quando il flow e' salvato
 diventa un'etichetta e non si tocca più. Non e' prudenza: il tipo decide quali globali esistono