The dashboard_message.properties file can be used to display custom messages on the various system dashboards by user role.
Note: this functionality is enabled by creating the necessary entries in the dashboard_message.properties file, which resides in your system's config directory. You cannot manage this functionality via the user interface.
This file can be viewed/edited with any standard text editor.
This file is not required.
The following items can be accomplished via dashboard_message.properties entries:
Display Custom Messages -- Administrators can use this feature to display messages on the various dashboards. Each message can be targeted to one or many dashboards as well as visible by specified user roles.
Note that you can include html tags within these messages for formatting or even include a link as in the example below:
<a href=”http://www.unanet.com” target=”_blank”>Unanet</a>
Note that on the properties that allow for the inclusion of HTML tags to provide formatting, here are a few basic tags that you might find useful.
For example, the following text included in a property...
<font color="red">This is red</font>
<b>This is bold</b>
<i>This is italic</i>
<font color="red"><b><i>This is red, bold and italic</i></b></font>
...would yield this output:
Notes:
If you want line breaks, you can use <br> tags (no closing tag required).
Remember to close each tag in the order you open them.
Most other html tags are valid (<p>, <div>, <table>, etc.), but you might want to keep it as simple as necessary to avoid the need for debugging.
Remember that this will not work in the messages that appear in pop up windows (the three submit confirmation pop ups) as these are not html.
You may also be interested in:
link.xml -- this file can be used to add a custom link (to an internal or external destination) onto a dashboard as well as to suppress the display of other left and right dashboard column entries.
The syntax necessary to create entries is defined in the example below (which is also available in the default dashboard_message.properties file included with the system).
############################################################################## # on. If not present, the message will show on all dashboards. # If multiple dashboards are desired, separate them with a pipe # symbol (|).
# Note: The "billing" value in the example below controls the # Invoicing & Posting Dashboard. Possible values are: # # login|home|organizations|projects|people|forcast|time|expense|financials| # accounts_payable|accounts_receivable|billing|general_ledger|admin|reports # # roles # Optional. Controls which type of user will see the message. If not # present, all roles will see this message. If multiple roles are # desired, separate them with a pipe symbol (|). The following is a # complete list of valid values. Remember, the tilde (~) at the end # of a role signifies an alternate for the listed role. # # administrator|manager|manager~|projectManager|projectManager~| # timesheetUser|timesheetUser~|expenseUser|expenseUser~|customer| # customer~|viewer|viewer~|unaSourceUser|unaSourceUser~| # costRateManager|costRateManager~|billRateManager|billRateManager~| # HRAdministrator|projectLead|projectLead~|projectApprover| # projectApprover~|projectController|prAdministrator|arAdmin| # arPoster|arUser|arViewer|apAdmin|apPoster|apUser|apViewer| # glAdmin|glPoster|glUser|glViewer|glBudgetManager # Example message for all administrators on the home and admin dashboards # Example message for alternate managers only on the People dashboard. |