Form settings

Introduction

Some settings apply to the entire form definition. You access these settings with the "Form Settings" wrench icon on the top right of Form Builder. The General Settings also show initially when creating a new form definition.

General Settings

General settings allow you to set the following form definition metadata:

  • Application name

  • Form name

  • Form title in the current language

  • Form description in the current language

General Settings

Form Options

[SINCE Orbeon Forms 2016.2]

Form options include options which apply to the entire form definition.

Form Options
  • Singleton Form

  • Maximum Attachment Size per Control

  • Maximum Aggregate Attachment Size

  • Allowed File Types

  • Appearance of Control Labels

  • Use Placeholder for Text Fields and Text Areas

    • Labels show inline above the control for most fields.

    • For text, date, and time input fields, labels show as an HTML placeholder within the field when the field is empty.

    • For text areas, labels show as an HTML placeholder within the field when the field is empty. [SINCE Orbeon Forms 2017.1]

  • Appearance of Control Hints

    • Use Default: use the oxf.xforms.hint.appearance property

    • Inline: hints show inline below the control

    • Tooltips: hints show as tooltips upon mouseover

  • Use Placeholder for Text Fields and Text Areas

    • Hints show inline or as tooltips upon mouseover.

    • For text, date, and time input fields, hints show as an HTML placeholder within the field when the field is empty.

    • For text areas, hints show as an HTML placeholder within the field when the field is empty. [SINCE Orbeon Forms 2017.1]

  • Simple Data Migration

  • Automatic Calculations Dependencies

Here is how hints appear depending on the type of control they are associated with:

Control Settings

[SINCE Orbeon Forms 2018.2]

This tab shows settings for specific controls. Those settings apply to all control on the form except when they are overridden by individual settings in the "Control Settings" dialog.

For example, you can set a "Digits After Decimal" setting global to the form, and then override it on specific number controls as needed.

Number Control Settings
Date Control Settings

See also the blog post.

Wizard Options

[SINCE Orbeon Forms 2018.1] These options are now in a separate tab.

Wizard Options

For details, see Wizard View.

  • Wizard View:

  • Wizard Navigation Validation Mode

    • Form Builder setting [SINCE Orbeon Forms 2018.1]

    • Free, Lax or Strict: use the given validation mode for this form definition, no matter how the property is configured.

  • Wizard Subsections Navigation

    • Form Builder setting [SINCE Orbeon Forms 2018.1]

    • Always or Never: enable or disable subsection navigation for this form definition, no matter how the property is configured.

  • Wizard Subsections Table of Contents

    • Form Builder setting [SINCE Orbeon Forms 2018.1]

    • "Show subsections for the active section only", "Show subsections for all sections", "Don't show subsections": use the given setting for this form definition, no matter how the property is configured.

About this Form

About this Form

Versions

[SINCE Orbeon Forms 2018.2]

This area shows relevant Orbeon Forms versions:

  • "Created with Version": version with which this form definition was created.

    • NOTE: This is blank for forms created prior to Orbeon Forms 2018.1.

  • "Updated with Versions": versions with which this form definition was updated This is updated:

    • when saving the form definition

    • when upgrading the form definition from the Form Runner Home page.

  • "Current Version": the current Orbeon Forms version.

Form Statistics

Form statistics show counts of various form elements.

See also