PC SOFT

ONLINE HELP
FOR WINDEV, WEBDEV AND WINDEV MOBILE

Home | Sign in | English US
  • Overview
  • Customizing the errors
  • Customizing the error messages for all the sites
  • Customizing the error messages for a specific site
  • Priority order for the customization
  • How to proceed?
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaReports and QueriesUser code (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Browser code
WINDEV Mobile
AndroidAndroid Widget iPhone/iPadApple WatchUniversal Windows 10 AppWindows Mobile
Others
Stored procedures
Overview
The administrator of WEBDEV Development version allows you to customize the error messages of a WEBDEV site.
The custom error messages of a site are saved and automatically installed when deploying the WEBDEV site.
Versions 17 and later
Note: The page of site errors can also be customized from the WEBDEV project. See Managing the site errors for more details.
New in version 17
Note: The page of site errors can also be customized from the WEBDEV project. See Managing the site errors for more details.
Note: The page of site errors can also be customized from the WEBDEV project. See Managing the site errors for more details.
Customizing the errors
You have the ability to customize:
  • the error messages for all the sites.
  • the error messages for a specific site.

Customizing the error messages for all the sites

To customize the error messages for all the WEBDEV sites installed on the current computer (and on the Web server during the setup), choose "All the sites" in the "Site" combo box.
This customization applies to:
  • the text of error messages
  • the page displaying the error message

Customizing the error messages for a specific site

To customize the error message for a specific site installed on the current computer (and on the Web server during the setup), choose the name of your site in the "Site" combo box.
This customization applies to:
  • the text of error messages
  • the page displaying the error message

Priority order for the customization

The priority order for the customization is:
  1. customizing all the messages for all the sites installed on the server.
  2. customizing the messages for a specific site.
Caution: Customizing the error messages for all the sites is not recommended when using a shared server. Indeed, this modification will be applied to all the WEBDEV sites installed on the server.
How to proceed?
To customize the error messages:
  1. Select the site that must be customized (specific site or all the sites).
  2. To customize the page used for all the errors:
    By default, the errors are displayed in a specific page. To customize this page:
    • Choose the "Custom" option:
    • Select an HTML page accessible from your computer.
      This HTML page must be a static HTML page that may contain images, ...
      Two static controls are required in this page: These controls must respectively have the following tags for value: [%MSG%] and [%SYS%]. These controls will be replaced by the identifier and caption of the error.
      This HTML page should be found in the <ProjectName>_WEB directory of the project.
  3. To customize the error message and/or the error page:
    • Choose the error identifier: the default caption is displayed.
      To get an explanation about these messages, see Error messages that can be displayed in the browser.
    • Select "Custom caption" and enter the new caption associated with the option.
      Note: The special characters used in the messages:
      • the {RECONNECT} tag means that the Web user will be automatically connected once the error message is displayed.
      • the %x characters will be automatically replaced when the error message is displayed.
    • Select "HTML page" and select a specific HTML page to display this error.
      This HTML page must be a static HTML page that may contain images, ...
      These two static controls are required in this page: These controls must respectively have the following tags for value: [%MSG%] and [%SYS%] . These controls will be replaced by the identifier and caption of the error.
      This HTML page should be found in the <ProjectName>_WEB directory of the project.
  4. To apply the changes:
    • Click the "Apply" button to immediately apply the changes to the current computer.
    • Click the "Save" button to save the changes in a ".REG" file.
      If the selected site is a specific site, the configuration file is saved in the project directory.
      If the selected site is "All the sites", the configuration file is saved in the WEBDEV directory.
  5. To install the modified files:
    • If the customization applies to a specific site, the remote setup will automatically select the configuration file and will run it on the server. If the HTML file for customizing the error page is found in the directory of project images (<Project_Name>_Web), it will be automatically installed.
    • If the customization affects all the sites found on the server, you must:
      • Optional step: copy (if necessary) the HTML files of the error pages and the associated images to the Web server.
        These files must be found in a server directory for which an alias was defined.
      • copy and run the ERR_MSG_WEBDEV.REG file on the WEB server.
Caution: This customization is an advanced modification that requires knowledge in the management of Web servers.
Minimum required version
  • Version 10
Comments
Click [Add] to post a comment