1,423
edits
Changes
From Studiosg
Jump to navigationJump to searchVtigercrm proprietà dei campi (view source)
Revision as of 13:37, 15 April 2016
, 13:37, 15 April 2016Ridisegnato parzialmente la pagina
{{header_it|title=Proprietà dei campi di VtigerCRM| keyword={{Template:keyword_it_vtigercrm}}| description=Un articolo inerente la configurazione dei campi utilizzati nelle maschere di VtigerCRM | link_page=vtigercrm_field_properties}}
[[vtigercrm_intro#Funzionamento_interno_di_VtigerCRM | Funzionamento interno di VtigerCRM]]
== Campi - Proprietà ==
Tutti i controlli che compaiono nelle maschere di VtigerCRM sono clonati da un insieme di "Widget" standard definiti dagli sviluppatori del prodotto. I controlli possono essere utilizzati nello sviluppo ed implementazione di moduli personalizzati mediante l'adozione della libreria '''vtlib''', oppure scrivendo il '''codice xml di definizione del modulo'''. Ogni controllo è caratterizzato da un '''numero fisso di proprietà''' che ne definiscono l'aspetto, il comportamento e le modalità d'uso. Di seguito verranno elencate le proprietà di ogni controllo e la loro funzione. Per consultare le caratteristiche dei controlli esistenti nel programma sarà possibile interrogare la tabella '''vtiger_field''' ove sono raccolti tutti i controlli definiti in VtigerCRM.
Tutti i controlli che compaiono nelle maschere di VtigerCRM sono clonati da un insieme di "Widget" standard definiti dagli sviluppatori del prodotto. I controlli possono essere utilizzati nello sviluppo ed implementazione di moduli personalizzati mediante l'adozione della libreria '''vtlib''', oppure scrivendo il '''codice xml di definizione del modulo'''. Ogni controllo è caratterizzato da un '''numero fisso di proprietà''' che ne definiscono l'aspetto, il comportamento e le modalità d'uso. Di seguito verranno elencate le proprietà di ogni controllo e la loro funzione. Per consultare le caratteristiche dei controlli esistenti nel programma sarà possibile interrogare la tabella '''vtiger_field''' ove sono raccolti tutti i controlli definiti in VtigerCRM.
{| border="1"
{| bgcolor="darkgrey" border="1" width="90%"
|+ '''PROPRIETÀ DEI CAMPI'''
|- bgcolor="darkgrey"
! '''Proprietà''' !! '''Descrizione'''
! '''Proprietà''' !! '''Descrizione'''
|-
|-
| ''name'' || Obbligatorio per ogni campo. Deve essere univoco.
| ''name'' || Obbligatorio per ogni campo. Deve essere univoco.
|-
|-
| ''column'' || La colonna della base dati a cui legare il campo della pagina. <BR> I dati salvati nella maschera del programma verranno memorizzati nella colonna associata.
| ''column'' || La colonna della base dati a cui legare il campo della pagina. <br /> I dati salvati nella maschera del programma verranno memorizzati nella colonna associata.
|-
|-
| ''columntype'' || La tipologia del dato salvato nella colonna. Si faccia riferimento alla documentazione del motore di database impiegato per un elenco dei possibili valori.
| ''columntype'' || La tipologia del dato salvato nella colonna. Si faccia riferimento alla documentazione del motore di database impiegato per un elenco dei possibili valori.
|-
|-
| ''generatedtype'' || Specifica se il campo sia predefinito oppure una personalizzazione aggiunta dall'utenza. <BR> Durante lo sviluppo di un nuovo modulo tutti i campi risulteranno predefiniti. <BR> Può assumere due valori numerici: 1 e 2. 1 corrisponde a '''Existing''' ossia un campo presente nelle tabelle di base del modulo, mentre 2 equivale a '''User Defined''': Un campo personalizzato il cui contenuto verrà salvato in una tabella separata, avente nome <nome modulo>'''cf'''.
| ''generatedtype'' || Specifica se il campo sia predefinito oppure una personalizzazione aggiunta dall'utenza. <br /> Durante lo sviluppo di un nuovo modulo tutti i campi risulteranno predefiniti. <br /> Può assumere due valori numerici: 1 e 2. 1 corrisponde a '''Existing''' ossia un campo presente nelle tabelle di base del modulo, mentre 2 equivale a '''User Defined''': Un campo personalizzato il cui contenuto verrà salvato in una tabella separata, avente nome <nome modulo>'''cf'''.
|-
|-
| ''label'' || L'etichetta visibile nelle maschere in corrispondenza del campo. <BR> VtigerCRM utilizza il valore specificato come chiave dello array '''$mod_strings''' che viene utilizzato per le traduzioni del programma. <BR> Sviluppando un nuovo modulo si dovrebbe imporre un nome in inglese.
| ''label'' || L'etichetta visibile nelle maschere in corrispondenza del campo. <br /> VtigerCRM utilizza il valore specificato come chiave dello array '''$mod_strings''' che viene utilizzato per le traduzioni del programma. <br /> Sviluppando un nuovo modulo si dovrebbe imporre un nome in inglese.
|-
|-
| ''table'' || La tabella in cui creare la colonna. <BR> Per un modulo standard verrà utilizzata la nomenclatura '''vtiger_'''<nome del modulo>.
| ''table'' || La tabella in cui creare la colonna. <br /> Per un modulo standard verrà utilizzata la nomenclatura '''vtiger_'''<nome del modulo>.
|-
|-
| ''maximumlength'' || Il numero massimo di caratteri / cifre digitabili nelle maschere in cui compare il campo.
| ''maximumlength'' || Il numero massimo di caratteri / cifre digitabili nelle maschere in cui compare il campo.
|-
|-
| ''typeofdata'' || La formattazione del dato mostrato nelle maschere. <BR> La formattazione è specificata attraverso una stringa '''X~Y''' ove X è '''la tipologia del dato''' (Vedere [[vtigercrm_tipi_di_dato]]), mentre Y Può assumere i valori '''M''' per obbligatorio o '''O''' per opzionale.
| ''typeofdata'' || La formattazione del dato mostrato nelle maschere. <br /> La formattazione è specificata attraverso una stringa '''X~Y''' ove X è '''la tipologia del dato''' (Vedere [[vtigercrm_tipi_di_dato | Tipi di dato di VtigerCRM 5]]), mentre Y Può assumere i valori '''M''' per obbligatorio o '''O''' per opzionale.
|-
|-
| ''uitype'' || Il Widget che verrà mostrato nelle maschere (Vedere [[vtigercrm_tipi_di_widget]]).
| ''uitype'' || Il Widget che verrà mostrato nelle maschere (Vedere [[vtigercrm_tipi_di_widget | Widget di VtigerCRM 5]]).
|-
|-
| ''displaytype'' || Impone in quali maschere debba essere mostrato il campo. <BR> Può assumere i valori da 1 a 4. <BR> 1 impone che sia mostrato in ogni vista, 2 che sia mostrato solo nella vista di '''dettaglio''', ma non in '''modifica''', 3 che non sia mai mostrato singolarmente, ma solo assieme a campi correlati ed infine 4 che sia mostrato solo durante l'inserimento di nuovi dati. Non nella vista di dettaglio '''dettaglio''' o '''modifica'''.
| ''displaytype'' || Impone in quali maschere debba essere mostrato il campo. <br /> Può assumere i valori da 1 a 4. <br /> 1 impone che sia mostrato in ogni vista, 2 che sia mostrato solo nella vista di '''dettaglio''', ma non in '''modifica''', 3 che non sia mai mostrato singolarmente, ma solo assieme a campi correlati ed infine 4 che sia mostrato solo durante l'inserimento di nuovi dati. Non nella vista di dettaglio '''dettaglio''' o '''modifica'''.
|-
|-
| ''masseditable'' || Impone se il campo debba comparire nella maschera di Mass Edit. <BR> Può assumere i valori 0 oppure 1. <BR> 0 Impone che il campo compaia nella maschera di Mass Edit e possa pertanto essere modificato tramite tale procedura. 1 al contrario nega la funzionalità.
| ''masseditable'' || Impone se il campo debba comparire nella maschera di Mass Edit. <br /> Può assumere i valori 0 oppure 1. <br /> 0 Impone che il campo compaia nella maschera di Mass Edit e possa pertanto essere modificato tramite tale procedura. 1 al contrario nega la funzionalità.
|-
|-
| ''presence'' || Classifica la natura del campo. <BR> Può assumere valori da 0 a 2. <BR> 0 identifica un '''campo di sistema''' che non può essere nascosto dall'utenza. 1 identifica un '''campo nascosto''', mai mostrato. 2 infine identifica un '''campo normale''', che può essere configurato nelle impostazioni.
| ''presence'' || Classifica la natura del campo. <br /> Può assumere valori da 0 a 2. <br /> 0 identifica un '''campo di sistema''' che non può essere nascosto dall'utenza. 1 identifica un '''campo nascosto''', mai mostrato. 2 infine identifica un '''campo normale''', che può essere configurato nelle impostazioni.
|-
|-
| ''quickcreate'' || Impone se il campo debba comparire nella maschera di inserimento veloce o meno. <BR> Può assumere i valori 0 oppure 1. <BR> 0 Impone che il campo compaia nella maschera di creazione veloce. 1 nega la funzionalità.
| ''quickcreate'' || Impone se il campo debba comparire nella maschera di inserimento veloce o meno. <br /> Può assumere i valori 0 oppure 1. <br /> 0 Impone che il campo compaia nella maschera di creazione veloce. 1 nega la funzionalità.
|-
|-
| ''quickcreatesequence'' || Specifica l'ordine del controllo nella maschera di inserimento veloce.
| ''quickcreatesequence'' || Specifica l'ordine del controllo nella maschera di inserimento veloce.
|-
|-
| ''readonly'' || Specifica se il campo sia in sola lettura. <BR> Un valore pari a 0 identifica un capo in sola lettura, 1 un campo in lettura e scrittura.
| ''readonly'' || Specifica se il campo sia in sola lettura. <br /> Un valore pari a 0 identifica un capo in sola lettura, 1 un campo in lettura e scrittura.
|-
|-
| ''selected'' || Se il controllo sia attivo all'apertura della maschera. <BR> Dovrebbe esistere un unico controllo attivo per ogni maschera. <BR> Può assumere i valori 0 oppure 1. <BR> 0 Elegge il campo ad attivo mentre 1 lo nega.
| ''selected'' || Se il controllo sia attivo all'apertura della maschera. <br /> Dovrebbe esistere un unico controllo attivo per ogni maschera. <br /> Può assumere i valori 0 oppure 1. <br /> 0 Elegge il campo ad attivo mentre 1 lo nega.
|-
|-
| ''sequence'' || Impone l'ordine del controllo nella maschera di dettaglio.
| ''sequence'' || Impone l'ordine del controllo nella maschera di dettaglio.
| ''helpinfo'' || Messaggio associato allo help contestuale. Il testo che verrà mostrato avvicinandosi con il mouse al controllo.
| ''helpinfo'' || Messaggio associato allo help contestuale. Il testo che verrà mostrato avvicinandosi con il mouse al controllo.
|-
|-
| ''info_type'' || Tipologia di help contestuale <BR> Può assumere i valori '''BAS''' per un messaggio che comparirà in '''Basic Information''', oppure '''ADV''' se il messaggio dovrà comparire in '''More Information'''.
| ''info_type'' || Tipologia di help contestuale <br /> Può assumere i valori '''BAS''' per un messaggio che comparirà in '''Basic Information''', oppure '''ADV''' se il messaggio dovrà comparire in '''More Information'''.
|}
|}
{{footer_it | link_page=vtigercrm_field_properties}}
