Aeon 5.2 Release Notes
Important Update Information
Released - May 16th, 2023
Highlights
As promised on the Aeon Product Roadmap, here are the main features/enhancements of Aeon v5.2:
- Appointment Scheduling Enhancements
- WebView2 Browser Enhancements
- ArchivesSpace Request Fulfillment via Aeon Plugin Enhancements
There are over 50 bug fixes in this release.
Considerations Before You Update
info
Review Aeon 5.2 FAQ and Webinars
For frequently asked questions and additional information regarding the 5.2 features and fixes, please see the Aeon 5.2 FAQ. You can also view the Aeon 5.2 release webinars in the Video Training Library, which include a general Q&A session and two detailed sessions overviewing the new 5.2 Appointment Scheduling features and the updated ArchivesSpace Request Fulfillment plugin. For all other questions, please contact support at support@atlas-sys.com.
Updating During Normal Working Hours
Please consider running updates and installations during standard support hours 8 am - 5 pm eastern time (business days: Monday - Friday) so that help is readily available if any issues are encountered.
Updating Procedures
Before you begin updating, please review the Hardware and Software Requirements for Version 5.2. For specific instructions on updating, see Updating Aeon to the Newest Version. Please also review the Installing and Updating section of the release notes.
Warning! New System Requirements
- The IIS 6 Management Console component must be installed on Aeon Servers using Windows Server 2022 prior to performing the Aeon 5.2 server upgrade due to a known issue affecting PowerShell. For installation instructions, see Installing Required Windows Server 2022 Components for the Aeon 5.2 Update
- Aeon Server 5.2.9 or later requires the Microsoft ASP.NET Core 8.0 Runtime Bundle for the Aeon API. This bundle can be installed via Microsoft's website. To prevent disruptions in the Aeon API after updating, please ensure that this bundle is installed on the Aeon Server prior to updating to Aeon 5.2. Once the update has been run, Microsoft .NET Core 2.2 should be manually removed from the server, if present. See Microsoft's documentation for instructions on this process.
- .NET Framework 4.7.2 may be required to perform the Aeon 5.2 server upgrade. See the Installing and Updating section of the release notes below for more information.
- Aeon Desktop Client 5.2 requires Windows 10 or higher. Due to the WebView2 changes included in this release, the Aeon Desktop Client will not successfully install on machines using earlier versions of Windows operating systems. Attempting to install Aeon 5.2 on an incompatible operating system will cause the Aeon Desktop Client Installer to return an error stating "there is a problem with this Windows Installer package."
Troubleshooting Information
Some users may experience an "Upload Error" when using the Upload File feature in the Aeon Desktop Client after updating to Aeon 5.2. For information on resolving this error, please see Resolving File Upload Errors After the Aeon 5.2 Update.
info
Point Releases
Bug fixes and new features are added periodically as point releases. See 5.2.x point releases below:
- 16 May 2023 (1.3.2) Atlas Authentication Portal Release
- 06 July 2023 (5.2.4) Aeon Server/Web DLL & (5.2.2) Server Installer Scripts Release
- 06 July 2023 (5.2.4) Default and Feature-Specific Web Pages Release
- 06 July 2023 (5.2.2) Desktop Client Release
- 12 July 2023 (5.2.3) Desktop Client Release
- 28 August 2023 (5.2.5) Aeon Server/Web DLL Release
- 16 October 2023 (5.2.6) Default and Feature-Specific Web Pages Release
- 07 February 2024 (5.2.6) Aeon Server/(5.2.7) Web DLL/(5.2.3) System Manager & (5.2.4) Desktop Client Release
- 05 March 2024 (5.2.7) Aeon Server/(5.2.8) Web DLL Release
- 18 March 2024 (5.2.11) Default & Feature-Specific Web Pages Release
- 04 April 2024 (5.2.13) Default & Feature-Specific Web Pages Release
- 11 April 2024 (5.2.9) Aeon Server/(1.5.2) Aeon API
- 29 April 2024 (5.2.10) Aeon Server Release
- 17 June 2024 (5.2.11) Aeon Server/(5.2.2) Web Platform/(5.2.4) System Manager& (5.2.5) Desktop Client Release
- 03 July 2024 (5.2.22) Default & Feature-Specific Web Pages Release
- 29 May 2025 (5.2.12) Aeon Server/(5.2.9) Web DLL Release
For a list of current known issues, see UserVoice.
Aeon 5.2 Features & Fixes
Aeon API | Addons | Administrative | Appointment Scheduling | ArchivesSpace Request Fulfillment Plugin | Customization Manager | Database | Email | Installing and Updating | Staff Desktop Client | Staff Manager | System Manager | Web Interface
Aeon API
| New | Added several new endpoints to the Aeon API:
For more information, see Aeon API. |
|---|---|
| Changed | The Create Request endpoint (/api/Requests/create/) will now perform validation to ensure that the request can be added to the associated appointment based on the timeframe configured in the associated reading room's Request Minimum/Maximum Lead Days settings in the Aeon Customization Manager. |
| Changed | The Create Request endpoint will now return detailed error messages when invalid values are submitted for the requestFor and customFieldValues properties. Bug# 13747 |
| Fixed | Fixed an issue where validation would not be applied to ensure that users were properly associated with activities attached to requests created using the Create Request endpoint. The endpoint will now return an error if the specified activity is not associated with the user for whom the request is created. Bug# 11562 |
| Fixed | Fixed an issue where the Create Request endpoint would return an error stating that the format, serviceLevel, and shippingOption field values were invalid if the specified requestFor or username values contained an invalid username. Bug# 13743/Bug# 17649 |
| Fixed | Fixed an issue where the API would return incorrect or redundant error messages when validating transactions. Bug# 8889 |
| Fixed | Fixed an issue where certain configuration changes such as updates to existing activities, users, and appointments would not be detected by the Aeon API until the IIS service was restarted. Bug# 13746 |
Addons
| New | Added support for the Microsoft Edge WebView2 embedded browser within the Aeon Desktop Client and Client addons. Support for the WebView2 browser will include the following enhancements:
:::tip For more information on the Aeon Desktop Client controls listed above, see Locating System Details and Clearing the WebView2 Cache in the Aeon Desktop Client. ::: :::tip Addons developers can find complete information on implementing the WebView2 browser within addons in the addon documentation. ::: :::warning Note: This update will not remove support for the Chromium or IE browsers from the Aeon Desktop Client. However, due to Microsoft’s end of support for Internet Explorer, we cannot guarantee that addons using the IE browser will work indefinitely with Aeon. It is strongly recommended that addon developers update addons to include support for WebView2 and that users update their addons to the new WebView2 versions when available. ::: :::info The WebView2 browser will only be used for browsers embedded within the Aeon Desktop Client. Any browser windows that open externally from the client will still use your machine’s default browser. ::: |
|---|---|
| New | Updated the Aeon ArchivesSpace Client Addon to use the new WebView2 embedded browser. For information on installing the addon, please see the addon's page in the Aeon Addon Directory. |
Administrative
| New | Added the collection of telemetry data to the Aeon Desktop Client and Web API. This feature will track the number of times each form and button is used in the Aeon Desktop Client and each time an endpoint is used in the Aeon API to assist with prioritizing features for future updates. Data collection will operate under the following restrictions and privacy considerations:
For more information on this feature, see Aeon Telemetry Data Collection. |
|---|---|
| Changed | Logs for the following Aeon components are now configured to use UTF-8 encoding by default to fix an issue where some characters, such as those with diacritics and non-Latin characters, did not display correctly (Bug# 21305):
:::warning This change will be applied automatically for new Aeon 5.2 installs only (i.e., those installing Aeon for the first time at version 5.2). If updating to Aeon 5.2 from a previous version of Aeon, the encoding change must be applied to each log's configuration file manually following the instructions in the documentation. ::: |
Appointment Scheduling
info
If you are updating from Aeon 5.1 and already have appointment scheduling features enabled, please review the appointment scheduling update checklist and make note of important changes and action items that should be performed before and after updating to Aeon 5.2.
| New | Appointment Status and Confirmation Workflows Reading rooms can now be configured to require that appointments booked in the room by patrons on the Aeon web interface are manually reviewed and confirmed by staff in the Aeon Desktop Client using new appointment confirmation workflow options:
:::tip For more information, see Appointment Confirmation and Notification Settings. ::: :::warning All existing appointments will be set to the Confirmed status upon updating. Existing reading room calendars configured in the Aeon Customization Manager prior to updating will have the Auto-Confirm Appointments option unchecked (disabled) upon updating to Aeon 5.2, meaning that appointments booked in the room from the web interface will be Unconfirmed by default. ::: |
|---|---|
| New | Appointment Reminder and Notification Emails To support appointment confirmation workflows, new email templates and notification options have been added for sending patrons additional appointment notification and reminder emails throughout the appointment booking and confirmation process:
:::tip For more information, see Appointment Confirmation and Notification Settings. ::: :::warning Existing reading room calendars configured in the Aeon Customization Manager prior to updating will have reminder emails disabled and appointment-received emails enabled after updating. Enabling reminder emails for a reading room after the 5.2 update will also schedule reminder emails for upcoming appointments that were booked in the room prior to updating. ::: |
| New | Added a new Reading Room Description field to the appointment scheduling settings for each reading room calendar configured in the Aeon Customization Manager. This field can be configured with reading-room-specific policies and then added as a merge field on appointment-type email templates to customize them with information related specifically to the room in which the appointment has been booked. :::tip For more information, see Appointment Confirmation and Notification Settings. ::: :::warning Reading Room Description is only used on email templates and will not be displayed by default to patrons anywhere on the Aeon web interface. This field is limited to 1000 characters. ::: |
| New | New and Improved Client Appointment Form Updated the Appointment form used to display and edit information for individual appointments in the Aeon Desktop Client with the following new options and features:
|
| New | Redesigned Reading Room Calendar Configuration Interface The Appointment Scheduling tab in the Aeon Customization Manager has been redesigned so that appointment settings for each reading room are now configured in two separate Policies and Open Hours sub-tabs:
:::tip For complete details, see Configuring Reading Room Calendars. ::: |
| New | New Status-Specific Configuration Options for Reading Rooms The following new and existing reading room appointment settings in the Aeon Customization Manager can now be optionally configured into separate sets of status-specific policies that will be selectively applied based on the status of the user requesting an appointment (e.g., staff, undergraduate, faculty, etc.):
These settings are found and configured in the new Status-Specific Policies table that has been added to the Policies tab for each reading room calendar configured for appointments in the Aeon Customization Manager. :::tip For complete configuration details, see Configuring Reading Room Calendars. ::: :::warning Each existing reading room calendar configured in the Aeon Customization Manager prior to updating will have the values contained in its Minimum/Maximum Lead Days and Appointment Required settings imported into a default, non-status-specific row in the Status-Specific Policies table after updating to Aeon 5.2:
::: |
| New | **Separate Minimum/Maximum Lead Days Settings for Appointments and Requests The ** Minimum Lead Days and Maximum Lead Days ** settings used when configuring reading room calendars in the Aeon Customization Manager have been split into separate ** Appointment Minimum/Maximum Lead Days ** and ** Request Minimum/Maximum Lead Days ** settings to allow patrons different time windows for booking new appointments in the reading room and for adding new requests to existing appointments:
These settings are configured in the ** Status-Specific Policies ** table for each reading room calendar configured for appointments in the Appointment Scheduling tab of the Aeon Customization Manager. :::warning The previous Minimum and Maximum Lead Days fields used in Aeon 5.1 will be ** removed ** from the database after updating to Aeon 5.2. ::: :::danger Action Required! Update Existing Status Lines and Email Templates Sites updating from Aeon 5.1 must manually update Appointment-related email templates and status lines that were configured to use tags for the old Minimum and Maximum Lead Days fields to instead use the tags for the new fields after updating **. For more information, see the ** Checklist for Updating Appointment Scheduling from Aeon 5.1 to 5.2**. New installations of Aeon 5.2 will use the new fields by default in email templates and status lines. ::: |
| New | Added two new status lines to the **Aeon Customization Manager ** under ** Web Interface |
| New | Added a newSLEditAppointmentInvalid status line to the **Aeon Customization Manager ** under ** Web Interface |
| New | The Appointment Required setting configured on reading room calendars in the Aeon Customization Manager will now apply only to the individual reading rooms for which the setting is enabled instead of applying to all reading rooms on the site. Additionally, the Aeon DLL will now also properly validate and enforce the appointment requirement on the EAD Request form (EADRequest.html) according to the settings configured for the selected reading room in the Customization Manager. :::danger Action Required! To support this new functionality, additional web validation for the Reading Room field must be configured in the WebValidation table after updating. For instructions, see Configuring the WebValidation Table to Enforce the Appointment Requirement. ::: |
| New | For multi-site instances of Aeon, the Aeon DLL will now perform additional validation when submitting requests from the Saved Requests web page (ViewUserReviewRequests.html) to ensure that the reading room selected is associated with the site value for each request:
See Appointment Scheduling Web Interface for more details. :::warning To implement this fix, please download the latest set of Aeon default web pages from the Aeon Downloads page and overwrite the KeepInReview.js file located in the js folder in your Aeon Web Directory with the updated file. ::: |
| New | Appointment Scheduling 5.2 Web Pages The feature-specific appointment scheduling pages were updated with a variety of new features and fixes to meet the latest web page accessibility requirements, provide a better experience for screen reader and keyboard-only users, and streamline the appointment scheduling process: :::tip Implementation Instructions
:::
:::tip For more information on the new features described above, see Appointment Scheduling Web Interface. ::: |
| New | Added the Appointment Name and Status fields to all grids containing appointment-related information in the Aeon Desktop Client and to the information displayed for individual appointments on the Client calendar interface. :::warning If updating from a previous version of Aeon, these fields will need to be manually added to any grids that had been customized prior to updating. ::: |
| New | All fields from the Appointments database table and select fields from the ReadingRooms table (ReadingRoomName, MinAppointmentLength, MaxAppointmentLength) can now be added as merge fields to the print templates for requests and callslips (PrintRequest.docx and PrintCallslip.docx). For more information on adding these fields to the print templates, please see Appointment Scheduling Overview. |
| New | Added a GetAppointmentAvailabilities AJAX endpoint that will retrieve all available appointment slots for a reading room across a specified range of dates. For more information, see**Appointment Scheduling AJAX Endpoints**. |
| New | Deleting or anonymizing a user will delete all Appointment-type emails that had been sent to that user from the database. |
| Changed | The Appointment Rescheduled email template will now be sent automatically to the patron when an appointment is rescheduled from the Aeon web pages. |
| Changed | Changed the default behavior for the initial appointment start time when creating a new appointment in the Aeon Desktop Client:
:::info The appointment start time will continue to default to the time selected on the calendar interface when in the appointment calendar's Day and Timeline views. ::: |
| Changed | Updated existing API endpoints to reflect new Appointment Scheduling features:
|
| Changed | Several improvements were made to the grid of appointments that is displayed while using the appointment association controls located on the Request form, Requests tab of the User Information form, and Request list grids in the Aeon Desktop Client:
|
| Fixed | Fixed several issues affecting the appointment scheduling web pages:
To implement these fixes, please update your appointment scheduling web pages. |
| Fixed | Fixed an issue where using the Submit Request button to submit a saved request via the Actions dropdown menu or from the Request Details page would not enforce the appointment requirement for the reading room or site associated with the request. Bug# 13543 |
| Fixed | Fixed an issue where the entire Aeon Desktop Client would become unresponsive if any appointments contained bad data. Bug# 15330 :::warning Any invalid appointment data in the Aeon database (e.g., an appointment with a start time later than its stop time or an appointment containing an improperly cased username) will now cause the appointment scheduling interfaces in the Client to display an error message directing the user to contact Atlas Support. Improperly cased usernames will no longer prevent the Appointment form from opening and will be corrected upon making and saving changes to the associated appointment. ::: |
| Fixed | Fixed an issue where an appointment could be created with invalid data and cause errors in the Aeon Desktop Client if a user created the appointment while logged into the web interface with a username containing trailing spaces or a different casing than the username associated with their user record. Bug# 15329 |
| Fixed | Fixed an issue where appointments could not be saved using the Request form controls in the Aeon Desktop Client when the computer's time zone was set to Coordinated Universal Time (UTC). Bug# 15576 |
| Fixed | Fixed an issue where the Appointments tab could be added to the Aeon Desktop Client using the layout customization tools even when no reading rooms were configured for appointment scheduling in the Customization Manager. Bug# 14767 |
| Fixed | Fixed an issue where setting a Reduced Availability exception for a reading room in the Customization Manager would cause the appointment scheduling calendar on the web pages to show the entire day as unavailable no matter how many seats were still available after the exception. Bug# 16362 |
| Fixed | Fixed an issue where a reading room could potentially be overbooked by a patron on the web under certain configuration settings. Bug# 16912 |
| Fixed | Fixed an issue where appointments with only one associated request would display the incorrectly pluralized text "1 Requests" on the calendar in the Aeon Desktop Client. |
| Fixed | Fixed an issue where changes to the name of an appointment in the Aeon Desktop Client would not be saved when the Appointment form was closed. Bug# 19121 |
| Fixed | Fixed an issue where Appointment merge fields used in Transaction-type email templates would appear blank when emails were generated for the template. Bug# 17993 |
_16579724962067.png)
_15231002071443.png)
_15094824512275.png)
ArchivesSpace Request Fulfillment Plugin
tip
To download and install the updated plugin, visit the ArchivesSpace Request Fulfillment via Aeon GitHub. If your ArchivesSpace repository is hosted by Atlas Systems, contact support@atlas-sys.com to request an update.
| New | Updated the ArchivesSpace Request Fulfillment plugin ** tov20230302 **. This version of the plugin is only compatible with **Aeon 5.2 ** and contains the following new features:
:::tip For more information on these new features and options, see ArchivesSpace Request Fulfillment via Aeon. ::: |
|---|---|
| New | Added new default and feature-specific Archival Request form web pages to the Aeon web directory to support the new plugin options. When the Archival Request form is configured to work with the plugin, clicking the Aeon Request button in ArchivesSpace will bring users to the new form containing the following new features:
:::tip The updated plugin will not use the Archival Request form by default. For more information on this form and for configuration instructions, see The Archival Request Form. ::: |
| New | The Aeon Customization Manager's OpenURLMapping table will now contain several pre-configured, default mapping entries for the ArchivesSpace Request Fulfillment plugin to streamline the plugin configuration process. These default mappings can be changed or removed from the table as needed and will not affect any sites that do not use the ArchivesSpace Request Fulfillment plugin. :::tip For more information on configuring OpenURLMapping table entries for the ArchivesSpace Request Fulfillment plugin, see ArchivesSpace Request Fulfillment via Aeon. ::: :::warning The new default mappings will be added to the OpenURLMapping table for all new Aeon installations and for existing Aeon installations upon update only if mappings were not configured for the ArchivesSpace plugin in the table prior to updating. The new default mappings will not be added to the OpenURLMapping table upon updating to Aeon 5.2 if mappings for the plugin were already configured in this table prior to updating. Pre-existing mappings for the plugin configured in the OpenURLMapping table will remain unchanged by the 5.2 update. ::: |
| New | Added new AccessRestrictions and ContainerID fields to the Aeon Transactions database table. These fields can be configured in the OpenURLMapping table to import restrictions and container information from the ArchivesSpace record into the Aeon request. See the Staff Desktop Client section below for more information on configuring these new fields in the Aeon Desktop Client. For more information on configuring OpenURLMapping table entries for the ArchivesSpace Request Fulfillment plugin, see ArchivesSpace Request Fulfillment via Aeon. |
| New | Added new files to the Aeon 5.2 default and feature-specific appointment scheduling web pages to support the new Archival Request box picker form:
For more information on configuring these files, see The Archival Request Form. |
| New | Added four new customization keys to the Aeon Customization Manager to support new plugin features:
|
| Fixed | Fixed an issue where the plugin's languageimport field would not properly import language values from the ArchivesSpace record into the Aeon request. This field will now import the following information from the ArchivesSpace record into Aeon when it is configured as an import field for the plugin in the Aeon Customization Manager's OpenURLMapping table:
Records with multiple language values will have those values imported as a semi-colon-separated list. For more information on configuring import fields for the plugin in the OpenURLMapping table, see ArchivesSpace Request Fulfillment via Aeon. |
Customization Manager
| Changed | Changed certain hard-coded colors within the Customization Manager to instead adjust depending on the skin chosen by the user to provide better color contrast ratios. For example, fields that have been edited and not yet saved had been always highlighted in yellow, but will now adjust to different colors based on the selected skin. |
|---|---|
| Fixed | Fixed an issue where the WebFormValidationLinks table contained two default entries for the "AllRequests" and "ReadingRoomRequests" rule sets that used an incorrect form name to apply these rules to the EditEADRequest.html web page ("EditGenericRequestEAD"). :::info The form name used in these entries will be changed to the proper name for the form ("EditEADRequest") for all new Aeon installations and for those updating to Aeon 5.2 from a previous version of Aeon if the default entries using the incorrect form name are still present in the WebFormValidationLinks table. If these default entries have been modified, then the form name will need to be corrected manually after updating. ::: |
Database
| New | Added new tables to the database to support new appointment scheduling features:
For details, see*Aeon Database Tables**.* |
|---|---|
| New | Added new columns to the Appointments table:
|
| New | Added new AccessRestrictions and ContainerID fields to the Transactions table. See the Staff Desktop Client section below for more information on these new fields. |
| Changed | The following changes were made to the ReadingRooms table:
|
| Fixed | Fixed an issue where requests could be created with a null (empty) Transaction Status and cause issues in the Aeon Desktop Client. The Aeon Database will no longer allow a null transaction status and will default the request to the Web Request Created status. Bug# 19511 :::warning Web Request Created is a transitory status that records the request's entry in the Transactions table. Requests are not meant to stay in this status and this status is not logged in the History or Tracking tables. If a request appears in this status in the Aeon Desktop Client after updating, please contact support@atlas-sys.com with the affected transaction number(s) for troubleshooting. ::: :::info The name of this queue can be changed in the Queues tab of the Aeon Customization Manager. If the name of the Web Request Created queue was changed prior to updating, the queue that will be used as the default transaction status can be identified by locating the queue that has an internal state code of WebRequestCreated and a state code of 5. For more information on changing the names of queues and locating each queue's state code, see The Queues Table. ::: |
Email
| Fixed | Fixed an issue where the From address specified on email templates would not be used when sending emails and would instead default to the value set in the LocalInfo table. The From address will now only default to the LocalInfo table value if this field is empty on the email template. Bug# 13531 |
|---|---|
| Fixed | Fixed an issue where the From address would be inconsistent on emails sent from the Aeon Desktop Client and those sent from the Aeon web interface. Emails sent from the Aeon web will now have this information populated in the same way as those sent from the Aeon Desktop Client. |
| Fixed | Fixed an issue where SMTP header information contained in the SMTP.config file would be overwritten by Aeon in some cases. Bug# 13531 |
Installing and Updating
danger
Warning! New System Requirements
- The IIS 6 Management Console component must be installed on Aeon Servers using Windows Server 2022 prior to performing the Aeon 5.2 server upgrade due to a known issue affecting PowerShell. For installation instructions, see Installing Required Windows Server 2022 Components for the Aeon 5.2 Update
- Aeon Server 5.2.9 or later requires the Microsoft ASP.NET Core 8.0 Runtime Bundle for the Aeon API. This bundle can be installed via Microsoft's website. To prevent disruptions in the Aeon API after updating, please ensure that this bundle is installed on the Aeon Server prior to updating to Aeon 5.2. Once the update has been run, Microsoft .NET Core 2.2 should be manually removed from the server, if present. See Microsoft's documentation for instructions on this process.
- .NET Framework 4.7.2 may be required to perform the Aeon 5.2 server upgrade. See the release notes below for more information.
- Aeon Desktop Client 5.2 requires Windows 10 or higher. Due to the WebView2 changes included in this release, the Aeon Desktop Client will not successfully install on machines using earlier versions of Windows operating systems. Attempting to install Aeon 5.2 on an incompatible operating system will cause the Aeon Desktop Client Installer to return an error stating "there is a problem with this Windows Installer package."
| New | Added several new default queues that will be installed to the Aeon Customization Manager's Queues tab for new Aeon installations:
:::tip For more information on the Aeon default queues, see The Queues Table. ::: :::warning Note: These queues will only be added for new Aeon installations. Existing Aeon installations updating to v5.2 from a previous version of Aeon will not have these queues installed upon updating. ::: |
|---|---|
| New | Added several new default routing rules that will be installed to the Aeon Customization Manager's Routing tab for new Aeon installations:
:::tip For more information on:
::: :::warning Note: These routing rules will only be added for new Aeon installations. Existing Aeon installations updating to v5.2 from a previous version of Aeon will not have these queues installed upon updating. ::: |
| New | Added the apiParentWebsite parameter to this server installation/update PowerShell scripts that can be used to modify the IIS website under which the Aeon API is installed (default value: "Default Web Site"). :::info To modify the value of this parameter, please run the server installation/update scripts in advanced mode. ::: |
| Changed | Updated the name of the default Awaiting Order Billing queue/photoduplication status to Awaiting Order Payment for new Aeon installations. The name of this queue will remain unchanged for sites updating from a previous version of Aeon. |
| Changed | The server installation/update PowerShell scripts are now signed with the Atlas code signing certificate, removing the need to set the system execution policy to "unrestricted" prior to running the scripts. |
| Changed | Non-administrator user accounts on the Aeon Server can now run the server installation/update PowerShell scripts, removing the need to log into the server with an administrator account prior to opening PowerShell. :::warning Note: PowerShell must still be opened via the ** Run as administrator**option. ::: |
| Changed | Increased the Internet Information Services (IIS) maxQueryString value set by the server installation PowerShell scripts to 4096 characters in order to prevent issues caused by OpenURL query strings that exceeded the previous default allowance of 2048 characters. |
| Changed | The following files used by the Aeon DLL are now installed to C:\Program Files (x86)\Aeon\WebDependencies by default instead of to the Aeon web directory (default location: C:\Program Files (x86)\Aeon\Web) in order to prevent these files from being removed or overwritten when changes are made to the web pages:
:::info The default installation path for these files can be modified by changing the value in the webDependenciesDirectory parameter when running the server installation/update scripts in advanced mode. ::: :::warning If upgrading from a previous version of Aeon, a legacy copy of these files will remain in your web directory after updating (default location: C:\Program Files (x86)\Aeon\Web). As a best practice, these legacy files can be deleted once your upgrade is complete:
::: |
| Changed | Removed the SQL Server Native Client component from the Aeon 5.2 server hardware and software requirements due to the end of support for this component by Microsoft. The Aeon server will now use the Microsoft OLE DB Driver for SQL Server in place of the SQL Server Native Client. :::info The Microsoft OLE DB Driver for SQL Server will be installed by the Aeon 5.2 server installation/update scripts and does not need to be installed separately. ::: |
| Changed | The server installation/update PowerShell scripts will now use the SQL Server PowerShell Module during the Aeon 5.2 update/installation process. The scripts will use whichever version of the module is currently installed on the Aeon Server, if present. If the module is not yet installed on the Aeon Server, then the latest version of the module (v22.0.59) will be installed during the server installation/update process. :::danger The most recent version of the SQL Server PowerShell Module (v22.0.59) requires that .NET Framework 4.7.2 or higher is installed on the Aeon Server. An error will be returned during the server update/installation process if the .NET Framework version is insufficient. For more information, see Resolving SQL Errors During the Aeon 5.2 Server Update. ::: |
Staff Desktop Client
| New | Added support for the Microsoft Edge WebView2 embedded browser within the Aeon Desktop Client. :::tip For more information on the impact of this change, please see the WebView2 entry in the Addons section of the release notes above. ::: |
|---|---|
| New | Added support for setting Transaction context type custom field values when creating requests from file in the Aeon Desktop Client. :::info The column name for the Transaction type custom field in the Excel spreadsheet should be configured to match the short name defined for the field in the CustomFieldDefinitions table. ::: :::warning **User ** and Activity context type custom fields are not supported for use with this feature. ::: |
| New | New Access Restrictions and Container ID text fields are now available to add on the Request form in the Aeon Desktop Client and on web request forms in the Aeon web interface. These fields are also available as merge fields for print templates. :::warning Note: These fields are not available on the Request form by default and must be added manually using the staff layout customization feature. For more information on this feature, see Creating and Assigning Templates to Staff Users. ::: :::info These fields can be added to your web forms using the following code: Access Restrictions: <br><div class="form-group col-md-8"><label for="AccessRestrictions"><span class="<#ERROR>">Access Restrictions</span></label><input type="text" class="form-control" name="AccessRestrictions" id="AccessRestrictions" value="<#PARAM name='AccessRestrictions'>"></div><br>Container ID: <br><div class="form-group col-md-8"><label for="ContainerID"><span class="<#ERROR>">Container ID</span></label><input type="text" class="form-control" name="ContainerID" id="ContainerID" value="<#PARAM name='ContainerID'>"></div><br>::: |
| Changed | Updated the Aeon Citation control located within the Z39.50 search interface on the Request form used to display citation information in rich text format. |
| Changed | For enhanced security, an entry will no longer be added to the User Change History on the User form when a user's password is changed. |
| Changed | Changed certain hard-coded colors within the Client to instead adjust depending on the skin chosen by the user to provide better color contrast ratios. For example, fields that have been edited and not yet saved had been always highlighted in yellow, but will now adjust to different colors based on the selected skin. |
| Changed | Extra spaces are now trimmed from the username saved to the database when creating a new username or updating an existing username for a user in the Aeon Desktop Client. |
| Fixed | Fixed an issue where filtering or sorting requests in the grid view by either the appointment Start Time or Stop Time fields would break the results. Bug# 14166 |
| Fixed | Fixed an issue where the current date could not be selected when adding attendance count to an activity. Bug# 13930 |
| Fixed | Fixed an issue where request callslips could not be printed from an Activity Information record if any custom fields were defined in the Customization Manager's CustomFieldDefinitions table. Bug# 14570 |
| Fixed | Fixed an issue where refreshing the Client would sometimes throw a multithreading error in the Client logs and lead to slowness issues. Bug# 16762 |
| Fixed | Fixed an issue where the Client would sometimes attempt to use a bad database connection when refreshing user or reading room information. Bug# 17093 |
| Fixed | Fixed an issue where any custom fields added to a custom tab group created on the Request, User, or Activity Information form would display highlighted yellow. Bug# 15993 |
| Fixed | Fixed an issue where leaving the FutureRoutingDays customization key value blank would cause errors when attempting to import requests from file. Bug# 15791 :::info The FutureRoutingDays key will now default to a value of -1 when left blank or when set to a non-numeric value and cause requests to immediately enter the Awaiting Request Processing status. ::: |
| Fixed | Fixed a formatting error in the Aeon Desktop Client log entry added when a user signed into a reading room is set to away. Bug# 19730 |
| Fixed | Fixed an issue where the controls located within the Aeon Options form were not aligned properly within the borders of each section of options on the screen. Bug# 18418 |
Staff Manager
| Changed | Changed certain hard-coded colors within the Staff Manager to instead adjust depending on the skin chosen by the user to provide better color contrast ratios. For example, fields that have been edited and not yet saved had been always highlighted in yellow, but will now adjust to different colors based on the selected skin. |
|---|---|
| Changed | Extra spaces are now trimmed from the username saved to the database when creating a new username or updating an existing username for a user in the Staff Manager. |
| Fixed | Fixed an issue where trailing and leading spaces would not be trimmed from the Username, First Name, and Last Name values when creating and/or editing staff users. Bug# 16655 |
System Manager
| Changed | The setup and update installer files downloaded by the System Manager and used to auto-update the Aeon Desktop Client when a new version is available will now be placed in separate Install and Update subfolders within the AeonUpdates\Client folder in the web directory (default location C:\Program Files (x86)\Aeon\Web\AeonUpdates\Client). For more information on this process, see "Obtaining the Client Installer Files" in Aeon System Manager. |
|---|---|
| Fixed | Fixed issues where the System Manager would not detect newly created or modified custom queues and fields for use with addons until the service was restarted. The System Manager will now check the Queues and CustomFieldDefinitions tables in the Aeon Customization Manager for changes and use the most up-to-date custom field and queue configurations each time an addon runs. Bug# 18405/Bug# 15370 |
Web Interface
| New | The date picker calendar used for the **Scheduled Date ** field in the default Aeon web pages has been updated to a significantly more accessible version for screen reader and keyboard-only users. In addition to the calendar's new accessibility features, unavailable dates will now be crossed out and displayed with a grey background:_15046124584723-636881a30f210c0365642e906392a1ae.png) As%20part%20of%20this%20change,%20the%20default%20web%20pages%20were%20also%20updated%20to%20 **remove **%20the%20hardcoded%20Scheduled%20Date%20field%20on%20each%20request%20form%20and%20instead%20implement%20this%20field%20using%20new%20 **include_scheduled_date.html **%20and%20 **include_scheduled_date_ead.html **%20files. :::tip For%20complete%20details%20and%20instructions%20on%20implementing%20the%20new%20calendar%20tool%20in%20the%20Aeon%20default%20web%20pages,%20please%20see%20**Implementing%205.2%20Web%20Page%20Changes **. ::: :::info **Updating%20Custom%20Fields ** The%20updated%20date%20picker%20calendar%20can%20also%20be%20implemented%20for%20any%20 custom%20Date%20fields%20used%20on%20your%20Aeon%20web%20forms.%20For%20instructions%20on%20updating%20the%20calendar%20tool%20for%20custom%20Date%20fields%20previously%20implemented%20on%20your%20forms%20in%20Aeon%205.1,%20see%20 Updating%20the%20Date%20Picker%20Calendar%20Used%20for%20Custom%20Date%20Fields%20on%20Web%20Forms%20(Aeon%205.2%20Web%20Pages).%20For%20instructions%20on%20implementing%20a%20custom%20Date%20field%20on%20your%20Aeon%20web%20forms%20from%20scratch,%20see%20 Adding%20Custom%20Fields%20to%20Web%20Forms. ::: |
|---|---|
| New | Several additional changes were made to the default web pages. The new web pages are not installed automatically to prevent overwriting any customizations your institution may have created. The complete set of v5.2 web pages are available for download on the Aeon Downloads page. For more information on implementing these changes, see Implementing 5.2 Web Page Changes:
|
| New | Added a new WebHomePage customization key (located in the Aeon Customization Manager under Web Interface |
| New | Added a WebCookieSameSite customization key to the Aeon Customization Manager under **Web Interface |
| Changed | Changed the web page redirect behavior when submitting requests from the Saved Requests page:
|
| Fixed | Fixed an issue where the <#OPTION> web tag could not be used to automatically generate a list of checkbox options for CustomDropDown type custom fields on web forms. Bug# 14532 :::tip For more information on configuring this feature using custom fields, see Automatically Generate Checkbox Selections for a CustomDropDown Group. ::: |
| Fixed | Fixed an issue where the web pages would display a blank space if no title was provided for an item, causing issues for screen readers. Bug# 17579 :::info The web pages will now display the text configured in a new WebNoTitleText customization key added to the Aeon Customization Manager under **Web Interface |
| Fixed | Fixed an issue where the Request For dropdown on request forms was not properly validated to ensure that the researcher or activity selected was associated with the user submitting the request. Bug# 11699 |
| Fixed | Fixed an issue where cloning a photoduplication request on the web would create a non-photoduplication request. Bug# 14459 |
| Fixed | Fixed an issue where status lines would not display on photoduplication request pages when accessed using the Clone to Copy button. Bug# 15485 |
16 May 2023 (1.3.2) Atlas Authentication Portal Release
Atlas Authentication Portal version 1.3.2 was released on May 16th, 2023. This release includes several changes to the session cookie generated by the Atlas Auth Portal upon login that will allow Aeon to persist the user's login when placing requests through the portal from an external website (i.e., from a website outside of the Aeon web pages, such as a library catalog or finding aid) in most instances.
danger
Atlas Auth Portal 1.3.2 requires .NET Framework 4.7.2 or greater, which is higher than the minimum .NET framework version required by the Aeon Server. Please ensure that the upgraded version of this component is installed on the Aeon Server prior to upgrading to/installing Atlas Auth Portal v1.3.2.
info
Update Instructions
The Atlas Auth Portal files can be obtained from the **Aeon Downloads**page. For step-by-step instructions on implementing the 1.3.2 release, see Atlas Auth Portal 1.3.x Release Configuration.
| New | The session cookie generated by the Atlas Auth Portal will now include SameSite and Secure properties that will allow Aeon to persist the user's login when placing requests through the portal from an external website (i.e., from a website outside of the Aeon web pages, such as a library catalog or finding aid) in most instances. By default, the SameSite and Secure cookie properties will be set as follows:
For more information, see Using an Authentication Portal Landing Page. |
|---|
06 July 2023 (5.2.4) Aeon Server/Web DLL & (5.2.2) Server Installer Scripts Release
The Aeon Server has been updated to a new version (v5.2.4) to install a new version of the Web DLL (v5.2.4) that will implement new configuration options to prevent bot-driven account creation spam through the user registration pages on the Aeon web interface. This release also includes new options for configuring a photoduplication toggle on web request forms and important appointment scheduling bug fixes. The Aeon Server Installer Powershell scripts have also been updated to v5.2.2 and must be used to perform the server update.
info
Update Procedure
The newest version of the Web DLL will be installed when updating to v5.2.4 of the Aeon Server. Please perform or request a server update to implement the updated DLL.
Note: Self-hosted sites will need to visit the Installing the Aeon Server page and download the new Aeon v5.2.2 Server Installer Powershell scripts to perform this update. The new installer scripts will include an additional prompt to determine if the SQL connection is encrypted when running the update.
| New | The following new configuration options are available for the Aeon web interface to prevent bot-driven spam account creation via the New User Registration form (NewUserRegistration.html):
:::tip For complete details and configuration instructions for these options, please see Preventing Account Creation Spam in Aeon. ::: |
|---|---|
| New | Added the following new customization keys to the Aeon Customization Manager to support the new spam prevention options in the Aeon web interface:
|
| New | Added the <#CAPTCHA> web DLL tag to the Aeon web interface. This tag is used to display the captcha challenge requirement on the New User Registration form (NewUserRegistration.html) when a captcha integration has been configured in the Aeon Customization Manager. :::tip For more information on this tag, see Aeon CAPTCHA Tag. ::: |
| New | Added new options for configuring a photoduplication toggle control on Aeon request forms. The photoduplication toggle control will allow patrons to toggle between submitting a reading room request or a photoduplication request from the request form(s) on which it has been configured:
|
| Changed | Users will no longer be able to register for an Aeon account from the TestWeb directory to prevent bot-driven spam account creation from the Aeon TestWeb web pages. TestWeb user registration will be disabled by default upon update and cannot be re-enabled. |
| Fixed | Fixed an issue where users could not view appointment details on the Aeon web interface for appointments with start dates in the past or with start dates exceeding the Minimum Lead Days setting for the reading room. Bug# 22857 |
| Fixed | Fixed an issue where appointments were sometimes visible to unrelated users on the Aeon web interface. |
| Fixed | Fixed an issue where the Aeon DLL would sometimes apply the incorrect set of appointment scheduling policies configured for the reading room in the Aeon Customization Manager when users booked or managed their appointments through the Aeon web interface. |
06 July 2023 (5.2.4) Default and Feature-Specific Web Pages Release
New versions of the default and feature-specific web pages have been released to implement captcha support on the New User Registration form and to make several important bug fixes. The Archival Request form has also been updated to include the new <#PHOTOTOGGLE> functionality included in the Aeon Server v5.2.4 release.
The new default and feature-specific web pages are available for download on the **Aeon Downloads**page. To implement these changes:
- Download the new Aeon v5.2.4 default and feature-specific (if using appointment scheduling features) web pages and replace your existing pages.
- If you have customizations, find and replace the code changes in Implementing 5.2 Web Page Changes.
| **New ** | Modified **NewUserRegistration.html ** to include the new <#CAPTCHA> tag and added the following new files to the default web pages to implement captcha support on the New User Registration form:
:::tip For more information on configuring these changes, please see Preventing Account Creation Spam in Aeon. ::: :::warning Note: The Aeon Server must be updated to v5.2.4 following the server update instructions above before the new captcha web pages can be used to implement the captcha requirement on the New User Registration form. ::: |
|---|---|
| **New ** | The following web pages changes were made to implement support for the new <#PHOTOTOGGLE> functionality on **ArchivalRequest.html ** and to make this feature available for configuration on other request forms:
:::tip For more information on configuring these changes, please see Implementing 5.2 Web Page Changes. ::: :::warning Note: The Aeon Server must be updated to v5.2.4 following the server update instructions above before the new web pages can be used to implement the new photoduplication toggle features. ::: |
| Fixed | Fixed an issue where clicking the Schedule a New Appointment button from the Aeon web pages would sometimes not display the appointment scheduling fields. |
| Fixed | Modified the Request For field on several web forms so that usernames are now consistently hidden within the list of users displayed in the dropdown selection across all web pages. |
06 July 2023 (5.2.2) Desktop Client Release
The Aeon 5.2 Desktop Client has been updated to a new version in order to fix bugs affecting email templates and appointment scheduling functionality.
info
Update Procedure
Follow the Client Automatic Updater prompts within the Aeon Desktop Client, or download and run the 5.2.2 Client Installer from the Aeon Downloads page to install the new client applications.
Client Application Updates
Performing the Aeon Desktop Client update process will install the following new application versions:
- Desktop Client v5.2.2
- Customization Manager v5.2.2
- Staff Manager v5.2.2
| Changed | The Hide Completed/Cancelled checkbox option used with the appointment association controls located on the Request form, Requests tab of the User Information form, and Request list grids in the Aeon Desktop Client will no longer hide appointments currently in progress when checked. Appointments will now only be considered completed and hidden once the appointment's stop time is reached. |
|---|---|
| Fixed | Fixed an issue where Reply To addresses configured for email templates in the Aeon Customization Manager would not be added to emails generated by the Aeon Desktop Client. |
| Fixed | Fixed an issue where the <#Request.CancelNote> tag in the ItemCancellation email template would not be populated with a value for emails generated by the Aeon Desktop Client. Bug# 22789 |
12 July 2023 (5.2.3) Desktop Client Release
The Aeon 5.2 Desktop Client has been updated to a new version in order to fix an issue affecting email templates after the 5.2.2 update.
info
Update Procedure
Follow the Client Automatic Updater prompts within the Aeon Desktop Client, or download and run the 5.2.3 Client Installer from the Aeon Downloads page to install the new client applications.
Client Application Updates
Performing the Aeon Desktop Client update process will install the following new application versions:
- Desktop Client v5.2.3
| Fixed | Fixed an issue where tags used to populate the ItemCancellation email template with information about the user's request would not be generated with values for emails sent by the Aeon Desktop Client. |
|---|
28 August 2023 (5.2.5) Aeon Server/Web DLL Release
The Aeon Server has been updated to a new version (v5.2.5) to install a new version of the Web DLL (v5.2.5) that will implement a bug fix for appointment scheduling functionality on the Aeon web interface.
info
Update Procedure
The newest version of the Web DLL will be installed when updating to v5.2.5 of the Aeon Server. Please perform or request a server update to implement the updated DLL. Atlas-hosted sites should contact Atlas Support (support@atlas-sys.com) to schedule their server update.
Note: Self-hosted sites must use the v5.2.2of the Aeon 5.2 Server Installer Powershell scripts (available from the Installing the Aeon Server page) released with the previous version of the Aeon Server to perform this update. The 5.2.2 server update will not appear if using a prior version of the installer scripts to attempt the update.
| Fixed | Fixed an issue in Aeon Web DLL where the last appointment availability for any month would incorrectly show as unavailable on the web if the associated reading room was configured to only offer all-day appointments. |
|---|
16 October 2023 (5.2.6) Default and Feature-Specific Web Pages Release
New versions of the default and feature-specific web pages have been released to make several minor fixes and improve the user experience on the Aeon web interface.
The new default and feature-specific web pages are available for download on the **Aeon Downloads**page. To implement these changes:
- Download the new Aeon v5.2.6 web pages and replace your existing pages.
- If you have customizations, find and replace the code changes in Implementing 5.2 Web Page Changes.
| Fixed | Fixed various minor issues on the default web pages and the feature-specific web pages used with appointment scheduling functionality. The list of changes can be found below. For more information on implementing each fix, see Implementing 5.2 Web Page Changes.
|
|---|
07 February 2024 (5.2.6) Aeon Server/(5.2.7) Web DLL/(5.2.3) System Manager & (5.2.4) Desktop Client Release
The Aeon Server has been updated to a new version (v5.2.6) to install a new version of the Web DLL (v5.2.7) and System Manager (v5.2.3), and the Aeon Desktop Client has been updated to a new version (v5.2.4) to provide several bug fixes for appointment scheduling, addon, and email functionality.
info
Update Procedure (these steps can be performed in any order)
Atlas-hosted sites can see the Aeon Update Procedures and Best Practices for Atlas-Hosted Sites article for more information on minor point release update procedures.
- The newest versions of the Web DLL and System Manager will be installed when updating to v5.2.6 of the Aeon Server. Please perform or request a server update to implement the updated DLL/System Manager. Atlas-hosted sites will be contacted by Atlas Support (support@atlas-sys.com) to schedule their server update.
Note: Self-hosted sites must use the ** v5.2.2 **of the Aeon 5.2 Server Installer Powershell scripts (available from the Installing the Aeon Server page) released with Aeon Server v5.2.4 to perform this update. 2. Follow the Client Automatic Updater prompts within the Aeon Desktop Client, or download and run the 5.2.4 Desktop Client Installer from the Aeon Downloads page to install the new client applications.
info
Server Component Updates
Performing the Aeon Server update process will install the following new component versions:
- DLL v5.2.7
- System Manager v5.2.3
| Changed | Updated the MS OLEDB SQL driver installed by the Aeon Server Installer/Update scripts to v19.3.2 for enhanced security. |
|---|---|
| Changed | Updated the scripting used by the Aeon System Manager to the latest version. |
| Fixed | Fixed an issue where the username associated with a user's record could potentially be stored in the Aeon Database using different casings when creating appointments for a researcher in the web interface, which could cause an error loading appointments in the Aeon Desktop Client. Bug# 25322 |
info
Client Application Updates
Performing the Aeon Desktop Client update process will install the following new application versions:
- Desktop Client v5.2.4
- Customization Manager v5.2.3
| Fixed | Fixed an issue where the username associated with a user's record could potentially be stored in the Aeon Database using different casings when manually cloning requests, which could cause an error loading appointments in the Aeon Desktop Client. Bug# 25322 |
|---|---|
| Fixed | Fixed an issue where tags used to import information from the Aeon database into emails (e.g., <#System.GeneralEMailAddress>) would not import the correct value when configured in the From or Reply To fields on email templates.Bug# 23764 |
| Fixed | Fixed an issue where changing the status of an appointment in the Aeon Desktop Client would save any other changes made to the information on the appointment form without enforcing data validation, which could lead to an error loading appointments in the Client if an invalid End Date was entered for an appointment. Bug# 26376 |
| Fixed | Updated the scripting used by the Aeon Desktop Client and Customization Manager to fix an issue affecting addons using WebView2 browsers where closing a request form for a request using the WebView2 browser and subsequently searching for a new request in the Aeon Desktop Client could open the previous request instead of the one for which the search was performed. Bug# 24181 |
05 March 2024 (5.2.7) Aeon Server/(5.2.8) Web DLL Release
The Aeon Server has been updated to a new version (v5.2.7) to install a new version of the Web DLL (v5.2.8) to provide an important security fix.
danger
If self-hosted, please coordinate with your IT department to update the Aeon Server as soon as possible to ensure that all components are secure. Atlas-hosted sites will be updated automatically by Atlas Support.
info
Update Procedure
The newest version of the Web DLL will be installed when updating to v5.2.7 of the Aeon Server. Please perform a server update to implement the updated DLL. Atlas-hosted sites will be updated automatically by Atlas Support (support@atlas-sys.com) and will receive an email with more details about the update.
Note: Self-hosted sites must use the ** v5.2.2 **of the Aeon 5.2 Server Installer Powershell scripts (available from the Installing the Aeon Server page) released with Aeon Server v5.2.4 to perform this update.
| Fixed | Fixed a potential security vulnerability found during a web application scan. |
|---|
18 March 2024 (5.2.11) Default & Feature-Specific Web Pages Release
A new version of the default and feature-specific web pages has been released to enhance the security of the Aeon web interface, fix several outstanding issues, and improve the user experience.
warning
Security Fixes
This update includes the removal of the jQuery UI JavaScript Library from the Aeon web pages for security purposes. It is highly recommended to update your web pages to implement this change to ensure the best possible security on the Aeon web interface.
The new default and feature-specific web pages are available for download on the **Aeon Downloads**page. To implement these changes:
- Download the new Aeon v5.2.11 default and feature-specific web pages and replace your existing pages.
- If you have customizations, find and replace the code changes in Implementing 5.2 Web Page Changes.
| Fixed | Fixed various issues on the default and feature-specific web pages. The list of changes can be found below. For more information on implementing each fix, see Implementing 5.2 Web Page Changes.
|
|---|
04 April 2024 (5.2.13) Default & Feature-Specific Web Pages Release
A new version of the default and feature-specific web pages has been released to improve the user experience on the Aeon web interface.
The new default and feature-specific web pages are available for download on the **Aeon Downloads**page. To implement these changes:
- Download the new Aeon v5.2.13 default and feature-specific web pages and replace your existing pages.
- If you have customizations, find and replace the code changes in Implementing 5.2 Web Page Changes.
| Fixed | Fixed various issues on the default and feature-specific web pages. The list of changes can be found below. For more information on implementing each fix, see Implementing 5.2 Web Page Changes.
|
|---|
11 April 2024 (5.2.9) Aeon Server/(1.5.2) Aeon API
The Aeon Server has been updated to a new version (v5.2.9) to install a new version of the Aeon API (v1.5.2) and to add several triggers to the Aeon database that will standardize the casing used for the username value on user, transaction, and appointment records. This update will transition the API from the Microsoft .NET Core 2.2 framework to the Microsoft .NET 8 framework as .NET Core 2.2 has been deprecated by Microsoft and is no longer receiving security updates. The existing functionality of the Aeon API will not be affected by this update.
danger
Warning! New System Requirements
The Microsoft ASP.NET Core 8.0 Runtime Bundle must be installed on the Aeon Server prior to running the v5.2.9 server update to prevent disruptions in the Aeon API after updating. This bundle can be installed via Microsoft's website. To prevent disruptions in the Aeon API after updating, please ensure that this bundle is installed on the Aeon Server prior to updating to Aeon Server v5.2.9.
Remove Previous Version of .NET Core
After the Aeon Server v5.2.9 update has been run, Microsoft .NET Core 2.2 should be manually removed from the server, if present, for the best possible security. See Microsoft's documentation for instructions on this process.
warning
End of Support for Previous API Versions
As .NET Core 2.2 has been deprecated by Microsoft and is no longer receiving security updates, older versions of the Aeon API prior to v1.5.2 are no longer supported. Please install the latest API version to ensure uninterrupted support for the API and the best possible security on your server.
info
Update Procedure
Atlas-hosted sites can see the Aeon Update Procedures and Best Practices for Atlas-Hosted Sites article for more information on minor point release update procedures.
Atlas-hosted sites will be updated automatically by Atlas Support (support@atlas-sys.com) and will receive an email with more details about the update.
Self-hosted Aeon sites should follow the update procedure below:
- Install the Microsoft ASP.NET Core 8.0 Runtime Bundle on the Aeon Server. This bundle can be installed via Microsoft's website.
- Run the Aeon v5.2.9 server update to install Aeon API v1.5.2. The update script will update the API in its existing location on your server.
- Once the server update is completed and the new API has been installed, manually remove Microsoft .NET Core 2.2 from the Aeon Server, if present. See Microsoft's documentation for instructions on this process.
Note: Servers using Windows Server 2012 must remove Microsoft .NET Core 2.2 before running the Aeon v5.2.9 server update.
Self-hosted sites must use the **v5.2.2 ** of the Aeon 5.2 Server Installer Powershell scripts (available from the Installing the Aeon Server page) released with Aeon Server v5.2.4 to perform this update.
| New | Updated the Aeon API to v.1.5.2. The new version of the Aeon API uses the Microsoft .NET 8 framework in place of the deprecated Microsoft .NET Core 2.2 framework used in previous API versions for enhanced security. :::info The existing functionality of the Aeon API will not be affected by this update. ::: |
|---|---|
| Fixed | Added triggers to the Aeon database that will automatically adjust the casing for the username value associated with new appointment or transaction records to match the casing used for that value in the Users database table to prevent issues caused when the casing of these username values did not match. |
29 April 2024 (5.2.10) Aeon Server Release
The Aeon Server has been updated to a new version (v5.2.10) to fix a bug found in the previous server release (v5.2.9) that could prevent appointments from being properly assigned to requests after updating.
info
Update Procedure
Please perform a server update to implement the fixes in the Aeon 5.2.10 server release. Atlas-hosted sites will be updated automatically by Atlas Support (support@atlas-sys.com) and will receive an email with more details about the update.
Note: Self-hosted sites must use the ** v5.2.2 **of the Aeon 5.2 Server Installer Powershell scripts (available from the Installing the Aeon Server page) released with Aeon Server v5.2.4 to perform this update.
| Fixed | Fixed an issue in the Aeon Server 5.2.9 release where the associated user's username would be assigned as the researcher username to requests, which could prevent the assignment of appointments to requests after updating. :::warning Transactions affected by the bug in the Aeon Server 5.2.9 release will be automatically corrected during the Aeon 5.2.10 server update to remediate this issue. Additionally, any existing database records that were affected by the username casing mismatch issues addressed in the Aeon 5.2.9 server release will also be automatically corrected during the 5.2.10 server update. ::: |
|---|
17 June 2024 (5.2.11) Aeon Server/(5.2.2) Web Platform/(5.2.4) System Manager & (5.2.5) Desktop Client Release
The Aeon Server has been updated to a new version (v5.2.11) to install a new version of the Web Platform (v5.2.2) and System Manager (v5.2.4) that will update the external third-party Newtonsoft dependency used by these components for security purposes. The Aeon Desktop Client has also been updated to a new version (5.2.5) to update the same Newtonsoft dependency in the Aeon Desktop Client, Customization Manager, and Staff Manager applications.
info
Update Procedure (these steps can be performed in any order)
Atlas-hosted sites can see the Aeon Update Procedures and Best Practices for Atlas-Hosted Sites article for more information on minor point release update procedures.
- The newest versions of the Web Platform and System Manager will be installed when updating to v5.2.11 of the Aeon Server. Please perform or request a server update to implement the updated Web Platform/System Manager. Atlas-hosted sites will be contacted by Atlas Support (support@atlas-sys.com) to schedule their server update.
Note: Self-hosted sites must use the ** v5.2.2 **of the Aeon 5.2 Server Installer Powershell scripts (available from the Installing the Aeon Server page) released with Aeon Server v5.2.4 to perform this update. 2. Follow the Client Automatic Updater prompts within the Aeon Desktop Client, or download and run the 5.2.5 Desktop Client Installer from the Aeon Downloads page to install the new client applications.
info
Server Component Updates
Performing the Aeon Server update process will install the following new component versions:
- Web Platform v5.2.2
- System Manager v5.2.4
| Fixed | Updated the third-party Newtonsoft dependency used by the Aeon System Manager and Aeon Web Platform to patch a security vulnerability found in the previous version of this component. |
|---|
info
Client Application Updates
Performing the Aeon Desktop Client update process will install the following new application versions:
- Desktop Client v5.2.5
- Customization Manager v5.2.4
- Staff Manager v5.2.3
| Fixed | Updated the third-party Newtonsoft dependency used by all client applications (Aeon Desktop Client, Customization Manager, and Staff Manager) to patch a security vulnerability found in the previous version of this component. |
|---|
03 July 2024 (5.2.22) Default & Feature-Specific Web Pages Release
A new version of the default and feature-specific web pages has been released to improve the user experience on the Aeon web interface.
The new default and feature-specific web pages are available for download on the **Aeon Downloads**page. To implement these changes:
- Download the new Aeon v5.2.22 default and feature-specific web pages and replace your existing pages.
- If you have customizations, find and replace the code changes in Implementing 5.2 Web Page Changes.
| Fixed | Fixed various issues on the default and feature-specific web pages. The list of changes can be found below. For more information on implementing each fix, see Implementing 5.2 Web Page Changes.
|
|---|---|
| Changed | Updated the Aeon default and feature-specific web pages to rename some of the account management-related features for clarity and to ensure naming consistency across the web pages:
For more information on implementing these changes, see Implementing 5.2 Web Page Changes. |
| Changed | The following changes have been made to the layout and style used to format the Aeon default and feature-specific web pages when they are printed from the web browser to improve the readability of the printed material and to increase focus on essential information:
For more information on implementing each change, see Implementing 5.2 Web Page Changes. |
| New | Added new minified versions of most default JavaScript and CSS files used in the Aeon web pages and updated all relevant web page files to use the new minified files in order to optimize the performance of the Aeon web interface and reduce page load times for users. The minified files will have the extension .min.js or .min.css and will be present in the js or css folder of the default and feature-specific web page downloads alongside the original un-minified version of each file. For more information on implementing these new files, see Implementing 5.2 Web Page Changes. |
29 May 2025 (5.2.12) Aeon Server/ (5.2.9) Web DLL Release
The Aeon Server and Web DLL have been updated to new versions to fix a bug with user custom fields and remote authentication where the username in Aeon vs. the Remote Authentication system had different casing.
info
Update Procedure
Please perform a server update to implement the fixes in the Aeon 5.2.12 server release. Atlas-hosted sites will be updated automatically by Atlas Support (support@atlas-sys.com) and will receive an email with more details about the update.
Note: Self-hosted sites must use the ** v5.2.2 **of the Aeon 5.2 Server Installer Powershell scripts (available from the Installing the Aeon Server page) released with Aeon Server v5.2.4 to perform this update.
| Fixed | Fixed an issue for User Custom Fields. Aeon would throw an error during remote authentication and login if an Aeon username had different casing than the remote authentication username. For example, researcher@site.edu vs RESEARCHER@site.edu. |
|---|