Vtigercrm errors - Revision history

Wikiuser at 13:55, 21 March 2022

2022-03-21T13:55:12Z

← Older revision	Revision as of 13:55, 21 March 2022
(No difference)

Wikiuser: Partial page redesign

2016-04-15T14:21:06Z

Partial page redesign

← Older revision		Revision as of 14:21, 15 April 2016
Line 1:		Line 1:
	~~Welcome to Simone Giustetti's wiki pages.~~		{{header_en\|title=Some VtigerCRM common errors and their solutions\| keyword={{Template:keyword_en_vtigercrm}}\| description=A selection of common VtigerCRM errors and the respective solutions \| link_page=vtigercrm_errori}}


	~~Languages: '''English''' - [http://www.giustetti.net/wiki/index.php?title=vtigercrm_errori Italiano]~~		As a custom module developer for the '''VtigerCRM''' software I incurred in some errors while writing code; my goal here is to describe them as best as possible. I'll provide a brief description for each error: the error message, if available, and the solution to the problem. I'll try to provide even links to the project documentation when needs be.
			As a general rule to problem solving I'll suggest to set '''Php''' parameter '''error_reporting''' equal to '''E_ALL''' in order to test code. The '''VtigerCRM''' install program requires production suited parameter values that '''hide useful error messages'''. Parameter settings should be set accordingly to coder needs while development is in progress.
	~~----~~

	As a custom module developer for the '''~~VtigerCrm~~''' software I incurred in some errors while writing code; my goal here is to describe them as best as possible. I'll provide a brief description for each error: the error message, if available, and the solution to the problem. I'll try to provide even links to the project documentation when needs be.
	As a general rule to problem solving I'll suggest to set '''Php''' parameter '''error_reporting''' equal to '''E_ALL''' in order to test code. The '''~~VtigerCrm~~''' install program requires production suited parameter values that '''hide useful error messages'''. Parameter settings should be set accordingly to coder needs while development is in progress.


	== Error "ListView results in a blank screen" ==		== Error "ListView results in a blank screen" ==
	The issue arises after a module is created recurring to the '''Vtlib''' API, while inserting a new record into the data aware form. Data are saved, but at save completion '''~~VtigerCrm~~''' returns a blank screen instead of the usual detail view. The issue is related to the new custom module and does not affect the standard software behavior.		The issue arises after a module is created recurring to the '''Vtlib''' API, while inserting a new record into the data aware form. Data are saved, but at save completion '''VtigerCRM''' returns a blank screen instead of the usual detail view. The issue is related to the new custom module and does not affect the standard software behavior.

	: ''Tentative bug diagnosis:'' One out of the '''*.php''' files the module is made of, language and localization files included, ends with a blank line instead of the standard '''"?>" closing tag'''.		: ''Tentative bug diagnosis:'' One out of the '''*.php''' files the module is made of, language and localization files included, ends with a blank line instead of the standard '''"?>" closing tag'''.
Line 30:		Line 26:
	:::* A '''debugged''' password reset script can be found here: [http://www.giustetti.net/resource/script/vtiger521/ResetPassword.phpfile.gz Updated ResetPassword.phpfile.gz]		:::* A '''debugged''' password reset script can be found here: [http://www.giustetti.net/resource/script/vtiger521/ResetPassword.phpfile.gz Updated ResetPassword.phpfile.gz]
	:::* Decompress the archived script: '''gunzip''' ResetPassword.phpfile.gz		:::* Decompress the archived script: '''gunzip''' ResetPassword.phpfile.gz
	:::* Copy the resulting file in '''~~VtigerCrm~~''' root directory.		:::* Copy the resulting file in '''VtigerCRM''' root directory.
	:::* Rename file in '''ResetPassword.php'''		:::* Rename file in '''ResetPassword.php'''
	:::* Open file '''ResetPassword.php''' with a text editor of choice and update parameter '''$configuredAppKey'''. Set its value equal to the one of parameter '''$application_unique_key''' which can be found in the main configuration file: '''config.inc.php'''.		:::* Open file '''ResetPassword.php''' with a text editor of choice and update parameter '''$configuredAppKey'''. Set its value equal to the one of parameter '''$application_unique_key''' which can be found in the main configuration file: '''config.inc.php'''.
Line 74:		Line 70:


	~~----~~		{{footer_en \| link_page=vtigercrm_errori}}

	~~Languages: '''English''' - [http://www.giustetti.net/wiki/index.php?title~~=vtigercrm_errori ~~Italiano]~~

Wikiuser at 13:06, 5 August 2013

2013-08-05T13:06:15Z

← Older revision		Revision as of 13:06, 5 August 2013
Line 23:		Line 23:


	== ~~Errore~~ "No user other than admin can log-in" ==		== Error "No user other than admin can log-in" ==
	'''No user other than admin''' can log-in to the CRM following a release upgrade or a back-up data restore. The following error message appears on screen: "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". The software redirects to password reset script in a [https://wiki.vtiger.com/index.php/520:Upgrading_to_PHP_5.3 Vtiger Wiki page]. Sadly running the script results in no effect.		'''No user other than admin''' can log-in to the CRM following a release upgrade or a back-up data restore. The following error message appears on screen: "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". The software redirects to password reset script in a [https://wiki.vtiger.com/index.php/520:Upgrading_to_PHP_5.3 Vtiger Wiki page]. Sadly running the script results in no effect.

Wikiuser: Added error "Not unique table/alias" to the VtigerCRM error page

2013-08-05T13:05:29Z

Added error "Not unique table/alias" to the VtigerCRM error page

@@ Line 20: / Line 20: @@
 ::: The INSERT clause should consist of the following data: (1st available identifier, '<module_name>', 'include/Webservices/VtigerModuleOperation.php', 'VtigerModuleOperation', 1) .
 :: '''Solution 2:''' Rewrite the module creation code inserting a call to function '''$'''<module>'''->initWebservice();''' in the line following the '''$'''<module>'''->save();''' instruction. The function will populate table '''vtiger_ws_entity''' with the proper data.
 ----
@@ Line 47: / Line 36: @@
 :::: '''php''' ''-f'' ./ResetPassword.php
 :::* Once done remove the script.
 ----

Wikiuser: Created page with 'Welcome to Simone Giustetti's wiki pages. Languages: '''English''' - [http://www.giustetti.net/wiki/index.php?title=vtigercrm_errori Italiano] ---- As a custom module develop…'

2012-07-20T18:08:09Z

Created page with 'Welcome to Simone Giustetti's wiki pages. Languages: '''English''' - [http://www.giustetti.net/wiki/index.php?title=vtigercrm_errori Italiano] ---- As a custom module develop…'

New page

Welcome to Simone Giustetti's wiki pages.

Languages: '''English''' - [http://www.giustetti.net/wiki/index.php?title=vtigercrm_errori Italiano]

----

As a custom module developer for the '''VtigerCrm''' software I incurred in some errors while writing code; my goal here is to describe them as best as possible. I'll provide a brief description for each error: the error message, if available, and the solution to the problem. I'll try to provide even links to the project documentation when needs be.
As a general rule to problem solving I'll suggest to set '''Php''' parameter '''error_reporting''' equal to '''E_ALL''' in order to test code. The '''VtigerCrm''' install program requires production suited parameter values that '''hide useful error messages'''. Parameter settings should be set accordingly to coder needs while development is in progress.

== Error "ListView results in a blank screen" ==
The issue arises after a module is created recurring to the '''Vtlib''' API, while inserting a new record into the data aware form. Data are saved, but at save completion '''VtigerCrm''' returns a blank screen instead of the usual detail view. The issue is related to the new custom module and does not affect the standard software behavior.

: ''Tentative bug diagnosis:'' One out of the '''*.php''' files the module is made of, language and localization files included, ends with a blank line instead of the standard '''"?>" closing tag'''.
:: '''Solution:''' Remove all blank lines after tag '''"?>"'''.

: ''Tentative bug diagnosis:'' An entry for the custom module is missing from table '''vtiger_ws_entity'''.
:: '''Solution:''' Add a record for the missing module into table '''vtiger_ws_entity''' recurring to a proper SQL clause.
::: The INSERT clause should consist of the following data: (1st available identifier, '<module_name>', 'include/Webservices/VtigerModuleOperation.php', 'VtigerModuleOperation', 1) .
:: '''Solution 2:''' Rewrite the module creation code inserting a call to function '''$'''<module>'''->initWebservice();''' in the line following the '''$'''<module>'''->save();''' instruction. The function will populate table '''vtiger_ws_entity''' with the proper data.
----

== Error "You are not permitted to execute this Operation" ==
Any action taken against the custom module fails returning error "You are not permitted to execute this Operation" to screen. The issue is related to the new custom module and does not affect the standard software behavior.

: ''Tentative bug diagnosis:'' Php scripts are affected by a lack of permissions.
:: '''Solution:''' Check for the script user and group to be the '''same which run the Web Server''' otherwise reassign user and group. If the user / group change were not decisive, temporarily assign permission '''755''' the the scripts in order to perform further checks. Please recover previous permissions at check completion. Granting higher than required permissions is a bad option when dealing with production environments connected to the Internet and could result in a security risk. The practice should be avoided for hosts other than development and test ones.

: ''Tentative bug diagnosis:'' The unique identifier for the related entity consists of multiple fields, but only some are flagged as "Required".
:: '''Solution:''' Update file <entity>.php setting '''$required_fields''' value equal to the parameter list passed to '''Vtlib''' function '''setEntityIdentifier''' in the module creation code.
----

== Errore "No user other than admin can log-in" ==
'''No user other than admin''' can log-in to the CRM following a release upgrade or a back-up data restore. The following error message appears on screen: "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". The software redirects to password reset script in a [https://wiki.vtiger.com/index.php/520:Upgrading_to_PHP_5.3 Vtiger Wiki page]. Sadly running the script results in no effect.

: ''Tentative bug diagnosis:'' Software release 5.2.1 was developed for '''Php 5.3.X''' release 5.1.0 for '''Php 5.2.X''' instead. Php release 5.3.X introduced a new '''Crypto API''' resulting in an updated and not backward compatible authentication subsystem.
:: '''Solution:''' Follow the procedure found in the redirect page.
:::* A '''debugged''' password reset script can be found here: [http://www.giustetti.net/resource/script/vtiger521/ResetPassword.phpfile.gz Updated ResetPassword.phpfile.gz]
:::* Decompress the archived script: '''gunzip''' ResetPassword.phpfile.gz
:::* Copy the resulting file in '''VtigerCrm''' root directory.
:::* Rename file in '''ResetPassword.php'''
:::* Open file '''ResetPassword.php''' with a text editor of choice and update parameter '''$configuredAppKey'''. Set its value equal to the one of parameter '''$application_unique_key''' which can be found in the main configuration file: '''config.inc.php'''.
:::* Execute the script through a browser or running '''Php''' from the '''command line''':
:::: '''php''' ''-f'' ./ResetPassword.php
:::* Once done remove the script.
----

For any feedback, questions, errors and such, please e-mail me at ''studiosg [at] giustetti [dot] net''.

----

Languages: '''English''' - [http://www.giustetti.net/wiki/index.php?title=vtigercrm_errori Italiano]