1,415
edits
Changes
Created page with 'Benvenuti nella pagina Wiki di Simone Giustetti. Languages: [http://www.giustetti.net/wiki/index.php?title=vtigercrm_errors English] - '''Italiano''' ---- Nella pagina che se…'
Benvenuti nella pagina Wiki di Simone Giustetti.
Languages: [http://www.giustetti.net/wiki/index.php?title=vtigercrm_errors English] - '''Italiano'''
----
Nella pagina che segue sono elencati alcuni errori in cui mi sono imbattuto sviluppando estensioni per '''VtigerCrm'''. Per ogni errore verrà riportato il relativo messaggio, se disponibile, una breve descrizione e la soluzione adottata comprensiva dei riferimenti alla documentazione consultata. Come linea guida generale alla risoluzione dei problemi consiglio di impostare il parametro '''error_reporting''' di '''Php''' al valore '''E_ALL''' per testare in maniera puntuale il codice prodotto. Le impostazioni richieste dal programma di installazione di '''VtigerCrm''' sono adeguate per un sito di produzione, ma '''nascondono messaggi di errore che possono risultare fondamentali in fase di sviluppo'''.
== Errore "ListView rende schermata bianca" ==
Il problema si presenta a seguito della creazione di un nuovo modulo tramite codice '''Vtlib''', al momento di inserire nuovi dati nelle maschere preposte. I Dati vengono salvati correttamente, ma '''VtigerCrm rende una schermata bianca anzichè l'usuale vista di dettaglio'''. La problematica interessa esclusivamente il modulo personalizzato e non intacca il funzionamento generale del programma.
: ''Causa potenziale:'' Un qualsiasi file '''*.php''' facente parte del modulo, inclusi i file contenenti le traduzioni e le localizzazioni, termina con una riga vuota anzichè con il corretto '''tag di chiusura "?>"'''.
:: '''Soluzione:''' Rimuovere tutte le righe vuote eventualmente presenti dopo il tag '''"?>"''' in coda ai file.
: ''Causa potenziale:'' Nella tabella '''vtiger_ws_entity''' manca una voce dedicata al modulo personalizzato.
:: '''Soluzione:''' Aggiungere la voce mancante nella tabella '''vtiger_ws_entity''' tramite opportune istruzioni SQL.
::: L'istruzione INSERT dovrebbe comprendere i dati che seguono: (1° identificatore libero, '<nome_modulo>', 'include/Webservices/VtigerModuleOperation.php', 'VtigerModuleOperation', 1) .
:: '''Soluzione alternativa:''' Modificare il codice di creazione del modulo perchè esegua una chiamata alla funzione '''$'''<module>'''->initWebservice();''' immediatamente dopo aver eseguito l'istruzione '''$'''<module>'''->save();'''. La funzione popolerà la tabella '''vtiger_ws_entity''' con i dati corretti.
----
== Errore "You are not permitted to execute this Operation" ==
Qualsiasi operazione eseguita sul modulo personalizzato fallisce rendendo l'errore "You are not permitted to execute this Operation" a video. Il problema è circoscritto al modulo personalizzato e non intacca il funzionamento generale del programma.
: ''Causa potenziale:'' Un problema di permessi inerente gli script Php.
:: '''Soluzione:''' Verificare che l'utente ed il gruppo cui appartengono gli script siano '''i medesimi con cui viene eseguito il Web Server''' e riassegnare le utenze in caso contrario. Se una prima verifica non producesse esiti soddisfacenti, è possibile assegnare temporaneamente permessi '''757''' agli script per eseguire ulteriori controlli. I permessi originali dovrebbero essere ripristinati a controlli ultimati. L'assegnazione di permessi eccessivi è comunque sconsigliata in ambienti di produzione, che verrebbero esposti a rischi di sicurezza, e dovrebbe essere impiegata solo su installazioni di sviluppo e test.
: ''Causa potenziale:'' L'identificatore univoco per l'entità su cui si sta operando è costituito da più campi e non tutti sono classificati obbligatori.
:: '''Soluzione:''' Modificare il file <entità>.php impostando il valore del parametro '''$required_fields''' uguale a quello passato alla funzione '''setEntityIdentifier''' della '''Vtlib''' in fase di creazione del modulo.
----
== Errore "Nessun utente tranne admin riesce a collegarsi" ==
A seguito di un upgrade di versione o di un ripristino dati da una copia di back-up '''nessun utente tranne admin''' riesce a collegarsi al CRM. Il programma rende il seguente messaggio di errrore a video: "You have updated your php version. due changes in crypt API your password is no longer applicable, please reset your password. you can reset password for all users using a script and set it to thier respective user names. Please Click here". Il programma reindirizza ad una [https://wiki.vtiger.com/index.php/520:Upgrading_to_PHP_5.3 pagina del Wiki di Vtiger] da cui e' possibile scaricare uno script per ripristinare le password di tutti gli utenti. Purtroppo lo script non produce l'effetto sperato.
: ''Causa potenziale:'' La versione 5.2.1 del programma è stata pensata e sviluppata per lavorare con '''Php 5.3.X''' mentre la 5.1.0 era stata sviluppata per '''Php 5.2.X'''. Aggiornando la versione si aggiorna la '''Crypto API''' cambiando così il sottosistema di autenticazione.
:: '''Soluzione:''' Seguire la procedura riportata al link cui si viene reindirizzati.
:::* Una '''versione corretta''' dello script e' reperibile all'indirizzo: [http://www.giustetti.net/resource/script/vtiger521/ResetPassword.phpfile.gz Updated ResetPassword.phpfile.gz]
:::* Decomprimere lo script: '''gunzip''' ResetPassword.phpfile.gz
:::* Copiare il file ottenuto nella directory di installazione di VtigerCrm.
:::* Rinominare il file in '''ResetPassword.php'''
:::* Aprire il file '''ResetPassword.php''' con un editor di testo e modificare il valore del parametro '''$configuredAppKey'''. Imporlo uguale al valore del parametro '''$application_unique_key''' reperibile nel file di configurazione principale: '''config.inc.php'''.
:::* Eseguire lo script richiamandolo da una finestra del browser oppure lanciando '''Php''' da '''riga di comando''':
:::: '''php''' ''-f'' ./ResetPassword.php
:::* Rimuovere lo script in modo che non possa essere eseguito una seconda volta per errore.
----
Per commenti, consigli, domande inviate una e-mail all'indirizzo ''studiosg [chiocciola] giustetti [punto] net''.
----
Languages: [http://www.giustetti.net/wiki/index.php?title=vtigercrm_errors English] - '''Italiano'''
Languages: [http://www.giustetti.net/wiki/index.php?title=vtigercrm_errors English] - '''Italiano'''
----
Nella pagina che segue sono elencati alcuni errori in cui mi sono imbattuto sviluppando estensioni per '''VtigerCrm'''. Per ogni errore verrà riportato il relativo messaggio, se disponibile, una breve descrizione e la soluzione adottata comprensiva dei riferimenti alla documentazione consultata. Come linea guida generale alla risoluzione dei problemi consiglio di impostare il parametro '''error_reporting''' di '''Php''' al valore '''E_ALL''' per testare in maniera puntuale il codice prodotto. Le impostazioni richieste dal programma di installazione di '''VtigerCrm''' sono adeguate per un sito di produzione, ma '''nascondono messaggi di errore che possono risultare fondamentali in fase di sviluppo'''.
== Errore "ListView rende schermata bianca" ==
Il problema si presenta a seguito della creazione di un nuovo modulo tramite codice '''Vtlib''', al momento di inserire nuovi dati nelle maschere preposte. I Dati vengono salvati correttamente, ma '''VtigerCrm rende una schermata bianca anzichè l'usuale vista di dettaglio'''. La problematica interessa esclusivamente il modulo personalizzato e non intacca il funzionamento generale del programma.
: ''Causa potenziale:'' Un qualsiasi file '''*.php''' facente parte del modulo, inclusi i file contenenti le traduzioni e le localizzazioni, termina con una riga vuota anzichè con il corretto '''tag di chiusura "?>"'''.
:: '''Soluzione:''' Rimuovere tutte le righe vuote eventualmente presenti dopo il tag '''"?>"''' in coda ai file.
: ''Causa potenziale:'' Nella tabella '''vtiger_ws_entity''' manca una voce dedicata al modulo personalizzato.
:: '''Soluzione:''' Aggiungere la voce mancante nella tabella '''vtiger_ws_entity''' tramite opportune istruzioni SQL.
::: L'istruzione INSERT dovrebbe comprendere i dati che seguono: (1° identificatore libero, '<nome_modulo>', 'include/Webservices/VtigerModuleOperation.php', 'VtigerModuleOperation', 1) .
:: '''Soluzione alternativa:''' Modificare il codice di creazione del modulo perchè esegua una chiamata alla funzione '''$'''<module>'''->initWebservice();''' immediatamente dopo aver eseguito l'istruzione '''$'''<module>'''->save();'''. La funzione popolerà la tabella '''vtiger_ws_entity''' con i dati corretti.
----
== Errore "You are not permitted to execute this Operation" ==
Qualsiasi operazione eseguita sul modulo personalizzato fallisce rendendo l'errore "You are not permitted to execute this Operation" a video. Il problema è circoscritto al modulo personalizzato e non intacca il funzionamento generale del programma.
: ''Causa potenziale:'' Un problema di permessi inerente gli script Php.
:: '''Soluzione:''' Verificare che l'utente ed il gruppo cui appartengono gli script siano '''i medesimi con cui viene eseguito il Web Server''' e riassegnare le utenze in caso contrario. Se una prima verifica non producesse esiti soddisfacenti, è possibile assegnare temporaneamente permessi '''757''' agli script per eseguire ulteriori controlli. I permessi originali dovrebbero essere ripristinati a controlli ultimati. L'assegnazione di permessi eccessivi è comunque sconsigliata in ambienti di produzione, che verrebbero esposti a rischi di sicurezza, e dovrebbe essere impiegata solo su installazioni di sviluppo e test.
: ''Causa potenziale:'' L'identificatore univoco per l'entità su cui si sta operando è costituito da più campi e non tutti sono classificati obbligatori.
:: '''Soluzione:''' Modificare il file <entità>.php impostando il valore del parametro '''$required_fields''' uguale a quello passato alla funzione '''setEntityIdentifier''' della '''Vtlib''' in fase di creazione del modulo.
----
== Errore "Nessun utente tranne admin riesce a collegarsi" ==
A seguito di un upgrade di versione o di un ripristino dati da una copia di back-up '''nessun utente tranne admin''' riesce a collegarsi al CRM. Il programma rende il seguente messaggio di errrore a video: "You have updated your php version. due changes in crypt API your password is no longer applicable, please reset your password. you can reset password for all users using a script and set it to thier respective user names. Please Click here". Il programma reindirizza ad una [https://wiki.vtiger.com/index.php/520:Upgrading_to_PHP_5.3 pagina del Wiki di Vtiger] da cui e' possibile scaricare uno script per ripristinare le password di tutti gli utenti. Purtroppo lo script non produce l'effetto sperato.
: ''Causa potenziale:'' La versione 5.2.1 del programma è stata pensata e sviluppata per lavorare con '''Php 5.3.X''' mentre la 5.1.0 era stata sviluppata per '''Php 5.2.X'''. Aggiornando la versione si aggiorna la '''Crypto API''' cambiando così il sottosistema di autenticazione.
:: '''Soluzione:''' Seguire la procedura riportata al link cui si viene reindirizzati.
:::* Una '''versione corretta''' dello script e' reperibile all'indirizzo: [http://www.giustetti.net/resource/script/vtiger521/ResetPassword.phpfile.gz Updated ResetPassword.phpfile.gz]
:::* Decomprimere lo script: '''gunzip''' ResetPassword.phpfile.gz
:::* Copiare il file ottenuto nella directory di installazione di VtigerCrm.
:::* Rinominare il file in '''ResetPassword.php'''
:::* Aprire il file '''ResetPassword.php''' con un editor di testo e modificare il valore del parametro '''$configuredAppKey'''. Imporlo uguale al valore del parametro '''$application_unique_key''' reperibile nel file di configurazione principale: '''config.inc.php'''.
:::* Eseguire lo script richiamandolo da una finestra del browser oppure lanciando '''Php''' da '''riga di comando''':
:::: '''php''' ''-f'' ./ResetPassword.php
:::* Rimuovere lo script in modo che non possa essere eseguito una seconda volta per errore.
----
Per commenti, consigli, domande inviate una e-mail all'indirizzo ''studiosg [chiocciola] giustetti [punto] net''.
----
Languages: [http://www.giustetti.net/wiki/index.php?title=vtigercrm_errors English] - '''Italiano'''