unanet.properties file

This page contains a listing of the available unanet.properties that can be configured in your system.  

Note that most of these values can be managed via the Admin >> Properties screen in your system and that any entries defined in the unanet.properties file will override the value set via that screen in the user interface (for that specific front end web server).

This page presents an alphabetical listing of available properties with links to the descriptions of each property (as they appear on the Admin >> Properties screen).

If your installation includes the use of multiple front end web servers, you may want to have different values for the same property on each front end.  Using this unanet.properties file can allow you to accommodate that need (whereas those properties defined via the Admin >> Properties screen will be shared by all front end servers -- unless overridden by entries in the unanet.properties file on a particular front end).

Additionally, any properties that you configure via this property file, can no longer be managed via the Admin >> Properties screen.  This may be useful for properties that you do not want your typical Unanet Administrator to be able to modify (i.e. some should only be modifiable by system administrators with access to a server).

This file can be viewed/edited with any standard text editor.   All property files are located in your config directory.

WARNING - All changes to the unanet.properties file should take place in the file located in your config directory.  DO NOT attempt to modify the copy of the unanet.properties file packaged within the unanet.war file (this can result in unpredictable system behavior).  

Topics covered on this help page include:

 

You may also be interested in:

 


Property Setting Syntax

Examples

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


List of Available unanet.properties

The table below contains a listing of all published unanet.properties values.  You can click on a particular property and view additional information about that property, including; descriptions, default values, related properties, as well as the name / location of that property as it appears on the Admin >> Properties screen.

 

Unanet

  1. mail.auth
  2. mail.debug
  3. mail.host
  4. mail.password
  5. mail.user
  6. unanet.assign_search.enabled
  7. unanet.assign_search.result_limit
  8. unanet.attachment.invalid_file_extensions
  9. unanet.attachment.max_size
  10. unanet.attachment.valid_file_extensions
  11. unanet.authentication
  12. unanet.auto.project_code.separator
  13. unanet.auto.project_code.sequence_number.min_length
  14. unanet.auto.project_code.source
  15. unanet.autocomplete.max_results
  16. unanet.autocomplete.min_query_length
  17. unanet.autocomplete.query_delay
  18. unanet.billing.post.suppress_preview
  19. unanet.cookie.http_only
  20. unanet.cookie.nonce
  21. unanet.cookie.secure
  22. unanet.default_dates_to_linked.assignments
  23. unanet.default_dates_to_linked.plans
  24. unanet.disable.minification
  25. unanet.email.static_from_address
  26. unanet.extract.require_org
  27. unanet.fiscal_calendar.enabled
  28. unanet.gzip
  29. unanet.image.invalid_file_extensions
  30. unanet.image.max_size
  31. unanet.image.valid_file_extensions
  32. unanet.invoice.add.suppress_preview
  33. unanet.invoice.allow_invoice_uncomplete
  34. unanet.invoice.auto_correct.rounding.default
  35. unanet.invoice.date_format
  36. unanet.invoice.hide.bill_to.org_name
  37. unanet.invoice.hide.billing_through_date
  38. unanet.invoice.hide.remit_to.org_name
  39. unanet.invoice.hide.ship_to.org_name
  40. unanet.jaas.application
  41. unanet.license_check.warning_interval
  42. unanet.locale
  43. unanet.log.level
  44. unanet.log.output
  45. unanet.login_attempts_before_locked
  46. unanet.logo.alt
  47. unanet.logo.src
  48. unanet.logo.url
  49. unanet.logout.redirect
  50. unanet.non_cost_mgr.allow_cost_reporting
  51. unanet.non_cost_mgr.allow_project_cost_reporting
  52. unanet.non_cost_mgr.allow_project_margin_reporting
  53. unanet.org_access.HRAdministrator.people.default_to_all
  54. unanet.org_access.apPoster.financial.default_to_all
  55. unanet.org_access.apUser.financial.default_to_all
  56. unanet.org_access.apViewer.financial.default_to_all
  57. unanet.org_access.arPoster.financial.default_to_all
  58. unanet.org_access.arUser.financial.default_to_all
  59. unanet.org_access.arViewer.financial.default_to_all
  60. unanet.org_access.billingManager.owning.default_to_all
  61. unanet.org_access.billingManager.project.default_to_all
  62. unanet.org_access.billingViewer.owning.default_to_all
  63. unanet.org_access.billingViewer.project.default_to_all
  64. unanet.org_access.contactManager.contact.default_to_all
  65. unanet.org_access.contactViewer.contact.default_to_all
  66. unanet.org_access.documentManager.document.default_to_all
  67. unanet.org_access.documentManager.financial.default_to_all
  68. unanet.org_access.documentViewer.document.default_to_all
  69. unanet.org_access.documentViewer.financial.default_to_all
  70. unanet.org_access.glBudgetManager.financial.default_to_all
  71. unanet.org_access.glPoster.financial.default_to_all
  72. unanet.org_access.glUser.financial.default_to_all
  73. unanet.org_access.glViewer.financial.default_to_all
  74. unanet.org_access.manager.people.default_to_all
  75. unanet.org_access.projectDocumentViewer.owning.default_to_all
  76. unanet.org_access.projectDocumentViewer.project.default_to_all
  77. unanet.org_access.projectManager.owning.default_to_all
  78. unanet.org_access.projectManager.project.default_to_all
  79. unanet.org_access.projectPOViewer.owning.default_to_all
  80. unanet.org_access.projectPOViewer.project.default_to_all
  81. unanet.org_access.projectPRViewer.owning.default_to_all
  82. unanet.org_access.projectPRViewer.project.default_to_all
  83. unanet.org_access.projectViewer.owning.default_to_all
  84. unanet.org_access.projectViewer.project.default_to_all
  85. unanet.org_access.purchaseOrderAssigner.financial.default_to_all
  86. unanet.org_access.purchaseOrderAssigner.people.default_to_all
  87. unanet.org_access.purchaseOrderViewer.financial.default_to_all
  88. unanet.org_access.purchaseRequestor.financial.default_to_all
  89. unanet.org_access.purchaseRequestor.people.default_to_all
  90. unanet.org_access.purchaseRequisitionViewer.financial.default_to_all
  91. unanet.org_access.purchaseRequisitionViewer.people.default_to_all
  92. unanet.org_access.purchaser.financial.default_to_all
  93. unanet.org_access.resourceAssigner.owning.default_to_all
  94. unanet.org_access.resourceAssigner.people.default_to_all
  95. unanet.org_access.resourceAssigner.project.default_to_all
  96. unanet.org_access.resourcePlanner.owning.default_to_all
  97. unanet.org_access.resourcePlanner.people.default_to_all
  98. unanet.org_access.resourcePlanner.project.default_to_all
  99. unanet.org_access.resourceRequestor.owning.default_to_all
  100. unanet.org_access.resourceRequestor.project.default_to_all
  101. unanet.org_access.viewer.people.default_to_all
  102. unanet.org_assignment.my_projects.select_by_default
  103. unanet.password.character.lowercase
  104. unanet.password.character.number
  105. unanet.password.character.special
  106. unanet.password.character.uppercase
  107. unanet.password.expire
  108. unanet.password.expire.warn
  109. unanet.password.minimum.character.lowercase
  110. unanet.password.minimum.character.number
  111. unanet.password.minimum.character.special
  112. unanet.password.minimum.character.uppercase
  113. unanet.password.minimum.length
  114. unanet.password_reset.enabled
  115. unanet.password_reset.time_to_live
  116. unanet.person.import.update_password.default
  117. unanet.prevent.administrative.login
  118. unanet.prevent.nonemployee.be.alternate
  119. unanet.prevent.nonmanager.be.alternate
  120. unanet.project_search.require_project_code
  121. unanet.properties.show_transfer_button
  122. unanet.restrict_alternates_by_role
  123. unanet.restricted_access
  124. unanet.scheduler.disabled
  125. unanet.show_emp_type_employees
  126. unanet.show_existing_plans_assignments
  127. unanet.splash.alt
  128. unanet.splash.src
  129. unanet.splash.target
  130. unanet.splash.url
  131. unanet.task.sort.order.by_sequence
  132. unanet.task_list.search_enable.limit
  133. unanet.tempFileReaper.max_temp_chart_age
  134. unanet.tempFileReaper.max_temp_file_age
  135. unanet.tempFileReaper.max_temp_import_file_age
  136. unanet.tempFileReaper.sleep_time
  137. unanet.temp_directory
  138. unanet.volume_search.filter_limit
  139. unasource.allow_bill_rate_edit
  140. unasource.allow_cost_rate_edit
  141. unatime.email
  142. unatime.email.default_from_address
  143. unatime.tasks.show_numbers

Approval Process

  1. approval_process.admin.can_edit.expense_request
  2. approval_process.customer.review.purchase_order
  3. approval_process.customer.review.purchase_requisition
  4. approval_process.customer.review.vendor_invoice
  5. approval_process.customer.view.attachments.purchase_order
  6. approval_process.customer.view.attachments.purchase_requisition
  7. approval_process.customer.view.attachments.vendor_invoice
  8. approval_process.dynamic.approval.sequence.purchase_order
  9. approval_process.dynamic.approval.sequence.purchase_requisition
  10. approval_process.dynamic.approval.sequence.vendor_invoice
  11. approval_process.manager.can_edit.expense_request
  12. approval_process.manager.review.purchase_order
  13. approval_process.manager.review.purchase_requisition
  14. approval_process.manager.review.vendor_invoice
  15. approval_process.project_approver.review.purchase_order
  16. approval_process.project_approver.review.purchase_requisition
  17. approval_process.project_approver.review.vendor_invoice
  18. approval_process.require.approval.expense_request
  19. approval_process.require.approval.leave
  20. approval_process.require.approval.purchase_order
  21. approval_process.require.approval.purchase_requisition
  22. approval_process.require.approval.vendor_invoice
  23. unanet.approve.force_view
  24. unanet.approve.self
  25. unasense.approval.authority.report
  26. unasense.approval.authority.request
  27. unasense.approval.authority.request.skip_zero_approver
  28. unasense.approval.required
  29. unasense.customer.review.required
  30. unasense.customer.view_approval_history
  31. unasense.customer.view_attachments
  32. unasense.expense.admin.edit
  33. unasense.expense.manager.edit
  34. unasense.manager.review.required
  35. unasense.pm.review.required
  36. unasense.user.review.required
  37. unatime.admin.edit
  38. unatime.admin_bulk_approve.enable
  39. unatime.administrator.review.required
  40. unatime.approval.required
  41. unatime.bulk_approvals.review.required
  42. unatime.customer.review.required
  43. unatime.manager.approval.preview.stored_procedure
  44. unatime.manager.edit
  45. unatime.manager.review.required
  46. unatime.pm.review.required
  47. unatime.pm_approval.view_all
  48. unatime.user.review.required

Time

  1. timesheet.edit.footer.exempt
  2. timesheet.edit.footer.nonemployee
  3. timesheet.edit.footer.nonexempt
  4. timesheet.edit.footer.subcontractor
  5. timesheet.printview.footer.exempt
  6. timesheet.printview.footer.nonemployee
  7. timesheet.printview.footer.nonexempt
  8. timesheet.printview.footer.subcontractor
  9. timesheet.submit.confirm.exempt
  10. timesheet.submit.confirm.nonemployee
  11. timesheet.submit.confirm.nonexempt
  12. timesheet.submit.confirm.subcontractor
  13. unanet.default.allow_budget_to_exceed
  14. unatime.accruals.hire_date_cap.post_first
  15. unatime.adjustment.allow_other_change_reason
  16. unatime.allow_custom_time_periods
  17. unatime.allow_timesheet_delete
  18. unatime.audit
  19. unatime.audit.allow_other_change_reason
  20. unatime.autolock
  21. unatime.cost.dilution.business_hours_from_dilution_hours
  22. unatime.cost.dilution.class
  23. unatime.cost.dilution.use_plan_rates
  24. unatime.daily_actuals.num_time_periods
  25. unatime.default.work.hours
  26. unatime.dilution.stored_procedure
  27. unatime.dilution_hours_from_business_week
  28. unatime.end_user_adjustment.enable
  29. unatime.etc_collection.enabled
  30. unatime.holiday.hours_from_business_week
  31. unatime.leave_request.autolock
  32. unatime.leave_request.enabled
  33. unatime.payroll_info.enable
  34. unatime.pre_dilution.stored_procedure
  35. unatime.prevent_post_on_weekly_overlap
  36. unatime.preview.expand./people/time/view
  37. unatime.preview.expand./people/time/view/adjust
  38. unatime.preview.expand./people/time/view/approve
  39. unatime.preview.expand./people/time/view/review
  40. unatime.preview.expand./projects/time/view/approve
  41. unatime.preview.expand./projects/time/view/review
  42. unatime.preview.expand./reports/people/status/time/report
  43. unatime.preview.expand./time/signature
  44. unatime.preview.expand./time/view
  45. unatime.preview.expand./time/view/review
  46. unatime.preview.logo.alt
  47. unatime.preview.logo.src
  48. unatime.preview.logo.url
  49. unatime.project_popup.display_tasks
  50. unatime.quick_reports.leave_balance.accrued_budgets
  51. unatime.req_non_owner_submit_comment
  52. unatime.save.stored_procedure
  53. unatime.save.stored_procedure.include_saver
  54. unatime.submit.stored_procedure
  55. unatime.submit.stored_procedure.include_submitter
  56. unatime.time_period_criteria.sort_by_type
  57. unatime.timesheet.classification.display
  58. unatime.timesheet.hide.comments
  59. unatime.timesheet.hide.labor_category
  60. unatime.timesheet.hide.location
  61. unatime.timesheet.hide.pay_code
  62. unatime.timesheet.hide.project_type
  63. unatime.timesheet.hide.task
  64. unatime.timesheet.org.display
  65. unatime.timesheet.project.title.display
  66. unatime.timesheet.project.title.hover
  67. unatime.ts_status_rpt.exempt_users.hours_from_dilution
  68. unatime.use_server_clock
  69. unatime.weekly_overlap.rate_align

Expense

  1. unasense.autolock
  2. unasense.company.currency
  3. unasense.creditcards.allow_imported_item_delete.admin
  4. unasense.creditcards.allow_imported_item_delete.user
  5. unasense.creditcards.enable
  6. unasense.creditcards.import.purge_days
  7. unasense.email.required
  8. unasense.enable_copy
  9. unasense.expense.manager.void
  10. unasense.expense.org.display
  11. unasense.expense_extract.post_date.required
  12. unasense.hide.project_type
  13. unasense.location.required
  14. unasense.lodging_allowable.include_tax_overage
  15. unasense.meal.cap
  16. unasense.meal.expense_types
  17. unasense.per_diem.mie.breakdown.breakfast.percent
  18. unasense.per_diem.mie.breakdown.dinner.percent
  19. unasense.per_diem.mie.breakdown.lunch.percent
  20. unasense.per_diem.mie.first_day.proration.percent
  21. unasense.per_diem.mie.last_day.proration.percent
  22. unasense.per_diem.special_situation.enabled
  23. unasense.per_diem.special_situation.factor
  24. unasense.preview.expand./expense/allocate
  25. unasense.preview.expand./expense/allocate/review
  26. unasense.preview.expand./expense/request/view
  27. unasense.preview.expand./expense/view
  28. unasense.preview.expand./expense/view/attach
  29. unasense.preview.expand./expense/view/review
  30. unasense.preview.expand./people/expense/allocate
  31. unasense.preview.expand./people/expense/allocate_info
  32. unasense.preview.expand./people/expense/request/view
  33. unasense.preview.expand./people/expense/view
  34. unasense.preview.expand./people/expense/view/approve
  35. unasense.preview.expand./people/expense/view/review
  36. unasense.preview.expand./projects/expense/view/approve
  37. unasense.preview.expand./projects/expense/view/review
  38. unasense.preview.expand./reports/people/status/expense/report
  39. unasense.project.title.display
  40. unasense.purpose.required
  41. unasense.save.stored_procedure
  42. unasense.save.stored_procedure.include_saver
  43. unasense.single.project.expense.limit
  44. unasense.submit.stored_procedure
  45. unasense.submit.stored_procedure.include_submitter
  46. unasense.threshold.exceeded.need_comments
  47. unasense.vat.enabled
  48. unasense.wizard.message

Planning

  1. unanet.plan_set_list.search_enable.limit
  2. unanet.plan_sets.enabled
  3. unasource.overbooking.blockout.allowed
  4. unasource.user.plan.show_labor_category

Financials

  1. unanet.financials.1099.enabled
  2. unanet.financials.allow_customer_payment_delete
  3. unanet.financials.allow_customer_payment_unpost
  4. unanet.financials.allow_deposit_delete
  5. unanet.financials.allow_journal_entry_delete
  6. unanet.financials.allow_vendor_invoice_delete
  7. unanet.financials.allow_vendor_payment_delete
  8. unanet.financials.cp.save.stored_procedure
  9. unanet.financials.cp.submit.stored_procedure
  10. unanet.financials.ds.save.stored_procedure
  11. unanet.financials.ds.submit.stored_procedure
  12. unanet.financials.duplicate_vendor_invoice
  13. unanet.financials.email.default.bill_archive_address
  14. unanet.financials.email.default.billing_from_address
  15. unanet.financials.gl_post_level.billing
  16. unanet.financials.gl_post_level.expense_cost
  17. unanet.financials.gl_post_level.expense_cost_non-reimbursable_offset
  18. unanet.financials.gl_post_level.expense_cost_reimbursable_offset
  19. unanet.financials.gl_post_level.invoice
  20. unanet.financials.gl_post_level.labor_cost
  21. unanet.financials.gl_post_level.labor_cost_offset
  22. unanet.financials.je.save.stored_procedure
  23. unanet.financials.je.submit.stored_procedure
  24. unanet.financials.open_fiscal_periods
  25. unanet.financials.post_cross_charge_labor
  26. unanet.financials.post_to_gl
  27. unanet.financials.post_to_gl.eff_date
  28. unanet.financials.use_financial_orgs
  29. unanet.financials.use_financial_orgs.eff_date
  30. unanet.financials.vi.save.stored_procedure
  31. unanet.financials.vi.submit.stored_procedure
  32. unanet.financials.vp.save.stored_procedure
  33. unanet.financials.vp.submit.stored_procedure

Purchasing

  1. unanet.purchasing.po.can_create_without_pr
  2. unanet.purchasing.po.can_delete_unapproved
  3. unanet.purchasing.po.default.email
  4. unanet.purchasing.pr.can_delete_unapproved

 


Example unanet.properties file

Should you decide to maintain the unanet.properties within the ascii text file, you'll be editing a file that resembles the sample below.   A sample unanet.properties file is included in your config directory by default with a number of common entries commented out.  

##############################################################################

# Note: Any line beginning with a pound sign (#) is treated as a comment.

#       Changes will not take effect until you restart your servlet engine.

#

# There are two methods of configuring the various features in Unanet:

#

#  1) Configure the properties directly in the user interface by going

#     to the Admin->Properties menu item (for administrators only). These

#     values are stored in your Unanet database and are used by any front

#     end that is not overriding them.  Any changes made through the user

#     interface take effect immediately (no servlet restart necessary).

#

#  2) Use this file to specify the property values using their property

#     ID. Any change made in this file will NOT take effect until the

#     Unanet servlet (ie Tomcat) is restarted.  The values specified

#     in this file will ALWAYS override the user interface settings.

#     There are two reasons this may be useful or even necessary:

#

#       A) You may need to ensure that no one can change certain critical

#          features through the user interface.  By placing them in this

#          file, you guarantee that they cannot be changed through the

#          user interface.

#

#       B) You may have multiple front-end servers pointing to your Unanet

#          database.  It is sometimes necessary to specify different

#          settings for each front end.  For example, perhaps the file

#          structure is different on each front end and you need to

#          specify different log files or temp directories.

#

#      When you do use this file to override property settings, the property

#      will appear grayed out in the user interface page.

#

# See the Unanet documentation for more information on how to customize your

# Unanet system and for a complete list of properties.

##############################################################################

##############################################################################

# E-mail Information

# To enable email, set unatime.email to true and set the mail.host to your

# SMTP server.  You may also want to set unatime.email.default_from_address

# to something meaningful to your system -- it is used when the sender email

# cannot be determined.

##############################################################################

#unatime.email=false

#mail.host=(SMTP Server Name Goes Here)

#unatime.email.default_from_address=unanet@localhost

##############################################################################

# Temp Directory Setting

# You should make sure you uncomment and set this directory property.  We

# recommend setting it to the "temp" directory under your main unanet folder.

##############################################################################

#unanet.temp_directory=c:/unanet/temp

##############################################################################

# You should also specify a log file that will contain all the logging info

# by setting the unanet.log.output property. A full path can be specified to

# anywhere that is writable by the user running the servlet engine, but we

# recommend keeping the log file in the servlet engine's log directory. We

# have provided an example.  Please  

# uncomment and make sure you change the path if you have

# installed the servlet engine in another location.

##############################################################################

### Example entry for Tomcat

#unanet.log.output=c:/Program Files/Apache Software Foundation/Tomcat/logs/unanet_runtime.log

##############################################################################

# Unanet logging level

# You can control the level of detail which gets logged by the Unanet system

# by setting the unanet.log.level.  Valid values are OFF, SEVERE, WARNING,

# INFO, CONFIG, FINE, FINER, FINEST or ALL.  The default value if INFO.

# Please see help documentation for more details.

##############################################################################

#unanet.log.level=FINE

 
 
 

Related Topics