Orbeon Forms：表单打开时判断URL以适配多环境第三方应用

一、解决JS代码被清除的问题 #

Orbeon原生<xf:action type="javascript">存在代码被自动清理的问题，建议使用Orbeon扩展的<xxf:script>动作（兼容性覆盖多数版本），或XForms 2.0标准的<xf:script>（适用于Orbeon 2021+）绑定事件执行JS逻辑。

二、环境标识存储与判断逻辑 #

1. 在表单模型中定义实例，用于存储环境判断结果：

<xf:instance id="env-instance">
    <env>
        <type>test</type> <!-- 默认设为测试环境 -->
    </env>
</xf:instance>

2. 绑定xforms-model-construct-done事件执行环境判断，并将结果写入实例：

<xxf:script event="xforms-model-construct-done">
    // 根据URL主机名判断环境
    const host = window.location.host;
    let envType = "test";
    if (host.includes("prod_indicator")) {
        envType = "prod";
    } else if (host.includes("qa_indicator")) {
        envType = "qa";
    }
    // 使用Orbeon官方API更新实例值，避免破坏XForms生命周期
    ORBEON.xforms.Document.setValue("env-instance/type", envType);
</xxf:script>

三、基于环境结果控制控件显隐 #

针对不同环境的第三方应用URL控件，通过XPath绑定visibility属性实现动态显隐：

• 生产环境控件：

<xf:output ref="prod-thirdparty-url" appearance="minimal"
           visibility="if(/env-instance/type = 'prod') then 'visible' else 'hidden'"/>

• QA环境控件：

<xf:output ref="qa-thirdparty-url" appearance="minimal"
           visibility="if(/env-instance/type = 'qa') then 'visible' else 'hidden'"/>

• 测试环境控件：

<xf:output ref="test-thirdparty-url" appearance="minimal"
           visibility="if(/env-instance/type = 'test') then 'visible' else 'hidden'"/>

关键注意事项 #

• 必须使用ORBEON.xforms.Document.setValue API操作XForms实例，禁止直接修改DOM，否则会导致XForms状态不一致。
• 若仅需区分生产/非生产环境，可简化判断逻辑为var isProd = window.location.host.includes("prod_indicator");，并将实例字段设为<is-prod>false</is-prod>，对应XPath判断visibility="if(/env-instance/is-prod = 'true') then 'visible' else 'hidden'"。

内容的提问来源于stack exchange，提问作者Pete Atkin