Survey123表单怎么设计?XLSForm语法是?

表单总报错？你可能连XLSForm的“语法潜规则”都没摸透

上周一位研究生在后台留言：“Dr. Gis，我按教程做了个野外植被调查表，上传到Survey123后字段全乱了，下拉菜单也失效……是不是软件bug？”——这哪是bug，分明是你没吃透XLSForm的“语法规矩”。我在参与某省国土变更调查项目时，就因为一个冒号位置错了，导致200份外业数据全部返工。今天，我就带你从零拆解Survey123表单设计底层逻辑，手把手教你写出“一次成功”的专业级XLSForm。

Survey123不是Excel，XLSForm是它的“DNA编码语言”

很多人以为Survey123表单就是把Excel表格上传上去——大错特错！它用的是专门的结构化语言叫XLSForm，你可以把它想象成“给GIS数据采集器写的剧本”。就像拍电影，你得先写分镜头脚本（XLSForm），演员（Survey123 App）才知道什么时候该问什么、怎么跳转、存什么格式。

XLSForm = 表单结构(sheet: survey) + 选项列表(sheet: choices) + 设置(sheet: settings) 的三件套组合。少一个sheet，你的“剧本”就会崩盘。

三张工作表，搞定90%的野外调查需求

打开你的Excel或Google Sheets，新建三个Sheet，分别命名为：survey、choices、settings。这是铁律，改名就报错。

① survey表：你的“问题导演台本”

每一行是一个问题，关键列包括：

② choices表：你的“选项素材库”

所有下拉菜单、单选按钮的选项都集中在这里管理，避免重复录入。必须包含三列：

• list_name —— 对应survey表中type里的后半截（如tree_type）
• name —— 选项存储值（英文/数字，无空格）
• label —— 显示给用户的文字

list_name,name,label
tree_type,pine,松树
tree_type,oak,橡树
tree_type,bamboo,竹子

③ settings表：你的“拍摄参数面板”

这里控制表单标题、默认语言等全局设置。最常用两行：

form_title,我的野外植被调查表
version,2024.06.01

避坑指南：这三个“隐形炸弹”90%新手会踩

1. 字段名带空格或中文 → 后端直接崩溃。请用下划线：如tree_height_m而非“树高(m)”。
2. choices表的list_name拼错 → 下拉菜单变空白。检查是否和survey表type中的名称完全一致。
3. 漏写settings表的form_title → 上传后表单无标题，难以管理。

进阶技巧：用“relevant”实现智能跳题

假设你想：只有当用户选择“土地用途=林地”时，才弹出“树种”问题。在survey表对应行的relevant列写入：

${land_use} = 'forest'

这里的${land_use}是你前面某个问题的name字段。这就相当于编程里的if判断，极大提升外业效率——再也不用滑动几十个无关问题了。

一键验证：发布前必做的“语法体检”

写完表单别急着上传！用官方XLSForm Online Validator（https://xlsform.org/en/#validator）粘贴你的表格内容，它会高亮所有语法错误。我在做海岸带调查时，靠这个工具提前揪出了5处拼写错误，救了整个项目组。

总结：XLSForm是门手艺，不是玄学

Survey123表单设计的核心，是理解XLSForm“三表联动”的剧本式结构。记住：survey是导演台本，choices是演员台词本，settings是制片人备忘录。避开命名、拼写、缺失表这三大雷区，再复杂的需求也能拆解成优雅的表格。

你第一次设计XLSForm时踩过什么坑？是在choices表拼错名字，还是被relevant语法搞晕？欢迎在评论区留下你的“血泪史”，我会挑3个典型问题做深度复盘！