Skip to main content

This content has been archived and is no longer being updated. Links may not function; however, this content may be relevant to outdated versions of the product.

Support Article

Connection Failed error observed during log off



'Connection Failed' error generated during log off. This occurs intermittently. 

Error Messages

Connection Failed

Steps to Reproduce

Log off to observe the error.

Root Cause

The root cause of this problem is a defect in customer application code/rules. 

The logoff link is an old URL gadget calling the activity Code-Security.Logoff directly. This allows the pyDeleteDocumentPG activity to run between the Code-Security.Logoff and Code-Security.EndSession activities resulting in the error.


This issue is resolved through the following Local-change.

In Pega 7.1.7 exists a code that suppresses the pyDeleteDocumentPG activity if/when logoff from the UI level has been called.

Rule-File-Text: webwb.pega_ui_doc_lifecycle.js 

harnessOnBeforeUnload : function (event)
       /* BUG-109795 - Added by Delta Touch*/
        var parentWindow =;
        if (parentWindow != null && parentWindow.logout == true) {

Update "Logoff" to use a UI Link gadget with a onClick action of "Logoff". This properly calls "application.Logoff()" and sets the parentWindow.logout = true. The above code then runs and exists the harnessOnBeforeUnload method before the pyDeleteDocumentPG call. 

Published June 12, 2015 - Updated October 8, 2020

Was this useful?

0% found this useful

Have a question? Get answers now.

Visit the Collaboration Center to ask questions, engage in discussions, share ideas, and help others.

Did you find this content helpful?

Want to help us improve this content?

We'd prefer it if you saw us at our best.

Pega Community has detected you are using a browser which may prevent you from experiencing the site as intended. To improve your experience, please update your browser.

Close Deprecation Notice
Contact us