Versions Compared

Key

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

There are many paths to Rome.... frevvo suggests the following best practices for managing your tenants, projects, forms and workflows.


Column
width400px
Table of Contents
maxLevel4


...

Let's say you have a form/workflow in production that requires some changes. Follow these steps:

  1. Download the form from your production account.

    Info

    frevvo recommends that customers maintain backup .zip files of production forms and workflows their own version repository. Each time you download a workflow from production, provide it with a unique filename (i.e. MyWorkflow_flow prod YYMMDD.zip) and maintain it in your directory as a backup. In case a later development version has incompatible changes, you will be able to revert to your latest backup version.

  2. Upload the form to a NEW or Existing project new or existing project in your development environment.
  3. Make the changes.
  4. Download the updated form/workflow from your development account.
  5. Upload it to your production account. Be sure to check the Replace checkbox on the Upload screen. The XML schema checkbox will automatically be checked.
  6. The existing version in your production environment will be replaced with the modified version from the development environment. You will see it at the end of the form/workflow list.

...

  • Changing a control Name or a selection control Option Value when that control is referenced in business rules, preconditions, and/or task assignments.
    • For example, let's say you change a control name and then perform a pending task for that workflow from your task list. The data entered into the workflow on the prior form version will not display in the task with the renamed control.
  • Move a control inside a section, repeat or table.
    • Similar to the above example, data from tasks performed before the change may not appear on tasks performed after the change.
  • Making a control required that was previously optional.
  • Adding steps with required fields.
  • Update the database (or google sheet, or 3rd party system) supplying data for dynamic select control options on form.[load,activate]. Any task performed from the task list that had an option set that was deleted or changed (for example, to fix a typo) from the database displays the control as blank again and required if that was the default. If you're on a workflow step where these fields are now disabled, such as an approval step, you need to reject back to the user of that prior task to re-enter the data.

  • This same behavior occurs if you change selection control option values.


Form/Workflow designer edit ACL

The Access Control feature in allows the designer to assign other users permission to make changes to forms and workflows.

Warning

The ability to edit a form/workflow should not be given to other users if the form/workflow is in production. Giving this permission would enable those users to edit your production forms directly thereby subverting the best practices described in this guide.

Multi-Tenant Scenario

Development Tenant

...