Versions Compared

Old Version 3

changes.mady.by.user Megan Ellis

Saved on

compared with

New Version Current

changes.mady.by.user Megan Ellis

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Use Email to send a custom email with attachments (if required) to a specified address. The email will be sent when the workflow step completes.

Add an Email Step

  1. Click the + Add Step icon just below that step you want to send the email.
  2. Select Email. The Add Step Email wizard will pop up.
  3. Enter email addresses or click the down arrow to select control and built-in form/workflow templates to dynamically determine it at runtime. *You must enter an email in the user@domain format in order to click Submit. The next three steps are optional and can be configured later.
  4. Customize the Subject and Message of the email.
  5. Select the type of attachments to include in the email.
  6. Click Submit.

...

Expand
titleClick here for more information about failed posts

Activity Document Action Behavior for Failed Post

If the HTTP POST returns a status code 422 and an error message, frevvo interprets this code to mean that the activity in question should be re-run. For workflow steps, this means that the form for the workflow step is re-rendered. 

If you want to display a message to the user when the post fails,

  1. Add a Message control with the text you want to display to the workflow step
  2. Add the class f-action-error to the CSS class property of the Message control. Controls with this class are not visible when the workflow step loads, even if the Visible property is checked.
  3. If the post returns a status code of 422 and some error text, the workflow step will be re-rendered and the Message control will display.

For example, Let's say you have a fields on the last step of a workflow step to collect a credit card number and the expiration date. The user fills in the information then clicks Finish. There is a Post Submission to a web app configured on this step.

Code Block
https://<your server>/services/testhttp?status={t}&content=errortext

If the web app returns a status code of 422 and some type of error message, the workflow step will be re-rendered. The message informing the user to check the information and resubmit displays.

The workflow step will continue to be re-displayed until the post returns an Ok status (HTTP 200).

Note

This behavior ONLY applies to POSTs to a web app in workflows. The behavior changes slightly if a Quick Approval/Rejection Setup is configured on the step. Refer to the QuickApprovalBehaviorwhenActivityDocumentActionpostfails Quick Approval Behavior when Activity Document Action post fails topic provides the details.


...