Versions Compared

Key

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

A control template is a control that was published by the form designer so that it can be reused in other forms and by other designers within the same tenant. You typically want to publish control templates when you create complex control with sophisticated layouts, field patterns, business rules, etc., and want to reuse that work in another form or share it with another form designer. You also may consider using control templates when you need to split the work among a number of form designers, where each designer is responsible for creating a subsection of a complex form and another designer is responsible for assembling these control templates into a final form or flow.

Image RemovedImage Added

Column
width240px

On this page:

Table of Contents
maxLevel1

...

There are two types of control templates that you can create in frevvo Live Forms – modifiable templates and read-only templates. In some cases may you want to publish a control template and allow them to be completely modified when used in other forms. These modifiable control templates are basically a starting point to a sightly or entirely different control at the discretion of the designer using it. Note that by changing the name of a control, you may break rules published with the control. In other cases, you may want to publish read-only control templates. A designer using a read-only control will not be able to remove nested controls nor change any properties that affect the underlying data binding (e.g., the name property). The designer can still change other UI-related properties such as styles and labels, and rearrange any nested controls on read-only templates.

...

There are two ways you can publish a control in frevvoLive Forms:

  • Clicking the Publish Control Template link, in the control properties pane, or 
  • Dragging and dropping the control onto the Custom tab header

There is small difference between these two ways of publishing controls, though. When clicking the Publish Control Template link, you are only publishing the control as a template, but when you drag & drop you are also adding the published control to the Custom tab, in one shot.

Image RemovedImage Added

Next, you will see the Publish Control Template dialog where you can enter a name and description for this template, a category, and any number of comma or space-separated tags.  See the [[V4_Admin_Home_Page#Manage_Control_Categories | Manage Control Categories]] topic for instructions for adding or removing control template categories.

...

Click Submit and you will see a confirmation page that once closed will refresh the page. If you used the drag & drop approach above, you should see the published control automatically added to your Custom pane.

Image RemovedImage Added

Publishing Controls with Rules

...

When the above conditions are met, the Publish Control Template dialog will list the candidate rules (see next screenshot) allowing you to select the ones you want to publish with the control. Note that as soon as at least one rule is selected the read-only checkbox will also be selected: you can only publish controls with rules in read-only mode. Since it is not possible to edit rules after the control is published, this restriction exists to make sure that no changes that could break the rules will be allowed when using the template.

Image RemovedImage Added 

Adding/Removing Templates to/from the Custom Pane

You can add control templates to the Custom pane by clicking the Search link found there. This will show the Search Control Templates dialog where you can search for the template you are looking for.

Image RemovedImage Added

This search dialog will show, by default, the first 10 templates ordered by the date when the control was published. You can then page through the templates by clicking Next or Previous.

...

If you want to remove control templates (instead of removing from the Custom pane) from frevvoLive Forms, you need to make sure you are logged in as the tenant admin and navigate to the Templates > Templates by Category or Templates > Templates by Tags page from the top menu. There you will see the list of published controls and can remove them one by one.