November Happy Hour will be moved to Thursday December 5th.

Handle submission actor's result

Fixed in

EPiServer.Forms 4.16.0

(Or a related package)

Created

Aug 10, 2018

Updated

Sep 27, 2018

State

Closed, Done


Description

Previously, Episerver Forms did not handle submission actor’s result (actors actually returned results but they were not used).
This feature allows actors to:

  • Return signal to cancel form submission in case actor running fails
  • Return error message which can be displayed to visitors
    There are some changes when implementing actors in order for the above to work:
    1. Actors must implement ISyncOrderedSubmissionActor. Actors implementing this interface will run synchronously in ascending order, regardless of IsSyncedWithSubmissionProcess value (we force the actor to run synchronously because we cannot control the result of async actors).
    2. Actors must return object instance of a class which implements EPiServer.Forms.Core.PostSubmissionActor.Internal.ISubmissionActorResult.
    By implementing this interface, the returned result will have two properties:
  • CancelSubmit (boolean): determine whether the form submission should be canceled or not.
  • ErrorMessage (string): this error message will be displayed to visitors.