@esfaenza/flow-builder 20.3.1 → 20.3.2

package/README.md

@@ -218,6 +218,27 @@ con la via d'uscita: scrivere quel risultato in una variabile.
 `Object` / `Enum`, `scale` solo sui numerici, costanti che non possono referenziare risorse,
 `stageOrder` distinti.
 
+**Oggetti e campi.** Ogni punto che chiede un'entita' o un suo campo usa lo stesso controllo:
+`<fb-object-picker>` e `<fb-field-picker>`, una casella con autocomplete che filtra il catalogo
+mentre si scrive. Un `<select>` andava bene con dieci entita', non con trecento; e dove il
+catalogo non arriva il controllo resta lo stesso, con un avviso, invece di degradare in un
+campo di testo cieco. La scrittura libera e' voluta — i percorsi di relazione
+(`Cliente.Citta`) non sono enumerabili e il catalogo dell'host puo' essere incompleto — ma un
+nome fuori catalogo viene segnalato subito, prima che il backend risponda `OBJECT_UNKNOWN` o
+`FIELD_UNKNOWN`. Il campo si chiede sempre con l'uso giusto (`filterable`, `sortable`,
+`updateable`), che decide sia l'elenco sia il testo dell'avviso: "non filtrabile" e "non
+aggiornabile" sono errori diversi. Restano `<select>` i dizionari chiusi — tipi di dato,
+operatori, enumerazioni — dove non c'e' niente da scrivere a mano.
+
+Lo stesso controllo, nella variante `<fb-name-picker>`, vale per i nomi che dipendono dal
+contesto e non da un catalogo di schema: il flow di uno step in background e dei suoi
+evaluation flow, il flow invocato da un Subflow, le variabili di input e output **del flow
+invocato**. Qui l'elenco arriva da chi ospita il picker (`listSubflowCandidates`, le variabili
+della definizione caricata), e un elenco vuoto resta "non lo so": il campo si scrive a mano e
+non si accusa nessun nome. Con l'elenco popolato, invece, un nome che non c'e' e' segnalato —
+ed e' la differenza rispetto al `datalist` che questi campi usavano prima, che accettava
+qualunque cosa in silenzio.
+
 **Problemi.** Pannello con filtro per gravita', navigazione all'elemento con un clic,
 validazione su pausa di digitazione (debounce 400 ms) e l'avvertenza che l'assenza di rilievi
 non e' una garanzia di correttezza.