Failing to follow app naming convention can cause duplicate Applications in AppDev.

Failing to follow app naming convention can cause duplicate Applications in AppDev.

book

Article ID: KB0085164

calendar_today

Updated On:

Products Versions
TIBCO BPM Enterprise (formerly TIBCO ActiveMatrix BPM) -
Not Applicable -

Description

Description:
Repeated uploading of an app zip with a non-conforming name results in duplicate entries in the Applications List. Removal of the duplicated apps is possible but not straightforward.


Symptoms:
Duplicate Apps in the Application List.
Selecting an app also selects the duplicates.
Deleting the selected duplicates removes one entry, but leaves the other(s) unusable.
Attempting to delete the remaining app(s) gives a failure message: "Delete Application Failed!"

Cause:
- Uploading an application with non-alphanumeric characters in the name results in all such characters being replaced with underscores (_) in the runtime. Note that this explanation assumes the app is packaged as "Badly-Named-Web-App.app.zip".

- Uploading the same app zip  results in duplicate apps in the UI. This is because the "does app already exist" check is comparing new "Badly-Named-Web-App" with existing "Badly_Named_Web_App". The new app is renamed automatically post-upload, leading to an additional app having the same name.

Issue/Introduction

Failing to follow app naming convention can cause duplicate Applications in AppDev.

Resolution

It is recommended to delete all such apps, then rename them according to the convention before uploading again. To delete the duplicates requires a non-obvious additional step:


- Upload the "Badly-Named-Web-App.app.zip" again.

- Select the app(s) and Open.

- Select the Badly_Named_Web_App.app.desc.json and Open it. You may need to click the "More Options" icon to reveal the Open button.

- Edit the "indexPage" value. It will be in the form "Badly-Named-Web-App/index.html"; change all '-' characters to '_', i.e.

{

  "indexPage": "Badly_Named_Web_App/index.html",

  "library": false

}


- Save and return to the Applications List. This should collapse all duplicates into a single "Badly Named Web App" in the Application List, which can and should be selected and deletedConsider renaming your original app.zip before uploading again. Use only alphanumeric (and underscore) characters.


Additional Information

Naming convention is mentioned in the documentation under heading "File and Folder naming" here:
- https://docs.tibco.com/pub/amx-bpm/4.0.0/doc/html/bpmhelp/AppMgmt/GUID-CEF7755D-D9CD-43F5-B1BB-EA7142E4E645.html