金数据带参传入自有系统

此方案使用「扩展属性」在自有系统和金数据表单之间传递一个关联标识，再通过 Webhook 将填表数据回传至自有系统。

适用场景

自有系统中已有用户 ID，希望填表人提交金数据表单后，自有系统可以根据该用户 ID，将收到的表单数据与已有用户关联。

如何传入并回传用户 ID

1. 在自有系统中嵌入金数据表单，具体操作请参考 在网页中嵌入表单。

2. 在表单 URL 中添加固定参数 x_field_1，将自有系统中的用户 ID 作为扩展属性值传入。

例如，H5 网页中 iframe 的 src 可以使用以下表单 URL：

https://jinshuju.net/f/bXXJk0?x_field_1=2020010198&background=white&banner=show&embedded=true&inner_redirect=true

微信小程序使用 WebView 嵌入表单时，可以动态生成表单 URL：

Page({
  data: {
    formUrl: "",
  },
  onLoad(options) {
    const userId = encodeURIComponent(options.userId || "");
    const formToken = "bXXJk0";

    this.setData({
      formUrl: `https://jinshuju.net/f/${formToken}?x_field_1=${userId}&background=white&banner=show&embedded=true&inner_redirect=true`,
    });
  },
});

3. 在表单中配置 Webhook。填表人提交表单后，金数据会将表单数据和扩展属性一起推送至自有系统，自有系统可使用扩展属性中的用户 ID 关联已有用户。

4. 如需在提交表单后跳转至自有系统页面，可以配置 提交后跳转并附带参数。

这个方案与 URL 传参有什么区别

本方案使用的是「扩展属性」，不是企业高级版的「URL 传参」功能。

• 扩展属性的参数名固定为 x_field_1，每个表单仅支持传入一个扩展值；

• 扩展属性值保存在数据的「扩展属性」列中，不会填入或显示在表单的普通字段中；

• 如果需要向一个或多个普通字段传值，请使用 URL 传参 功能，不能使用 x_field_1 实现；

• 有关扩展属性的生成方式、数据查看位置和使用限制，请参考 扩展属性：区分发布渠道。

实现效果

• 填表人从自有系统进入嵌入的金数据表单时，表单 URL 会携带该用户对应的扩展属性值；

• 填表人提交后，自有系统会收到金数据通过 Webhook 回传的表单数据和扩展属性；

• 自有系统可以根据扩展属性中的用户 ID，将本次提交与已有用户关联。