Qualtrics使用getEmbeddedData读取数字开头嵌入数据返回NULL如何解决

核心结论 #

Qualtrics支持读取以数字开头的嵌入字段，读取返回NULL的核心原因是字段名导入时的自动转义规则导致的名称不匹配。

失败原因分析 #

• Qualtrics的Web Service模块导入JSON字段时，默认会对不符合JavaScript变量命名规范的字段做自动转义：如果字段名以数字开头，系统会自动在字段名前增加_（下划线）前缀，例如你导入的0.male会被系统重命名为_0.male
• 你直接调用getEmbeddedData("2.male")时查询的是未转义的原始字段名，该字段在系统中不存在，因此返回NULL

正确读取方案 #

方案1：直接使用转义后的字段名查询 #

在数字开头的字段名前加下划线即可完成匹配，示例代码如下：

let n = 2
let maleData = Qualtrics.SurveyEngine.getEmbeddedData(`_${n}.male`)

方案2：导入阶段修改字段名（一劳永逸） #

在Web Service模块的字段映射配置页，手动调整导入的字段名格式，例如将0.male修改为male_0，后续读取时直接使用修改后的字段名即可：

let n = 2
let maleData = Qualtrics.SurveyEngine.getEmbeddedData(`male_${n}`)

验证提示 #

你可以先进入问卷的Survey Flow页面，查看Web Service导入后生成的嵌入式数据字段的实际名称，确认转义规则后再做代码匹配，可进一步降低出错概率。

内容的提问来源于stack exchange，提问作者John-Henry