Sepasoft MES Module Suite
system.mes.signature.authorization.triggerAuthRequest()
This function is the bridge between the backend logic and the live user session. While queueAuthRequest() defines the rules, triggerAuthRequest() initiates the user-facing action. It is typically called from a UI event, such as a user clicking an 'Approve' button on a batch confirmation screen, to present the security challenge in that user's specific client.
Description: Triggers an authentication challenge for a previously scheduled request.Parameters
Parameter | Type | Purpose & Role |
uuid | String or UUID | Request Identifier: The unique ID of the specific signature request to be triggered. This value is one of the UUIDs returned by queueAuthRequest() that has been associated with the current user's required signature. |
session | SessionScriptWrapper.SafetyWrapper | Session Context: Specifies the user's Perspective session where the authentication challenge will appear, ensuring the prompt is delivered to the correct user interface. |
page | PageScriptWrapper.SafetyWrapper | Page Context: Specifies the Perspective page within the session where the challenge will appear. |
approve | boolean | Intent Declaration: A boolean flag that declares the user's intent, typically determined by which button they clicked in the UI (e.g., 'Approve' sets this to true, 'Reject' sets it to false). This allows a single signature prompt to handle both outcomes, which are then routed to the corresponding approve or reject callback functions. |
Returns
N/A
This function does not return a value (void). Its purpose is purely to initiate an action—the display of the UI challenge. The results of the user's interaction are handled asynchronously by the approve, reject, or error callback functions that were defined in the initial queueAuthRequest() call.
Methods
This function provides flexibility by accepting the unique identifier as either a native UUID object or a String representation.
void triggerAuthRequest(UUID uuid, Session session, Page page, boolean approve)
void triggerAuthRequest(UUID uuid, SessionScriptWrapper.SafetyWrapper session, PageScriptWrapper.SafetyWrapper page, boolean approve)
void triggerAuthRequest(String uuid, SessionScriptWrapper.SafetyWrapper session, PageScriptWrapper.SafetyWrapper page, boolean approve)
While queuing and triggering requests handle the active parts of the workflow, the getPendingAuthRequests() function provides the necessary visibility to monitor all outstanding signature requests across the system.
Sepasoft MES Module Suite