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 form submission is prevented 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.

To validate the content in each input control, frevvo assigns a default XML schema data type to each control.  The table below shows the default data types for each input control.

The explanations below describe the controls generically—before you edit them to impose additional restrictions or define behavior specific to the form you’re creating. Refer to Setting Properties for the information.

Text 

Text controls allow users to type any text and are intended for short, one-line entries.

TextArea

The TextArea control lets users type any text and is intended for longer, multi-line submissions. Scroll bars appear as needed to accommodate the text entered. This control has a # of Rows property that controls the default number of lines visible in the input area. The TextArea control is the only input control that does not have a decorator.

In HTML there is no way to set a maxLength on a TextArea control which is why the TextArea control does not have the maxlength property like the text control. If you need a maxlength, it's best to either choose the text control, or this can be accomplished via a business rule. See the Business Rule for TextArea Max Length. 

Since users typically enter multi-line text into TextArea controls this can pose a challenge if you want to display that text in an HTML page. For example, you may want to display the entered text in your form's Doc Action display message, in an HTML formatted email, or in on a web page such as your Confluence wiki. The challenge is caused by the fact that line breaks entered into a TextArea control are represented by a single newline character \n while line breaks in an HTML context are represented by the HTML break characters:

<\br>

In order to display the text in an HTML context you need to replace the \n with the HTML break characters. See the business rules chapter TextArea newline vs break for a working example.

Date, Time, and Date/Time Controls

The date control allows the user to enter a date, time, or date/time combo. The designer can choose from a variety of formats for each type.

Designers can add a date picker via the Style Properties tab. 

• The Date control denotes a day and has no dependencies on time zone.

• The Time control denotes the time of the day and has no dependencies on time zones or offsets. It will not shift based on whether or not Daylight Savings Time is observed in a time zone.

• The Date/Time control relies on the time zone of the browser. The time portion will be calculated based on the date and whether or not Daylight Savings Time is observed in that time zone. The Date/Time control type is meant to represent a point in time, so certain functions in the Visual Rule Builder (year, month, day, hour, minute) are not available on this control type. 

  If the form cannot infer the browser time zone, the Date/Time control will display in UTC.

For example, the time 5:00 PM is entered into a Time control and the date 2/4/2020 plus 5:00 PM into a Date/Time control by a user located in the America/New_York (Eastern Standard Time). When the submission is viewed in the EST time zone, the Time Control displays 5:00 PM. This value will not change. The time portion of the Date/Time control also displays 5:00 PM, because it takes on the timezone of the browser (EST) and it is not further adjusted because Daylight Savings Time is not observed in EST on February 4th.

If the submission is viewed in Tijuana (Pacific Standard Time), the Time Control will display 5:00 PM as it did in EST, since it has no dependency on time zone. However, the Time portion of the Date/Time control will show 2:00 PM because it will be adjusted by the browser time zone to PST. 

Business Rules can be applied to the Date/Time control in all variations. See the Rules Examples chapter containing numerous examples.

Date, Time and Date/Time Submission Values

frevvo saves Date and Time control values in the submission xml document exactly as entered, but converted to ISO format. These values will display as entered, regardless of viewer's time zone, when the submission or workflow step is viewed.

frevvo saves Date/Time control values in the submission document in Coordinated Universal Time (UTC), also in ISO format. The indicator "Z" is appended to the end of the string to denote UTC time. This value will display in the user's browser time zone when the submission or workflow step is viewed.

Here is a form with Date, Time, and Date/Time controls entered by the user at run-time in the New York time zone.

In the submissions document, notice that the date and time are saved as entered. You can see the time is '10:43:00' which is 10:43 AM in ISO format. However, the Date/Time control value is saved in UTC '14:43:00Z' which is 10:43 AM EST converted to UTC.

ISO Formats

• Date: YYYY-MM-DD

• Time: HH:MM:SS

• DateTime: yyyy-mm-ddThh:mm:ssZ

Email

The EMail control requires users to enter a valid email address. The address must conform to the following syntax: <name>@<domain>. The email control provides rudimentary syntactic validation by checking for the presence of an "@" between the local-part (name) and domain, both of which can contain any character. The local-part can have a max length of 64 characters and the domain 255. Your usage may have stricter rules on what an email address can contain. In this case, you may want to use a text control with a pattern that represents your usage instead.

Multiple emails can be entered in the email control separated by either a comma or a semicolon; however, the syntax will only be validated on the first email entered.

Money

The Money control allows users to enter U.S. currency. Users may type commas and a decimal point but frevvo will not add them to the data automatically. The form also will round all entries to two decimal places. 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. If you want to enforce one of the 10-digit formats (to require an area code), you can edit the control’s Pattern.

• ##########

• ###-###-####

• ###.###.####

• ###-####

• ###.#### 

Quantity

The Quantity control is used for entering quantities or any whole numbers (integers). The form displays an error message if users enter decimal points, commas, or anything other than an integer.

Number

The Number control is used for entering decimal numbers. Users may enter any number of digits after the decimal place.

Selection Controls

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

• Dropdown

• Radio

• Checkbox

• ComboBox

• T/F

Setting Options

Options for the Dropdown, Radio and Checkbox controls can be populated using two methods. These are discussed in detail in the Control Properties chapter.

1. Design Time (Static Options)- Designers enter the options at design time by typing them in the Options property for the chosen selection control. Options entered in this way are static - they will not change at runtime. The controls are discussed below.

2. Web Service (Dynamic Options) - Designers can dynamically populate options at runtime from an external RESTful web service source, such as the frevvo Database Connector. The frevvo Dynamic Option feature allows you to do this without code right in the control properties panel. If you prefer, you can also set dynamic options using a business rule. Refer to the Dynamic Options topic for the details.
   

Dropdown

The Dropdown control displays a list of options in a dropdown menu and allows a single selection. The first choice in the dropdown list is blank; you define the other choices by editing the control’s Options properties. Keyboard selection of an option is not currently supported but is planned for a future release. Users can type-ahead. For example, select a dropdown control and type "S" and it jumps you to options that start with "S". This is extremely useful for dropdown controls that have a long list of options. This control is a standard HTML dropdown so it does not allow using backspace to clear selected options. The Comment property can be used to provide a text box for additional information when the last option in the selection control is chosen. 

ComboBox

The ComboBox control supports three types of data retrieval: frevvoUsers, frevvoRoles, and Web Service. Designers select the data source from the Options Src property. See the Dynamic Options feature topic for information about how to set up options for the ComboBox control.

You can use the ComboBox to retrieve values from a database and enable a list of possible partial matches.

frevvo LDAP customers often use the ComboBox control if they have many users/roles configured on their LDAP server. What if the designer wants to pull a list of users or roles from their LDAP server into a form or workflow for user selection? Using a traditional dropdown control is not ideal especially when you have thousands of users to pick from. The ComboBox control allows users to type characters in the ComboBox control that filter the choices to the entered characters and display those that match. You can also type a value that is not in the list. You may limit responses to the available options by selecting Options Value Only (available only for frevvoUsers and frevvoRoles.) Checking Options Value Only is recommended when using the ComboBox value in form routing; allowing a value that is not in the list could result in an invalid task assignment.

Drag/drop the ComboBox from the Palette or import it from ComboBoxfrom Schema. When you drag/drop the ComboBox from the Palette, it does not have a ControlType property. You cannot change the ComboBox to a different control by changing the value in the Control Type dropdown. You must delete the ComboBox and then add the control that you want. 

Existing forms/workflows that contain the ComboBox control will have the value of the Options URL property in the Options Src field after upgrading.

ComboBox from Schema

You can change the Options Src for ComboBox controls that are added to your form/workflow when you upload a schema.  Notice this control does not have a display as property so you cannot change the appearance of the control using this property.

Information about how to set up Options for the ComboBox control is discussed under the Dynamic Options feature topic.

Radio

This adds mutually exclusive radio buttons. You define the number of radio buttons and the specific choices by editing the control’s Options properties. Note: If you select a radio option as the default and later decide you do not want an option selected by default, you must remove that option from the control and tab out of the options property so that it is removed from the control. Then add the option back to the control's options list. Now that option is no longer a selected default.

A  Comment property can be used to provide a text box for additional information when the last option in the selection control is chosen. 

Checkbox

This adds a set of checkboxes so users can check one or more. As with the other selection controls, you edit the control’s Options properties to define the number of checkboxes and the specific choices. A Comment property can be used to provide a text box for additional information when the last option in the selection control is chosen. 

T/F

Use a T/F (Boolean) control in your form for situations where the values will only be Yes or No. For example, The image shows a T/F control in the Preferences section of a company Travel Request. The label for this field has been changed to Non-Smoking Hotel Room. The employee filling out the request checks the box if they prefer a Non Smoking room.

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. However, changes to the label for false are irrelevant as they 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 allowed. Checking the “Yes” checkbox of the Boolean control results in a true value in the XML document.

Leaving it unchecked will translate to a null value, so no value will show in the XML document.

Notice the Required (false) property on the T/F Properties panel. This property is unchecked by default. If checked, the XML entry shows a false value when the T/F value is not selected. However, this property does not require a T/F control to be checked, since the unchecked option is still a valid value (false).

A T/F control added to a table will hide the "Yes" option label. A Boolean checkbox should be used only if there are two states: Y/N. The column header label in the table can help make the choice obvious. For Example, you could create a column header - Non-Smoking Room in the table and if the user checks the box the value will be true and if the box remains unchecked, the value will be false.

Use another selection control if the choices are not restricted to yes/no, or if you want to require the user to check the box. For example, you may want to require the user to check a box "I agree to the policies." In this case, a better option would be a checkbox control with a single value rather than a T/F control.

Value Property of T/F in Business Rules

The value property behaves differently for a T/F control depending on whether it is from schema or not.

• From schema, when checked: control.value === true

• From scratch, when checked: control.value[0] === true

If you use the Visual Rule Builder to build a rule with the T/F control, the resulting rule covers both value states so the designer will not have to make further changes.

Upload Control

Use this to allow the user to upload and submit attachments with your forms. You can attach photos from your device photos library or take a new photo with the device camera. The Upload control is decorated with an image that cannot be changed. When you click on the Upload control in use mode, the button text is underlined.

The upload control contains special properties to control the MaxSize, the Min/Max Number of Attachments to accept per form submission, and to allow the form designer to specify Restricted Content Types and Other Mime/Ext on the types of files allowed to be uploaded to the control/form. When a user uploads content to an upload control with a content filter applied, frevvo will check the upload against the filter and if there is no match, reject the upload with an error message.

Attachments are viewable in the Submissions Repository. You can configure your form's Doc Action property to send attachments to a URL endpoint (ex: servlet) that can save the attachments locally within your company.

The Filename property allows designers to specify a naming convention for the attachment in the form/workflow submission.

Min/Max Number of Attachments

You can specify the minimum and maximum number of attachments that can be uploaded to your form using the Min # and the Max # properties. Setting the min and max values to 0 or if the maximum # field is left empty means an unlimited number of files can be uploaded. Setting the min # to a value greater than zero makes the field required. Set the min # to 1 to ensure that the user uploads at least one attachment to your form. Use the max # for the maximum attachments allowed. Clicking on Add Files will not display the upload lightbox when the maximum # of attachments have been uploaded. No further uploads will be allowed. Setting the Max # to 1 disables the Multi-File Upload feature. See below for more information.

Setting Min/Max Properties with a Business Rule

The min and max properties can be changed with a business rule using the properties, minFiles, and maxFiles. The values for minFiles and maxFiles can be read and changed at runtime if required. Check out this very simple example.

Restricted Content Types and Other Mime/Ext

Use the Restricted Content Types field on the Upload Control Property pane to restrict the content type of the files uploaded to your form. This property lets the designer specify one or more types which restrict the content to those types. Uploads can be restricted by using MIME Types (limited set supported), File Extensions, or both.

Select the content types you want to allow by checking the associated check box in the Restricted Content Types field. The choices are pdf, MS Word, MS Excel, MS PowerPoint, MS Access, gif, jpeg, png, tiff, rtf, tar, zip, gzip, xml, and bmp. frevvo will map the content types that you choose to one or more mime types. Content type filtering will be enabled for the extensions selected. For example, the image shows an upload control in a form that will only allow files with .jpeg, .pdf and .png extensions. This list can be expanded for customers using frevvo On Premise by modifying the context parameter: frevvo.upload.file.types in the web.xml file. See Installation Tasks for the details.

An easier way to add extensions or other mime types for filtering can be accomplished via the Other Mime/Ext field. You can use this field to restrict uploads to a mime type or file extension that is not included in the subset of the most common file content types provided by frevvo. Enter one or more extensions (of any length) or mime types, separated by a space, to enable the extension and additional mime type filtering. An upload matches on an extension if its name ends in a period followed by one of the extensions.  The comparison is case insensitive.  Likewise, an upload matches on mime type if its mime type matches one of the additional mime types entered. For example, the extensions, txt, and htm, shown in the Other Mime/Ext field in the image above, restricts uploaded files to ones that have .jpeg, .png, .pdf, .txt, and .htm extensions.

The frevvo mime utility now uses the Apache Tika toolkit for improved mime detection. Files with .xls, .xlsx, ppt  and .docx extensions are now correctly described when uploaded in use mode.

Error Messages 

The user will see error messages if upload filtering is applied and the uploaded content types do not match. The error message shown below will be displayed if content type only filtering or both content type and extension/mime filtering have been applied and the uploaded content does not match either restriction. For instance, uploading a file with a .jpeg extension will not match the selected content type choices or the .docx file extension listed in the Other Mime/Ext field as shown in the Upload Control Property Pane image:

When extension and additional mime type filtering only have been specified and the uploaded content does not match, the error message below will display:

Multi-select

The user can select more than one file (during a single file browse) to be uploaded by holding down the control/command key and then clicking on each file you want to select. The multi-select feature support has been added in HTML 5 with multiple attributes. Multi-select of files for the frevvo Upload control is supported in newer versions of browsers. For example, multi-selection of files works in Safari, Chrome, and Firefox.

The multi-select of files in the browser is dependent upon the max files property of the upload control. Multi-select is disabled by setting the max # files to 1. It is possible to select too many files. For example, turn on multi-select by setting the max # to 2. Multi-select 3 files. This will show an error and none of the 3 will be uploaded.

Max Size

Max size is the upper limit for each attachment uploaded to an Upload control in your forms/workflow in bytes. The internal upper limit is controlled by a configuration parameter - frevvo.attachment.maxsize. In the frevvo Cloud, it is set to 25 MB. If you enter a value into the control's max attachment size property greater than frevvo internal upper limit, this property will reset. If left blank, it defaults to 26214400.

When a user attempts to upload a file greater than the max size, they will see an error message displayed on the upload control.

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:

The value in the user profile takes precedence over the server configuration parameter but it cannot exceed the internal upper limit configured in the frevvo Cloud - 25 MB. The value in the control Max Size property takes precedence over both the user and server parameters if it is more restrictive. Individual users will still be bound by the max attachment size set in their user profile, even if the upload control setting is higher.

On Premise customers can control the frevvo internal upper limit via the frevvo.attachment.maxsize parameter in the <frevvo-home>/tomcat/conf/frevvo-config.properties file.

Changing the file name of an uploaded attachment in the form/workflow submission

The File Name property allows designers to set up an attachment name that applies to all files uploaded with an upload control. Attachments with configured file names will be seen when viewing the attachment section of a submission.

This property only affects the name of the file, not the extension which will be automatically appended. The file name can be a:

• Fixed name - The attachment name of the file is entered and is used without change.

• Dynamic - The attachment name can be configured to be dynamic. It can be any combination of static text, form control templates, and/or a template representing the name of the upload file as derived from the local file system - {$FILENAME}

The default setting of the File Name property is: "{$FILENAME}". This special template names the attachment using the file name as derived from the local file system. Leaving the File Name property empty is synonymous with setting it to "{$FILENAME}".

Expand the File Name field by clicking/dragging the three diagonal lines in the bottom right corner.

The image displays the file names for attachments visible in the form/workflow submission detail when:

• the File Name property uses a control template from the form/workflow (the custInfo field) and the default template {$FILENAME}

• the File Name property is empty or uses the default template {$FILENAME}

• the File Name property uses a fixed name (My Filename)

File Name Property Behavior in Use Mode

When a user uploads an attachment to the Upload control, the file name will be the name of the file from the local file system.

• Hovering over the file link in your form/workflow shows a tooltip that displays: "<filename> uploaded as <attachment_name>". The attachment will be stored in the form/workflow submission with the attachment name mentioned in the hover message.

If the same attachment is uploaded more than once in a form/workflow,  "_#" is appended to the subsequent attachment file names where "#" is a number starting at 1.

• filename.pdf

• filename_1.pdf

• filename_2.pdf

View Attachments in Submissions

Once the designer has configured the File Name property and submissions have been created, attachments named with the specified criteria are viewed in the attachment section of a submission. Follow these steps to view them:

1. Click View Submissions in the form/workflow action menu.

2. Double click on a submission for the Submission Details.

3. Submission attachments are listed in the Attachment section of the Data tab.

File Names for Downloaded Attachments

The following is true when downloading attachments:

• If the filename contains a space it will be replaced with a  '+' in the downloaded filename. For example, if the filename is "My File.pdf" the downloaded file is named "My+File.pdf"

• If the filename contains special characters, the encoded value of the special character is included in the downloaded filename. For example, if the filename is "My Name@@" then it changes to "My+Name%40%40.txt "

• When downloading an attachment from the View Submission Details lightbox, the link to edit a submission or from Test Mode

  • The filename of the downloaded attachment will be the original filename if the File Name property is empty or set  to {$FILENAME}.

  • The filename of the downloaded attachment will use the configured filename if the File Name property is set to a fixed name i.e. MyFile.

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:

• Checking this property has no effect in a desktop browser

• If maxFiles=1, you will be able to take a picture with the camera and upload it. You will see a prompt similar to the image below when you tap "Choose Files".

• If maxFiles=0 or if maxFiles > 1, on mobile iOS, you can enable or disable the camera. If enabled, you can take a picture with the camera and upload it but cannot upload multiple files at a time. If disabled, you can upload multiple files at a time but the user will not be presented with the option to take a picture from the camera for uploading.

• IOS Safari decides access to the camera on the iPhone or iPad. Unchecking the "Enable Camera" checkbox does not disable the camera because it is not possible. If you check it, it will disable the multi-select (multiple attribute) of files to upload, even when max # is > 1.

Mapping an Upload Control 

You can take a picture with your iPad or iPhone and map the photo into a generated pdf. Image types supported are gif, png, jpg/jpeg, and bmp. Tiff is not supported. Non-image file types uploaded are ignored. The designer should be aware of the following when mapping the Upload control:

• The Upload control can be only be mapped to text fields in the pdf acroform.  

• Only a single file will be mapped per control. Mapping takes the first found image file in the case of an upload control with multiple files.  

• The image will resize to the dimensions of the acrofield.

The image shows an upload control in a form where jpg files for a koala bear and a jellyfish have been uploaded. Drag the Upload control from the Mapping Form Outline and drop it on the text field in your acroform. Viewing the pdf via the Form Viewer control shows the koala bear image in the pdf.

Message Control

Message controls are most often used to add static text to your form or workflow. Message Controls are often used to add form titles and helpful instructions for users to your form. You can also use it to:

• add custom client-side JavaScript to your form/workflow.

• add a spacer to center other controls including images.

• display an error message to the user if a form/workflow contains invalid controls and cannot be submitted. 

The Message Control has a Rich Text Editor which allows you to enter and format text easily. If your prefer, you can type the message content into the Message property, and add your own HTML for formatting.

Rich Text Editor

The message control supports rich text input in design mode via the Rich Text Editor (RTE). The editor simplifies the creation of your message content eliminating the need for the designer to provide HTML code. The RTE menu provides a simple way to format message content such as font, colors, bullet and numbered lists, and more. You can even include a Google Map or an image if desired.

For example, you can easily create an Instruction section for users that has a bullet list, bold text, and an image in a Message control using the text styling and image features available in the Rich Text Editor.

Using the Rich Text Editor

Follow these steps to use the Rich Text Editor.

1. Drag a Message control from the palette and drop it into your form/workflow. Click on it, and look at the property panel to the left.

2. Click the Rich Text toggle switch to turn the Rich Text Editor on. frevvo will remember the RTE mode you set for each control the next time you edit the form/workflow.

3. When you toggle it on, the message property will be replaced with a link to "Edit with rich text editor." Click the link to open the RTE Editor window. You can also click the red pencil icon  on the control to open the RTE Editor window.

4. The editor consists of an editing area for Entering Text and an icon in the top left that shows/hides the editor toolbar and menus.
   

Rich Text Editor Toolbar

The Rich Text Editor has a variety of menus/buttons for enhancing the entered text. Hover the cursor over each button for a helpful tooltip about its function. 

Entering Text

There are two ways to apply text styling features;

1. Select the feature from the toolbar first, then type your text. For example, to write in bold, click the button on the toolbar then type your text. Bolded characters display as you type.

2. Highlight a portion or all of the text in the Editing area with your mouse, then select the desired feature from the toolbar.

Exiting the Rich Text Editor

To exit the Rich Text editor window, click the X in the top right corner. When you click away from the Message control you can get an idea of how it will look to your users.

If you want to return to editing the message content in the properties panel with HTML, turn Rich Text off by sliding the toggle switch to the off position. Notice that any rich text formatting you did in the RTE is now represented by HTML code in the message property.

Save Value Property

Check the Save Value property to include the value of the Message control in the form/workflow submission document and the translation file used for multi-language support. This property is unchecked (default) when you add new Message controls to your form/workflow. Refer to the Save Value property topic for more information and to see how this property can help with Message controls in optional sections.

Using Templates in a Message Control

Controls in your forms/workflows that are dynamically populated can be included in the message text by using templates. The templates in the Message control are replaced with the values in these controls at runtime. For example, let's say you have a Product Order form with controls for the customer to select the product, color, size and select the option to include a gift card. When the order is complete, you want to display a message to the customer recapping the order. The image shows the control templates in the message text in the designer and the form at runtime. A business rule hides the Message control until the order is complete.

Message control with templates at design-time:

Message control with templates at run-time:

Using Custom Fonts in the Message Control

If your organization has special font requirements, custom fonts can be used to style Message Control text. Typically custom fonts can be added dynamically with JavaScript. The exact JavaScript will vary based on the font.

There are two methods for enabling custom fonts.

1. HTML markup, or

2. On Premise customers can add custom fonts to the font dropdown in the Rich Text Editor. This is optional.

HTML Markup

Follow these steps to use HTML markup:

1. Upload custom JavaScript to dynamically load custom fonts to each project or to your tenant. 

    Click here for an example of a tenant custom JavaScript to load the Google Roboto condensed and the trial Century Schoolbook Roman fonts.

   // frevvo custom JavaScript
    
   var TenantCustomEventHandlers = {
       fontsLoaded: false,
       setup: function (el) {
           if (!this.fontsLoaded) {
    
               // Load Roboto Condensed font
               this.addStyleSheetToDoc("https://fonts.googleapis.com/css?family=Roboto+Condensed:700");         
    
               // Load trial Century Schoolbook.  The following js was generated by myfonts using the
               // free trial option.  With this you can put markup in message controls like the following:
               // <h1 style="font-family: 'Century Schoolbook Roman';">Header looks great</h1>
    
               (function() {
                   var trial = document.createElement('script');
                   trial.type = 'text/javascript';
                   trial.async = true;
                   trial.src = 'https://easy.myfonts.net/v2/js?sid=42(font-family=Century+Schoolbook+Roman)&sid=44(font-family=Century+Schoolbook+Bold)&
                   key=CwN4ZsXpUs';
                   var head = document.getElementsByTagName("head")[0];
                   head.appendChild(trial);
               })();
               this.fontsLoaded = true;
           }
       },
       addStyleSheetToDoc: function (href) {
                    
           // don't load it again if it's already there
           var ss = document.styleSheets;
           for (var i = 0, max = ss.length; i < max; i++) {
               if (ss[i].href == href)
                   return;
           }
                    
           if (document.createStyleSheet) {
               document.createStyleSheet(href);
           } else {
               var l = document.createElement("link");
               l.rel = "stylesheet";
               l.href = href;
               document.getElementsByTagName("head")[0].appendChild(l);
           }
       }
   }

2. Drag and drop a Message Control into your form/workflow.

3. Add the markup and text to the Message property.

   <h1 style="font-family: 'Century Schoolbook Roman';">h1 style - Century Schoolbook Roman</h1>
   <h2 style="font-family:'Roboto', sans-serif">h2 style - Roboto</h2>

4. Save and test your form/workflow
   

   

Adding Custom Fonts to the Rich Text Editor

If you want custom fonts to be available in the Message Control's Rich Text Editor, on premise customers can add the frevvo.message.rte.extra.fonts property to the <frevvo-home>\tomcat\conf frevvo-config.properties file.

Follow these steps.

1. Upload custom JavaScript to dynamically load custom fonts to each project or on the tenant level. 

    Click here for an example of a tenant custom JavaScript to load the Google Roboto condensed and the trial Century Schoolbook Roman fonts.

   // frevvo custom JavaScript
    
   var TenantCustomEventHandlers = {
       fontsLoaded: false,
       setup: function (el) {
           if (!this.fontsLoaded) {
    
               // Load Roboto Condensed font
               this.addStyleSheetToDoc("https://fonts.googleapis.com/css?family=Roboto+Condensed:700");         
    
               // Load trial Century Schoolbook.  The following js was generated by myfonts using the
               // free trial option.  With this you can put markup in message controls like the following:
               // <h1 style="font-family: 'Century Schoolbook Roman';">Header looks great</h1>
    
               (function() {
                   var trial = document.createElement('script');
                   trial.type = 'text/javascript';
                   trial.async = true;
                   trial.src = 'https://easy.myfonts.net/v2/js?sid=42(font-family=Century+Schoolbook+Roman)&sid=44(font-family=Century+Schoolbook+Bold)&
                   key=CwN4ZsXpUs';
                   var head = document.getElementsByTagName("head")[0];
                   head.appendChild(trial);
               })();
               this.fontsLoaded = true;
           }
       },
       addStyleSheetToDoc: function (href) {
                    
           // don't load it again if it's already there
           var ss = document.styleSheets;
           for (var i = 0, max = ss.length; i < max; i++) {
               if (ss[i].href == href)
                   return;
           }
                    
           if (document.createStyleSheet) {
               document.createStyleSheet(href);
           } else {
               var l = document.createElement("link");
               l.rel = "stylesheet";
               l.href = href;
               document.getElementsByTagName("head")[0].appendChild(l);
           }
       }
   }

2. Stop frevvo.

3. Navigate to <frevvo-home>\tomcat\conf.

4. Edit the frevvo-config.properties file

5. Add the frevvo.message.rte.extra.fonts property with a value listing the extra fonts in this format:

   1. Each font in the list is delimited by a semi-colon. 

   2. The font itself must be identified by its name in single quotes. Prefix the font name with an optional display name, if desired. Separate the display name from the font name by a forward slash. The display name is used in the font dropdown of the Rich Text Editor. If the display name is not provided, the actual font name will be used. 

   3. The font names and font type (sans-serif) on the right side of the equal sign in the example above came from the vendor. Contact the font vendor for the correct information for the custom font(s) that you are using.

      Example of the Configuration property for Custom Fonts

      frevvo.message.rte.extra.fonts=Century Schoolbook Roman/'Century Schoolbook Roman';Roboto/'Roboto', sans-serif

6. Save the file.

7. Restart frevvo.

8. Log in as a designer user.

9. Create/Edit a Project

10. Create/Edit a Form

11. Drag and Drop a Message control into your form.

12. Enable the Rich Text Editor of the Message control by sliding the Rich Text toggle to the right.

13. Click to show the Rich Text Editor menu

14. Click on the Font dropdown in the toolbar.

15. Custom fonts are appended to the standard supported fonts.

Message Control and Business Rules

The Message control supports the value property. The Save Value property must be checked for there to be a value and have it accessible in a business rule.

Message Control Style and Settings Tabs

To display different background colors, decorators, or a border, choose a message type from the Message Type dropdown on the Setting tab of the property panel. You can still select style properties on the Style Tab.

Message Control in a Table

When you drop a Message Control in a Table and turn the Rich Text Editor on, the red pencil icon will not be visible on the control. Click the "Edit with rich text" link in the properties panel to open the RTE Editor window.

Message Control in a Repeat

You can drag and drop a Message control from the palette into a repeat or into a section that then gets dropped into a repeat. You can write Rules affecting the Message controls in repeats. Message controls in Repeats can contain templates. Repeat controls containing Message controls can be converted to Tables. Refer to the Control Type property for the details. 

Horizontal Layout using the Message Control

Let's say you wanted to modify a section of your form to reflect a horizontal layout. One approach would be to use the Horizontal Layout using the Table Control.  Another alternative is to use three Message controls and three Radio controls. Follow these steps: 

1. Drag and drop a Panel onto the designer canvas.  

2. Drop Message controls into the panel for the user instruction and the labels Fellowship announcements, Conferences and workshops and Other major news and events. Select None in the Message Control Type field.

3. Click on the Style tab. Set the width of the Message Controls to half the size of the panel.

4. Place 3 Radio controls with Yes/No options to the right of the Message Controls for the 3 choices. Check the Hide Label property for each.

   1. Click the Style tab and enter 50% in the Item Width property

5. You may have to insert a single line break HTML tag in the Message property to align the Message Control text with the Yes/No options of the Radio Control.

Here is what the form looks like in the Forms Designer:

 Here is how the form looks in use mode:

Center, Right-align or Justify Message Control

Text in Message Controls is left-aligned by default. The Message Control Style tab has a "Center" property which is the simplest way to center text in a Message Control, whether or not you are using the Rich Text Editor. At this time the RTE does not provide a way to change the text alignment in your Message Control. However, standard html tags allow this function. Here are some examples.

Right Align

<p style="text-align: right;">This text is RIGHT ALIGNED.</p>

Justify

<p style="text-align: justify;">This text is JUSTIFIED....</p>

Message controls as a spacer

Message controls are commonly used as a spacer to center other controls in forms/workflows. Simply delete the default Message text and change the Message Type to "None" to use a blank message as an invisible spacer for aligning other controls in your form. Refer to Centering Images using the Message Control for an example.

Embed an Image, PDF, or Video in a Message Control

You can use the Rich Text Editor to add images to your message. You can also use standard HTML to embed a PDF or a video that is hosted on another website into a message control. In some cases, you can simply type the html into the message control. Here are a couple of examples:

Embed a video in message control

<iframe width="100%" height="450" src="https://youtube.com/embed/AOtLYy6I9Vg" frameborder="0" ></iframe> 

Note that the URL following src= is the link to your video. 

Embed a PDF in a message control

<iframe width="100%" height="750" src="https://s3.amazonaws.com/static.frevvo.com/docs/Sample+PDF.pdf" frameborder="0" ></iframe>

These methods display the image/video/pdf in Design Mode. You can use Business Rules to only display them during use mode or to embed PDFs from the frevvo PDF Mapping feature. See also this example for displaying an image that the user uploaded at run time. 

Link Control (for URLs)

Use the Link Control when you want to include a URL in your form. When users click the link, the button text is underlined and the target URL will open in a separate browser window. The Link control has a default button color and is automatically decorated. You cannot remove the decorator or change the button color. Unlike most controls, the default width of the control, when dragged from the palette and dropped into your form is 3 columns. Click here for more information. The New Line property is checked by default. 

Templates are allowed in the Link controls href/url property.

Save Value Property

Check the Save Value property to include the value of the Link control in the form/workflow submission document. This property is unchecked (default) when you add new Link controls to your form/workflow. Refer to the Save value property topic for more information and to see how this property can help with Link controls in Optional Sections.

Link Control and Business Rules

The Link control supports the value property. The Save Value property must be checked for there to be a value and have it accessible in a business rule.

Image Control

This control lets you include an image (picture, logo, etc.) in your form. The control allows you to use .JPG, .GIF, and .PNG files, or any other image type that your browser supports. 

When you drag in the control, you’ll see a Browse button and an Upload Image button. Click Browse, navigate to the image you want and click Upload Image. After you upload the image, the Browse and Upload Image buttons disappear, so if you aren’t satisfied with the image, delete the image control and drag in a new one.  

Choose images that fit sensibly in your form before you upload it. The “regular” form size is 600px. You can resize an uploaded image by selecting the image control in the designer, clicking on the style tab in the properties panel, and setting the width.

Save Value Property

Check the Save Value property to include the value of the Image control in the form/workflow submission document. This property is unchecked (default) when you add new Image controls to your form/workflow. Check the Save Value property if you are using the Image control in a template i.e.Print Headers/Footers in the form/workflow PDF.

Refer to the Save value property topic for more information and to see how this property can help with Image controls in Optional Sections.

Image File Size

The maximum size of the image that can be uploaded is configured with the frevvo.asset.maxsize context parameter. The default value is 2097152 bytes. If the size of the image exceeds the specified value, the following message displays:

The message informs the designer what the configured limits are so they can take corrective action.

Centering Images using the Message Control

You can add a Message control on the left side of an image uploaded to your form to center the image. Message controls can be set to an empty string. Delete the default text in the message control. Change its Message Type to None. This will add a blank area on the left of that image and move it into the center. Click the Style tab if you need to modify the width of the message control.

Trigger Control

The trigger control adds a button to your form and is used in conjunction with rules. If your form does not have rules you will not need the trigger control. If your form does have rules, see Triggers & Dynamic Options for details on how to use trigger controls and examples of when you might want to use them.

You can change the color of the Trigger button on the Setting tab of the properties panel. When you drag a trigger control from the palette and drop it into your form the default width is 3 columns. You can change this on the Style Properties tab. You cannot center the text on a Trigger or remove the decorator.

The New Line property is checked by default. Refer to this documentation for migration information. 

Submit Control

The submit control adds a new button to your form that, when clicked, will submit the form. By default, new forms already contain a single submit button labeled "Submit." Submit buttons can only be added to the bottom of the form in a special drag/drop area.

The background color of the Submit control is controlled by the form style. Submit and Cancel buttons are automatically decorated. The Submit button has a darker gradient background color to highlight it compared to the Cancel button.

Group Controls

Group controls help you organize your forms and give them a professional appearance free of visual clutter. Each group control is described below.

Sections

Use sections to create groups of controls that users can expand and collapse. Sections are always 12 columns wide when you drag/drop it from the palette and each is itself divided into 12 columns. Click here for more information.

Click thearrow to expand or collapse a section in design mode. When users access your form the section can be expanded or collapsed—it’s up to you. If you want the section collapsed initially, make sure it is collapsed when you save (finish) your form. Click anywhere in the Section header to expand/collapse the section in Use mode.

You can show/hide the section expand/collapse icon via a checkbox on the control style tab.

After you drag a section control into your form, you can drag any other controls inside it — or even another section control. 

If you have a required control inside a collapsed section, the section label turns red to cue users that they must expand the section and supply the required information before they submit the form. If you delete a section control while designing your form, frevvo will automatically delete all controls you dragged inside the section. See Optional Sections for details on using the required property with sections and how that affects the validation.

Sections may be configured as Signed Sections, allowing authenticated users (or email users on steps assigned to an email) to digitally sign and lock the section, protecting the data from tampering. Please see this documentation on Electronic Signatures for more details.

Tabs

This group control lets you create a tabbed view as in the example below.

Tabs are always 12 columns wide when you drag/drop it from the palette and each is itself divided into 12 columns. When you drag the tab control into your form you’ll start with three individual tabs. To add or remove a tab, click any tab and then click the or  icon. Added tabs appear to the right of the tab from which you clicked the add  icon.

To rearrange the tab order, drag one tab on top of another tab; look for the green right arrow then release the mouse when the green arrow is in the destination position. The tab you dragged will move to the right of the tab upon which it was dropped. (Since you can’t move tabs left, if you wanted the Shipping Details tab before the Customer Info tab in the example above, you’d drag the Shipping Details tab and drop it on the Product Info tab.)

You can drag in other controls (including other group controls) into any individual tabs.  As you’d expect, users will see only those controls in the currently selected tab—in the example above we dragged the First Name, Last Name, Phone, and Email controls into the Customer Info tab, so these will not be visible when users select the Product Info or Shipping Details tabs. When users click the Shipping tab, they see different controls as shown below.

To move your entire group of tabs to another spot in your form, click the area to the right of your last tab and drag the entire group to the desired location. Tab controls have some limitations:

• Individual tabs in a tab group must be the same size and fit on one row

• Individual tab labels must fit on one line

• Centering of a column header cannot be done

Tab Widths

Multiple rows of tabs are not fully supported, so if your tabs spill over to the second row, adjust the width of your tabs and also possibly the Form Width. To edit the tab widths, click the unlabeled area to the right of your last tab; this will display the tab group properties on the left side of the Forms Designer. Type a percentage in the tab group’s Width property field. With five tabs, for example, typing 19% will cause each individual tab to take up 19% of your form’s width. As with panels, you must account for space consumed by tab borders—so if you try to set the width to 20% the five tabs won’t fit on one row.

Panels

Columns can be created with or without the use of the panel control. Click Multi-column Form Layout for an in-depth discussion about this topic. Panels have a default width of 6 columns. Notice panels do not have a label. You can identify a panel in the designer by the panel icon seen on the top-left header.

Let's make a three-column layout using panels, where the first column is twice the width of the other two. Drag/drop a section onto the canvas. Simply drag/drop the first panel into the section. It will have a width of 6 columns. Drag a second panel to the right of the first and drop it when you see the green right arrow. Change the width of the second panel to 3 columns. Drag the third panel from the palette over the second panel and drop it when you see the green right arrow. This panel will automatically adjust to a 3-column width to fill the remaining space in the section. Since panels are group controls, you drag other controls inside them.  Below are three panels used for a three-column layout. Inside the first panel is a text control (City), a dropdown control (State), and a number control (Zip Code.)

If you want to rearrange the order of your panels, drag the panel you want to move across the other panels in the direction you want to go and drop it when you see the green arrow. For example, the image below shows the panel for State being moved to the left of the panel for Zip Code.

Panels themselves are not visible to users or to you when you test or preview your form. Only the controls inside your panels are visible; these controls will be organized visually according to the width of the panels. The width of panels can be 1-12 columns, as desired. Each panel is itself divided into 12 columns irrespective of its width. Panels do not take up visible use mode space i.e. have a 6-column control outside a panel and a 12-column control inside a 6-column panel take up exactly the same width.

Panels can be dropped to the left or right of other panels. You can't drop other controls in a similar manner to the left/right of panels. The same width rule from above applies: a newly dropped panel dropped to the left/right of another panel will take the width of whatever you dropped on.  This makes it very easy to create multi-column layouts.

You can drop another control in between two panels. In the image below, two panels 4 columns wide were dragged/dropped on the canvas. A Money control is dragged/dropped on the canvas and the width is changed to 4 columns. Moving the first panel to the left of the Money control and dropping it when the  up green arrow appears will put the Money control in between the two panels.

If you delete a panel frevvo automatically deletes any controls you’ve dragged inside it.

Table

A table/grid layout in a form is a useful space-saving technique. The use of panels to create columns can be replaced by using the table control. This control makes table/grid form layout easy by allowing you to create a table with user-designated columns and rows. You can edit the table name, change the column names, drag and drop new controls from the palette, and set the widths of the columns. You can control the number of rows in the table by clicking on Add/Remove icons that appear to the left of the first column in the table. You can hide the delete icon to eliminate the deletion table rows using the deletable property or allow only a certain number of items based on user input using a business rule. You can also use business rules for computed values, enabling/disabling fields, showing/hiding fields, etc. When tabbing through a form, use Shift-Right arrow or click on a table cell to begin tabbing into a table. Tables are always 12 columns wide when you drag/drop them from the palette. Table controls do not have an identifying icon like Panels and Repeats do.

When you drag the table control into your form, the control will have three rows and three columns. The Table is assigned a default name i.e.Table95. The columns will display the default names of col 0, col 1 and col 2 respectively. The  and  icons will display for each row in the table, allowing addition and deletion of rows. Deleting all the rows will result in a table with one row. Notice the name of each tables column is unique.

Rearrange table columns by clicking on the green bidirectional arrow that appears when you click in the column heading of the column that you wish to move. For Example, to move the “Years Acquainted" column to the left of the “Business” column in the table, click the green  arrow in the "Years Acquainted" column until it reaches the desired position. Columns will move to the to the left or right until the last column position in each direction in the table is reached.

There is a property panel for the table and a separate panel for each column and cell in the table. Labels for the table control will not display in Use mode.

Users can add/delete rows in a table control in a form depending on the requirements of the task. The forms designer can control the number of rows in a table by setting the Min/Max properties on the table properties panel. Min # defaults to zero and Max # to10. The Min #  value will dictate the minimum number of rows in the table and the Max # value specifies the maximum number of table rows allowed. Setting the Min# and Max# to zero will default the Max# to 1 resulting in a table with one row. All the cells in this one-row table will be displayed in the designer and use mode with a pink color indicating the entire row must be filled in to submit the form. See Min/Max and Required properties for more information.

Designers creating accessible forms/workflows can use the Summary property to specify extra help text that will be announced by Assistive Technology tools.

The table control has some limitations:

• The Table control cannot be published by dragging to the custom palette. Currently, this can be done by clicking on Publish Control Template link in the properties panel.

• Drag and drop of a Table control into a Repeat control is not supported. 

• Schema controls cannot be added to a table that is dragged from the palette and dropped into a form.

• Centering of a column header in a table cannot be done at this time but might be possible in a future release.

• The f-page-break css class should not be used in table cells. 

Adding a Column to the Table Control

Other controls can be dragged into the table (Dropdown, Radio, Checkbox, Message, Text, Text area, Date, Email, Money, Phone, Quantity, Number, T/F). Drag the control from the palette. The new control will appear as a column positioned to the right of the column where it is dropped. For Example, a date control can be dragged from the palette and dropped over the Description of Expense column. Adjust the Column Widths in the table if necessary. Notice that the cells in the added control column do not have the Required property checked. The form designer must set the Required property as appropriate for newly dragged columns. Help icons for a column with a label that has multiple lines may not align properly. Adjust the column widths if possible. 

Table Min and Max Properties

Add/Remove icons will automatically appear to the left of each row in the table. Click on the plus icon to append a row to the bottom of the table until the number of rows reaches the Max # value specified in the property panel. The image below shows an Expense Report created using the Table control. The Min # property is set to zero and the Max # is set to 10. Nine expense items can be specified in the table as shown. One more row can be added by clicking the plus icon. When the table consists of 10 rows,  the  plus icon will disappear and the  delete icon will remain. Clicking on the  delete icon will delete one row from the bottom of the table. The minus icon will become a  plus when the Min # value is reached or there is only one row in the table. 

The Table control can also be used for static grids where the number of rows is fixed. Set the Min # equal to the Max # and the Add/Remove icons will not display. The image below shows a table control in a Time Sheet form. Users enter the work data into the grid and are not able to add /delete rows.

Prompt and Prompt Message Properties for Tables

Check the Prompt property checkbox on the Table control Properties panel to display a confirmation message if users attempt to delete a table row. The text of the message can be customized in the Prompt Msg property.The Prompt Msg property is only visible when the Prompt property is checked.

At runtime,  displays the prompt when the user attempts to delete a repeat item if the Prompt property is checked. This applies to Table rows and Repeat items. If the user selects Ok the item is deleted. Selecting Cancel aborts the delete.

The Prompt Msg and the labels of controls included in a Repeat are available in the form level downloadable text strings file for localization.

Table Column Properties

Columns in a table may require different properties depending on your specifications. There is a properties panel for each column where the properties shown in the image below can be selected. Checking a property on the column property panel will apply the selection to all the rows in that column in the table.The Visible property is available at the column level and can be used to Show/Hide a column at runtime using a business rule. If you have a dropdown, radio or checkbox control in your table the required and comment properties are selectable on the cell property panel.

Modifications made to one cell in a table on the cell property panel will be replicated in all the rows of the column in the table. The Control Type drop down provides choices to change the type of control from a text control to one of the following types: Email, Money, Phone, Quantity, Number. Changing the Control Type of one cell will change the control type for all of the cells in the column of the table. For example, all of the cells in a column in a table that will be used to collect mileage information can easily be changed to number controls by selecting that choice in the Control Type dropdown on one of the cell property panels.  

Required cells in a table will display in the edit and test modes with a yellowish background color as shown. When you drag the table control from the palette into your form, all cells are marked required. Individual cells can be designated as required/optional by checking/unchecking the required checkbox on each cell property panel. Changes made to the required property in one cell in a column will add/remove the requirement from all the cells in the column. Refer to Setting Properties for more information. Error messages for invalid data in a table will display one at a time. 

Column Widths

Column widths can be adjusted using the Column Width property found on the table Style Properties tab. To edit the column widths, enter a value in percentages (Ex: 50%), or px values, separated by a space, for each column in the table. For Example, the Name and Business columns have a width of 25% of the Form Width while the Address and Phone column is set to 30%. The Years Acquainted column is set to 10%. 

Here is how the Table control looks with these column widths.

Labeling the Rows of a Table

Dragging a message control from the palette and dropping it into a table will provide a column in the table that can be used to label the table rows. Move the message column to the desired position. The text of the message control of each cell in that column can then be set as desired.  The days of the week in the Day column of the Timesheet form shown below is an example of using the message control with modified text for row labels. Remember the Palette Controls#MessageControl is available for easy creation of your Message control content.

A Message Control dropped into a table will not have hint, help, or enabled properties. Be sure to check the "hide label" property if you have a message control as a column in your table and you do not want a column label on it. The column label will be hidden in use and edit modes if "hide label' is selected. 

Deleting a Table Control

Select the entire table control by clicking in the table label. A red will display. Click on the x to delete the entire table.

To delete a column in the table, click on the red in the top right corner of the column. 

Changing a Table Control to a Repeat

You can change a table control to a repeat control via the Control Type or Display As properties, depending on whether the table was dragged and dropped from the palette or added from schema. Refer to this documentation for the details.

When you change a table to a repeat or vice versa and there are referencing rules, it is recommended that you check the rules for the correct syntax and section names.  See Rules Examples for more information. 

Horizontal Layout using the Table Control

Let's say you wanted to modify a section of your form to reflect a horizontal layout. You can use a Table control with Message and Radio controls to accomplish this. Follow these steps: 

1. Drag a Table control from the palette and drop it on the designer canvas.

2. Drag a Message control from the palette and drop it into the table to create a column. Click on the column header and check the Hide Label property on the Settings tab. Delete unwanted columns.

3. Modify the rows of the Message control column for the labels. The Palette Controls#MessageControl is available for easy creation of your Message control content.

4. Drag a Radio control from the palette to the canvas. 

   1. Set up the Yes/No options for the Radio Control.

   2. Specify the item width on the Style tab so that the options display horizontally.

5. Drop the Radio Control into the table to make a second column. 

   1. Click on the column header and check the Hide Label property.

6. This is what the table will look like in Use mode. 
   

   

Repeats

Say you want users to be able to enter one or more addresses, phone numbers, or other data. With repeating controls, your form can dynamically display as many controls as a user needs rather than always showing extra input controls that may not be needed. You can write a business rule to allow only certain number of items based on user input.

Repeat controls do not have a label. You can identify a repeat control in the designer by the palette icon for a repeat seen on top-left header. Repeats are assigned a name by default i.e. Repeat 417. 

Repeats are always 12 columns wide when you drag/drop it from the palette and each is itself divided into 12 columns. Click here for more information.

Drag the repeat control into your form and then drag another control into the repeat control just like you would for sections, tabs or panels. When the control is inside your repeat control, click the control to see its properties (on the left hand side of the Forms Designer). Notice that two Settings properties have been added to the properties you normally see for the control: Min# and Max#. These properties default to 0, 1. You must change them as described below to make the control repeat.

These minimum and maximum properties control the behavior users will see on the form. In the example below we’ve set the phone control min # to 2 and the max # to 5, so when they access the form users will see two phone controls and both will be required. Also, both will have an  icon; clicking this automatically displays another phone control. If you click during design, the min # property will be incremented automatically. The  icon above each control is optional and appears because we set the phone control's Help property.

It is often helpful to tell the user how to add additional repeat items. You can easily do this by dragging a message control into the form with the following text:

<center>Click on the <img src="/frevvo/images/icons/add.gif"/> icon to add more phone numbers to the list.<br/></center>

The first items in order up to the min# must be filled in when the form is used in order for the submit button to be enabled. Thus if the user enters a value into the 1st repeat item and then the 2nd repeat item, and then clicks plus on the first repeat item, a new item will be added to the form between what was the 1st and the 2nd moving what was the 2nd item to the 3rd position in the list. The new 2nd item will become required because it has no value. Until the new 2nd item is filled with a value the form will not be submittable.

Thus it is not enough that 2 items contain values when min# is 2. The 1st two items must contain values.

If users elect to supply the maximum number of values, after all controls are displayed, the  icons will disappear from the form and only the icons will remain.

When you edit the label or any properties of a control inside a repeat control, your changes will be applied to every instance of the control inside the repeat control. The same is true if you decide to delete a control inside the repeat control—all instances of the control will be deleted.

As with panels, repeat controls are hidden when testing or using forms and only the controls inside your repeat controls are visible. (The input controls will have  icons as a visual cue to users.)   

There are some key differences between repeat controls and the other grouping controls:

• You may drag in only one control, and you may not drag in tab controls, panels or other repeat controls. 

• You may not drag in trigger, image, upload, tab, table or signature controls. 

You can have multiple controls inside a repeat. To do this, first add your controls to a section control, and then drag the section into the repeat control. Only one section is allowed inside a Repeat control. Sections inside repeats will not have the Palette Controls#SecurityProperties, since signatures are not supported in Repeats.

If you add a control from a repeating element that was uploaded as part of a schema (maxOccurs > 1),  automatically will generate a repeat control and nest the repeating item in that control. The repeat control will automatically enforce the minimum and maximum occurrence constraints. When referring to repeat controls in various places such as Form Action display message, you must use a special template syntax. See templates for repeat controls for the details.

Prompt and Prompt Message Properties for Repeating items

Check the Prompt property checkbox on the control inside a Repeat control Properties panel to display a confirmation message if users attempt to delete a repeating item. The text of the message can be customized in the Prompt Msg property.The Prompt Msg property is only visible when the Prompt property is checked.

At runtime,  displays the prompt when the user attempts to delete a repeating item if the Prompt property is checked. If the user selects Ok the item is deleted. Selecting Cancel aborts the delete.

The Prompt Msg and the labels of controls included in a Repeat are available in the form level downloadable text strings file for localization.

If you have more than one control inside a Section that is dropped into a Repeat control, these properties will show on the Section Properties panel. The Prompt and Prompt Message properties appear on the Properties panel for all levels of controls that are included in nested Repeats.

Changing a Repeat Control to a Table

You can change a repeat control to a table control via the Control Type or Display As properties, depending on whether the repeat was dragged and dropped from the palette or added from schema. Refer to this documentation for the details.

When you change a repeat to a table or vice versa and there are referencing rules, it is recommended that you check the rules for the correct syntax and section names. See Rules Examples for more information.

PageBreak

Mobile forms work best when they are broken up into small, logical pieces. The PageBreak control lets the designer create a mobile layout consisting of multiple pages where each page contains a small number of controls (logical groupings). The user navigates between the pages via Back/Next buttons, or on a device that supports it, by swiping left/right.

Tablet and Smartphone  

Forms are generated using HTML5 controls so features like Custom Keyboards, Date pickers etc. can be used. For example:

• Money, Number and Quantity controls will display a numeric keyboard.

• An Email control will display a keyboard with an @ sign.

• A Phone control will display a phone-specific keyboard.

• Date, Time and Date-Time controls will display the appropriate pickers.

• Drop-downs will use the device specific pickers.

Panels will be ignored on a smart phone, rendering all controls one below the other. Panels on a tablet will be rendered as usual.  The +/- icons are rendered larger so that it's easier to touch them with a finger. Your mobile form takes up the entire width of the device

If your form has PageBreak controls in it, they will be visible by default when you edit your form in the form designer. You can hide them by clicking the  icon in the toolbar.

When you drag/drop a PageBreak control from the palette into your form, the visibility will automatically be toggled so the controls are visible. Drag and drop a Page Break control from the palette into your form to specify pages on your mobile devices. You can set a page break for Phone, Tablet or both by checking the Tablet and Phone checkboxes on the Properties panel of the control. If neither is selected, it has no effect.  When the designer clicks Finish, will generate a Smartphone layout and a Tablet layout with the page-breaks specified. If page-breaks are not specified, there will be just one page. The Employee on Boarding form shown below, when rendered on the iPad and iPhone, displays the company information, the new employee's date of birth and manager's name on the first page and the new employee's name, social security number and home phone on the next page because the first PageBreak control has both phone and tablet checked. If tablet is unchecked on the second PageBreak control, the name and address panels will display on the same page on the tablet.

The PageBreak control can be dropped between 2 controls or above any control (it cannot be dropped below any control.). For example, say you had a form with two panels side by side and you wanted to drop a PageBreak control in between them. Drag the PageBreak control from the palette to the left of the second panel in the form until you see the  up arrow. Then drop the control and the PageBreak control will drop between the two panels.

Let's try another example. 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 dropped inside sections, panels, tables or repeat group controls. The only exception is the Tab control. See Palette Controls#PageBreaksinaTabControl 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:

You cannot move the PageBreak out of a tab. The only way to remove it from one of the tabs is to click on the delete icon which will remove it from all the tabs.

Here is how a PageBreak control dropped into a Tab control looks in the designer.

Tabs containing a Page Break will be rendered as separate pages on the appropriate device e.g. if phone is checked and tablet is unchecked, the Tabs will turn into pages on the phone and stay as Tabs on the tablet.

Testing Your Mobile Form

Test mobile forms/workflows by clicking the Test icon on the Form Designer or  Test on the Forms and Workflows Home Page. You can click on tablet and phone icons at the top to see an approximate rendering of your form on the selected device. . Sometimes, the mobile form/workflow does not look the same in these test form views as it does on the mobile device. It is recommended that you design/debug your form/workflow completely on the desktop first. Then you can add your form/workflow to a space and look at it on the mobile device.

Signature

Drag a signature control from the palette to add an electronic wet signature to your form. The Signature control is decorated with an image that cannot be changed.

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, stylus or a configured Topaz Electronic Signature Pad 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. The signature is displayed in the form scaled down into the signature control.

Forms and workflows can be made accessible to help individuals with visual and motor impairment. Refer to this topic for the behavior of the Wet Signature control when this property is checked.

will display the error message "Signature support not available. Please use a later browser version with HTML5 support for canvas." if your browser does not support HTML5 canvases. 

Signature controls on mobile devices will not have the text entry field.

Refer to Electronic Signatures for more information.

Limitations

•  does not support drag and drop of a Signature control into a repeat control or its descendants or a table control. 

• The signature control in thin forms is not supported. 

Form Viewer Control

The Form Viewer Control is used to allow a generated PDF to be viewed as part of a form/workflow. This control is visible in the Forms designer palette to be used when generating "Pixel Perfect" PDFs in the Forms designer. Refer to this documentation for the details.   

Save Value Property

Check the Save Value property to include the value of the Form Viewer control in the form/workflow submission document. This property is unchecked (default) when you add new Form Viewer controls to your form/workflow. Refer to the Save value property topic for more information and to see how this property can help with Form Viewer controls in Optional Sections.