Versions Compared

Key

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

palette offers a rich variety of controls that let you create virtually any form. All controls provide functionality as soon as you drop them into your form but need to be customized (edited) to suit the form you are designing.

The purpose of each control is described below.

Column
width240px

On this page:

Table of Contents
maxLevel2

Input Controls
Anchor
Input Controls
Input Controls

Input controls allow users to enter data (text, dates, numbers, etc.) into your form and automatically prevent them from entering the wrong data types. For example, if users enter letters into a number control, your form will display an error message and the Submit button will not be enabled until valid data is supplied. This validation happens automatically; you do not have to do anything special. The purpose of each input control is described below.

...

Warning

You must specify the _formTz=<tz> parameter appended to the share URL when initializing a form with date, time or date/time controls from an XML init document, the _data parameter or a business rule that uses the rule identifier,form.load. The form server needs to know the timezone in which to return the date and time. Successful initialization cannot be guaranteed if the &_formTz parameter is not supplied. Refer to Initializing Forms with Data for the details. This URL parameter is not needed if your form/flow only contains Date controls.

Time data in a form is always converted from the browser's timezone to a valid UTC format when posted in the form XML document in the submissions database. Refer to Viewing XML Documents for more information. Business Rules execute in the form time zone. 

...

Allows users to enter U.S. currency. Users may type commas and a decimal point , but if they don’t, the form will display these symbols for them. For example if a user types 4000, the form will redisplay the value as 4,000.00will not add them to the data automatically. The form also will round all entries to two decimal places. (Note that if a user types more than two digits after the decimal place the XML submissions document will store as many digits as the user entered but will not include the dollar symbol, decimal point or commas.)For example, if the user enters 4000, it will display as 4000.00 when the user exits the field.

Phone

Used for entering a phone number and allows any of the following formats: xxx.xxx.xxxx, xxx-xxx-xxxx, xxx.xxxx, or xxx-xxxx.  If you want to enforce one of the 10-digit formats (to require an area code), you can edit the control’s Pattern.

...

Note

You may notice that the Max Length property for the numeric controls: Number, Quantity and Money is no longer present in the v5 designer. Uploading forms that were designed in v4.1.7+, with the Max Length set to a value, will not show this property in the v5 designer. However, the max length value will be honored when the form is executed in v5 use mode.

...

Selection Controls

 supports 4 types of Selection controls. Selection controls let users choose from a list of options instead of having to enter text.  

  • Dropdown
  • Radio
  • Checkbox
  • T/F
Tip

See the Item Width and Option Width properties for styling options.

...

The control options default to "true=Yes" and "false=No". When you drag the control from the palette, only the "Yes" option will be visible. You can change the option labels from Yes and No to whatever you want. It is important to note changes to the label for false are irrelevant as it will never be visible on the form. The option values cannot be changed and will always stay as true and false. Blank labels for options are not allowedChecking the “Yes” checkbox of the Boolean control results in a true value in the XML document.

...

In-house, a download customer can control ' internal upper limit via the web.xml parameter frevvo.attachment.maxsize. Initially, this value is set to 10485760 bytes. You can also set the max attachment size per user by editing the user's profile as the admin user and editing the Configuration field shown below:

Image Removed

Info

Now that you can take pictures using your mobile device camera and/or upload images to your , the default value of max_allowed_packet may not be large enough if you are using MySql. Refer to this website for detailed information about the MySql configuration parameter. Increasing the max_allowed_packet variable setting in your MySQL Server from the default (1M) to something like 16M (16777125) fixes the issue. To fix the issue temporarily, run the following commands:

  • mysql -u root
  • set global max_allowed_packet=16777216

To permanently set it, choose one of the two methods listed below:

  • You can add the parameter  - max_allowed_packet=16M to the mysqld command line or (mysqld_safe command line) as shown: 

 mysqld --max_allowed_packet=16M 

  • Edit the MySql configuration file (my.ini on Windows/ my.cnf on Mac OS) and add max_allowed_packet=16777216 to the [mysqld] section. 
Code Block
[mysqld]
max_allowed_packet = 16M
  • Restart MySQL.
  • Restart frevvo. 
  • The setting will permanently take effect.

On Mac OS, you can access the my.cnf file by typing

    • sudo vi /etc/my.cnf

 The location of the my.ini/my.cnf file varies by configuration.

parameter in the web.xml or frevvo.xml files. Initially, this value is set to 10485760 bytes. You can also set the max attachment size per user by editing the user's profile as the admin user and editing the Configuration field shown below:

Image Added

Enable Camera

The"Enable Camera" property for the upload control refers to the camera in your mobile device .It is enabled by default. Here is how it works:

...

The PageBreak control cannot be dropped BELOW any control. It can be dropped BETWEEN 2 controls or ABOVE any control. Let's say you are designing a form for mobile devices. You drag and drop one control on the form. Now you want to add the PageBreak control and then add other controls below it. You cannot drop the PageBreak below any control so you will have to add the other controls first and then drop the PageBreak control where you want it. Once you add more than one control to the form, you can drop controls from the palette or the form above or below the page break. You can drag and drop the PageBreak itself anywhere at the root of the form. The PageBreak control should not be inside sections, panels, tables or repeat group controls. The only exception is the Tab control. See below for the details.

PageBreaks in a Tab Control

Dropping a page break control in one tab of the tab control adds the page break to all tabs. You must drag and drop the Tab control into the form first and then drop the PageBreak into one of the tabs in the tab control. If you drag and drop the PageBreak control onto the canvas first and then try to move it into a tab control, it will not work. When you drag and drop a page break control into a tab, it will always be at the top. You cannot drag it but if you drop another control from the palette or the form it will always drop below the page break control even if you drop it on the tab header. Setting/unsetting a property (e.g. uncheck Phone) in one Tab will duplicate the action in all tabs. If you try to add more than one PageBreak control to a tab, you will see the following message:

...

Section
Column
width50%

Tabs Display on a Tablet

Column
width50%

Tabs become Pages on a Smart Phone

Testing Your Mobile Form

Currently, the best way to test mobile forms/flows is to click the Test icon on the Forms Home Page in the designer. Sometimes, the mobile form/flow does not look the same in your desktop browser as it does on the mobile device. It is recommended that you design/debug your form/flow completely on the desktop first. Then you can add your form/flow to a space and look at it on the tablet. You can also add ?_device=phone or ?_device=tablet to the raw form/flow link or the share URL for a space or task list to render it for that device in a regular browser. Use ?_device= if this is the first parameter you are adding to the linkURL. Change the ? to an & if this parameter follows other parameters in the linkURL.

Signature

Drag a signature control from the palette to add an electronic wet signature in your form. You cannot enter a signature into the control in edit mode. In use mode, clicking or touching a signature control presents the signature entry dialog that is illustrated in the image below. Use your mouse, track pad, touchscreen or a stylus to sign. You can clear the signature in order to sign again by clicking the Clear button.The Cancel button negates any changes. All signature controls are empty of any signature (shows the X and a line) when the user first displays the form. Entered signatures are only applied to the use mode form when the user selects Done. Notice the signature is displayed in the form scaled down into the signature control.

...

The ability to generate additional PDFs in the Forms designer is available in  version 5.2.  This control will be visible in the Forms designer palette in this release when generating "Pixel Perfect' PDFs.