Survey123表单设计?XLSForm怎么写?

为什么你写的XLSForm总报错？从“填空题”到“智能表单”的实战指南

上周一位研究生私信我：“Dr. Gis，我按教程写了XLSForm，上传Survey123却提示‘列名无效’，改了三遍还是不行！”——这太典型了。XLSForm不是Excel表格，它是用“电子问卷语言”描述地理调查逻辑的脚本。今天我就带你从零拆解，避开90%新手踩的坑。

表单的本质：不是画格子，而是定义“数据契约”

想象你要组织一场全国土壤采样，需要各地队员统一记录“坐标、土层厚度、湿度等级”。如果每人手写一张纸，回来数据肯定五花八门——这就是传统纸质表单的灾难。XLSForm的作用，就是提前和所有采集者签一份“数据契约”：规定每个字段叫什么、填数字还是选文字、是否必填、甚至联动校验规则。

我在某省耕地质量评估项目里吃过亏：初期没设“土壤pH值必须介于3-12之间”的约束，结果收上来一堆“pH=99”的无效数据，返工重采损失20万预算。

三张核心工作表：settings, survey, choices —— 像搭乐高一样组装

XLSForm文件本质是三个Sheet的组合，缺一不可：

避坑实战：五个高频错误与修复方案

1. 列名拼写错误：比如把 select_one 写成 select one（中间不能有空格）。系统会直接报“unknown type”。
2. choices表未关联：在survey表用了 select_one soil_type，但choices表里没有名为 soil_type 的list_name。
3. 约束语法错误：想限制年龄≥18岁，正确写法是 .>=18 ，写成 >=18 会失效（缺少点号引用当前值）。
4. 重复字段名：两个问题都用了name=“location”，会导致后一个覆盖前一个。
5. 缺失必填项：settings表没填 form_title，上传时直接失败。

进阶技巧：用“计算字段”自动生成GIS属性

假设你要采集古树信息，除了手动输入“树种”“胸径”，还可以让表单自动计算“保护等级”——根据胸径自动生成A/B/C级：

type          | name        | label       | calculation
--------------|-------------|-------------|--------------------------
integer       | dbh         | 胸径(cm)    | 
calculate     | level       | 保护等级    | if(${dbh}>100,'A',if(${dbh}>50,'B','C'))

这里用到了类似Excel的IF函数，但注意变量要用 ${字段名} 包裹。我在古村落测绘项目中，用这个方法让村民协作者无需懂分类标准，填完基础数据自动打标，效率提升3倍。

终极心法：先画“纸面原型”，再填XLSForm

别急着打开Excel！拿出纸笔，先画出表单的“用户旅程”：第一步问什么？选完A选项后跳转到哪？哪些字段相互依赖？——这步能避免70%的逻辑混乱。就像盖房子先画蓝图，而不是直接砌砖。

现在轮到你了：你在设计XLSForm时遇到过最诡异的报错是什么？把截图或描述贴在评论区，我来帮你“在线诊断”。也欢迎分享你的神级应用案例——说不定下期专栏主角就是你！