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
maxLevel3



...

Info
titleEditing Forms & Workflows In Use

When a production workflow that has pending tasks associated with it is edited and replaced with an updated version, pending tasks will contain the changes the next time they are "performed" from the task list. For example, let's say you

  • Add or delete controls in a signed section and there are workflows pending in flight that have already been signed.
  • Add/remove a field that was used in a business rule; ex: Add/remove a column from a table that was used in a calculation.
  • Change a spreadsheet that you are reading from or writing to using the Google connector.

When you edit a workflow and change business rule or add/remove fields, all the pending tasks pick up the latest version of the workflow. Pending tasks for a form/workflow that integrates with a Google sheet reflects any changes made to the Google sheet while the tasks are in-flight.

There are some restrictions if you want to update a production workflow without causing problems in existing flows workflows that are in-process:

  1. If you add new controls, and make them required/mandatory, then the
flows
  1. workflows which are already in-process might get stuck. This can happen if the controls that you added are visible in prior steps of
flow
  1. workflow, but they are hidden (via rules) in later steps. If an existing
flow
  1. workflow has already reached later steps when you add these required controls, then there won’t be any value in these hidden controls when user loads his step. As these required controls are empty,
frevvo
  1.   won’t allow the user to submit his step.

So you will have to think about how the newly added controls affect existing flows.
  1. A work-around could be to use a business rule to make these control not required if the
flow
  1. workflow was started before certain date.
  2. When you edit existing controls in the
flow
  1. workflow, you will have to make certain that underlying schema
of the flow
  1. does not change. For example, if you have some controls in a Section, and you edit the
flow
  1. workflow and move these controls outside that section or to a different section, this will change the underlying schema
of the flow
  1. , and will cause the existing in-process
flows
  1. workflows to not work correctly.
So we
  1. We recommend that you do not
to
  1. change the base structure/schema of your
flows
  1. workflows once they are in production

The best approach is to finish all existing flows, before changing the workflowworkflows before uploading/replacing with the edited version. You can prevent users from starting new flows workflows (while you are waiting for existing flows workflows to finish) by temporarily changing the Access Control for Who can start the form/workflow? to "Designer/Owner only" that no one else can access it.

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

...