abstract class %ZHSLIB.Login.Utils

General class to contain login-related APIs to simplify the process of setting up server-side data to handle login failures and password changes.

Method Inventory (Including Private)


classmethod CheckLoginRequest(Output pLoginData As %ZHSLIB.Login.LoginData, pCSPRequest As %CSP.Request = $get(%request), pCSPSession As %CSP.Session = $get(%session), pClearRequestError As %Boolean = 0) as %Status [ Language = objectscript ]
API to wrap checks for login pages to work out whether a login failed, and whether there are any values related to HealthShare logins that should drive the page's behaviour.

The API returns a %ZHSLIB.Login.LoginData instance that indicates what happened on the previous incoming request, particularly when there was some sort of failure on the previous request.

The arguments to the method are as follows:
  • pLoginData - the object that indicates what the state of the login was.
  • pCSPRequest - the incoming %CSP.Request instance, which defaults to %request.
  • pCSPSession - the current %CSP.Session instance, which defaults to %session.
  • pClearRequestError - a flag to control whether the Error:ErrorCode field in the request object should be removed in cases where there should not be an error reported to downstream code.

classmethod GatherChangePasswordData(pCSPSession As %CSP.Session = "") as %Status [ Language = objectscript ]
API to be called from a change password page to correctly initialize the server-side data to support the subsequent password change request.