Versions Compared

Key

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

Each control setting property is explained below. Keep in mind that all controls do not have the same setting properties.

Image RemovedImage Added


Column
width240px

On this page:

Table of Contents
maxLevel1

...

You aren’t restricted to plain text for labels.  You may use arbitrary XHMTL when typing the label name.  Say you want two different font sizes and colors for a label as in the illustration below. 

Image RemovedImage Added

In the Label field, type this XHTML: Password <span style = "font-size:0.9 em; color: red; "> (6 characters) </span>.

...

Note that a control's name defaults to its label minus any spaces and special characters. Spaces and special characters are removed in order to make the name valid for use in rules and, for XML users, valid as a xsd schema element name. If the name begins with a numeral (for example,123Name),  preppends prepends an underscore to the it (for example, _123Name) to make it a valid XSD element name. Control names will be truncated to 32  characters for all the controls except triggers and panels.

...

For example, if you are using a pattern that requires the user to enter an area code of 203 or 860 in a phone control, you can use the Error Message property to let users know this explicitly if they try to enter a different area code.

Image RemovedImage Added

Refer to the Table control for information on error messages and columns in a table.

...

This property applies only to Date controls and the Date portion of the Date/Time control. Select the Date control type to display only the date input field with a  calendar Image Removed icon Image Added  calendar icon. Clicking the calendar to choose the date or hand-typing it, will display the date in the format selected. European date formatting is supported. Allowable Date Formats consist of three different seperators (.- or / or .) and three date display formats (DD/MM/YYYY, MM/DD/YYYY, and YYYY/MM/DD). The default value is MM-DD-YYYY.

On a mobile device, the date picker is typically used to provide a date. If you set a default date in your form it must be formatted as YYYY-MM-dd in order for it to display correctly.

The date format choices are shown below:

...

  1. A date typed into a form field will be reformatted to match the selected Date Format 
  2. A date entered into a form field will be translated according to the selected format. For example,if you choose a European format of DD-MM-YYYY and enter 10-05-2009 the date value will be translated as May 10, 2009. If you choose a US format of MM-DD-YYY the date value will be translated as October 5, 2009. 
  3. If you choose any of MM-DD-YYYY using either - or / or . as the separator, all will be valid for that format but will be translated to the selected separator
  4. Users can still enter dates like Feb 3, 2001. It will be translated into the specified format

Image RemovedImage Added

Note

The date will be converted to the standard xsd:date format of yyyy-mm-dd  in the submissions XML document. Here is an example: <Order Date>2012-03-06</Order Date>. Refer to Viewing XML Documents for more details.

...

By using this property, time entries entered into the form are reformatted to match the selected format. For example, if you choose a military time format of hh:mm:ss and enter 2:00 PM the time value will display in the form as 14:00:00. It will be converted to UTC and saved in the submissions XML document. Here is an example: <Order Time>18:00:00Z</Order Time>. Refer to Viewing XML Documents for more details.  

Image RemovedImage Added

Date/Time Formats

Select the Date/Time control type, to display two input fields: one for date entry and one for time entry. Dropdown menus, as described above, provide the selection of the nine allowable date formats for the date portion of the control and eight choices in military and standard time for the time portion. Refer When you select Date/Time as the control type, the properties panel will display dropdowns to format the date and time. Refer to Date Format and Time Format for details. Default formats for date and time remain mm-dd-yyyy and hh:mm.    

  1. When you enter a date in the date portion of the date/time control (or select the date with the picker), it will automatically fill the time portion of the control with a value for 12:00 AM. The value displayed depends on the time format selected: For Example:.   
    • 00:00 will display if the selected time format is hh:mm
    • 12:00 AM will display if the selected time format is hh:mm – AM/ PM          
    • 00:00:00 will display if the selected time format is hh:mm:ss    
    • 12:00:00 AM will display if the selected time format is hh:mm:ssAM/ PM      
  2. You cannot enter a time value without a date value. 
  3. The time input field cannot be labeled. It is recommended that the label for the date portion be descriptive enough to include the time portion. If date and time labels over the appropriate input fields are required, two separate controls can be used or the label for the date portion can be extended over the time input field, as shown in the image below:

Image RemovedImage Added

Note

The local time will be converted to and saved in UTC format and the date will be converted to the standard xsd:date format of yyyy-mm-dd In in the submission XML document. Here is an example: <OrderDate>2012<OrderDate>2013-08-14T0512T19:0013:00Z</OrderDate>. Refer to Viewing XML Documents for more details. 

...

This property determines whether the value saved in the submissions repository is hidden when viewed in the  web submissions UI. The value is not currently encrypted in the database. Check  Check the checkbox if the data users will enter into this field contains sensitive data that should not be visible when viewed in the web UI. In a future release sensitive  Sensitive field values will be encrypted in the submissions database using an SHA algorithm.

CSS Class

This is the control’s class The control must be designated as a Saved Field in the form. This property does not enable hashig of the value stored in the XML document.

CSS Class

This is the control’s class name that was added to your form's XHTML markup. You can use this CSS class to reference the control in any CSS when customizing themes.

One built-in css class name is 'f-page-break'. If you want to add a page break to the printed view of the form's pdf, tiff, add f-page-break to the control that you want to start at the top of a new page. See Printing Forms for the details.

Note

You can find information about adding css code to a custom theme to support international characters in Print View and submission PDFs here.

Name

Every control has a name. The name is automatically generated and defaults to the control's label minus any spaces and special characters. Spaces and special characters are removed in order to make the name valid for use in rules and, for XML users, this makes the name valid as a xsd schema element name. Control names will be truncated to 32  characters for all the controls except triggers and panels. 

Notewarning

Do not name your controls action or method. These are reserved names. If you use these names your form will not properly submit or cancel and may cause a http 404 error when the users try to submit or cancel.

...

Also, avoid using JavaScript Reserved Keywords as control identifier names as these words have a special function in the JavaScript language. Click here for a partial list.

If you have two controls with the same label and at the same level, the control's name will automatically be made unique. If you try to edit the name such that it would no longer be unique,  will prevent the edit. In order to use a control in a rule the name must be unique in your form. When a control is dropped inside a section control, it is at a different nesting level then a control dropped outside a section. Also two controls, one inside a section called Car and another in a section called Boat are also at different nesting levels. In both cases the form designer will allow you to name the controls the same. For example both Car and Boat can contain a control named VIN. 

Notewarning

Use English alphabet characters only when naming controls. For example, controls named with ó as in Póliza may cause issues when the control is used in a business rule and with submission data.

...

This property applies only to Submit controls. By default  disables the form's submit button until all required fields are filled and contain valid data. See Valid Forms for details of this feature. However, sometimes you may wish to override ' default behavior and allow the user to submit a form even if it is invalid. To do this, uncheck this property.

 

...

Prefix Property

Custom groups with rules included when dropped back onto the same or another form, will contain a special "Prefix" property. The property will automatically be given a unique value if you drop the group onto the same form 2 or more times. This ensures that the group controls have unique element name. You can view the impact the prefix has on the element names by viewing the form's schema or the control's property panel. Using the prefix property, you can write a separate rule to manipulate the 2nd or greater instance of the custom control. Refer to this documentation for the details.

Max Size

The Max Size property is used to set the upper limit for each attachment uploaded using the Upload Control in your forms/flow. It is set to 10Mb in the cloud. In-house customers should refer to the Max Size property for information about configuring this property for an in-house installation.