[AEM Forms]{class="badge positive" title="Si applica ad AEM Forms)."}
Componente per variabile non associata nell’editor di comunicazione interattiva
1. Introduzione
Il componente Variabile non associata nell’editor di comunicazione interattiva (IC) consente di inserire un campo il cui valore non è associato ad alcun nodo schema o modello dati esterno. Il valore viene invece fornito tramite script, calcolo basato su regole o un valore statico predefinito, rendendo questo componente la scelta giusta ogni volta che è necessario un valore di visualizzazione calcolato o intermedio che non provenga direttamente da un’origine dati associata.
Poiché una variabile non associata non è connessa a un modello dati modulo, offre il controllo completo sull’authoring del valore in fase di progettazione e di esecuzione. È possibile utilizzarlo per visualizzare i totali calcolati, i numeri di riferimento generati dinamicamente, i risultati di formule intermedie o qualsiasi altro valore generato dal modulo di gestione delle regole.
Il componente supporta tutti e quattro i tipi di dati Testo, Numerico, Data e Data/ora. Il tipo di dati attivo determina la sintassi del modello di visualizzazione e i simboli della clausola immagine da applicare.
2. Pattern di visualizzazione
È possibile assegnare un pattern di visualizzazione a un campo Variabile non associata dal pannello Proprietà, utilizzando gli stessi controlli del pattern di visualizzazione disponibili per i componenti Casella di testo, Campo numerico, Campo data e Campo data/ora. Questo consente la presentazione formattata dei valori calcolati o di riferimento nell’anteprima dell’area di lavoro e nell’output generato.
Il pattern configurato viene immediatamente visualizzato nell’anteprima dell’area di lavoro e viene mantenuto nei vari cicli di salvataggio e ricaricamento.
Configurare un pattern di visualizzazione
- Seleziona il componente Variabile non associata nell’area di progettazione.
- Apri il pannello Proprietà.
- Nella sezione Pattern di visualizzazione scegliere un pattern predefinito o immettere una clausola immagine personalizzata.
- Visualizzare l’anteprima del valore formattato nell’area di lavoro.
Scelta del pattern giusto
Poiché una variabile non associata può contenere qualsiasi tipo di dati, la sintassi della clausola immagine utilizzata deve corrispondere al tipo di dati configurato del campo:
YYYY-MM-DD o YYYY-MM-DDTHH:MM). I valori che non seguono questo formato vengono visualizzati così come sono, senza il pattern di visualizzazione applicato.3. Proprietà
Il componente Variabile non associata condivide un set comune di proprietà con altri componenti di campo, con una distinzione chiave: supporta opzioni di associazione dati esterne per qualsiasi origine dati o frammento di comunicazione interattiva.
3.1 Campo di base
-
Nome: Identificatore univoco della variabile. Utilizzato per farvi riferimento in regole, script ed espressioni all’interno dell’IC.
-
Tipo di dati: Specifica il tipo di valore che questa variabile contiene Testo, Numerico, Data o Data/ora. Il tipo di dati selezionato determina la sintassi del pattern di visualizzazione applicabile e il modo in cui il valore viene convalidato.
-
Didascalia: etichetta visualizzata accanto al campo nell’area di lavoro (ad esempio, “Totale calcolato” o “Numero di riferimento”).
-
Valore: Il valore predefinito o calcolato visualizzato nel campo. Nella maggior parte dei casi questo viene impostato a livello di programmazione utilizzando l’editor di regole o uno script, anziché essere digitato manualmente.
-
Riserva: Un valore di fallback visualizzato quando non è disponibile alcun valore calcolato, utile per output di sola stampa o di sola lettura in cui un campo vuoto non è accettabile.
-
Aspetto: Predefinito di stile visivo (Nessuno, Casella piena o Sottolineato) per il contenitore di campi.
3.2 Tipografia
Controlla lo stile del valore visualizzato:
-
Variante carattere: Scegliere la famiglia di caratteri, lo spessore (Normale, Grassetto) e lo stile (Corsivo) in modo che corrispondano al contenuto circostante.
-
Dimensione carattere: In genere è impostato su 10 pt per impostazione predefinita; regola per mantenere la coerenza visiva con il resto della comunicazione.
3.3 Posizione
Definisce il posizionamento del componente nell’area di lavoro:
-
Coordinate X e Y: Impostare la posizione orizzontale e verticale esatta.
-
Larghezza e altezza: Specificare le dimensioni in millimetri da allineare agli elementi adiacenti.
3.4 Margine
Definisce la spaziatura attorno al limite del componente:
-
Superiore (Su)
-
Inferiore (giù)
-
Sinistra
-
Destra
3.5 Aspetto
Personalizza lo stile del contenitore di campi:
-
Riempimento: Colore di sfondo del campo.
-
Tratto: Bordo intorno al campo, con le seguenti opzioni:
-
Larghezza: Spessore bordo.
-
Stile: Tinta unita, tratteggiata o punteggiata.
-
Edge: angoli arrotondati o vivi.
-
3.6 Presenza
Controlla la visibilità in fase di runtime:
-
Visibile: Il campo viene visualizzato e occupa lo spazio di layout.
-
Nascosto (mantiene spazio): Il campo è invisibile ma il relativo spazio di layout è mantenuto, utile quando si attiva la visibilità in modo dinamico tramite l’editor di regole.
4. Utilizzo
Utilizza una variabile non associata quando il valore da visualizzare è:
-
Calcolato da una regola o da uno script, ad esempio un totale parziale, un calcolo delle imposte o un importo di sconto derivato da altri valori di campo.
-
Generato a livello di programmazione, ad esempio un numero di riferimento o un codice di tracciamento assegnato in fase di esecuzione dalla logica di back-end.
-
Non disponibile nel modello dati, ad esempio un risultato intermedio significativo visualizzato sullo schermo ma che non esiste come campo schema.
-
Visibile in modo condizionale: visualizza un messaggio o un valore calcolato solo quando vengono soddisfatte determinate condizioni, utilizzando l’Editor regole per impostare insieme visibilità e valore.
È possibile inserire una variabile non associata all’interno di sottomaschere, contenitori di layout o direttamente nell’area di progettazione. Combinalo con l’Editor regole per scrivere espressioni che calcolino il suo valore in base ad altri campi associati nell’IC.
5. Best practice
-
Impostare un valore di riserva significativo in modo che l’output di stampa e le anteprime di sola lettura non visualizzino mai un campo vuoto quando il valore calcolato non è disponibile.
-
Abbina il tipo di dati all’output. Se si calcola un importo di valuta, impostare il tipo di dati su Numerico e applicare un pattern di visualizzazione numerico. Se si calcola una data, impostarlo su Data e assicurarsi che l’input ISO 8601 sia corretto.
-
Utilizza una didascalia chiara: poiché il valore è calcolato e non direttamente riconoscibile da un’etichetta, una didascalia descrittiva (ad esempio, “Subtotale (calcolato)”) impedisce confusione sia per i revisori che per gli utenti finali.
-
Evitare di utilizzare in modo eccessivo le variabili non associate per i dati che appartengono al modello. Se è possibile aggiungere un valore al modello dati del modulo, è preferibile associare un campo standard. Riserva variabili non associate per valori effettivamente transitori o derivazionali.
-
Documenta le espressioni. Aggiungere un commento nell’editor di regole che descriva il calcolo di ogni variabile non associata, in modo che la logica rimanga gestibile quando l’IC viene modificato in un secondo momento.
Consulta anche
- Componente casella di testo — sintassi del pattern di visualizzazione per i valori di testo
- Componente campo numerico: sintassi del modello di visualizzazione per i valori numerici e di valuta
- Componente campo data — sintassi del modello di visualizzazione per le date
- Componente campo data/ora: sintassi pattern di visualizzazione per valori combinati di data e ora
- Utilizza l’Editor regole nell’Editor comunicazioni interattive: scrivi espressioni per calcolare e assegnare valori a variabili non associate
- Configurare l’associazione dati nell’editor di comunicazione interattiva