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

Office Business Application for 2021

Platform
OnBase
Product
Office Business Application for 2021
Release
Foundation 22.1
License
Premier
Standard
Essential
ft:lastPublication
2023-12-11T13:38:45.065000
ft:locale
en-US

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

To upgrade and preserve user settings:

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

    C:\Users\USER_NAME\AppData\Local\Microsoft_Corporation\Hyland.Office2021.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.Office2021.Word.AddIn.Properties.Settings child element to Hyland.Office2021.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.Office2021.Word.AddIn.Properties.Settings element closing tag is named Hyland.Office2021.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.