Help requests
Last updated
Last updated
Help requests will be deprecated. That means the features are still available, but we do not recommend implementing if not already used. The new generation clients do not support help requests.
When working with offline workflows in the iOS, Android or Windows10 Flow clients, all transactions that are produced by the workflow are put in a queue. This queue can be found in the Offline Data section, under MY WORK. The transactions are executed automatically in the background when the device have access to internet.
Normally these transaction executes without any problems and disappears from the queue. However, if a workflow transaction has failed, the User is able to send a Help Request to an Administrator, so that the problem can be fixed. The Administrator can then either correct the problem in the back-end system or correct the data in the workflow transaction. When the problem is fixed, the Help Request can be sent back to the User and the transaction can be executed again.
The Administrator can view all requests in the Help Request tab under Monitoring.
The help request table contains eight columns:
Request ID: Unique id for the Help request
Login: Username of the user who made the Help request
Workflow name: From where the transaction is created
Time stamp: Time when the request was created
Status: Request status
Error message: The error message for the failed transaction
Instance name: The name of the workflow instance
Transaction name: The task name set for the handover
The Administrator can in the right side panel edit and view the details of the request, such as the name of the workflow that has failed, the user id, comment from the sender, status etc. In order to resolve the transaction issue, the Administrator can edit any variable from the workflow transaction, add an optional comment and send the solution back to the user. If the cause of the error is only related to data or logic in the back end system, the Administrator can fix the root cause and directly send the request back to the User. The Administrator can also cancel the request.
The Help Request is being tracked by the following statuses:
New: New unhandled request
In progress: The transaction is changed by the Administrator
Sent back: The Help request is sent back to the User
Retried: Retried by the User without errors
Retried with errors: Retried by the User with errors
Resolved: Resolved of the change done by the Administrator
Cancelled by user: The User has deleted the request
Cancelled by administrator: The Administrator cancelled the request
Session was closed: The User logged out from the app
Changes done by an administrator are sent to the user as a notification on the mobile device. The status is refreshed after clicking on the notification or clicking the Refresh button.
When the fix is delivered, will the user see the message: Retry updated transaction! and can then click on the green TRY AGAIN button to execute the transaction again.
The User will receive notifications when the Help request changes status, from New to In progress and from In progress to Sent back.
To get a notification about new requests, can the System Event Flow functionality be used, which can be found in the System Events panel under the Environment tab. Read more about system events here.