ApplicationXtender - Admin - Change an Application Name

Applies to AX Versions 6.5 and higher

Summary

An application was created with a temporary name or the name of an existing application needs to be updated or changed.

Resolution Steps

Below are the steps necessary to update the name of an existing application within ApplicationXtender.

In order to modify an ApplicationXtender application name, you will need to have access to SQL and to the storage repository path of the images.

Only experienced Database Admins should make modifications to the database.

Login to the SQL database where the AX database is stored.

Run Query below to display the list of applications

SELECT * FROM ae_apps ORDER BY appname

Identify the application name to be modified and take note of its AppID value and its associated pathid(s)

In the screenshot above, we will use the AP application and rename it to AP_ARCHIVE for the rest of the examples

In this case, the appid associated with the AP application is 101 and the associated pathid(s) are 1,2,3, and 4.

Next, we need to locate where the images are stored. Run the query below to identify the storage paths.

SELECT * FROM ae_paths WHERE pathid IN (1,2,3,4)

This will provide us with the locations of the folders that will need to be renamed later. Take note of the different locations as there may be a need to update multiple locations.

Next, run the script below to update the name where the appid equals the appid identified above. Replace NEWAPPNAME with the new name and appid with the corresponding appid from above.

UPDATE ae_apps SET appname = 'AP_ARCHIVE' WHERE appid = '101'

Next, browse out to the write path(s) for the application.

In this case, we need to navigate to all four locations and rename the folder found there that matches the original name of the application. You may not have a corresponding folder in all the locations. They are only created once a value is entered. For example, if there have never been any annotations applied to a document in the existing application, the AP folder under the Annotation path will not exist. There is no need to create or modify anything in that folder if there is not a folder name matching your original application name present.

Each of the existing folders needs to be updated to AP_ARCHIVE for ApplicationXtender to read/write to the correct storage location.

Once this has been completed, it is recommended to perform a component registration and an iisreset on the AX web server host, to ensure the AX website(s) are propagated with the changes.

After the IISRESET, next open ApplicationXtender and verify the updated name is showing correctly and that images are retrievable and can also be added successfully.