Frequently Asked Question

Symptom

• Configure an external Need4Viz Web Application to be used by exported HTML/FTP charts

Environment

• Windows Server
• Need4Viz : since 2021.3.1

Resolution

To configure Need4Viz to use an external webapp for exported charts (in HTML files generated by FTP/HTML export) :

1. Copy the entire N4VCustomElements webapp folder (~BOE_folder/tomcat/webapps) in the external web server that will be used by exported charts (Apache server for instance ~Apache/htdocs)
2. Get the URL for this new web server (ex.: http://my_external_server) and check in a browser that you can access the Need4Viz webapp in this web server by entering the URL http://my_external_server/N4VCustomElements/res/images/green_tick.png
3. The following image should appear : 
4. On the Need4Viz server, open the file ~Need4Viz_folder_installation/nodejs/node_modules/custom_element/ce_libs/config.js (make a backup copy before any update of this file)
5. Set the use_external_webapp_FTP parameter to true (to enable the usage of external webapp for FTP exports), or the use_external_webapp_HTML parameter to true (to enable the usage of external webapp for HTML exports)
6. Go to the //FTP Config section of this file
7. Fill the URL_PORT_WebApp_ext_FTP parameter (for FTP export) or the URL_PORT_WebApp_ext_HTML parameter (for HTML export) : the URL of the external web server (without ending '/'), for instance : 'http://my_external_server'. If a specific port need to be used, set it in the URL for instance : 'http://my_external_server:my_port'
8. Save the config.js file
9. Restart the Need4Viz services

Test an export (FTP or HTML) of a Need4Viz component and open it in a notepad++ editor. You should see the static includes in the file are set with your external web server.