MINT Customised Files

From IMSMA Wiki
Jump to navigation Jump to search

This is the exhaustive list of all customized. files in MINT/JasperReports Server. When upgrading to a new version, all these files must be changed according to the instructions.

Path File name Comment
WEB-INF\decorators decorators.jsp Changed application title; Logic to add the company name on the banner and the div bannerWrapper to centre the header
WEB-INF\jsp\modules\login loginHelp.jsp Changed message in the Need help logging in dialog
WEB-INF\jsp\modules\login\rotating login_rotating_pro_0.jsp Adapt which rotating login messages to display
WEB-INF\jsp\templates control_tabSet.jsp Needed for dashboards in tabs, still to be checked and corrected
WEB-INF\jsp\modules commonJSTLScripts.jsp Needed for dashboards in tabs, still to be checked and corrected
WEB-INF\bundles jasperserver_messages.properties Added properties and changed values. This defines the text messages shown on the MINT login page/welcome screen.
WEB-INF\jsp\modules\home home.jsp Defines the login (home) page
WEB-INF\jsp\modules\home\custom all files Organization-specific custom landing pages
WEB-INF js.config.properties deploy.base.url=http://mint.gichd.org/mint
WEB-INF\bundles All jasperserver_message.properties files All the language properties files (e.g. WEB-INF\bundles\jasperserver_messages_fr.properties have been renamed to xxBKP.properties, e.g. WEB-INF\bundles\jasperserver_messages_frBKP.properties). This way, the default MINT text (English) is always displayed, regardless of the regional browser settings. Otherwise, the default Jaspersoft text would be displayed if the browser is set to a language for which a translation of the standard Jasper text exists. In the future, the customised MINT text can be translated to other languages.
WEB-INF js.quartz.properties Contains the email configuration (reference to other documentation!)
WEB-INF applicationContext-report-scheduling.xml Also needed for the email config, put ref to other documentation!
WEB-INF jasperserver-servlet.xml This file sets the change password link to true (in order to display the change password link on the login page) and sets the following property to false (default is true), in order to prevent users to store their password in the browser: <property name="autoCompleteLoginForm" value="false"/>
WEB-INF applicationContext-security-web.xml set the <property name="showStacktraceMessage" value="false"/> to false (default is true) in order to disable the display of stack trace messages. Stack traces reveal some information about the application, and security experts recommend that an application not display them.
WEB-INF\classes\esapi security-config.properties set encryption.on=true (default: false) in order to turn on user session login encryption.
WEB-INF js.config .properties set feature.audit_monitoring.enabled=true and audit.records.enabled=true and monitoring.records.enabled=true to enable auditing and monitoring
WEB-INF applicationContext-audit.xml TODO
WEB-INF applicationContext-remote-services.xml in the element <util:set id="customDataSourcesToHide">, comment out jsonDataSource and jsonSeriesDataSource in order to allow file-based data sources (cf. MARS-MINT integration).
\scripts\bower_components\bi-report\src\bi\report\jive\view GooglemapComponentView.js All occurrences of "http://maps.google.com..." need to be replace by "//maps.google.com"
\optimized-scripts\bower_components\bi-report\src\bi\report\jive\view GooglemapComponentView.js All occurrences of "http://maps.google.com..." need to be replace by "//maps.google.com"
net\sf\jasperreports\components\map\resources\require jasperreports-map.js All occurrences of "http://maps.google.com..." need to be replace by "//maps.google.com". This change is to be done in a jar archive. Steps:
  1. Copy jasperreports-6.x.jar from E:\apache-tomcat-8.0.32\webapps\mint\WEB-INF\lib to any location
  2. Open a command window and go to the directory where the jar is copied to
  3. run: jar xf jasperreports-6.x.jar (this extracts all the files contained in the jar)
  4. Make the changes to the files as required as save the files
  5. run: jar cf jasperreports-6.x.jar * (this re-created the jar archive)
  6. Copy the new jar back to its original directory
  7. Restart the Tomcat
net\sf\jasperreports\components\map\resources\templates MapElementHtmlTemplate.vm All occurrences of "http://maps.google.com..." need to be replace by "//maps.google.com". Change to be made in the jar archive, cf. above.

Template:NavBox Hub