[[fr:format_export_html|{{:wiki:flag_fr.png?45 }}]]

====== Export Server (HTML/PNG/CSV) Feature ======

**Updated for N4V 2025.2.10**

===== Description =====

  * Export the Need4Viz component into HTML, PNG and/or CSV format. You can export locally on N4V server or on web servers (intranet/extranet...) through UNC paths
  * If you need to export the Need4Viz component outside of SAP BusinessObjects to give access the information to users that don't have an SAP BusinessObjects user account, this feature will give you some great possibilities.

===== Server Configuration =====

Ask your Need4Viz Administrator to set the config.js file to activate the export server (HTML/PNG/CSV).

  * To enable the Export Server settings in the chart, you need to set **export_HTML** to "true"
  * If you need to use an external webserver for the Need4Viz static files, you need to set the **use_external_webapp_HTML** to "true" and define your external URL in the **URL_PORT_WebApp_ext_HTML** variable
  * You can define a list of authorized destination paths in the authorized folders parameter.
  * You can also display the list of authorized folders to the user (if they select a wrong folder, a message will be displayed in a popup) setting to true (or false) the display_autorized_folders parameter


===== Parameters =====

==== HTML export ====

  * **General**
    * //Automatically export the chart// : Check the box to export automatically the chart in HTML format each time it is refreshed
    * //Use default path configured by administrator// : Check the box to use the default path configured by your Need4Viz Administrator for all the HTML/PNG/CSV exports.
    * //Destination path (or completion of default path)// : Path accessible from the Need4Viz server(s) to save the file. Multiple paths can be set using the ";" separator. It can be an absolute path (if the folder is stored on the Need4Viz server) or an UNC path (folder on a NAS...). If the folder doesn't exist, it will be automatically created (the account executing Need4Viz services have to get necessary privileges to achieve it). If the //Use default path configured by administrator// is checked, you can complete this path with subfolders (they will be automatically created).
    * //Name of the generated target HTML file// : Filename (specify the .html extension) that will be used to save the file.
    * <color #ed1c24>//Warning//</color> : for safety reasons, path and filename will be put in lowercase and accented characters will be replaced by unaccented and special characters will be replaced by '_'. These options can however be modified in the general configuration of N4V FOR WEBI (ask your Need4Viz administrator for the modification).

  * **Navigation JS function in exported file**
    * //Use a custom JS function to navigate// : Check the box to enable navigation workflow in exported charts and define a custom JS function
    * //Navigation function name// : Name of the function that will be called during navigation. By default, the function name is "parent.click_link_ext". You need to implement this function in the main HTML page that contains your iframed chart. This function will receive an array containing the selected item(s) in the N4V component.
    * //Use a custom JS function to reset// : Check the box to enable reset workflow in exported charts (unselection of slice...) and define a custom JS function
    * //Reset function name// : Name of the function that will be called when unselection/reset. By default, the function name is "parent.click_linkres_ext". You need to implement this function in the main HTML page that contains your iframed chart. This function will receive an array containing the unselected item(s) in the N4V component.

  * **Change webapp URL**
    * //Replace N4VCustomElements webapp URL in the exported file// : Check the box if you want the default exported URL calling N4VCustomElements webapp to be changed for your export
    * //URL path of the webapp// : If you have checked the previous box, fill here the replacement URL to do in the exported file.
==== PNG export ====

  * **General**
    * //Automatically export the chart// : Check the box to export automatically the chart in PNG format each time it is refreshed
    * //Use default path configured by administrator// : Check the box to use the default path configured by your administrator for all the HTML/PNG/CSV exports.
    * //Destination path (or completion of default path)// : Path accessible from the Need4Viz server(s) to save the file. Multiple paths can be set using the ";" separator. It can be an absolute path (if the folder is stored on the Need4Viz server) or an UNC path (folder on a NAS...). If the folder doesn't exist, it will be automatically created (the account executing Need4Viz services have to get necessary privileges to achieve it). If the //Use default path configured by administrator// is checked, you can complete this path with subfolders (they will be automatically created).
    * //Name of the generated target PNG file// : Filename (specify the PNG extension) that will be used to save the file.
    * <color #ed1c24>//Warning//</color> : for safety reasons, path and filename will be put in lowercase and accented characters will be replaced by unaccented and special characters will be replaced by '_'. These options can however be modified in the general configuration of N4V FOR WEBI (ask your Need4Viz Administrator for the modification).

==== CSV export ====

  * **General**
    * //Automatically export the chart// : Check the box to export automatically the chart in PNG format each time it is refreshed
    * //Use default path configured by administrator// : Check the box to use the default path configured by your administrator for all the HTML/PNG/CSV exports.
    * //Destination path (or completion of default path)// : Path accessible from the Need4Viz server(s) to save the file. Multiple paths can be set using the ";" separator. It can be an absolute path (if the folder is stored on the Need4Viz server) or an UNC path (folder on a NAS...). If the folder doesn't exist, it will be automatically created (the account executing Need4Viz services have to get necessary privileges to achieve it). If the //Use default path configured by administrator// is checked, you can complete this path with subfolders (they will be automatically created).
    * //Name of the generated target CSV file// : Filename (specify the .csv extension) that will be used to save the file.
    * <color #ed1c24>//Warning//</color> : for safety reasons, path and filename will be put in lowercase and accented characters will be replaced by unaccented and special characters will be replaced by '_'. These options can however be modified in the general configuration of N4V (ask your Need4Viz Administrator for the modification).

  * **Format**
    * //Do not export header// : Check the box to not export the header of data in the CSV file
    * //Columns separator// : The default columns separator is the comma, you can change it here
    * //Text qualifier// : You can enclose the text fields with a text qualifier defined here (for example : ")
    * //Format//: Choose the digital export format here (1234.56 or 1234.56)


===== Animations =====

  * The component will be exported in HTML with the same features (animation, hide series, etc...) it has in SAP Web Intelligence

===== Related articles =====

KB articles to get more information :

  * Automate the Need4Viz HTML export / Use N4V Variables to generate dynamics path and filename : [[https://www.need4viz.com/support/kb/faq.php?id=19|Here]]