English
Instant Developer Foundation Documentazione
  • Approfondimenti
  • IDE

Nuova Proprietà 'Titolo'

copia link

Introduzione

Dalla versione 7.5, si può notare che la videata delle proprietà di molti oggetti presenta nella parte alta, dopo il nome e la descrizione, una nuova proprietà denominata Titolo. Lo scopo di questa proprietà è quello di disaccoppiare il nome logico dell'oggetto da quello che gli utenti dell'applicazione vedranno nel video. I vantaggi che ciò permette sono i seguenti:

  • Se si decide di introdurre uno standard di nomenclatura dei nomi degli oggetti, probabilmente esso non corrisponderà con quanto gli utenti dovranno vedere a video. In questo caso sarebbe stato necessario introdurre righe di codice o rinominare gli oggetti di interfaccia utente in modo diverso da quelli del modello.
  • Nel caso in cui più campi dello stesso pannello debbano avere la medesima intestazione, ora non è più necessario scrivere righe di codice per ottenere il risultato.
  • E' possibile specificare il tooltip dei campi statici (bottoni, ecc...) senza dover scrivere righe di codice.


Esempi di uso della proprietà Titolo di un campo di pannello

Titolo e oggetti visuali

I seguenti oggetti visuali supportano la proprietà Titolo:

  • Applicazione web: rappresenta il titolo principale dell'applicazione (proprietà MainCaption).
  • Form: rappresenta il titolo della videata.
  • Command Set: rappresenta il titolo del menù.
  • Comando: rappresenta il titolo del comando di menù.
  • Pannelli, Alberi, Book, Grafici, Bottoniere: rappresenta il titolo del relativo oggetto nell'interfaccia utente.
  • Campi di pannello: rappresenta il titolo del campo nell'interfaccia utente.
  • Gruppi e pagine di campi di pannello: rappresenta il titolo del gruppo o della pagina nell'interfaccia utente.
  • Costanti: rappresenta il nome della costante nelle liste valori dell'interfaccia utente.

Titolo e oggetti non visuali

La proprietà Titolo è supportata anche da diversi oggetti non visuali. Ecco la lista:

  • Tabelle: il Titolo della tabella viene propagato alle classi DO, alle form ed ai pannelli derivati dalla tabella.
  • Campi di database: il Titolo del campo di database viene propagato alle proprietà delle classi DO, e ai campi di pannello derivati dal campo del database.
  • Classi DO: il Titolo della classe viene propagato ai pannelli che derivano dalla classe, inoltre viene esportato nella proprietà UIName del metaschema del documento.
  • Proprietà classe DO: il Titolo della proprietà del documento viene propagato ai campi dei pannelli che derivano dalla classe, inoltre viene esportato nella proprietà UIName del metaschema della proprietà del documento.

Meccanismi di propagazione

La proprietà Titolo ha un meccanismo di propagazione identico a quello della proprietà Nome, quindi se ad esempio viene variata la proprietà titolo di un campo del database, allora viene cambiata anche quella di tutte le proprietà di classi documento e di tutti i campi di pannello che derivano da tale campo del database. Questo avviene però se la proprietà Titolo degli oggetti derivati conteneva ancora il valore precedente della proprietà Titolo dell'oggetto base.

Ad esempio, supponiamo che la proprietà Titolo di un campo del database sia 'Nome' e la corrispondente proprietà di tre campi di pannello sia 'Nome', 'Nome Prodotto' e 'Denominazione'. Se allora sul campo del database da Nome viene variata in Codice, la proprietà titolo dei tre campi di pannello diventerà 'Codice', 'Codice Prodotto' e 'Denominazione'.

Nel caso particolare in cui la proprietà Titolo sia vuota sull'oggetto padre e sul derivato, allora la regola di propagazione è leggermente diversa: si guarda se sarebbe stata propagata la variazione della proprietà Nome. Questo per preservare il comportamento delle applicazioni preesistenti.

Compatibilità applicazioni preesistenti

L'introduzione della proprietà Titolo non causa alcun problema di compatibilità: ricompilando un progetto preesistente con la versione 7.5, tutto funzionerà come prima in quanto se si lascia vuoto il Titolo di un oggetto allora la composizione dell'interfaccia utente avverrà utilizzando la proprietà Nome come avveniva nelle versioni precedenti di Instant Developer.

Nel caso di campi statici di pannello, se la proprietà Titolo non viene specificata allora il contenuto del campo viene preso dalla proprietà Descrizione, come avveniva nelle versioni precedenti. Se invece viene specificato un Titolo, allora esso diventa il contenuto del campo e la proprietà Descrizione diventa il tooltip del campo come per tutti i campi non statici.

Importazione dello schema del database

In alcuni schemi di database, specialmente in quelli DB2/400, il commento degli oggetti del database è stato usato proprio per contenere il titolo dei campi che a video avrebbero poi mostrato tali informazioni. Per recuperare correttamente queste informazioni è stata introdotta una nuova opzione di importazione schema: Importa commenti come Titolo oggetti. Tale opzione, attiva per default in caso di importazione da DB2/400, copia il commento dell'oggetto di database nella proprietà Titolo invece che nella proprietà Descrizione come solitamente avviene.

Titolo e RTC

Se per un'applicazione web è stato attivato il modulo RTC, allora la proprietà Titolo, quando specificata, viene esportata nel campo RTC Nome Oggetto. Se il Titolo non viene specificato, allora verrà esportata la proprietà Nome come nelle versioni precedenti.

Ultima modifica: 23/03/2021 / Validità: da 7.5.3400

Vedi anche

  • Main Caption (proprietà)

Hai trovato utile l'articolo?

Grazie per il feedback!

Ti serve altro aiuto?

Consulta il Forum