GoDaddy托管站将URL参数传入Cognito Forms iframe预填字段失败求助

我们的网站托管在GoDaddy平台，使用Cognito Forms嵌入表单，需要通过https://ourwebsite.com/client?barcode=921371这类URL传递唯一的barcode值预填对应字段，但当前使用的脚本完全无效，浏览器控制台无报错，字段始终无法预填。提供的脚本如下：

<iframe src="https://www.cognitoforms.com/f/ourformid/1" style="border:0;width:100%;" height="576">    </iframe>

<script src="https://www.cognitoforms.com/f/iframe.js"></script>

<script>
   function getQueryStringParam(parameter) {
      var queryString = window.location.search;
      var urlParams = new URLSearchParams(queryString);
      return urlParams.get(parameter);
   }
   Cognito.prefill({ "Barcode": getQueryStringParam('Barcode') });
</script>

一、脚本存在的核心问题 #

1. URL参数大小写不匹配
   URL中的参数是小写的barcode，但脚本中调用getQueryStringParam('Barcode')时用了大写的Barcode，而URL查询参数是大小写敏感的，这会导致无法正确获取到参数值，预填自然失效。

2. 预填代码执行时机过早
   直接调用Cognito.prefill()时，可能Cognito Forms的iframe脚本还未完成初始化，Cognito对象虽然存在，但还未和嵌入的iframe建立通信，导致预填指令无法传递到表单中。

二、修正后的脚本 #

<iframe src="https://www.cognitoforms.com/f/ourformid/1" style="border:0;width:100%;" height="576"></iframe>

<script src="https://www.cognitoforms.com/f/iframe.js"></script>

<script>
function getQueryStringParam(parameter) {
    var queryString = window.location.search;
    var urlParams = new URLSearchParams(queryString);
    return urlParams.get(parameter);
}

// 等待Cognito对象初始化完成后执行预填
Cognito.ready(function() {
    // 匹配URL中的小写barcode参数
    var barcodeValue = getQueryStringParam('barcode');
    // 仅当获取到参数值时才执行预填
    if (barcodeValue) {
        // 确保此处的字段名称与Cognito Forms中字段的内部名称完全一致
        Cognito.prefill({ "Barcode": barcodeValue });
    }
});
</script>

三、额外排查点 #

• 确认表单字段内部名称：在Cognito Forms的编辑界面，查看目标字段的「内部名称」（不是显示名称），必须和预填对象中的键名完全一致（包括大小写）。如果字段内部名称是小写的barcode，需将Cognito.prefill中的键名改为"barcode"。
• 检查浏览器拦截插件：广告拦截器、隐私防护插件可能会阻止Cognito Forms的脚本通信，尝试禁用插件后测试。
• 验证参数获取：在浏览器控制台手动执行getQueryStringParam('barcode')，确认是否能返回URL中的对应值，排除参数获取环节的问题。

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