Upgrading While Preserving User Settings - Upgrading While Preserving User Settings - This procedure upgrades the user settings file in the Office Business Application for 2019 while preserving the user configuration settings. - OnBase - Office Business Application for 2019 - OnBase/Office-Business-Application-for-2019/Foundation-23.1/Office-Business-Application-for-2019/Installation/Troubleshooting/Using-the-Office-Business-Application-Tab-Causes-an-Exception/Upgrading-While-Preserving-User-Settings - Foundation 23.1 - Foundation 23.1

Office Business Application for 2019

Platform
OnBase
Product
Office Business Application for 2019
Release
Foundation 23.1
License
Premier
Standard
Essential
ft:lastPublication
2025-04-01T15:12:24.843000
ft:locale
en-US

This procedure upgrades the user settings file in the Office Business Application for 2019 while preserving the user configuration settings.

To upgrade and preserve user settings:

  1. Locate the user.config for Office Business Application for 2019. This file is located in a system folder that follows a semi-randomized naming convention:

    C:\Users\USER_NAME\AppData\Local\Microsoft_Corporation\Hyland.Office2019.Word.Ad_Path_***\111

    where USER_NAME is the user name of the user logged in, *** is a random string, and 111 is a randomly numbered folder.

  2. Open the user.config file in a plain-text editor, such as Notepad.
    Note:

    Do not open this file in a binary-text editor, such as Microsoft Word. Editing this file in a binary-text editor can introduce characters that cannot be read by the software.

  3. Locate the userSettings node.
  4. Rename the Hyland.Office2019.Word.AddIn.Properties.Settings child element to Hyland.Office2019.Word.Addin.Properties.Settings
    Note:

    This name is case sensitive. The issue is caused because the earlier version of the software used a capital I in AddIn. The newer version uses a lowercase i in Addin.

  5. Make sure the Hyland.Office2019.Word.AddIn.Properties.Settings element closing tag is named Hyland.Office2019.Word.Addin.Properties.Settings
    Note:

    This name is case sensitive. The closing element name must match the opening element name.

  6. Save and close the user.confg file.