Issue
On logging in, the Constellation work portal fails to display the landing page and becomes unresponsive. The following errors are observed:
On-screen error:
ViewContainer
Failed to display content. Contact the application administrator.
Browser console error:
Error while Rendering the component undefined: TypeError: Cannot destructure property 'routeKey' of 'this.appRoutes[n]' as it is undefined.
Root cause
The 'D_pzBuiltOnAppRoutingTable' data page, which resolves and combines routing table entries, returns stale, cached data. As a result, when the Constellation portal attempts to load, it receives an outdated routing table that lacks the required route for the landing page. This leads to the application attempting to access a non-existent 'routeKey' property, causing the 'Cannot destructure property routeKey' error.
Solution
Update to Pega Platform 24.2.2, see Pega Platform 24.2.2 patch resolved issues.
OR
Workaround
As a workaround, apply the following hotfixes:
-
HFix-C1743 on Pega Platform 24.1.2
-
HFix-C2254 on Pega Platform 24.1.3
-
HFix-C1833 on Pega Platform 24.2.0
-
HFix-C1184 on Pega Platform 24.2.1
The hotfix alone might not fix the issue if the routing table does not contain a valid route. In such scenarios, follow the below steps in sequence until the issue no longer persists:
-
Save the application rule.
-
Clear the browser cache and storage.
-
Regenerate the application routing table
-
Navigate to the 'Advanced' section of the application rule.
-
Click the 'Generate routing table' button.
-
Unlock a ruleset; otherwise, the button will remain disabled.