Versions Compared

Key

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

Wizards make it easier to configure what happens to the data when a user submits your form and what the users see after submitting the form. The wizards are accessible from the flow designer toolbar via the  icon labeled what does the user see for Form Actions or the  icon labeled what happens to my data for Doc Actions. The action settings are summarized in the form properties Form Info tab.

An email notification is sent to the tenant administrator or the flow administrator(s) (if configured) when a Form Action post, DOC URI or DOC Action fails and the submission does not reach it's intended destination. When the form/flow is submitted, the user sees the message "Thank You! Your submission has been received." and then the appropriate admin is notified via email. The email is sent when the following Form/Doc actions are configured in a form/flow:

This is not applicable to the email doc action since it is asynchronous and the notification would fail if the service were unavailable. Refer to each topic for more information.

Form Action Wizards

The form action wizards configure what users will see when they submit your form.

Image Removed

Using these wizards you can:

  • Close the form window
  • Display a message to the user in the existing form windows
  • Forward to a nicely formatted web page that you have created elsewhere
  • Forward to Paypal if your form has sold items to the user
  • Post the form data to a service and then forward the user to a web page 
The wizards help guide you through the configuration process. Many of the wizards allow you to use form controls as templates to dynamically create what the users sees rather than hard coding this. See the


Info

Doc action wizards are single select. If you set up one of the wizards then configure an action using a second wizard, the information configured on the first wizard will no longer display. This is as designed.

Let's say you want to send an email after your form/flow is submitted but you are also using the Filesystem connector to save your submissions to a directory on a local server. You configure the Filesystem connector wizard to do this. Then your configure the Email data to a specified address wizard to send the email. If you return to the Filesystem connector wizard, after configuring the email wizard, the information that you entered on the Filesystem connector screens will no longer display. In this situation, you can use the email wizard on the Additional Email tab to configure your email. Refer to How to setup Multiple Document Actions for an example.

 

Form Action Wizards

The form action wizards configure what users will see when they submit your form.

Image Added

Using these wizards you can:

  • Close the form window
  • Display a message to the user in the existing form windows
  • Forward to a nicely formatted web page that you have created elsewhere
  • Forward to Paypal if your form has sold items to the user
  • Post the form data to a service and then forward the user to a web page 

The wizards help guide you through the configuration process. Many of the wizards allow you to use form controls as templates to dynamically create what the users sees rather than hard coding this. See the section on using templates in form/doc/error actions for full detailsfull details.

You can only configure one Form action for a form/flow. This is as designed.

Column
width300px

On this page:

Table of Contents
maxLevel2

...

When the form is submitted,  will send an email message with the submission data, an optional XML document(s) , and optionally an image of the filled form via the Send Snapshot dropdown. Signatures are not sent as part of the email submission. 

The email can be sent to multiple addresses separated by a comma or a semicolon. See Email Integration for further details. The "To:" email address is required. All other properties are optional.

Tip

The tenant admin can configure the from email address on the tenant admin's Edit Tenant page. If you want an email to show a different From:address than what is configured on the Edit Tenant page, enter that address in the From: field. You can enter a static address or use templates to make the the address dynamic. The From address replaces the default no-reply@… , an address configured on the Edit Tenant screen or any settings in web.xml or frevvo.xml config files for In-house customers.

Save to PaperVision® /ImageSilo®

 integrates directly with Digitech Systems' PaperVision® and ImageSilo® document management products. This Wizard enables an easy way for you to save form submissions to your PaperVision® and ImageSilo® document management repository as PDF, TIFF, .JPG and .GIF format.

The wizards walks you through simple steps to login to your PaperVision®/ImageSilo® account:

Image Removed

To select the correct PaperVision®/ImageSilo® project where you want to store the form submission:

Image Removed

And finally to map your form fields so that the entered form field values become the index field values for your document.

Image Removed

Now when a users fills and submits your form and image of the form and any uploaded attachments will automatically be stored into the selected PaperVision®/ImageSilo® project. The document's index fields will be set to the values the user entered into the form.

The pve connector by default does not send handwritten signature images to ImageSilo. This can be overridden by setting frevvo.send.signature.xml to true in web.xml in pve.war. XML document(s) , and optionally an image of the filled form via the Send Snapshot dropdown. Signatures are not sent as part of the email submission. 

The email can be sent to multiple addresses separated by a comma or a semicolon. See Email Integration for further details. The "To:" email address is required. All other properties are optional.

Tip

The tenant admin can configure the from email address on the tenant admin's Edit Tenant page. If you want an email to show a different From:address than what is configured on the Edit Tenant page, enter that address in the From: field. You can enter a static address or use templates to make the the address dynamic. The From address replaces the default no-reply@… , an address configured on the Edit Tenant screen or any settings in web.xml or frevvo.xml config files for In-house customers.

Save to PaperVision® /ImageSilo®

 integrates directly with Digitech Systems' PaperVision® and ImageSilo® document management products. This Wizard enables an easy way for you to save form submissions to your PaperVision® and ImageSilo® document management repository as PDF, TIFF, .JPG and .GIF format.

The wizards walks you through simple steps to login to your PaperVision®/ImageSilo® account:

Image Added

To select the correct PaperVision®/ImageSilo® project where you want to store the form submission:

Image Added

And finally to map your form fields so that the entered form field values become the index field values for your document.

Image Added

Now when a users fills and submits your form and image of the form and any uploaded attachments will automatically be stored into the selected PaperVision®/ImageSilo® project. The document's index fields will be set to the values the user entered into the form.

The pve connector by default does not send handwritten signature images to ImageSilo. This can be overridden by setting frevvo.send.signature.xml to true in web.xml in pve.war. 

Info

If a form/flow submission does not reach PaperVision®/ImageSilo® successfully, notifies the tenant admin of the failure via an email. If flow administrator(s) are configured the flow admin(s) will receive the email instead of the tenant admin.

Image Addedare

 See  ImageSilo® integration for full details. 

Save to Google Documents

Form submissions can be saved to your Google Sheet. See the documentation for Connecting to Google Apps for full details. Also refer to the Leave Approval Workflow Tutorial for step by step instructions.

Warning
  • Do not use spaces or special characters when creating submission folder names.
Info
  • If a form/flow
submission
  • does not reach
PaperVision®/ImageSilo®
  • the specified folder in your Google drive successfully, notifies the tenant admin of the failure via an email. If flow administrator(s) are configured, the flow admin(s)
will
  • receive the email instead of the tenant admin.

Image Removedare

 See  ImageSilo® integration for full details. 

Save to Google Documents

Form submissions can be saved to your Google Sheet. See the documentation for Connecting to Google Apps for full details. Also refer to the Leave Approval Workflow Tutorial for step by step instructions.

Warning
  • Do not use spaces or special characters when creating submission folder names.

...

Post Data

When the form is submitted,  POSTs the document set to the specified URI and ignores any returned XHTML or redirect. This option may be used for additional processing of data. Use form action post if you want to both submit data to your URI and forward to a web page or display returned XHTML.

You have the option of also sending a filled form image using the Send Snapshot dropdown as well as sending an XML attachment containing the form data.

Info

If a form is configured to Post Data to a web application and it does not reach it's intended destination successfully, notifies the tenant admin of the failure via an email. If a flow does not reach the web application successfully, the flow administrator(s) - if configured -  receive the email instead of the tenant admin.

Image Removed

Additional Email Wizard

When the form is submitted,  can send an additional email message with the submission data, an optional XML document(s) , and optionally an image of the filled form via the Send Snapshot drop down  The email can be sent to multiple comma separated email addresses. The "To:" email address is required. All other properties are optional.

If you want an email to show a different From:address than what is configured on the Edit Tenant page, enter that address in the From: field. You can enter a static address or use templates to make the the address dynamic. The From address replaces the default no-reply@… , an address configured on the Edit Tenant screen or any settings in web.xml or frevvo.xml config files for In-house customers.

This is in addition to any document action you may have configured. For example, consider a Vacation Request Approval workflow. When the workflow is complete, we want to send a PDF to the internal HR system (using the document action) but in addition, we want to notify the employee requesting the vacation by email. Use the Additional Email wizard for this scenario.

...



  • Image Added 

Post Data

When the form is submitted,  POSTs the document set to the specified URI and ignores any returned XHTML or redirect. This option may be used for additional processing of data. Use form action post if you want to both submit data to your URI and forward to a web page or display returned XHTML.

You have the option of also sending a filled form image using the Send Snapshot dropdown as well as sending an XML attachment containing the form data.

Info

If a form is configured to Post Data to a web application and it does not reach it's intended destination successfully, notifies the tenant admin of the failure via an email. If a flow does not reach the web application successfully, the flow administrator(s) - if configured -  receive the email instead of the tenant admin.

Image Added

Additional Email Wizard

When the form is submitted,  can send an additional email message with the submission data, an optional XML document(s) , and optionally an image of the filled form via the Send Snapshot drop down  The email can be sent to multiple comma separated email addresses. The "To:" email address is required. All other properties are optional.

If you want an email to show a different From:address than what is configured on the Edit Tenant page, enter that address in the From: field. You can enter a static address or use templates to make the the address dynamic. The From address replaces the default no-reply@… , an address configured on the Edit Tenant screen or any settings in web.xml or frevvo.xml config files for In-house customers.

This is in addition to any document action you may have configured. For example, consider a Vacation Request Approval workflow. When the workflow is complete, we want to send a PDF to the internal HR system (using the document action) but in addition, we want to notify the employee requesting the vacation by email. Use the Additional Email wizard for this scenario.

Info

Doc action wizards are single select. If you set up one of the wizards then configure an action using a second wizard, the information configured on the first wizard will no longer display. This is as designed.

Let's say you want to send an email after your form/flow is submitted but you are also using the Filesystem connector to save your submissions to a directory on a local server. You configure the Filesystem connector wizard to do this. Then your configure the Email data to a specified address wizard to send the email. If you return to the Filesystem connector wizard, after configuring the email wizard, the information that you entered on the Filesystem connector screens will no longer display. In this situation, you can use the email wizard on the Additional Email tab to configure your email. Refer to How to setup Multiple Document Actions for an example.

To use the wizard, click Doc Action in the toolbar at the top of the form and select the Additional Email Tab. See  Email Integration for further details on configuring the content of the email.

How to set up Multiple Document Actions

It is important to remember that doc action wizards are single select by design. The Additional Email wizard can be used to send an email if you are configuring more than one doc action on a form/flow. 

Let's say you have a workflow where you want to

 

  1. Save a copy of the form to Google Drive
  2. Email a copy of flow pdf to the IT department

Set up the Save to Google wizard. Then use the Additional Email tab to configure the email to the IT department.

Doc URI Wizards

The doc URI wizards enables you to manually set a URI to which the data will be sent when your form is submitted. The Google Spreadsheet wizard provides additional assistance in setting up the login to your google account and in selecting the spreadsheet.

...