> ## Documentation Index
> Fetch the complete documentation index at: https://jinshuju-20a27453.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# 金数据带参传入自有系统

> 通过在自有系统嵌入金数据表单，并利用 URL 传参将姓名 ID 等信息传递给金数据，同时借助金数据的 Webhook 功能将用户提交的问卷数据（含姓名 ID、问卷 ID 等）回传至自有系统。这种方式能够实现客户在自有系统填写问卷后，金数据收集用户 ID 并回传完整数据，便于自有系统进行后续处理和管理。

## 需求场景

金数据可向自有系统传入姓名/表单参数，打通自有系统。实现如下需求：

> 客户通过自有系统提交表单，希望填表人提交表单后，金数据可以收集到用户 ID，金数据可将客户姓名和对应的表单 ID 回传至自有系统。

<img src="https://mintcdn.com/jinshuju-20a27453/lpVaY_eqU8NMCSd_/v4/attachments/GsGHgJYCyShGZitpJT1tJRLe.png?fit=max&auto=format&n=lpVaY_eqU8NMCSd_&q=85&s=9c4b5f33a39ab9149cd30523be4a5da1" alt="" width="921" height="663" data-path="v4/attachments/GsGHgJYCyShGZitpJT1tJRLe.png" />

## 实现方式

* 在自有系统嵌入金数据表单，嵌入方式参考\[在网页中嵌入表单]；(/v4/articles/embedded-form)

* 自有系统传输参数：通过 URL 传参，将姓名 ID 到金数据表单，带到用户提交的数据里。金数据本身自带表单Token；

| 字段 | code | 传入值 |
| - | - | - |
| 姓名ID | x\_field\_1 | 2020010198 |

> **例如 H5 网页iframe 嵌入**：
>
> \<iframe id="goldendata\_form\_bXXJk0" src="[https://jinshuju.net/f/bXXJk0?==x\_field\_1=用户ID值==\&background=white\&banner=show\&embedded=true\&inner\_redirect=true](https://jinshuju.net/f/bXXJk0?x_field_1=用户ID值\&background=white\&banner=show\&embedded=true\&inner_redirect=true)" width="100%" frameborder=0 allowTransparency="true" height="572">\</iframe>
> **例如微信小程序 WebView 嵌入**：
>
> ```
> #wxml 文件#
>
> ```
>
> `<web-view src="{{formUrl}}"></web-view>`
>
> `#js 文件#`
>
> `Page({`
>
> `data: {`
>
> `formUrl: ''`
>
> `},`
>
> `onLoad(options) {`
>
> `const userId = options.userId || 'default_user_id'; // 从上一页面传入或获取用户ID`
>
> `const formToken = 'bXXJk0'; // 替换为你的金数据表单Token`
>
> `this.setData({`
>
> `formUrl: https://jinshuju.net/f/${formToken}?x_field_1=${userId}&amp;background=white&amp;banner=show&amp;embedded=true&amp;inner_redirect=true`
>
> `});`
>
> `}`
>
> `})`
> **注意：接收参数只能是 x\_field\_1**

* 金数据 Webhook 推送用户提交的数据到自有系统。

* 提交表单后跳转到指定网页并带参数跳转\[完成预登记]，[点击查看参考文档](/v4/articles/submit-redirect)

## 实现效果

* 填写者自有系统填写金数据表单，链接URL会根据规则带上固定的姓名字段和值。

* 填写者提交表单，自有系统会收到金数据回传的完整数据（含姓名id，表单id等）

* 填表者填写完成并提交，可直接访问指定的地址。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.