Understanding the Servlet Properties File for m-Power Templates

 

The Servlet Properties File (also known as the mrc_servlet_config.xml file) is instrumental in controlling how your run-time applications connect to the correct database. This file is a data dictionary specific file, meaning that it is applicable only within the data dictionary you are currently in. This file works in conjunction with it's sister file, the Data Source Configuration file. More information about the Data Source Configuration file can be found here.

This file can be accessed from the "Admin Menu". Then click on "Edit Dictionary Files". From here, select "Servlet Properties".

NewGUIservletProp

This document will break each tab into separate sections and explain the key features. First up, Program Options:

ServletProperties1

tablename_fmt — By default, at runtime, your applications will attempt to use the same schema you used to develop your applications to run them. However, if you developed over a development library and wish to connect to a run-time library, please select "Table name only".

procname_fmt — Similar to what is written above, however rather than tables, this option controls Stored Procedures.

Note: In either case, if you choose to leave out the schema/library name, you must specify these libraries within the Data Source Configuration file so the servlets know where to connect.

email_server — If you wish to utilize the e-mail functionality that is available within mrc Reports, you must specify the location of your email server here.

email_sender — You also must specify a default email_sender as well. Without either of these two options, you will not be allowed to utilize the e-mail function.

Maintainer Message

ServletProperties2

The Maintainer Message section allows you to change any error message specific to Maintenance templates. If you want all the error messages for this particular data dictionary to be different than the default, please modify the specific line with regards to the correct error message.

Others

ServletProperties3

The Others tab contains the single most important field, and that is the datasource option. This option specifically ties back to the Data Source Configuration file to the id tag. Simply put, the value of the datasource option tells the current data dictionary how to connect to the correct database. Since mrc does not mandate your production environments, this is the only place where you tell your runtime applications how to connect to the database.

You can also change common images seen throughout our template, including the next, previous, ascending/descending buttons, etc..

Additionally, you can also change common error messages, such as "record-not-found" to something more specific, depending on your needs. You would simply change the text in the "Value" field.

When completed, press "OK". Then be sure to press the Save button. Because these are configuration changes, you must restart Tomcat before your changes will go into affect.

Notes: Changes made to this file apply to the current data dictionary. That is, any changes made to this file will not affect any other data dictionary except for the one you are in.

Note: This file can be found in this location on your system's drive: \mrcjava\WEB-INF\classes\NAME OF DATA DICTIONARY\ mrc_servlet_config.xml

Created: June 6, 2008 | Modified: June 12, 2017