The unanet.properties file is located on your web server, in the Unanet installation directory, in a subdirectory called properties. This page addresses the following topics:
When defining your parameters, enter the parameter name (exactly as spelled --- cutting and pasting from this page is recommended), followed by the equals symbol ("="), and your overriding value with no spaces between the property and the equal sign -- or the equal sign and the beginning of the property value. Also, the parameter names and values are case sensitive unless otherwise noted.
For example, if setting the email option to true, you would enter:
unatime.email=true
Do not enter as:
unatime.email = true <==== incorrect
unatime.email = TRUE <==== incorrect
unatime.email = True <==== incorrect
The table below contain a listing of all published Unanet properties.
| Parameter Name | Description | Default Value |
|---|---|---|
| export.default.directory | If you are using the Unanet Extract or Export, then you will see a directory or email address to place the output file on the web server. Here is where you can set the default directory to place these files on the web server. For example: export.default.directory=C:\\time\\export Please note that you must use 2 back slashes to represent 1 back slash between directories. | <blank> |
| export.default.email | If you are using the Unanet Extract or Export, then you will see a directory or email address to place the output file on the web server. Here is where you can set the default email to send these files to. Note that this value overrides the export.default.directory value. For example: export.default.directory=joe@url.com | <blank> |
| mail.host | If unatime.email is set to true, then you will have to define your mail server. This is the name of your 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> |
| unanet.admin.only.assign.people | If this property is set to true, only a project manager who is also an admin can assign people or organizations to a project. | FALSE |
| unanet.adp.directory | If you are using the UnaADP Extract (to interface with ADP), then you will see a directory to place the comma delimited 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 directories. | C:\\ |
| 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.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.creditcards.selfedit | If you want to track credit cards issued to each employee, the Administrator can always maintain this information. However, if you have this parameter set to true, then each employee can also maintain their own credit card information from their User Profile. If set to false, then the regular timesheet and expense report user can not edit their own credit card information. Example: unanet.creditcards.selfedit=true | TRUE |
| unanet.export.list | When extracting data, the system prompts Administrators for the
time period to extract. 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 have more
time period options available in your drop down lists.
If you are exporting data, you are not prompted for a time period, but rather, enter a date range, thus this property does not affect exports (only extracts). |
5 |
| unanet.logo.align | This property defines the alignment of the
Company
Logo.
Options - LEFT, RIGHT, or CENTER. For example: unanet.logo.align=LEFT For more information click here. |
<blank> |
| unanet.logo.alt | Displays the text of the Company Logo when
doing a mouse-over. For example: unanet.logo.alt=Unanet
For more information click here. |
<blank> |
| unanet.logo.src | This property defines the location of the
Company logo. Only internet supported image files can be used. For
example: unanet.logo.src=http://andy.csi1.com/head.gif
For more information click here. |
<blank> |
| unanet.logo.url | When Company Logo is clicked, it will link to
this specified url. For example: unanet.logo.url=http://www.unanet.com
For more information click here. |
<blank> |
| unanet.locale | Date/time, number, and day formatting defaults to the locale specified by the JVM, which presumably gets the locale from the operating system. This default will generally provide the desired result, but this default may be overridden with the unanet.locale property. Example unanet.locale=en_US Click here for more locales. Setting this property will change the default locale for the entire JVM, which may affect other applications (servlets and JSP's) running on the same servlet engine instance as Unanet. | Specified by the JVM |
| unanet.pda.download_link | This sets up the
link on the User/Profile/PDA Settings page so that PDA users can download
the UnaPDA conduit and PDA software. The setup file comes
with the Unanet standard install, but you need to make the file visible to
you web server by doing one of the following:
|
|
| unanet.person.import.update_password.default | The default value of the checkbox on the administrator's person import screen (if the checkbox is displayed -- see the associated display property below). 'true' indicates checked, 'false' indicates not checked. | false |
| unanet.person.import.update_password.display | Display a checkbox on the person import screen, allowing the administrator to choose if passwords in the import file should set passwords for existing users, or not. | false |
| 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. Please use the respective values here. | no |
| 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. Please use the respective values here. | no |
| 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.report.criteria.all_people | This is used to restrict Manager's view of time and expense data to their own Approval Groups. If the property is set to true, any Manager can view time and expenses reported by anyone to Open and View projects as well as the time and expenses reported to List or Restricted projects by the members of their Approval Group. If the property is set to false, a Manager can only access data concerning members of their Approval Group. An Alternate Manager has the same viewing privileges as the named Manager. For more info, check out Restricted View. | TRUE |
| 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.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 in a browser, you will see that image in your browser. Example: http://www.domain.com/images/picture.gif | |
| 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 |
| 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.task.sort.order.by_sequence | This property
will govern the sort order of tasks in all screens that contain a task
drop down list box. If true, then the tasks will be sorted
in the same sequence that they appear on the Task Home page (by sequence
entered/displayed on screen). If false,
then the tasks will be sorted in an alphanumeric order.
Note: If set to false, you may consider turning off the display of the task numbers -- see unatime.tasks.show_numbers below. |
TRUE |
| unanet.temp_directory | This is the name of the directory that holds Unanet temporary files. Example: unanet.temp_directory=C:\\Unanet\\Temp | |
| unasense.approval.authority.report | If true,
this will activate the Dynamic
Approval Sequence functionality for Expense Reports. The
standard Approval Sequence requires each Manager in the Approval Group to
approve the expense. With the Dynamic Approval Sequence, you can
skip manager's depending on their expense authorization limit (which is
set on the Person Page).
If the value for this parameter is false, then every expense request will pass through every manger in the approval group. |
FALSE |
| unasense.approval.authority.request | If true,
this will activate the Dynamic
Approval Sequence functionality for Expense Requests. The
standard Approval Sequence requires each Manager in the Approval Group to
approve the expense. With the Dynamic Approval Sequence, you can
skip managers depending on their expense authorization limit (which is
set on the Person Page).
If the value for this parameter is false, then every expense request will pass through every manger in the approval group. |
FALSE |
| unasense.approval.enforce_order | NOTE:
Beginning w/ version 3.4, this property is no longer used. The
processing order for the Managers in the Approval Group is dynamically
sorted at approval time in an ascending order, based on their approval
authority amount. Essentially, order is now always enforced.
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, an approval or disapproval will be required - regardless of that Expense being previously approved by a manger with the appropriate authority. See Dynamic Approval Sequence for more information. |
TRUE |
| unasense.approval.required | If
this parameter is true,
then it requires that every Expense Report go through the approval process
(with at least one valid Manager in an approval group) before it is set to COMPLETED.
If the parameter is set to false, then it would be possible for this expense report to not require any Manager approval (e.g. you could have an empty approval group). This does not impact the Project Manager or Customer approval process at all. Even if set to false, the expense report may still require PM or Customer approval. |
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 is found, the system will use USD by default, even if USD is not an option in your Currency Code Page. Example unasense.company.currency=GBR See Currency Page for more information. | USD |
| unasense.creditcards.import.purge_days | This parameter is used to tell Unanet how long
to keep imported credit card records (or transactions) in the holding
table before they are automatically purged. This parameter accepts an
integer value that represents the number of days to keep each record in
the holding table, based on the system date on the webserver. The purge is
run at the beginning of each import started by an Administrator. NOTE: If the value entered for this parameter is equal to or less than zero (0), then the data in the holding table will NEVER be purged. If the value for this field is not a number, then it will be converted to zero. |
90 |
| 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.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.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.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 |
| 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 semicolons. Example: dinner;lunch;breakfast (note: this is not case-sensitive). | <blank> |
| 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.per_diem.mie.breakdown.breakfast.percent | Determines the breakdown values for M&IE Rates -- percentages expressed without the % sign. Specifies the Breakfast percentage. | 15 |
| unasense.per_diem.mie.breakdown.lunch.percent | Determines the breakdown values for M&IE Rates -- percentages expressed without the % sign. Specifies the Lunch percentage. | 25 |
| unasense.per_diem.mie.breakdown.dinner.percent | Determines the breakdown values for M&IE Rates -- percentages expressed without the % sign. Specifies the Dinner percentage. | 40 |
| unasense.per_diem.mie.first_day.proration.percent | Determines the partial day proration percentage factor for the first day of trip -- percentages expressed without the % sign. If your company policy does not include this concept, you may want to set this value to 100 percent. | 75 |
| unasense.per_diem.mie.last_day.proration.percent | Determines the partial day proration percentage factor for the last day of trip -- percentages expressed without the % sign. If your company policy does not include this concept, you may want to set this value to 100 percent. | 75 |
| 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.single.project.expense.limit | If true, then expense reports can not be allocated across multiple project/tasks. If false, (the default) an expense report purpose page will allow for more than one project/task to be defined in the project allocation section. | FALSE |
| 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 |
| unasense.user.import.enable
|
If you are using Una$ense and are importing credit card information, you will want to set this value to true. Once true, an Import button will appear on the detail screen of the Expense Reports. The user will then be able to import any transactions that have been uploaded by the Administrator. If the value of this parameter is false, then the button will not appear. However, all other functionality of the credit card importing will be available. Meaning that Administrators can still import transactions and users can still maintain credit card information. | TRUE |
| unasense.vat.enabled | If true, then several new columns appear on the Expense report that will facilitate the recording of VAT (value added tax) information. If false, then the fields will not appear on the expense screens. | FALSE |
| unasense.wizard.message | The value of this property will appear at the top of every wizard page. It can be used to display a generic message or an expense policy. If the property is not set, no message is displayed. The value can be a simple text string, or text string containing embedded HTML format tags. A custom message can be displayed on each expense type by editing the expense type directly. | <blank> |
| unatime.admin.edit | If true, then Unanet Administrators can edit and submit other people's Timesheets. This would be done from the Administrator / People / List or Search menu. The result will display next to each person's name, a stack of timesheets. By clicking this icon, all timesheets will be displayed for that user. Any Administrator can view anyone's Timesheets, but if this parameter is true, then that Administrator can also edit it. If the parameter is false, then the Administrator can only view the Timesheets. | FALSE |
| unatime.allow_timesheet_delete | If true, then then Unanet users can delete timesheets that have a status of INUSE or DISAPPROVED. You are only allowed to delete timesheets which you have authority to edit. Note: this feature is not available if you have the unatime.audit property set to true. | FALSE |
| unatime.autolock | If true, then timesheets are automatically set to a status of LOCKED when they are completed. | FALSE |
| unatime.manager.edit | If true, then Unanet Managers
can edit and submit other people's Timesheets. This would be done from the
Manager / Approve Time menu. After viewing the Timesheet, the Manager can
press the edit button to edit or submit that time. If the
parameter is false, then the Manager can only view,
approve, or disapprove that time.
If this property is set to false, the Manager may still be able to edit another users timesheet if the Manager is this user's alternate or perhaps if the Manager is also an Administrator (and that property is set to allow Administrators to edit timesheets). |
TRUE |
| 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. Warning: Once this feature is activated it is complicated to deactivate it again. This property is commonly used in conjunction with the DCAA guidelines. | FALSE |
| unatime.cost.dilution.class | This parameter shows which Cost Rate Dilution style you are using. Unanet currently has two Styles of Cost Rate Dilution: Style0 and Style1. | com.unanet.unatime.data.Style0CostDilution |
| 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 |
| 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.import.timesheet_submit.display | If If the property is set to true, a group of radio boxes allowing the change of the timesheet status will be added to the page. | FALSE |
| unatime.pm_approval.view_all | Specifies whether a project manager can see all of a user's timesheet entries during project manager time approval. The value false only allows a project manager to see a user's timesheet entries for those projects managed by the project manager. The value true allows the project manager to see all entries when approving the user's timesheet. | FALSE |
| unatime.select.bill.dilution | This parameter is used by Unanet reports. If it is set to true, the selection criteria for the reports will be modified to include Bill Dilution. | FALSE |
| unatime.select.cost.dilution | This parameter is used by Unanet reports. If it is set to true, the selection criteria for the reports will be modified to include Cost Dilution. | FALSE |
| unatime.submit.stored_procedure | This setting is
used to define the name of a database stored procedure that should be
called prior to the submission of a timesheet. The stored procedure can be
used to perform installation specific edits upon a timesheet, prior to its
submission for approval. Check out the stored
procedure page for additional information. Note: Providing a value for this parameter will have no effect on time submitted via IVR, Time Import or Time Populate. |
|
| unatime.tasks.show_numbers | If this
parameter is set to true, task numbers will be displayed with the
task name wherever task names are displayed.
Note: This setting impacts the display of Task Numbers throughout all of the Unanet products (not just UnaTime). |
TRUE |
| unatime.time.populate.approve | If this parameter is set to true, a Complete button is displayed on the Time Populate Entry page. This button allows the Administrator to complete the timesheets updated or created through this page bypassing the regular approval process. | FALSE |
| unatime.timesheet.lineitem.signature | The value of this property controls the appearance of the signature column on the Timesheet Preview page. If the property is not set or set to false, the column does not appear. | FALSE |
| unasource.user.plan.show_labor_category | Specifies whether a user can see and select a Labor Category when self planning via UnaSource. With a value of FALSE (the default) users do not see this field. With a value of TRUE, users can see and select the Labor Category field. | FALSE |
| unasource.allow_bill_rate_edit | This property controls the Project Manager's ability to edit the Bill rate while creating/editing assignments and plan work items. The field is editable if the property is set to true and is display only, if the property is set to false. The default value is true. | TRUE |
| unasource.allow_cost_rate_edit | This property controls the Project Manager's ability to edit the Cost rate while creating/editing assignments and plan work items. The field is editable if the property is set to true and is display only, if the property is set to false. The default value is is true. | TRUE |
Click here to see the text.properties definitions.
Return to Unanet Table of Contents page
Copyright © 1998-2002 Computer Strategies, Inc.,
All Rights Reserved.
Last revised: September 13, 2002
.