Difference between revisions of "Vtigercrm proprietà dei campi"
From Studiosg
Jump to navigationJump to search| (2 intermediate revisions by the same user not shown) | |||
| Line 1: | Line 1: | ||
| − | + | {{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. < | + | | ''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. < | + | | ''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. < | + | | ''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. < | + | | ''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. < | + | | ''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. | + | | ''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. < | + | | ''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. < | + | | ''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. < | + | | ''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. < | + | | ''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. < | + | | ''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. < | + | | ''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. | ||
| Line 51: | Line 51: | ||
| ''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 < | + | | ''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'''. |
|} | |} | ||
| Line 58: | Line 58: | ||
| − | + | {{footer_it | link_page=vtigercrm_field_properties}} | |
| − | |||
| − | |||
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à | 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
