Orbeon Forms 通过配置属性进行配置。 它们通常设置在名为 properties-local.xml 的文件中，并存储在 Orbeon Forms WAR 文件中，如下所示：WEB-INF/resources/config/properties-local.xml:

Orbeon Forms 可以做一些开箱即用的事情，而您无需在 properties-local.xml 中进行任何设置。 但是，如果您想更改默认行为（并且很可能为了设置访问控制、数据库访问、配置按钮等），您将需要对该文件进行更改。 本文描述了该过程的基础知识。

您可以通过编辑 properties-local.xml 来更改属性。 该文件位于 Orbeon Forms Web 应用程序内的目录 WEB-INF/resources/config 中。如果该文件在您的 Orbeon Forms 安装中尚不存在，您可以通过将文件 properties-local.xml.template 重命名或复制到 properties-local.xml 中来创建它。 此时，您的 properties-local.xml 将只包含一个开始 <properties> 标记和结束 </properties> 标记，您需要编辑它以在这两个标记之间添加属性，如下所示：

<properties xmlns:xs="http://www.w3.org/2001/XMLSchema"            xmlns:oxf="http://www.orbeon.com/oxf/processors">    <property as="xs:string"              name="oxf.fr.persistence.provider.*.*.*"              value="oracle"/></properties>

属性由以下组成：

• 一种类型，例如 xs:boolean

• 名称，例如 oxf.resources.versioned

• 一个值，例如 true

• 可选的，很少有处理器名称，例如 oxf:page-flow，它指的是 XPL 处理器名称

一个例子：

<property  as="xs:boolean"  name="oxf.resources.versioned"  value="true"/>

保存属性文件（例如 properties-local.xml）后，会立即考虑对大多数属性的更改，但仅在首次启动服务器时才考虑对某些属性的更改。

Built-in property files

这些属性的默认值在以下文件中提供，这些文件存储在 orbeon-resources-private.jar 中：

• config/properties-dev.xml：root of dev mode properties

• config/properties-prod.xml：root of prod mode properties

• config/properties-base.xml：base Orbeon Forms properties

• config/properties-xforms.xml

• config/properties-form-runner.xml

• config/properties-form-builder.xml

通常，您不应修改这些文件。

通常，您可以在 properties-local.xml 中定义所有自定义属性。 但是，如果 properties 的价值需要因环境而异，例如 dev 和 prod 的值不同，那么您可以在 properties-local-dev.xml 和 properties-local-prod.xml 中定义这些属性两次，并根据文件为属性定义不同的值。 在这种情况下，您仍将保留不因 properties-local.xml 中的环境而不同的自定义属性。

您在 properties-local-dev.xml 中定义的属性仅适用于开发运行模式，并且在这种情况下覆盖 properties-local.xml 中的属性。

您在 properties-local-prod.xml 中定义的属性仅适用于 prod 运行模式，在这种情况下会覆盖 properties-local.xml 中的属性。