Orbeon Forms：如何传入字符串并解析为下拉列表选项值？

这个需求完全可行，Orbeon Forms支持通过外部传入字符串数据，解析后动态生成下拉列表的选项，具体实现步骤如下：

1. 传入字符串数据到表单 #

常见的两种传入方式：

• URL参数传递：打开表单时在URL后追加参数，示例：
  http://your-orbeon-server/fr/your-app/your-form/new?dropdown-options=选项1|选项2|选项3
• 上下文参数传递：如果是集成调用表单，可在Form Runner配置中设置上下文参数，将字符串数据写入表单实例的指定节点。

2. 解析字符串生成下拉选项 #

假设传入的字符串用|作为选项分隔符，以下是两种实现方式：

方式一：XPath解析（推荐） #

在下拉组件的Items属性中编写XPath表达式，完成字符串拆分与选项生成：

• 基础场景（选项文本与值一致）：

for $option in tokenize(xxf:get-request-parameter('dropdown-options'), '\|')
return
    <item>
        <label>{$option}</label>
        <value>{$option}</value>
    </item>

• 进阶场景（选项为值:文本格式，如val1:选项1|val2:选项2）：

for $pair in tokenize(xxf:get-request-parameter('dropdown-options'), '\|')
let $parts := tokenize($pair, ':')
return
    <item>
        <label>{$parts[2]}</label>
        <value>{$parts[1]}</value>
    </item>

方式二：Form Builder可视化配置 #

如果使用Form Builder搭建表单：

• 选中目标下拉组件，在右侧面板找到「Items」设置项
• 选择「From XPath expression」，粘贴上述XPath表达式
• 保存表单后即可测试动态选项效果

3. 关键注意事项 #

• 选择不会与选项内容冲突的分隔符（如|、;），避免解析出错
• 若传入字符串包含特殊字符，需提前做转义处理
• 若通过上下文参数传值，可使用instance('fr-parameters-instance')替代xxf:get-request-parameter()获取参数

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