unanet.properties Definitions

The unanet.properties file is located on your web server, in the Unanet installation directory, in a subdirectory called properties.

Note:  when defining your parameters, enter the parameter name, followed by the equals symbol ("="), and your overridding value with no spaces.   For example, if setting the email option to true, you would enter:  unatime.email=true   Do not enter as:  unatime.email = true.  Also, the parameter names and values are case sensative unless otherwise noted.


Parameter Name Description Default Value
unanet.splash.src This field must be the full URL to an image you want displayed on the Unanet Login Screen.  An image, that if your type in this URL on a browser, you will see that image on your browser.  Example:  http://www.domain.com/images/picture.gif
unanet.splash.url The full URL of the target destination you want the user to go to if they click on the image defined in the unanet.splash.src parameter.  Example:  http://www.domain.com/my_home_page.html
unanet.splash.alt The description, or help text, displayed in the browser when the user hovers the mouse over the image defined in the unanet.splash.src parameter.
unanet.splash.target This defines where to open the target URL defined by the unanet.splash.url parameter.  The value should have one of the following values:  (1) _self : Open in the Same Frame, (2) _top : Open in current browser, but take up the whole page, (3) _blank : Open in a new browser, (4) _parent : Open in the parent frame. _blank
unatime.email If true, this enables Unanet to send E-mail messages. If false, then the E-mail option is disabled, and Unanet will never attempt to send out any E-mails.  If you do not want to use the E-mail option, then you should set this parameter to false, or remove it, or comment out the line.  NOTE: Even though the parameter name is unatime.email, it works system wide with Una$ense and UnaTime. false
mail.host If unatime.email is set to true, then you will have todefine your mail server.  This is the name of you SMTP Server.  Your network administrator should be able to provide you this information.  An example would be something like:  mail.host=servername.domain.com <blank>
unatime.email.default_from_address If the system can not determine a valid From E-mail address when sending a message, then the system will use this E-mail Default From Address.  It could be an administrator mail account, like admin@abc.com. <blank>
unatime.audit If true, this enables the UnaTime to keep track with any changes the users make on their Timesheet and prompts the user to enters comments for the reason of the change.  these changes are kept in a table and displayed on the preview page of the timesheet.

false

unasense.purpose.required Refers to the purpose field on the Expense Report in Una$ense.  If true, then this is a required field in the system.  If false, then the field can be left blank. false
unasense.location.required Refers to the location field on the Expense Report in Una$ense.  If true, then this is a required field in the system.  If false, then the field can be left blank. false
unasense.email.required If this parameter is set to true, then, when a user submits his/her Expense Report it checks to make sure that the user has an E-mail address in their User Profile.  If not, then the Expense Report can not be submitted.  If this parameter is set to false, then anyone can submit their Expense Report without an E-mail address. false
unasense.approval.required If this parameter is true, then it requires that every Expense Report go through an approval chain (with at least one valid manager) before it is set to COMPLETED.  If the parameter is set to false, then any user can just submit their Expense Report, and have it immediately set to COMPLETED without going through an approval process. true
unasense.nonemployee.show_company_paid If this parameter is true, then the Method of Payment (Company Paid) will always show up on Expense Reports.  If it is false, then Company Paid will not show up on Expense Users who are Non Employees (as defined when setting up a person - specifically in the Classification Drop Down List). true
unasense.company.currency This is where you setup the default currency that your company uses.  All Expenses will be converted to this currency.  It is important that whatever Currency Code you create in the Currency Types Page match exactly what you have entered for this parameter.  If no match if found, the system will use USD by default, even if USD is not an option in your Currency Code Page.  See Currency Page for more information. USD
unasense.meal.cap If your company uses a Daily Meals Cap (meaning employees are allowed to spend $x.xx number of dollars a day on all meals), this is where you set the ceiling amount of meal expenses in a day. You must also set the unasense.meal.expense_types field to define what expense types are meals. 0.00
unasense.meal.expense_types These are the Expense Types you have defined in your system that are meals and will be applied against the unasense.meal.cap parameter.  List all the expense types that are meals separated by simi-colons.  Example:  dinner;lunch;breakfast   (note:  this is not case-sensative). <blank>
unasense.expense.admin.edit Allows Unanet Administrators to edit and submit people's Expense Reports and Expense Requests.  Done from the Administrator / Person / List Page false
unasense.expense.manager.edit Allows employee's manager(s) to edit and submit their Expense Reports and Expense Requests.  Done when a manager is approving an Expense Item. false
unasense.approval.authority.report If true, when a user submits their Expense Report to a manager, if any previous managers have already approved that Expense Report and have the expense authority to approve it (amount defined on the Person Page by the Administrator), then all subsequent managers will be skipped.   Exceptions are if the subsequent managers do not have any authority amount entered in their profile or that amount is equal to, or less than $0.00.   Those managers will be forced to approve or disapprove that Expense Report.  Also, if unasense.approval.enforce_order is set to true, then if that manager has an expense approval amount less than any manager earlier than them in the chain, then that manager must approve or disapprove.  If the value for this parameter is false, then every expense report will pass through every manger in the chain. false
unasense.approval.authority.request If true, when a user submits their Expense Requests to a manager, if any previous managers have already approved that Expense Request and have the expense authority to approve it (amount defined on the Person Page by the Administrator), then all subsequent managers will be skipped.   Exceptions are if the subsequent managers do not have any authority amount entered in their profile or that amount is equal to, or less than $0.00.   Those managers will be forced to approve or disapprove that Expense Request.  Also, if unasense.approval.enforce_order is set to true, then if that manager has an expense approval amount less than any manager earlier than them in the chain, then that manager must approve or disapprove.  If the value for this parameter is false, then every expense request will pass through every manger in the chain. false
unasense.approval.enforce_order if true, then during the approval process, if either the unasense.approval.authority.report or the unasense.approval.authority.request is set to true, then it will also check that the managers in an approval group are all in ascending order of expense approval amounts.  for any mangers that are out of order, then an approval or disapproval will be required - regardless of that Expense being previously approved by a manger with the appropriate authority. true
unasense.threshold.exceeded.need_comments If true, then if any expense thresholds are exceeded on an Expense Report or Expense Request, then Unanet will require that comments are entered for that expense line.  If false, then no comments are forced based on the amount spent for an expense type. false
unanet.prevent.nonmanager.be.alternate Prevents a person who is not defined as a manager in Unanet from becoming an alternate for someone.  This field accepts yes and no values instead of  true and false.  Please use the respective values here. no
unanet.prevent.nonemployee.be.alternate Prevents a person who is defined as a non-employee in Unanet from becoming an alternate for someone.  This field accepts yes and no values instead of  true and false.  Please use the respective values here. no
unatime.tasks.show_numbers When displaying the tasks for a project in a drop down select list, the associated task numbers will be displayed to the left of the task name.  To only show the task name without the task numbers, turn this parameter off.  true is on.   false is off.  This parameter is used throughout unanet (both in UnaTime and Una$ense) true
unanet.approve.self Setting this to true, allows users to submit timesheets and expense reports to approval groups of which they are also an approver.  In short, they will be approving their own timesheets and/or expense reports.  If false, then this prevents this. true
unanet.approve.force_view Setting this to true, forces an approver to view a timesheet for approval.  Setting to false, allows a manager to approve a timesheet from the list page, without viewing the details. false
unanet.reminder.list When sending e-mail reminders, the system prompts Administrators for a time period to send reminders for.  This parameter shows only the last 'x' number of time periods in the drop down list.  The default is to only show the last 3 time periods.  Enter a larger number here to select more time periods 3
unanet.export.list When exporting or extracting data, the system prompts Administrators for the time period to export.  This parameter shows only the last 'x' number of time periods in the drop down list.  The default is to only show the last 5 time periods.  Enter a larger number here to select more time periods 5
unanet.adp.directory If you are using the UnaADP Extract (to interface with ADP), then you will see a directory to place the comma deliminated CSV file on the web server.  Here is where you can set the default directory to place these files on the web server.  For example: unanet.adp.directory=C:\\adp\\import  Please note that you must use 2 back slashes to represent 1 back slash between directorys. C:\\

Export and Extract UnaTime Fields

You can setup your own default Fields To Export for UnaTime, so that each time you Export or Extract data, the fields you normally want selected will already be in the right-side box in the order that you specify.  Add these field to your unanet.properties file or modify them if they already exist.

To define, if the value of the field is zero (0), then that field will not be selected and will be put in the left-side box.  If the value of the field is greater than zero (0), then it will be displayed in the right-side box and then ordered by the value you give it. 

unanet.export.unatime.name=0
unanet.export.unatime.person_code=0
unanet.export.unatime.id_code1=0
unanet.export.unatime.id_code2=0
unanet.export.unatime.begin_date=0
unanet.export.unatime.end_date=0
unanet.export.unatime.period_number=0
unanet.export.unatime.date_completed=0
unanet.export.unatime.time_completed=0
unanet.export.unatime.cost_center=0
unanet.export.unatime.project_name=0
unanet.export.unatime.project_account=0
unanet.export.unatime.task_name=0
unanet.export.unatime.task_account=0
unanet.export.unatime.date_worked=0
unanet.export.unatime.hours_worked=0
unanet.export.unatime.pay_code=0
unanet.export.unatime.project_type=0
unanet.export.unatime.billing_rate=0
unanet.export.unatime.cost_rate=0
unanet.export.unatime.comments=0

Export and Extract of Una$ense Fields

You can setup your own default Fields To Export for Una$ense, so that each time you Export or Extract data, the fields you normally want selected will already be in the right-side box in the order that you specify.  Add these field to your unanet.properties file or modify them if they already exist.

To define, if the value of the field is zero (0), then that field will not be selected and will be put in the left-side box.  If the value of the field is greater than zero (0), then it will be displayed in the right-side box and then ordered by the value you give it. 

unanet.export.unasense.voucher_number=0
unanet.export.unasense.purpose=0
unanet.export.unasense.location=0
unanet.export.unasense.name=0
unanet.export.unasense.date_completed=0
unanet.export.unasense.time_completed=0
unanet.export.unasense.total=0
unanet.export.unasense.expense_type=0
unanet.export.unasense.account_number=0
unanet.export.unasense.expense_date=0
unanet.export.unasense.cost_center=0
unanet.export.unasense.project_name=0
unanet.export.unasense.task_name=0
unanet.export.unasense.currency=0
unanet.export.unasense.payment_method=0
unanet.export.unasense.vendor=0
unanet.export.unasense.amount=0
unanet.export.unasense.project_type=0
unanet.export.unasense.billable=0
unanet.export.unasense.wizard=0
unanet.export.unasense.comments=0