@esfaenza/flow-builder 20.3.8 → 20.3.10

package/README.md

@@ -254,6 +254,26 @@ Restano fuori i percorsi radicati sul risultato **automatico** di un elemento
 (`Leggi_Contatti.Owner.Name`): la validazione non li verifica, e l'editor non accusa cio' che il
 backend non verifica.
 
+Il filtro di tipo di un campo (§6.4) guarda il tipo della **radice**, e quindi non basta: in un
+parametro `String` una variabile `Structure` non e' compatibile, ma `Richiesta.Ragione` sì. Per
+questo `<fb-reference-picker>`, dove un filtro c'e', chiede al backend **anche** l'elenco non
+filtrato, e ne ricava due cose: i contenitori compaiono come righe in cui si **entra** — cliccarle
+apre il percorso invece di scegliere un valore del tipo sbagliato — e le radici si riconoscono
+tutte, così un `Leggi_Ordine.Numero` già scritto in un campo `String` non viene accusato di non
+esistere. Le proposte le filtra il backend come prima; i segmenti di un percorso li filtra
+l'editor con la stessa regola, tenendo comunque quelli da cui si scende.
+
+**Le globali si navigano come le risorse.** Un percorso dichiarato dall'host puo' portare un
+contenitore, e allora `objectType` dice di che tipo: `$User.Anagrafica.Citta` si propone e si
+verifica come `Richiesta.Ragione`. La regola da non sbagliare e' che vince il **prefisso dichiarato
+piu' lungo** — non tutto cio' che segue lo scope — perche' altrimenti un percorso giusto viene
+segnalato come rotto (§4.1). Dove il catalogo dichiara il contenitore ma non il tipo il rilievo e'
+`PATH_NOT_VERIFIABLE`, e la correzione sta nel catalogo dell'host; navigare uno scalare
+(`$User.Email.Dominio`) e' invece `GLOBAL_UNKNOWN`. Sulle **destinazioni** non cambia niente da
+sapere: le globali sono di sola lettura, membri compresi — le assegnabili sono `$Flow.CurrentStage`,
+`$Flow.ActiveStages` e i campi di `$Record` — e il picker lo dice con `TARGET_NOT_WRITABLE` invece
+di far sembrare il nome inesistente (§5.2).
+
 Su una destinazione la colonna che decide non e' la stessa nei due mondi: un membro porta il proprio
 `isWritable`, un campo no. Fuori da un Create o da un Update il contesto non c'e' — un Assignment su
 `Cliente.Codice` non sa se quel record verra' creato o aggiornato — quindi lì basta `isCreateable`