Difference between revisions of "Vtigercrm proprietà dei campi"

From Studiosg
Jump to navigationJump to search
 
(3 intermediate revisions by the same user not shown)
Line 1: Line 1:
Benvenuti nella pagina Wiki di Simone Giustetti.
+
{{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}}
  
  
Lingue: [http://www.giustetti.net/wiki/index.php?title=vtigercrm_field_properties English] - '''Italiano'''
+
[[vtigercrm_intro#Funzionamento_interno_di_VtigerCRM | Funzionamento interno di VtigerCRM]]
  
----
 
  
[[vtigercrm_intro#Funzionamento_interno_di_VtigerCrm]]
+
== Campi - Proprietà ==
  
== 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&ograve; 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&agrave; 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&ograve; 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&agrave; 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&agrave; utilizzata la nomenclatura '''vtiger_'''<nome del modulo>.  
+
| ''table'' || La tabella in cui creare la colonna. <br /> Per un modulo standard verr&agrave; 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 &egrave; specificata attraverso una stringa '''X~Y''' ove X &egrave; '''la tipologia del dato''', mentre Y Pu&ograve; assumere i valori '''M''' per obbligatorio o '''O''' per opzionale.
+
| ''typeofdata'' || La formattazione del dato mostrato nelle maschere. <br /> La formattazione &egrave; specificata attraverso una stringa '''X~Y''' ove X &egrave; '''la tipologia del dato''' (Vedere [[vtigercrm_tipi_di_dato | Tipi di dato di VtigerCRM 5]]), mentre Y Pu&ograve; assumere i valori '''M''' per obbligatorio o '''O''' per opzionale.
 
|-
 
|-
| ''uitype'' || Il Widget che verr&agrave; mostrato nelle maschere.
+
| ''uitype'' || Il Widget che verr&agrave; mostrato nelle maschere (Vedere [[vtigercrm_tipi_di_widget | Widget di VtigerCRM 5]]).
 
|-
 
|-
| ''displaytype'' || Impone in quali maschere debba essere mostrato il campo. <BR> Pu&ograve; 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&ograve; 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&ograve; 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&agrave;.
+
| ''masseditable'' || Impone se il campo debba comparire nella maschera di Mass Edit. <br /> Pu&ograve; 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&agrave;.
 
|-
 
|-
| ''presence'' || Classifica la natura del campo. <BR> Pu&ograve; assumere valori da 0 a 2. <BR> 0 identifica un '''campo di sistema''' che non pu&ograve; essere nascosto dall'utenza. 1 identifica un '''campo nascosto''', mai mostrato. 2 infine identifica un '''campo normale''', che pu&ograve; essere configurato nelle impostazioni.
+
| ''presence'' || Classifica la natura del campo. <br /> Pu&ograve; assumere valori da 0 a 2. <br /> 0 identifica un '''campo di sistema''' che non pu&ograve; essere nascosto dall'utenza. 1 identifica un '''campo nascosto''', mai mostrato. 2 infine identifica un '''campo normale''', che pu&ograve; essere configurato nelle impostazioni.
 
|-
 
|-
| ''quickcreate'' || Impone se il campo debba comparire nella maschera di inserimento veloce o meno. <BR> Pu&ograve; assumere i valori 0 oppure 1. <BR> 0 Impone che il campo compaia nella maschera di creazione veloce. 1 nega la funzionalit&agrave;.
+
| ''quickcreate'' || Impone se il campo debba comparire nella maschera di inserimento veloce o meno. <br /> Pu&ograve; assumere i valori 0 oppure 1. <br /> 0 Impone che il campo compaia nella maschera di creazione veloce. 1 nega la funzionalit&agrave;.
 
|-
 
|-
 
| ''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&ograve; 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&ograve; 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.
Line 51: Line 51:
 
| ''helpinfo'' || Messaggio associato allo help contestuale. Il testo che verr&agrave; mostrato avvicinandosi con il mouse al controllo.
 
| ''helpinfo'' || Messaggio associato allo help contestuale. Il testo che verr&agrave; mostrato avvicinandosi con il mouse al controllo.
 
|-
 
|-
| ''info_type'' || Tipologia di help contestuale <BR> Pu&ograve; assumere i valori '''BAS''' per un messaggio che comparir&agrave; in '''Basic Information''', oppure '''ADV''' se il messaggio dovr&agrave; comparire in '''More Information'''.
+
| ''info_type'' || Tipologia di help contestuale <br /> Pu&ograve; assumere i valori '''BAS''' per un messaggio che comparir&agrave; in '''Basic Information''', oppure '''ADV''' se il messaggio dovr&agrave; comparire in '''More Information'''.
 
|}
 
|}
  
Line 58: Line 58:
  
  
----
+
{{footer_it | link_page=vtigercrm_field_properties}}
 
 
Lingue: [http://www.giustetti.net/wiki/index.php?title=vtigercrm_field_properties English] - '''Italiano'''
 

Latest revision as of 13:52, 21 March 2022

Benvenuti nella pagina Wiki di Simone Giustetti.


Lingue: English - Italiano



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.


PROPRIETÀ DEI CAMPI
Proprietà Descrizione
name Obbligatorio per ogni campo. Deve essere univoco.
column La colonna della base dati a cui legare il campo della pagina.
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.
generatedtype Specifica se il campo sia predefinito oppure una personalizzazione aggiunta dall'utenza.
Durante lo sviluppo di un nuovo modulo tutti i campi risulteranno predefiniti.
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.
VtigerCRM utilizza il valore specificato come chiave dello array $mod_strings che viene utilizzato per le traduzioni del programma.
Sviluppando un nuovo modulo si dovrebbe imporre un nome in inglese.
table La tabella in cui creare la colonna.
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.
typeofdata La formattazione del dato mostrato nelle maschere.
La formattazione è specificata attraverso una stringa X~Y ove X è la tipologia del dato (Vedere 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 Widget di VtigerCRM 5).
displaytype Impone in quali maschere debba essere mostrato il campo.
Può assumere i valori da 1 a 4.
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.
Può assumere i valori 0 oppure 1.
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.
Può assumere valori da 0 a 2.
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.
Può assumere i valori 0 oppure 1.
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.
readonly Specifica se il campo sia in sola lettura.
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.
Dovrebbe esistere un unico controllo attivo per ogni maschera.
Può assumere i valori 0 oppure 1.
0 Elegge il campo ad attivo mentre 1 lo nega.
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.
info_type Tipologia di help contestuale
Può assumere i valori BAS per un messaggio che comparirà in Basic Information, oppure ADV se il messaggio dovrà comparire in More Information.


Per commenti, consigli, domande inviate una e-mail all'indirizzo studiosg [chiocciola] giustetti [punto] net.



Lingue: English - Italiano