Release Notes
ASNA Visual RPG® (AVR)
Version: 17.0.31.0
Release date: 2024-05-09
If you are upgrading from an earlier version of AVR, you may be effected by the changes to the ASNA Runtime (see ASNA Runtime Changes below).
Be sure to see the Visual Studio 2022 and .NET Framework requirements immediately below.
Microsoft made changes to the Visual Studio 2022 debugger and those changes are causing intermittent errors with AVR 17.x's debugger. These issues are more likely to appear in ASP.NET apps. R&D is currently researching this issue.
AVR 17.x requires .NET Framework 4.8 for both development and runtime.
If you intend to install Visual Studio 2022's local help, don't miss the note about that in the DataGate Studio and Visual Studio 2022 and Local Help Support sections below.
Platform support/product requirements
Platform support and product requirements are detailed on our Product Requirements page
Visual Studio Editions
Platform support and product requirements, including Visual Studio, are detailed on our Product Requirements page
Visual Studio 2022 treats local (offline) as an optional component. As such installing it requires some additional steps:
When installing Visual Studio 2019:
To verify the Help Viewer is installed, look at the top of the Help Menu in Visual Studio. The following three options should be visible at the top of the menu:
vs-2022-local-help
The following Visual Studio Workloads must be installed:
DataGate 17 features secure database name storage using Windows DPAPI.ASNA has always recommended using *PUBLIC
database names for websites. In v17, we further recommend always using the *Public
prefix explicitly when referencing database names in website applications, including Monarch. Otherwise, applications may encounter run-time exceptions that include phrases such as "user profile not loaded" when Windows DPAPI is used in IIS sessions running with anonymous or impersonated credentials.
For example, an AVR-based website might have code similar to the following, which references a DG database name in a DCLDB statement as follows:
DclDB Name(MyDatabase) DBName("IBMSERVER") Access(*Public)
We strongly recommend changing this statement as shown below:
DclDB Name(MyDatabase) DBName("*Public/IBMSERVER") Access(*Public)
If changing existing code is impractical, the only way to avoid errors is to ensure that the configuration of the IIS application pool in which the
website runs includes the setting "Load User Profile = True".
Note that this setting may reduce the performance of large-scale website applications.
Configuring IIS is Windows- and version-dependent, but generally follows this set of steps: 1. Open IIS Manager. 2. Under the Application Pools node, select the Application Pool that the website runs under. 3. On the right-hand panel, select "Advanced Settings...". A property dialog appears. 4. Scroll to the Load User Profile setting, and ensure that it is set to True. 5. Restart IIS.
Websites may produce "user profile not loaded" exceptions mentioned in the release Notes, even when database names are referenced with the recommended "*Public/" prefix. If so, you must configure the "Load User Profile = True" IIS Application Pool setting (also mentioned in the Release Notes) as a workaround. It is highly recommended to remove this workaround when you install the release of DataGate.
database-name-change
ss-info
To maintain backwards compatibility of version 15.0 with previous versions we ship an
ASNA.VisualRPG.Runtime.dll
library which forwards requests for any of the four original namespaces that where in that DLL to the corresponding new DLL. We will stop shipping theASNA.VisualRPG.Runtime.dll
with the next major version of ASNA .NET products. This forwarding version of this DLL will be available as a separate download.
The second change is that ASNA.VisualRPG.Common.Sgml.dll
has been deprecated and its code has been moved to ASNA.Runtime.dll
. This change mostly affects customers using Mobile RPG and Wings.
There are no coding changes you need to make in your projects because of these changes. The only changes you need to make is adding and/or deleting references. For new 15.x projects the correct project references will already exist.
ASNA.VisualRPG.Common.Sgml.dll
In addition to removing that reference:
For Visual RPG Windows and Web projects:
ASNA.VisualRPG.Runtime.dll
ASNA.Runtime.dll
For Wings and MobileRPG projects:
ASNA.VisualRPG.Runtime.dll
ASNA.Runtime.dll
ASNA.Runtime.JobSupport.dll
For Monarch projects:
ASNA.VisualRPG.Runtime.dll
ASNA.Runtime.dll
ASNA.Runtime.JobSupport.dll
ASNA.Runtime.Monarch.dll
The ASNA.Runtime.* DLLS are located at:
C:\Program Files (x86)\Common Files\ASNA Shared\Client\16
For more details on the runtime changes click here.
dot-net-runtime-changes
If this software is downloaded via Edge you may receive a message stating that this file "is not commonly downloaded" when attempting to install it. In this event click the View Downloads button, select the ASNA product to install from that list, and confirm that you'd like to install it.
Similarly, attempting to install the software directly through Microsoft Windows may cause a "Windows protected your PC" message to appear. In this event click the small More Info
prompt on the left, and click Run Anyway
on the following window.
windows-installation-note
DataGate Server
Visual RPG IDE Project