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

Form Options

[SINCE Orbeon Forms 2016.2]

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

• Singleton Form

  • Enable or disable singleton form behavior.

  • See Singleton Form​

• Maximum Attachment Size per Control

  • [SINCE Orbeon Forms 2017.1]

  • Use Default: use the oxf.fr.detail.attachment.max-size property​

• Maximum Aggregate Attachment Size

  • [SINCE Orbeon Forms 2017.1]

  • Use Default: use the oxf.fr.detail.attachment.max-size-aggregate property​

  • Other: the maximum size allowed in bytes

• Allowed File Types

  • [SINCE Orbeon Forms 2017.1]

  • Use Default: use the oxf.fr.detail.attachment.mediatypes property​

  • Other: the maximum size allowed in bytes

• Appearance of Control Labels

  • Use Default: use the oxf.xforms.label.appearance property​

  • Inline: labels show inline above the control

  • Other: a space-separated list of mediatypes or wildcard mediatypes

• 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

  • [SINCE Orbeon Forms 2018.2]

  • For details, see Simple data migration.

• Automatic Calculations Dependencies

  • [SINCE Orbeon Forms 2018.1]

  • For details, see Automatic calculations dependencies.

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

Wizard Options

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

For details, see Wizard View.

• Wizard View:

  • Use Default: use the oxf.fr.detail.view.appearance property​

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

• Wizard Navigation Validation Mode

  • Form Builder setting [SINCE Orbeon Forms 2018.1]

  • Use Default: use the oxf.xforms.xbl.fr.wizard.validate property​

  • 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]

  • Use Default: use the oxf.xforms.xbl.fr.wizard.subsections-nav property​

  • 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]

  • Use Default: use the oxf.xforms.xbl.fr.wizard.subsections-toc property​

  • "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.

Form Statistics

Form statistics show various counts of form elements.

See also

• ​Wizard View​

• ​Simple data migration​

• ​Automatic calculations dependencies​

• Blog post: Improved constraints on attachments uploads​