Live Forms v7.2 is no longer supported. Click here for information about upgrading to our latest GA Release.

Skip to end of metadata
Go to start of metadata

The frevvo product installation can be customized in many ways. For example OEM partners can brand frevvo with their own company images and look.

frevvo properties make it easy to implement many of the common customizations that all customer and OEM partners will want to consider.

frevvo Data API provides a programmatic protocol for viewing and managing resources such as tenants, users, applications, forms, schemas, etc.

Customization properties can be changed in the frevvo web.xml or the frevvo.xml files. Any parameter in web.xml can be duplicated in frevvo.xml and the value in frevvo.xml takes precedence over the value in web.xml. We suggest making changes to the context parameter values in the frevvo.xml if you are using the tomcat bundle. This keeps all your modified parameters in one place and makes it easy to upgrade frevvo to newer releases. See Installation Tasks for more information.

        frevvo war settings 
    <Parameter name="" value="" override="false"/>
    <Parameter name="" value="" override="false"/>
    <Parameter name="frevvo.mail.debug" value="false" override="false"/>
    <Parameter name="frevvo.actions.debug" value="true" override="false"/>
    <Parameter name="frevvo.rule.debug" value="true" override="false"/> 

On This Page:

Common Customizations

For the most common configuration customization tasks that every customer and OEM partner will want to consider see Installation Tasks. Also see the web.xml and frevvo.xml files for all of the context parameters that can be changed in frevvo

CSS for Forms/Flows

If you are using frevvo in-house, Cascading Style Sheet code that was used in themes applied to forms/flows in previous frevvo releases, can be added to a newly created style.css file in the frevvo.war file . The context parameter, frevvo.css.url, in the web.xml file must be changed to point to it.  The web.xml file is included in the <frevvo-home>\tomcat\webapps\frevvo.war. The frevvo.war must be unzipped/rezipped after modifications have been made as outlined in the steps below: Let's use the following css code which hides the submit and cancel buttons on all forms/flows as an example:

  1. Stop Live Forms if it is running.
  2. Unpack the frevvo.war file to a temporary location of your choice: e.g. c:\tmp\frevvo-war. Change the file extension from .war to .zip if necessary.
  3. Create a text file named style.css. To hide the submit and cancel button globally add the code below. 
div.f-control.f-submit.s-submit {
        display: none;
div.f-control.f-submit.s-cancel {
        display: none;

     4. Save the changes to the style.css file.

     5. Copy the style.css file to the  c:\tmp\frevvo-war directory. 

     6. Navigate to c:\tmp\frevvo-war\WEB-INF directory. Edit the web.xml file.

     7. Search for the frevvo.css.url context parameter. set the value of frevvo.css.url context parameter in the web.xml file to point to the newly created style.css file. The frevvo.css.url context parameter should look like this: Remember to save your changes.

         <description>Custom Stylesheet URL</description>

     8. Rezip all the files in the c:\tmp\frevvo-war directory, even the ones you did not edit — if you change directories or zip them differently, Live Forms may not load correctly. Rename the modified file frevvo.war.

     9. Copy the modified frevvo.war to the  <frevvo-home>\tomcat\webapps directory of your frevvo in-house installation.

    10. Restart your Live Forms server.

If you are using tomcat, you can add the frevvo.css.url parameter to the <frevvo-home>\tomcat\conf\catalina\localhost\frevvo.xml instead of modifying the parameter in the web.xml file. To do this, replace steps 6 and 7 above with the following steps then continue with step 8 listed above:

     6. Navigate to <frevvo-home>\tomcat\conf\catalina\localhost. Edit the frevvo.xml file with a text editor. 

     7. Add this parameter to the frevvo.xml file. Remember to save your changes.  


<Parameter name="frevvo.css.url" value="${context.path}/style.css" override="false"/>

If you make these changes, the Login and Forget Password buttons on the frevvo login screen will also be hidden. This is useful for OEMS that embed frevvo in their own application.



The frevvo Data API enables programmatic access to the all resources and data stored in the frevvo server. The API provides a simple protocol for viewing and managing resources such as forms, applications, schemas, etc. OEM partners as well as end user customers can use the API to extend the features and provide tighter integration with other applications.

You will need to install a client library in order to use the API.


VAR and OEM partners can brand Live Forms with their own company images and look. This is accomplished via frevvo web application parameters.

Set Branding Parameters

The frevvo.war file contains a web.xml with branding parameters. In the frevvo-tomcat bundle, frevvo.war is located in: <frevvo-home>\tomcat\webapps - when the war file is unzipped to a temporary directory, the web.xml file will be found in <tmp>\WEB-INF.  Refer to Installation Tasks for the steps to repackage frevvo.war after parameters in web.xml have been editied.

For example, the parameter,,  if added to the web.xml file, prevents the menu bar from being rendered.  Any of the menu items (Downloads,Templates, Help, Docs, Forum, Contact) can be removed from the menu bar via configuration parameters in the web.xml or frevvo.xml files.  If all of the menu items are disabled, the menu bar should be removed.  

        <description>Show menu bar. Set to false if all menu items are disabled</description>

Set branding parameters at container level

If you choose to brand at your web container level, note the web configuration changes at the container level take precedence over (override) those in the frevvo.war web.xml file. Again using Tomcat as an example:

  • Open the file: <frevvo-home>\tomcat\conf\Catalina\localhost\frevvo.xml.
  • Create a parameter with the same name as you see in frevvo.war's web.xml file. For instance, for the logo image:
<Parameter name="frevvo.logo.url" value="<url to your image>" override="false"/>

These are the brandable parameters and their defaults:

ParameterDescription Default
frevvo.home.urlHome page for the Company Logo link ${context.path}
frevvo.logo.urlURL to the Company Logo image. Also applies to Spaces${context.path}/images/bright/TransparentLogo-NoBeta.png to the Help page${context.path}${servlet.path}/static/help/designer to the Documentation to the Forum to the blog
frevvo.product.nameThe Product NameLive Forms
frevvo.copyrightProduct Copyright One-LinerCopyright 2006-2012 frevvo Inc. All rights reserved.
frevvo.license.urlURL to License Agreement${context.path}${servlet.path}/static/termsDL Us email
frevvo.downloads.menuShow Downloads menu itemtrue Gallery (Examples) menu itemtrue
frevvo.templates.menuShow Templates menu item true
frevvo.css.urlCustom Stylesheet URL 
frevvo.poweredby.markupLogo in form footer when the Logo property setPowered by Live Forms™ title prefix for all Live Form pagesfrevvo menu bartrue
frevvo.oem.branding.classNames css class applied to body of UI pagesempty
frevvo.certificate.signature Ignore SSL Security when posting to an https endpointempty

Branding External Urls 

Notice that several of the parameters use Url templates. For example, references a help file named designer.xsl that is part of frevvo.war and is located in the directory <frevvo-home>\WEB-INF\xsl\main\help after the war file has been unzipped . You may wish to bundle up a replacement help file and store your replacement file in that same directory. In that case you will keep the templates ${context.path}${servlet.path}/static that are part of the default path and append your own help file name. It can be an html file, myAppHelp.html. Or if your help is an external file you can replace the entire default value ${context.path}${servlet.path}/static/help/designer with a Url such has http://mycompany/myapp/help.html. Refer to Installation Tasks for the steps to repackage frevvo.war after parameters in designer.xsl have been editied.

Hiding Url Menu Items 

The frevvo.war file contains a web.xml with branding parameters. In the frevvo-tomcat bundle frevvo.war is located in: <frevvo-home>\frevvo\tomcat\webapps - when the war file is unzipped, the web.xml file will be found in <frevvo-home>\WEB-INF.  Refer to Installation Tasks for the steps to repackage frevvo.war after parameters in web.xml have been editied. Certain menu items are links to external Urls. Examples are Downloads, Forum, Docs etc. It is possible to completely remove any of these menu items by deleting the URL or setting the appropriate property. If no URL exists the menu item will be hidden.These paramters are found in the web.xml file. 

For example, if you want to hide the Downloads menu item:

        <description>No Downloads menu</description>

For example if you wish to hide the Docs menu item, edit the and delete the content:

        <description>No URL set will hide the Docs menu and top link</description>

The look & feel of the Live Forms application is controlled via css. frevvo.css.url gives you the ability to add your own style sheet if you need to customize the look & feel of the page itself such as the background colors and sizes of the items on the pages. You can use a tool such as firebug to learn how the page is styled with css and thus how to override the default styling. 


The Powered by frevvo™ logo can be customized via the frevvo.poweredby.markup branding parameter. If this branding parameter is an empty string no logo will appear on any form. The logo can still be turned off on any given form via the Show Logo form property.

Hiding Form/Doc Action Wizards

The Live Forms designer form and doc action  buttons can be customized via the web.xml configuration file. Web.xml  is contained in the <frevvo-home>\tomcat\webapps frevvo.war. It is located in <frevvo-home>\WEB-INF\web.xml after the frevvo.war is unzipped to a temporary directory. Refer to Installation Tasks for the steps to unzip and repackage frevvo.war after parameters in web.xml have been edited. By default all wizards are visible in the form & doc action buttons page. To hide a wizard, remove it from the associated context parameter below.

<!-- Wizards -->
        <description>Which form action wizards are displayed</description>
        <description>Which error action wizards are displayed</description>
        <description>Which doc action wizards are displayed</description>
        <description>Which doc uri wizards are displayed</description>
        <description>Which form action wizards are displayed</description>
        <description>Which error action wizards are displayed</description>
        <description>Which doc action wizards are displayed</description>
        <description>Which doc uri wizards are displayed</description>

Any parameter in web.xml can be duplicated in frevvo.xml and the value in frevvo.xml takes precedence over the value in web.xml. If you plan to override the web.xml context parameter values and you are using the frevvo Tomcat bundle, we suggest doing so in frevvo.xml. This keeps all your modified parameters in one place and makes it easy to upgrade frevvo to newer releases.

Hiding Data Sources/Palette

Hiding Data Sources on the designer screen can be accomplished by adding the ?_method=post&edit=true and &showDS=false parameter to the edit link of a form.  Create the URL using the steps below:

Then copy and paste it in another tab of the browser. You have to add it to the Edit link, you cannot click Edit first and then add this parameter to the link that appears in your browser.

  1. Click the Share icon  of a form on the Forms Home page and copy the "Raw Url" of the form into another tab of your broswer.
  2. Add the "?_method=post&edit=true" parameter to the end of the link.
  3. Add the "&showDS=false" parameter to hide Data Sources or "&showPalette=false" to hide the control palette.
  4. When the form displays, either the Data Source section or the palette will be hidden.

Here are examples of the URl:

Customizing the HTML Page Title Prefix

You can use the context parameter in the frevvo.xml file to  change the HTML prefixes of the titles of all Live Form pages. The Preview Page in the designer will display with value of the the title  parameter  - <browser name>.  For example, to change the HTML page prefix to a company name, follow the steps below:

  1. Ensure that frevvo is not running.
  2. Navigate to <frevvo-home>\tomcat\conf\catalina\localhost. Open the frevvo.xml with a text editor.
  3. Add the information below to the frevvo war setting section of the file
<Parameter name="" value="Company Name" override="false"/>

      4. Save the file and restart frevvo.

Adding a Custom Button to the Designer Tool Bar

Adding a custom button to the frevvo tool bar can be accomplished with the frevvo.form.edit.toolbar.buttons context parameter in the web.xml file. The value of the parameter is a JSON string that determines which buttons are visible in the toolbar. This context parameter is not optional - if it is not present there will be no buttons in the designer toolbar. 

Here is an example of how to edit the web.xml file to add the configuration parameter to add a custom Test Form button to the toolbar. The comment shows example JSON to add a new button. You can specify an id, a class and a title.  Be sure to rezip the frevvo.war file, as described above, when the changes are complete. 

		Example JSON to add a new toolbar button.
		<param-value>{"id":"e-test-form","class":"e-test-form e-toolbar-icon","title":"click to test the form"}</param-value>
		<description>Which edit mode toolbar buttons are rendered in the form designer</description>
This will generate something like this:
<a id="{id}" title="{title}" class="{class}" href="#" onclick="return'{id}');"></a> calls your code. Make sure it is defined. The FrevvoCustomActions, as shown below, is an example:

var CustomWizard = {
	show: function (id) {
		if (parent.FrevvoCustomActions)
			parent.FrevvoCustomActions.doAction (id);
		else if (FrevvoCustomActions)
			FrevvoCustomActions.doAction (id);

frevvo.certificate.signature context parameter

When a form's doc action is configured to post to an https endpoint, you can ignore ssl security using the frevvo web.xml param frevvo.certificate.signature. Services that accepts https and do not have a security certificate setup might generate an error like this:

INFO: 11:09:51,062 INFO DocumentSetUtil:539 - notifyDocumentSet_POST: POSTing document set to 11:09:51,062 ERROR DocumentSetUtil:615 - Could not POST document set to URI: PKIX path building failed: unable to find valid certification path to requested target

 You can tell frevvo to ignore this error using the frevvo.certificate.signature context parameter . This should work with services that have self-signed certificates that aren't installed in jvm certificate file and with certificates from a security authority. Add this context parameter to the frevvo web.xml file included in the frevvo.war zipfile. See Installation Tasks for the instructions to unzip and rezip the war after modifications to the web.xml are completed.

  <description>Set to true to accept self-signed certificates</description>

Check Database Encoding

The parameters, frevvo.db.check.encoding and frevvo.db.encoding.error, have been added to the web.xml file included in the <frevvo-home>\tomcat\webapps\frevvo.war. These parameters can be used to specify how to handle a check of database encoding and how to display the error if it is not UTF8. They are particularly useful for OEMs who may want to skip the fatal error by setting the frevvo.db.check.encoding parameter to false.

You can set up these parameters to accomplish the following: By default live forms does the check and will fail if not set correctly. 

1. Perform the utf8 check with a fatal error.

2. Disable the UTF db encoding check completely.

3. Perform the check but not fail and simply log the warning in the <frevvo-home>\.tomcat\logs\frevvo.log file.

 Here is how it works:

  • An error will not be displayed if either of the parameters are false. The license page is displayed.
  • Both parameters must be set to true for the error message "Users database schema, Database char set incorrectly configured. It must be utf8, but is instead: XXXXX"  to display:  

Follow these steps to set the parameters:

  1. Unzip the frevvo.war as explained here. Rezip it after the modifications are made.
  2. The parameters are located in the Database Schema checking on startup section:  
 <!-- Database Schema checking on startup -->
        <description>Check the database encoding on startup</description>
        <description>If encoding is checked and is wrong, then it is a fatal error, otherwise only a warning is logged</description>

Pointing frevvo Help Links to your Documentation


Branding CSS

OEM partners can use the context parameter, frevvo.oem.branding.class to name a css class that will be placed onto the body of the frevvo UI pages (form designer, etc.). Follow the steps below to do this:

  1. Stop frevvo, if it is running.
  2. Unzip <frevvo-home>\tomcat\webapps\frevvo.war file to a temporary directory. You may have to change the file extension from .war to .zip to unzip it. See Installation Tasks for instructions.
  3. Edit \your temporary directory\WEB-INF\web.xml to set  the context parameter, frevvo.oem.branding.class to oem
  4. Edit \your temporary directory\css-XXXXX\themes\oem\oem-branding.class file to make your changes. The XXXXX in the directory path represents the Revision Number of frevvo. For example, the oem-branding.css file will be located in \your temporary directory\css-19498\themes\oem for a revision number of
  5. Recreate the oem-branding.css file to include the modified oem-branding.css file.
  6. Repackage frevvo.war. Refer to Installation Tasks for instructions.
  7. Copy the modified frevvo.war file to the <frevvo-home>\tomcat\webapps directory.
  8. Start frevvo.
  9. Clear the cache before restarting your browser to see the changes.
 <description>This css class will be placed onto the body of the frevvo ui pages. OEMs can then edit the included oem-branding.css file with rules based on the body having the oem branding class in order to customize the frevvo app.</description> 

It is recommended that you modify the default oem-branding.css file to make the desired changes to the frevvo application. Any aspect of this file can be changed.

3rd Party Licenses

frevvo builds upon several 3rd party products. The frevvo.war file contains a WEB-IN\licenses with all the 3rd party licenses.



  • No labels