raven/docs/8.0/ayanova/docs/changelog.md

# Change log

If you are viewing this page from your local copy of AyaNova be advised that it will only show changes up to the date that your version was released, the most recent changes are documented in the AyaNova manual [hosted on our website](https://ayanova.com/docs/changelog).

## How to upgrade

See the [upgrade instructions](ops-upgrade.md) section of this manual for details.

## 2026

### AyaNova 8.3.0

IN PROGRESS

**WARNING:** this release contains changes that will require a **pre upgrade step** on all Windows and Linux network platforms from the normal upgrade process you may be accustomed to. Be sure to follow our [upgrade instructions](ops-upgrade.md) and the **pre upgrade step** for your platform for this particular upgrade from version 8.2.4 (or older) to version 8.3.0 (or newer).

**IMPORTANT:** this release includes important security improvements along with the move to .NET 10. We recommend upgrading self-hosted installations to 8.3.0 promptly.

**Changed**

- Server: after several incorrect two-factor authentication codes, the password must be entered again before another code can be tried.
- Server: the `AYANOVA_JWT_SECRET` setting is no longer used. AyaNova now generates its own [sign-in key](ops-config-jwt-secret.md) once and keeps it in its data folder, so users stay logged in when the server restarts. The setting can be removed from `config.json`.
- Server: updated to use .NET 10.x LTS from previously used .NET 8.x LTS. .NET 8.x reaches end of support in November 2026. With this update to .NET 10.x come performance and security gains.
- Server: all 3rd party components used by the AyaNova server have been upgraded to their most recent release versions to use with .NET 10.x. This improves performance, stability and security for each component used.
- Server: the report rendering system now uses the smaller and faster "Chrome headless shell" browser instead of the full Chrome browser. It is downloaded into a `report-browser` folder under the AyaNova data folder instead of the program folder, so it is no longer removed by an upgrade. There will be a longer than normal delay the _first time_ a report is rendered after upgrading while AyaNova automatically downloads the new report rendering browser. Any old `Chrome` and `ChromeHeadlessShell` folders in the AyaNova program folder are no longer used and can be removed.
- Server: the automatic internal backup now runs the database backup utility directly instead of through a command shell, so the database password can contain any characters, and a failed backup is now reported as an error instead of appearing to succeed. See [backup](ops-form-backup.md).
- Server: log files are now named with an increasing number when they are archived; the [server log](ops-log.md) form lists them newest first.
- Server: removed an unused internal performance profiling component.
- Server: AyaNova now checks the email (SMTP) server's security certificate when sending email. If your mail server uses a self-signed or internal certificate and email notifications stop after upgrading, see [SMTP certificate check](ops-config-smtp-accept-any-certificate.md).
- Server: after repeated failed login attempts, further attempts for that login, or from that address, are refused for a few minutes.
- Server: new [trusted reverse proxies](ops-config-trusted-proxies.md) setting for a reverse proxy that runs on a different computer from the AyaNova server, so AyaNova sees each user's own address.
- Server: the server information page at `/api/v8/` no longer shows license details.
- Server: business logo uploads must be PNG, JPEG, GIF, WebP or SVG images, and need full rights to global settings. See [business logos](adm-global-logo.md).
- Server: when a user's password is reset or set by an administrator, or their login is disabled, they are signed out and must sign in again.
- Server: on a server with a purchased license, the SuperUser account can only be used to change its password while it still has the default password, and the login form no longer offers the default SuperUser login. See [SuperUser login](ay-start-login.md).
- Server: the SMTP server password is no longer shown in the [notification settings](ops-notification-system.md) form; it shows `********` when a password is set. Type a new password to change it.
- Linux: Ubuntu 24.04 and 26.04 are now tested and supported. On Ubuntu 24.04 and newer the .NET runtime is installed from Ubuntu's own package archive.
- Docs: updated the [Linux server](ops-install-linux-server.md), [Linux desktop](ops-install-linux-desktop.md), [Windows local network](ops-install-windows-lan.md) and [Windows IIS](ops-install-windows-iis.md) installation and upgrade instructions for .NET 10 and Ubuntu 24.04 / 26.04.
- Docs: updated the database password guidance in the installation and [backup](ops-form-backup.md) documentation.
- Windows: the local network installer and the [local network](ops-install-windows-lan.md) and [IIS](ops-install-windows-iis.md) installation instructions now link to the official PostgreSQL download page (the third-party guide linked before is no longer available), and the configuration examples assume PostgreSQL 18.
- Docs: the Windows installation instructions now state that only one type of AyaNova 8 installation (single user, local network or IIS) can be on a computer at a time.

**Fixed**

- Server: fixed occasional errors on the first requests after the server starts.
- Server: searching selection lists for text that contains an apostrophe (for example a name like O'Brien) now works.
- Server: hardened data table filter handling of number and role filter values.
- Server: data table date filters for "greater than or equal", "less than" and "not equal" could include or exclude records on the boundary of the selected date.
- Server: the database connection used for administrative operations is now built correctly when the database name also appears elsewhere in the connection setting.
- Server: erasing the database with AYANOVA_PERMANENTLY_ERASE_DATABASE now checks that the database user has the rights to re-create the database before dropping it.
- Server: if the report rendering browser cannot be downloaded or started, a specific error is now shown and logged instead of a generic job failure.
- Docs: fixed several links in the manual that opened the wrong section or page.


## 2025

### AyaNova 8.2.4

Released 2025-11-24

**Fixed**

- Server: changes for compatibility with PostgreSQL 18.1.  This update is only required if Postgres is 18.1 or newer.

### AyaNova 8.2.3

Released 2025-02-18

**Fixed**

- Server: resolved edge case issue with Customer Notifications attached reports could fail to generate when platform is Windows / IIS and AYANOVA_REPORT_RENDER_API_URL_OVERRIDE configuration setting override in effect

- Docs: fixed outdated and missing installation steps for setting directory rights and ownership in [linux server install](ops-install-linux-server.md) for post 8.2.0 changes (hat tip to Steven L. for spotting this)

- Docs: improved PO part requests documentation section to specify that only Parts that match the Vendor selected on the PO will be offered for selection in the Part Requests list

## 2024

### AyaNova 8.2.2

Released 2024-10-23

**Fixed**

- Server: resolved false negative validation issue with Custom fields set to Required in WorkOrders, Quotes or PM's at the Item and Unit levels preventing save

### AyaNova 8.2.1

Released 2024-08-28

**WARNING:** If you are currently at a version older than 8.2.0 you _must_ [follow the special instructions for that release](#ayanova-820).

**Changed**

- Server: updated internal 3rd party database related dependencies

**Fixed**

- Server: resolved issue which could result in an overflow exception error when opening an existing work order

### AyaNova 8.2.0

Released 2024-06-03

**WARNING:** this release contains changes that will require a **pre upgrade step** on all Windows and Linux network platforms from the normal upgrade process you may be accustomed to. Be sure to follow our [upgrade instructions](ops-upgrade.md) and the **pre upgrade step** for your platform for this particular upgrade from version 8.1.5 (or older) to version 8.2.0 (or newer).

**Changed**

- Server: updated to use .NET 8.x LTS from previously used .NET 6.x LTS. .NET 6.x is reaching end of support this upcoming November. With this update to .NET 8.x come numerous benefits including performance and security gains.
- Server: switched the report rendering system from Chromium to Chrome browser to align with the default browser now supported by the Puppeteer headless browser controller library that we use for report generation. There will be a longer than normal delay the _first time_ a report is rendered after upgrading while AyaNova automatically downloads the new report rendering browser.
- Server: all 3rd party components used by the AyaNova server have been upgraded to their most recent release versions to use with .NET 8.x. This improves performance, stability and security for each component used.

**Added**

- Docs: added documentation about a potential issue with "US" being prepended to currency values on reports for non US users and how to correct it in [user settings currency code](home-user-settings.md#currency-code)

### AyaNova 8.1.5

Released 2024-05-03

**Fixed**

- App: issue with Workorder status set to inactive displaying for selection on Work orders
- App: issue with Quote status set to inactive displaying for selection on Quotes

### AyaNova 8.1.4

Released 2024-04-29

**Fixed**

- Server: issue handling retrieval of last work order service date for work orders with a null service date

### AyaNova 8.1.3

Released 2024-04-08

**Added**

- Server: Improvements to license installation code to automatically handle some edge cases that previously prevented license installation
- Docs: Documented ["Viz" fields](ay-report-edit.md#viz-fields-in-report-data) in the report template editor documentation

### AyaNova 8.1.2

Released 2024-03-20

**Fixed**

- App: a true / false [custom field](ay-customize.md#custom-fields) would not display properly in the [data table](ay-start-form-data-tables.md) for that object

### AyaNova 8.1.1

Released 2024-01-26

**Fixed**

- App: some users were seeing an error when dropping file attachments on to a record. (This error was "cosmetic" only and did not affect the functionality of attaching files)

- Reporting: issue where some "Viz" server populated fields such as Work order item Task completion types and other similar pick list related fields on reports were defaulting to English translation instead of the User's selected translation

## 2023

### AyaNova 8.1.0

Released 2023-11-22

**Fixed**

- Server: Customer notes Tag extension: "Job failed" error when using tag extension for customer notes

**Changed**

- App, Server: Reporting - the ayT translation key helper function now shows an error directly in the rendered report in place of an incorrect or uncached translation key rather than the report failing entirely with an error message

- App: Improvements to error handling and display if there is an issue when rendering reports

- App: Customer notes edit form: "New" menu option now defaults Customer selected on the new Customer notes form to the same Customer

**Added**

- App: Work orders, Quotes and PM's added a new feature to the Customer Contact field to enable the user to select from any existing [Contact](customers.md#contacts-tab) entered for that Customer.

- Docs: in several places added a [warning](ops-form-backup.md#failed-backup) about using special characters such as '@' or '$' in the PostgreSQL database name or password as it may interfere with the automatic backup process and cause it to fail.

### AyaNova 8.0.43

Released 2023-05-10

**Fixed**

- App: postal code not being copied when copy to postal or to street address menu items selected on Customer, Head office or Vendor

**Added**

- App: New [Send email extension](ay-ex-direct-smtp.md) to support bulk SMTP email to selected Customers, Vendors, Head office, Users, Contacts
- App: New [Send email](customers.md#send-email) ability to support sending an SMTP email in Customer, Vendor, Head office, User, Contact edit forms
- App: Now indicates if an AyaNova server update is available on login ("Perpetual" licensed build only)
- App: Trial period remaining days display added on login

**Changed**

- App, Server: Change notification settings to allow empty notification password and login to support Office365 direct send SMTP scenario
- Docs: Change log format simplified going forward

### AyaNova 8.0.42 (2023-04-06)

**Fixed**

- App: data table filter changes unintentionally overwriting saved filters

**Changed**

- App: Data table saved filter UI improved usability and functionality saving filters and changing / ovewriting saved filters
- Docs: Re-written [saved filters documentation](ay-start-form-data-tables.md#saved-filters) to reflect changes

### AyaNova 8.0.41 (2023-03-24)

**Fixed**

- Server: report data field `PartDescriptionViz` not being set for Work order and PM

### AyaNova 8.0.40 (2023-03-21)

**Added**

- App: Additional improvements to web app local error logging in certain conditions

**Fixed**

- Server: occasionally causing error saving duplicated Work order, Quote, PM with attachments selected

### AyaNova 8.0.39 (2023-03-17)

**Added**

- App: Improvements to web app local error logging in certain conditions

### AyaNova 8.0.38 (2023-03-16)

**Fixed**

- App: occasionally causing Work order and Quote to show an incorrect current status in their main data table display

### AyaNova 8.0.37 (2023-03-08)

**Changed**

- Server: Unit and Customer report data `LastWorkorderViz` and `LastServiceDateViz` fields now indicate the most recent work order of _any_ Status matching their respective data table similar field

**Added**

- Server: Unit and Customer report data added two new fields `LastWorkOrderCompletedViz` and `LastServiceDateCompletedViz` which indicate the most recent work order set to a _Completed_ Status
- Server, App: Customer [Autocomplete list template](adm-global-autocomplete-templates.md) added all 5 phone numbers, email address and account number as options in addition to existing Tags and Name

### AyaNova 8.0.36 (2023-03-06)

**Fixed**

- Server: Unit report data's "LastWorkOrderViz" field being set to incorrect value

**Changed**

- Server: manual / on demand backup files no longer prepended with "manual-", named same as daily automated backups. Existing "manual-" files found will have the "manual-" portion removed when next backup runs. This resolves a potential issue with pruning of excess backup sets and removes potential confusion from lack of consistent naming. Docs updated to remove reference to "manual-" naming of backup sets.

**Added**

- App: added `Quote w Travel Loan Item Expense Outside Service` report to available Quote reports as the original stock one left out some sections of the quote.
  Note: this report will only automatically install in new databases created after upgrading to this release.  
  For existing databases [download Quote w Travel Loan Item Expense Outside Service](https://ayanova.com/download/xtra/Customer Quote w Travel Loan Item Expense Outside Service.ayrt)
  and [import to AyaNova](adm-report-templates.md#import).

- Docs: added [documentation page](sub-service-intro.md) for AyaNova subscription service on-boarding information

### AyaNova 8.0.35 (2023-01-27)

**Fixed**

- Server: bug preventing import of Translation

### AyaNova 8.0.34 (2023-01-25)

**Added**

- Server: added new [AYANOVA_REPORT_RENDER_API_URL_OVERRIDE](ops-config-report-rendering-api-url-override.md) configuration option for specific report rendering issue scenarios

### AyaNova 8.0.33 (2023-01-24)

**Fixed**

- Server, v8-migrate: Fix for issue preventing erasing database when Customer notification set to a custom translation
- UI: date picker control when selected "Today" option not using local timezone for value could result in wrong day being set
- UI: data table when opening a data table pre-filtered (e.g. viewing a single Customer's units from Customer edit form menu) that had previously been paged was not resetting to page 1

**Changed**

- Server: improved server error logging when unexpected exception prevents erasing database
- Server, UI: Quote, PM, WorkOrderItemXXX collections (labors, travels etc) now fetch and display in edit form in fixed order by "start" / "sent" / "request" dates if dated otherwise in order created

**Added**

- Documentation: various sections improved

### AyaNova 8.0.32 (2023-01-10)

**Changed**

- Installers, Documentation: changed URLs and references in install documentation to ASP.NET Core 6.x specifically as .net core 7 has just been released but is not currently supported for AyaNova

### AyaNova 8.0.31 (2023-01-05)

**Fixed**

- UI: Work order item custom fields not correctly displaying if same index work order header custom field also defined but incompatible data type (no data loss, display issue only)

### AyaNova 8.0.30 (2023-01-04)

**Fixed**

- UI: DateTime and Date controls not displaying properly localized when in edit enabled mode
- UI: Unit edit form New work order menu item not translated
- UI: Customer edit form internally sending an extra unused field on updates

**Changed**

- Developer console: Updated developer console to latest release, was incorrectly showing internal only properties (i.e. ayType)

## 2022

### v8-migrate 8.0.5 (2022-12-30)

**Added**

- v8-migrate: workaround to assigned document file migration, now logs and skips without intervention when issues with URI
- v8-migrate: workaround to handle migrating work order item parts from pre 7.6 AyaNova with inventory off but had been on and empty warehouse id set
- Documentation: improved sections regarding migration from v7 to v8

### AyaNova 8.0.29 (2022-12-20)

**Fixed**

- UI: Part inventory data table was incorrectly showing the Delete and Tag extension when it should only show the export extension
- Server: fixed a bug that could cause a server crash attempting to process mass delete extension on unsupport object types

### AyaNova 8.0.28 (2022-12-14)

**Fixed**

- UI: Work order, Quote, PM were not recognizing record needs to be saved if the only change is in an address field

**Added**

- Server, App, Documentation, v8-migrate: Added Postal / ZIP code to physical address for all addressible objects

### AyaNova 8.0.27 (2022-12-02)

**Added**

- UI: [Service schedule](svc-schedule.md#create-modify-view-events) added Customer selection / edit link to new work order dialog to preselect Customer or create new one using [Open record button](ay-start-form-autocomplete.md#opening-selected-record)
- UI: All schedule forms click on Work order more info dialog added [Work order header's Summary text](svc-workorders.md#summary) below work order serial and customer name

### AyaNova 8.0.26 (2022-11-28)

**Changed**

- Server: Removed unique Name requirement for User / Customer Contact
- App: Added `UserId` field to `ayClientMetaData` so report template scripts have access to the Id of the User rendering the report

### AyaNova 8.0.25 (2022-11-25)

**Fixed**

- UI: Home notifications could error out with "internal server error" rather than list of notifications

**Added**

- Documentation: Multiple pages improved / expanded

### AyaNova 8.0.24 (2022-11-21)

**Added**

- Server: Added new internal API route `/api/v8/notify/direct-smtp` to support on demand notification scenarios
- Server, App: log to AyaNova event log when User sends a direct smtp message using new notify API route, can be viewed in [Event history](adm-history.md)
- Server: Report api utility methods ayPutToAPI, ayPostToAPI, ayGetFromAPI was incorrectly throwing exception on empty return body (202, 204 results)
- App: added `z_API send SMTP from work order report` example report to show how to use the new API notify via smpt method added to
  send an email when a report is rendered automatically.
  Note: this example report will only automatically install in new databases created after upgrading to this release.  
  For existing databases [download z_API send SMTP from work order report](https://ayanova.com/download/xtra/z_API send SMTP from work order report.ayrt)
  and [import to AyaNova](adm-report-templates.md#import).

### AyaNova 8.0.23 (2022-11-18)

**Added**

- Server, App, Documentation: Added [ayPutToAPI](ay-report-edit.md#api-convenience-functions) API convenience method to report renderer
- App: added `z_ayPutToAPI work order` example report to show how to use the new put method added to update a work order on render
  Note: this example report will only automatically install in new databases created after upgrading to this release.  
  For existing databases [download z_ayPutToAPI work order](https://ayanova.com/download/xtra/z_ayPutToAPI work order.ayrt)
  and [import to AyaNova](adm-report-templates.md#import).

### AyaNova 8.0.22 (2022-11-14)

**Changed**

- Server: Quote, Work order state's collections GET change to avoid any potential for non-deterministic ordering

### AyaNova 8.0.21 (2022-11-10)

**Changed**

- UI: New Quote status object's _default_ Roles for who can set and who can remove changed to all compatible Roles (had some incompatible ones before)
- Server: Quote, Work order internal improvements to status change synchronization between header and state collection
- UI: Custom fields improved layout and clarity

**Fixed**

- UI: Home schedule form appointment item icons nudged upwards to layout fully visibly in month view

**Added**

- UI: [Customer](customers.md#new-work-order) and [Unit](svc-units.md#new-work-order) form's menu's added new `New work order` option to directly create a new Work order with these items pre-selected
- UI,SERVER: Part inventory data table added Part Manufacturer as available column
- UI: `New customer` menu option added to [Home schedule](home-schedule.md#menu-options), [Service Schedule](svc-schedule.md#new-customer), [Units table](svc-units.md#new-customer-menu-option), [Workorders table](svc-workorders.md#new-customer-menu-option), [Quotes table](svc-quotes.md#new-customer-menu-option) and [PM table](svc-pms.md#new-customer-menu-option)
- Documentation: more screen shots and images, more to come

### AyaNova 8.0.20 (2022-11-03)

**Fixed**

- UI,Server: Unit Model form implemented "Workorders", "Quotes", "Preventive Maintenance" menu items features to view list of those items for the open Unit Model
- UI,Server: Work order, Quote fixed several issues related to changing Status when restricted Role permissions were set for changing status
- UI: Customize form wasn't showing _full_ Translation keys in each field's subtitle
- UI: Translation form display text editing could cause item being edited to disappear if searched for and modified to no longer match search
- UI: Translation display edit allowed empty string

**Added**

- Documentation: more [guided tours](tour-intro.md) added, many more to come
- UI: User settings added OK popup when changing the "Use browser's standard date time input controls" setting to help indicate it's instantly changed and doesn't require saving the form
- UI: Translation form items table was unsorted by default when first open form changed to sort by Key initially

### AyaNova 8.0.19 (2022-10-29)

**Fixed**

- Server: With generated sample data only, not production use, Work order and Quote could potententially not show as locked when set to a locking status

**Changed**

- UI: Reduced whitespace on forms between fields and row heights in data tables to show more in less space

### AyaNova 8.0.18 (2022-10-27)

**Fixed**

- Server: expiration date of license and maintenance incorrectly stated "(utc)" time in log but is actually server local time
- UI: Evaluation license request page now properly shows that the company name and other details are _required_ and disables request button until filled in

**Changed**

- Server: Erase database huge speed improvement; improves v8-migrate, sample data generation, manual erase by SuperUser in UI
- UI: Administration -> License page added _time_ in addition to existing _date_ for license and maintenance expiration
- UI: Administration -> License page only SuperUser account is offered the Erase Database menu option (no other user has rights to erase db)
- UI: Evaluate, show SuperUser only message _before_ showing generate options dialog rather than on submit
- UI: Evaluation request button now disabled when request is actively being processed

### AyaNova 8.0.17 (2022-10-12)

**Fixed**

- Server: Report rendering would fail if Global setting Company physical address longitude or latitude were set to an empty string

### AyaNova 8.0.16 (2022-10-12)

**Added**

- Server: Debug log level diagnostic information for troubleshooting report generation issues during technical support

### AyaNova 8.0.15 (2022-09-30)

**Added**

- UI, Server, Documentation: Misc. additions and changes for Subscription mode AyaNova

**Fixed**

- Server: Automatic backup pruning to remove backup sets in excess of the [Number of backups to keep](ops-form-backup.md#number-of-backups-to-keep) setting was not deleting manual backup sets

### AyaNova 8.0.14 (2022-09-29)

**Changed**

- UI, Server, Documentation: Dashboard list widgets limited to maximum 100 items to prevent overwhelming and potentially freezing the browser with large quantities of data better viewed through filtered data tables

### AyaNova 8.0.13 (2022-09-28)

**Changed**

- UI, Server, Documentation: Bulk Tag and delete extensions changed to show progress and support cancellation of long running jobs

**Fixed**

- UI: Dashboard issue potentially causing freeze / high memory usage with Reminders, Reviews and Scheduled dashboard widgets

### AyaNova 8.0.12 (2022-09-27)

**Changed**

- SERVER: internal change to batch jobs to prevent long running jobs from hogging CPU cycles in constrained environments

### AyaNova 8.0.11 (2022-09-26)

**Fixed**

- Multiple data tables had more than one column internally defined at the AyaNova server end as the row id column which could result in a table not displaying data and an error message showing in the AyaNova web app. This also meant that the extra row id columns were not able to be set to not display in the data table columns.

### V8-Migrate plugin 8.0.3 (2022-09-23)

**Added**

- UI: "copy to clipboard" button added to migration log display form to enable copy displayed migration log to clipboard
- UI: warning message indicating migration will fail if login to v8 server during migration

**Changed**

- UI: Text displayed when migration ended to more clearly show if failed or completed properly
- Always attempt to send memo of log to SuperUser on any failure
- Always attempt to set v8 server state back to open even if earlier failure

**Fixed**

- Not fail on empty v8 Part name due to missing v7 data but generate a unique placeholder instead

### AyaNova 8.0.10 (2022-09-22)

**Added**

- Documentation: Added Change log / release notes page and links to it
- Documentation: Personal History manual page added section about Ghostery and other similar browser extensions potentialy blocking event log history
- Documentation: several pages added section that clarifies SuperUser is not a normal account and specific information about SuperUser not having access to business data
- Documentation: ops-restore section added more detailed instructions regarding restoration and in particular setting rights and ownership when restoring to Linux server

**Changed**

- License check: when using active trial license now does fast track license check to accomodate slow data migration scenarios where trial license would expire before migration has completed
- Metrics: changed the server's timespan for gathering daily metrics from beta period interval of every 12 hours to normal release interval of 24 hours
- Metrics: changed the default timespan for graphs from last 6 hours to last 7 days
- Metrics form: improved the timeline chart data points to be more clearly visible

**Fixed**

- Documentation: miscellaneous improvements and edits to documentation in multiple places
- Metrics form: fixed issue with some timeline charts not displaying properly

#### Removed

- Evaluate form: removed various levels of trial data seeding, defaults to small only
- Profiler form: removed now that beta test and primary development has ended