Proprietà di configurazione e opzioni di configurazione

Si definiscono le opzioni di configurazione nella vista in modo che gli utenti possano personalizzare una specifica istanza di tale vista. Gli utenti vedono queste opzioni di configurazione come proprietà di configurazione in tale istanza.

Ad esempio, la vista Pulsanti di selezione ha l'opzione di configurazione layout e un'etichetta Layout . Quando si rilascia un'istanza di pulsante di opzione in un layout della vista e si seleziona l'istanza, viene visualizzato un elenco di proprietà di configurazione. Una di queste proprietà di configurazione è Layout. È possibile scegliere Orizzontale o Verticale per questa proprietà di configurazione. Questa scelta influisce solo su questa istanza di pulsanti di opzione.

Quando si definisce un'opzione di configurazione per la propria vista, si imposta l'aspetto della proprietà di configurazione corrispondente e le informazioni visualizzate.
  • Nel campo Etichetta , fornire il nome di visualizzazione della proprietà di configurazione. Se non si fornisce un'etichetta, l'istanza della vista utilizza il nome dell'opzione di configurazione come nome di visualizzazione.
  • Nel campo Documentazione , fornire il testo della guida a comparsa per aiutare gli utenti a decidere l'impostazione per tale proprietà di configurazione.
  • Per raggruppare diverse opzioni di configurazione correlate, fornire un nome gruppo. L'istanza della vista visualizza il nome gruppo con un triangolo. Quando gli utenti espandono il twistie, vedono tutte le proprietà di configurazione che hanno lo stesso nome gruppo. Ad esempio, si aggiungono config1 e config2 al gruppo Config .
    Opzione di configurazione config1 con il campo Nome gruppo impostato su Config
    Quando gli utenti fanno clic su un'istanza della vista, visualizzano il gruppo Config . Se gli utenti espandono il twistie, vedranno config1 e config2.
    Gruppo di configurazione con le proprietà di configurazione config1 e config2
Il tipo di dati dell'opzione di configurazione influisce sul modo in cui l'istanza della visualizzazione visualizza la proprietà di configurazione corrispondente. Se il tipo è un tipo semplice, come String, o si basa su un tipo semplice, la proprietà di configurazione corrispondente è una vista appropriata. Ad esempio, la vista è una casella di spunta per il tipo booleano o il campo di testo per un tipo stringa. Se il tipo è un oggetto di business, la proprietà di configurazione è un gruppo che contiene i parametri dell'oggetto di business come proprietà di configurazione.
L'opzione di configurazione config4 è un oggetto di business che contiene tre parametri. L'ultimo parametro è anche un oggetto di business.
Di seguito è riportato config4 come una proprietà di configurazione:
La proprietà di configurazione config4 è un gruppo che contiene parametri che vengono visualizzati come proprietà di configurazione
Se il tipo è un elenco, la proprietà di configurazione è una tabella a due colonne. Ogni riga nella tabella rappresenta un elemento nell'elenco.
L'opzione di configurazione config5 è un elenco di stringhe
Di seguito è riportato config5 come una proprietà di configurazione formattata come tabella.
La proprietà di configurazione config5 è una tabella che contiene due elementi aggiunti
Se il tipo è un elenco di oggetti di business, la proprietà di configurazione è una tabella con una riga di intestazione e una riga per ogni elemento dell'elenco. Ogni parametro nell'oggetto di business ha una colonna corrispondente nella tabella. Se un parametro è anche un oggetto di business, la colonna corrispondente si suddivide in colonne per ogni parametro nell'oggetto di business secondario.
Opzione di configurazione config6 come elenco di oggetti di business. param6, param7e param8 sono stringhe
Di seguito è riportato config6 come una tabella di configurazione formattata come una tabella a tre colonne:
La proprietà di configurazione config6 è una tabella con una colonna per i tre tipi semplici nella gerarchia di oggetti di business

Un'istanza della vista utilizza valori predefiniti impliciti per le proprietà di configurazione se gli utenti non impostano un loro valore. Il valore predefinito implicito dipende dal tipo. Quando si definisce un'opzione di configurazione di tipo booleano, è necessario tenere conto del relativo valore predefinito implicito, ovvero false. Ciò significa che il designer visualizza le opzioni di configurazione di tipo booleano impostate su false per impostazione predefinita, come le caselle di spunta deselezionate.

È possibile impostare un'opzione di configurazione in modo che risponda alle impostazioni della dimensione dello schermo, consentendo alle istanze della vista di avere fino a tre impostazioni differenti per tale proprietà di configurazione, ciascuna corrispondente a un'impostazione della dimensione dello schermo differente. Ad esempio, se la vista ha una proprietà di configurazione che controlla il rendering di un controllo di selezione come casella di spunta, pulsante di opzione o dispositivo di scorrimento, gli utenti possono configurare le proprie istanze della vista in modo da avere tre diversi rendering per tale vista in ambienti utente differenti. Per rendere un'opzione di configurazione reattiva, fare clic su Rispondi alla dimensione dello schermo.
Le opzioni di configurazione 7a, 7b, 7ce 7d sono impostate per rispondere alla dimensione dello schermo
Di seguito sono riportate le quattro proprietà di configurazione corrispondenti:
La proprietà di configurazione config 7a non ha alcun valore impostato, 7b ha un valore per schermi grandi, 7c ha un valore per schermi medi e 7d ha un valore per schermi piccoli

Quando gli utenti configurano l'istanza della vista e desiderano impostare un valore diverso per ciascuna dimensione di schermo, fanno clic sull'icona della dimensione di schermo accanto all'opzione di configurazione per specificare che il valore si applica a una dimensione di schermo grande, media o piccola. Possono quindi modificare l'impostazione della dimensione dello schermo in una nuova dimensione e immettere un nuovo valore per l'opzione di configurazione. Per informazioni sulle impostazioni di risposta per istanze di vista, consultare l'argomento Impostazioni di risposta per viste.

Quando si sta impostando (collegando a dati) una proprietà di configurazione su un'istanza della vista, è possibile collegarla staticamente o dinamicamente. Per eseguire il bind in modo statico, immettere o scegliere un valore per la proprietà di configurazione. Per eseguire il collegamento in modo dinamico, assegnare una variabile alla proprietà di configurazione facendo clic su Assegna una variabile Assegna una variabile. È quindi possibile selezionare una variabile esistente dall'elenco presentato. Per impostazione predefinita, l'elenco visualizza tutte le variabili. Le variabili con un tipo di dati che corrisponde al tipo definito per le opzioni di configurazione sono in grassetto. Tuttavia, è possibile scegliere di visualizzare solo queste variabili. Se si seleziona una variabile e il relativo tipo non corrisponde al tipo definito per l'opzione di configurazione, il designer visualizza un'avvertenza. Anziché selezionare una variabile, è possibile fare in modo che il designer crei un'opzione di configurazione del tipo corretto e associ la proprietà di configurazione a questa opzione di configurazione selezionando l'icona Esponi opzione di configurazione Esponi opzione di configurazione.
Limitazioni:
  • Non è possibile eseguire il collegamento statico a un oggetto di business che contiene elenchi nidificati. È necessario, invece, eseguire il bind in modo dinamico.
  • Se viene impostato un valore dinamico per un'istanza dell'opzione di configurazione reattiva, è possibile scegliere solo un valore. Ad esempio, non è possibile collegare una variabile diversa per ogni impostazione della dimensione dello schermo. Un'eccezione a questa restrizione è rappresentata dalle opzioni di configurazione che hanno un tipo di URL. Se queste opzioni di configurazione sono impostate per rispondere, possono accettare i valori per le diverse impostazioni di dimensione dello schermo, a condizione che tali valori siano file Web.
  • Solo le opzioni di configurazione che sono di tipo oggetto possono essere contrassegnate come reattive. Le impostazioni di risposta non sono supportate per opzioni di configurazione di tipo servizio.