The initial release of frevvo Version 10.0 was deployed to the frevvo Cloud in October 2020. The v10.0 download is available for On Premise customers from our Software Downloads Directory.

Automatic Upgrade for frevvo Online (Cloud Hosted) Customers

frevvo Online cloud hosted customers receive a seamless automatic cloud upgrade. If you have any questions, please email support@frevvo.com.

New Features 

frevvo v10.0 features a fresh new user interface and tools that will help designers swiftly and easily create new forms and workflows, build custom logic, and customize the user experience. The brand new Guided Form & Workflow Designers are simple and intuitive, making the design process faster and even more fun. We hope you will love these enhancements as much as we do! To see all of the new features for this release visit our Detailed Release Notes page. Here are some highlights to get you started:  

Watch our What's New in v10.0 Webinar for a tour of our favorite new features!

Features Introduced in Prior Releases

There are several important features that were introduced to the frevvo Cloud in prior releases and are now included for On Premise customers in v10.0. Please review the information below and see the detailed release notes for each version in between your current version and v10.0.

Guided Designers

The Form Designer and Workflow Designers have a new look with improvements to speed up your design process. The new navigation icons at the top of the page help you step through an efficient form/workflow design process, but you can also switch between them as needed with just a click.

Guided Form Designer

You will notice that the header on the Form Designer has been replaced by the Guided Designer navigation header. This allows you to quickly switch between adding and editing controls on your form to building custom logic with business rules to mapping a PDF and modifying the overall form settings. You also have a menu of actions such as Save, Test, and Preview in the upper right corner.

Form Name

Your form name will always show in the top left corner, and you can edit it here as well by clicking the pencil.

Action Menu

Use the action menu to save, test, and more. Visit the Forms page for a description of each action. Additionally, you will see your version number just below the dropdown icon.

Form

This mode allows you to add controls to your form and edit their properties via the left side Properties panel. Notice that you no longer see overall form properties here (view those in Settings.)

Notice that when you first open the Form Designer editing mode, or anytime you click the Form icon in the navigation bar, the Properties panel on the left side will say "Select a control on the form in order to view and edit its properties here." In past versions you saw an overview of the Form Properties here; starting in v10.0 this panel is exclusively used for Control Properties. You can view all of your Form Properties by selecting the Settings editing mode from the navigation bar.

Rules

The rules mode is where you will add and edit business rules to customize form behavior. While you're there, check out these additional enhancements to the Rules list.

PDF Mapping

Access, add and edit custom PDFs you are generating for this form.

Settings

Settings mode displays your familiar Form Properties Wizard previously accessed as a popup window when you clicked the cog icon. Now it has much more space so it's easier to view and edit your form properties, and it's responsive when you change your window size.

Guided Workflow Designer

Workflow Name

Your workflow name will always show in the top left corner, and you can edit it here as well by clicking the pencil.

Action Menu

Use the action menu to save, test, and more. Visit the Action Menu documentation for a description of each action. Additionally, you will see your version number just below the dropdown icon.

Workflow 

One of the biggest changes you'll see is the great new workflow outline look! The workflow outline now has narrower boxes with an action menu, and they also have icons that you can customize. Consider printing a screenshot of your workflow outline to use as a proof of concept or wireframe when planning a workflow with your team.

Activity Document Actions (Email and Web Hook) will appear on your workflow outline, making it very clear what actions happen on each step. 

Quickly add steps, preconditions, or Activity doc actions using the + icon between steps with a handy wizard tool.

Drag and drop steps to change their order.

Copy (alt-drag) Email or Web Hook steps to copy them to other workflow steps.

Workflow: Step Properties

Simply click on any step to view it's properties wizard right there on the canvas. Keeping the workflow outline in view gives you context for the properties you're working on. You now also have the ability to switch between steps while remaining on the same properties tab. We find this super time saving when making lots of similar changes to workflow steps, such as changing the Task Info message for every step of a workflow.

Forms

This is where you can edit the forms included in your workflow. 

Click Switch Form to change to a different form in your workflow.

The form that appears will be the step or linked step you last selected in the workflow outline. You can also get to the Forms mode by clicking the Action Menu on any step and selecting Edit.

Print Name Property in Workflow Steps

In past versions, a form used as a workflow step had a Form Name property independent of the Workflow Step Name property. The Form Name was primarily used as the filename when printing a workflow step. In v10.0, the printable PDF filename can be edited using the Print Name property, located in the Forms editing mode in the left-side properties panel.

Rules

The rules mode is where you will add and edit business rules to customize form behavior. While you're there, check out these additional enhancements to the Rules list.

Just like the Forms mode, you can Switch Form  to view and edit rules for another form in your workflow.

PDF Mapping

Access, add and edit custom PDFs you are generating for this workflow.

Settings

This is your familiar Workflow Properties Wizard previously accessed as a popup window when you clicked the cog icon. Now it has much more space so it's easier to view and edit your workflow properties, and it's responsive when you change your window size.

Saving Changes

We've added two new ways to save your work.

  1. Your changes are temporarily saved in memory when you move from one screen to another within the Guided Designer, switch between forms in a workflow, or switch between steps on Workflow Step Properties. You can quickly, and safely, navigate the the Guided Designer without losing your work.

    You must still Save, Save and Test, or Save and Exit before leaving the Guided Designer (i.e. closing the window, clicking the 'back' button in your browser, or clicking Cancel and Close.)


  2. Save without closing: You can now Save your work and remain on the current page instead of being navigated back to the Forms & Workflows homepage. This is super handy for saving time while designing forms!

Notice our Save icons have been updated and look great!

Business Rules Enhancements

The Business Rules list been enhanced with a similar user interface to the other list views in frevvo, along with the much-requested ability to drag-and-drop to reorder rules. 

Reorder Rules

It's easy to change the order of your rules. Simply click and hold any rule, and drag it to the place in the list you want to move it. You may also use the "Move down," "Move Up," "Move Top," and "Move bottom" options in the rule's Action Menu. These feature is helpful when you want to group your rules by workflow step, action or control type.

New User Interface

The Rules list now features

Switch Form button to view rules for a different form in your workflow

In prior versions, a Control Properties panel appeared on the Rules page above the Form Outline. With v10 the Properties Panel is gone. Instead you will notice that when a control has focus (is selected) in the Form and you move to the Rules page, that control will be expanded in the Form Outline. This give you access to view the control's properties that are available to you in the Rule Builder/Editor.

Rich Text Editor Enhancements

The Rich Text Editor (RTE) for Message controls now displays as a pop-up window. This provides more space for easily adding, editing and formatting your content. It also resolves bugs that could cause the RTE to close or disallow edits.

When you toggle Rich Text "on" the message property will be replaced with a link to "Edit with rich text." Click the link, or the red pencil icon  on the control, to open the RTE window.

Disable Task Notification Emails

You can disable the Task Notification emails for any workflow step assigned to a User or Role. This feature is useful for steps that should not notify users or for testing purposes. This feature is not available for steps assigned to an Email.

Navigate to the Assignment Tab.

Click CLEAR NOTIFICATION .

A confirmation message will appear. Click OK.

This will permanently remove both the Subject and Message text, effectively disabling the Task Notification email for that step.

If you have customized your task notification Subject and Message fields, and only want to temporarily disable notifications (such as for testing) we recommend copying the Subject and Message fields to a text editor so that you do not have to configure them from scratch later. 

Task List Search

Searching the task list could sometimes be a resource-intensive process, especially for workflow admins with permission on multiple forms/workflows. To speed up the process and prevent timeout issues, the form/workflow dropdown has been replaced with a search bar. Type a few letters of the name of your form/workflow, and a list of relevant results will show. Select the one you want.

Sort Spaces, Styles and Schemas

The Spaces, Styles and Schemas lists now have a Sort  feature that allows you to sort alphabetically A-Z or Z-A. 

Retired Features

ImageSilo/Papervision Connector

The ImageSilo/Papervision Connector has been removed. Forms and workflows will no longer be able to be saved to ImageSilo. Alternatively, customers may use the frevvo Filesystem Connector, or a Document Action email with PDF attachment that can be manually or programmatically uploaded to ImageSilo/Papervision. If you are currently using ImageSilo/Papervision connector, frevvo recommends that you contact your Account Manager to discuss other integration options. 

Migration Considerations

Upgrade Startup Times

The initial frevvo restart following v10.0.0 upgrade could take upwards of 10 minutes to complete (10+ in our Cloud) due to changes related to MySQL 8.

Windows Service Log On Settings

This applies only to On Premise Customers. If you plan to install frevvo as a Windows Service, there is a new Tomcat default security setting that you need to be aware of and configure so the service will run successfully. See Installing frevvo as a Windows Service for complete instructions.

Double click on the Service and go to the Log On tab. Notice that Log on as is set to This Account: Local Service. This is a Tomcat default security setting. 

You must make one of the following changes:

  1. To continue running as "Local Service", you have two choices.
    1. Give "full control" to the "Local Service" account for the frevvo installation folder (e.g. using File Explorer on Windows 10: properties->Security -> Advanced -> Add -> Select a Principal -> Enter "Local Service"), or
    2. Use this command to give specific access to only the Administrators, SYSTEM and LocalService (replace the frevvo-install-directory placeholder with the actual folder path):

      "%SystemRoot%\system32\icacls.exe" "<frevvo-Install-Directory>" /inheritance:r /grant *S-1-5-19:(OI)(CI)(F) /grant *S-1-5-32-544:(OI)(CI)(F) /grant *S-1-5-18(OI)(CI)(F)


  2. Or, switch the Log on as setting to "Local System account"

The windows documentation describes the security implications as "The LocalSystem account has broad permissions, including the ability to write to the event log. Use this account with caution, because it might increase your risk of attacks from malicious software. For other tasks, consider using the LocalService account, which acts as a non-privileged user on the local computer and presents anonymous credentials to any remote server". 

Uploading Forms, Workflows and Projects from Different Versions

Uploading from a Prior Version

Uploading forms, workflows and projects from prior versions is supported for resources up to two major release versions apart. frevvo v10.0 will support uploads from v7.4 and later. For example, you may download forms, workflows and/or applications/projects from v7.4 and upload them directly to v10.0. However, if you attempt to upload a form, flow, or application created in v7.0 or earlier to v10.0, you will see the error message "Invalid project/form/workflow file version: Version 7.0. Make sure you are uploading a zip file that was downloaded from a version of frevvo frevvo that is between version 7.4 and 10.0." In this case, you will need to first upload your forms to a v7.4 or v9.0 installation to upgrade them, then download from that installation and upload to your v10.0 installation. See our End of Life Policy chart for a list of major release versions.

If you need assistance upgrading forms and workflows in order to use v10.0, please contact our Support Team at support@frevvo.com.

Uploading to a Prior Version

Beginning in v10.0, you will no longer be able to download a form, workflow or project from one major frevvo version and upload it to a prior major version. For example, in the future if you upgrade your test server to v10.1.x, download a form from the test server, and attempt to upload it to your v10.0.x production server, you will see the error message "Invalid form file version: Version 10.1. Make sure you are uploading a zip file that was downloaded from a version of frevvo frevvo that is between version 9.0 and 10.1." You may still upload/replace versions safely between patches in the same major version (i.e. 10.0.14 → 10.0.13).

Duplicate Spaces

Duplicate space ids are no longer allowed in v10.0.x. On Premise customers upgrading to v10.0.x may see the error "Duplicate space(s) exist in the database, please delete duplicate records." in the Configuration Checklist if a user has more than one space with same space id. To resolve this error, delete the duplicate space and restart.

Embedded Forms/Workflows

Security enhancements in v10.0.0 now require embedded forms and workflows to be used in https-supported sites. Cloud customers with forms/workflows embedded in http-only supported sites will see a blank page or an error message when attempting to access the resource. To resolve this, use an https-supported outer site to embed the form/workflow. Please note that this may also require a browser or OS upgrade; for example, iOS 13/macOS 10.15 are the minimum iOS/macOS versions that supports the frevvo Cloud sameSiteCookies=none attribute.

Some browsers, such as Safari, also have security enhancements that will prevent embedded content from a third party site from loading. Please see this documentation describing how Safari users can load embedded frevvo forms. 

Data API

An http change request (post/put/delete) will soon require a token. This includes operations such as login and upload users by CSV performed through the API. Customers using the frevvo Data API should update their API calls to provide tokens and/or use the new API. Please see additional details including updated example cURL commands here. Current tokenless methods will remain supported for a limited time.

Embedded Forms & Safari Browser

Recent Safari updates have enhanced security features that prevent embedded content third party sites from loading inside another domain. These features help prevent sites from monitoring user's browsing activity, but they also impact frevvo forms embedded on your website when accessed via Safari browsers (and any other browser with similar security features.) Please see this documentation for details.

External URLs

The frevvo.forms.server.external.url property has been deprecated and is no longer supported. If this property was configured in your previous version, you must remove it when upgrading to v10+. Instead, configure a Tomcat proxy in the HTTP connector (port 8082) of the <frevvo-home>\tomcat\conf\server.xml file. See the External URLs Documentation for instructions. 

You must remove the frevvo.forms.server.external.url property when upgrading to v10.0+. Failing to remove this property can cause unexpected behavior.


The frevvo.internal.baseurl property no longer exists in v10+. Any setting in frevvo.internal.baseurl will be ignored by frevvo.

The connector with port 8081 was newly added to server.xml in v10+. Please ensure this port is available for frevvo to use. As indicated in the server.xml, changing the frevvo internal connector 8081 settings in the server.xml file can cause unexpected changes, and is not advised. 

<!-- A "Connector" used for internal frevvo calls: DO NOT MODIFY IT! -->
    <Connector address="127.0.0.1" port="8081" protocol="org.apache.coyote.http11.Http11NioProtocol"
               connectionTimeout="40000"
               maxHttpHeaderSize="32768"
               useBodyEncodingForURI="true" /> <!-- makes sure that uri parameter are decoded as utf-8 -->

If you need to change the internal port, please see this Default Internal Port documentation.

Documentation Update

The frevvo v10.0 Documentation has been reorganized to better reflect the Guided Designers, make content easier to find, and support both new and experienced users. Some page names have changed, and some content has been moved to different pages. If you have bookmarked frevvo documentation pages, you may need to update your links. Please use the page tree on the left to locate your favorite content.


Planning Your On Premise Upgrade

The initial release of frevvo version 10.0 was deployed to the frevvo Cloud in October 2020. Version 10.0 was released for On Premise customers on January 18, 2021. On Premise customers should review the topics below, the instructions in the Upgrade Guide and Supported Platforms before migrating. It is recommended that you perform a full installation of frevvo v10.0 when upgrading. 

v10.0 License

A v10 license key is required for this version of frevvo if you are upgrading from a prior version. Request a v10 license by completing this form before you begin the upgrade. 

Before you begin the migration process: