SBM AppScript Reference → Programming SBM AppScript → Shell Properties → Shell Property Descriptions → Retry Shell Properties
Retry shell properties are defined when an operation can be retried or rejected. Retry shell properties are available for Post-Transition, Pre-State, Post-State, Notification and Self-Registration contexts.
string (output). If the script writes a non-empty string to this property, the current operation is rejected and may be retried.
Form-based operations are rejected similarly to when required fields are missing. The user is redirected to the same form (still maintaining any data they entered) and has another chance to submit the form. The string in Shell.RedoMessage is used as an error message, appearing at the top of the form and in the Windows Event Viewer. If the script does not write to Shell.RedoMessage, the form is processed normally.
If an API program submits or transitions an item and an SBM AppScript associated with the transition fails, Shell.RedoMessage is returned to the API and is available in the GetErrorMessage call. The message is also logged in the Windows Event Viewer as well. However, since there is no interface, the message is not displayed to the user and the user may not have an opportunity to fix the problem.
Copyright © 2007–2015 Serena Software, Inc. All rights reserved.