跳到主要内容
版本:5.9.0

移动端集成表单填报

背景

观远BI、移动轻应用等都可以集成到第三方移动端并且实现免密登录,例如钉钉、企业微信、飞书等。那如何把观远BI九宫格里的“表单填报”也集成到移动端,让用户免密登录直接在移动端填入数据呢?

image.png

实现前提

1. 第三方移动端和观远BI的集成已经完成,可以免密登录已经内嵌好的H5微应用。

2. 表单填报页面有使用可信的外网域名,内网IP地址不能用于集成到移动端,一般建议跟随使用BI的可信域名即可。

3. 暂时只支持集成单个表单免密登录,后续会开发支持集成移动端表单填报列表页并免密登录。

实现方法:以创建钉钉微应用为例

  1. 在表单列表页点击表单名称后面菜单,选择“复制链接”,点击复制移动端链接。

image.png

2. 利用在线转码工具或者其他开发工具,对上一步取到的的表单填报home URL后第一个斜杠(/)后从survey-engine开始的部分进行encode编码(可以将一些特殊字符和汉字变为encode编码格式)。

例如 https://demo.guandata.com/survey-engine/m/survey/b9bd48a2-f1bc-4385-8118-80c2fa627376高亮部分转码后变为 survey-engine%2Fm%2Fsurvey%2Fb9bd48a2-f1bc-4385-8118-80c2fa627376

image.png

3. 把第一步得到的移动端链接拆分开,把home URL后第一个斜杠(/)后部分替换为 ?path_url=上一步编码后的URL字符串。

替换前:https://demo.guandata.com/survey-engine/m/survey/b9bd48a2-f1bc-4385-8118-80c2fa627376

替换后:https://demo.guandata.com/?path_url=survey-engine%2Fm%2Fsurvey%2Fb9bd48a2-f1bc-4385-8118-80c2fa627376

Note:需要同时集成PC端微应用的话需要把表单的PC端链接的从survey-engine开始的部分进行encode转码。

4. 钉钉管理员进入钉钉管理后台,创建新的H5微应用,点击“开发管理”tab页,配置相关信息。

注1:开发模式,请选择“开发应用”。

注2:请将观远平台公网IP添加到“服务器出口IP”中。

注3:应用首页地址填入上一步拼接好的移动端URL,PC端首页地址根据需求设置或保持为空。

注3:管理后台地址,一般可填相应观远平台的主页地址,即回调域名。

image.png5. 在“权限管理”tab页,设置应用的接口权限。“接口权限”配置中,请确保该微应用已获得“身份验证”、“消息通知”和“通讯录只读”权限。以下截图是钉钉开放平台旧版视图,如使用新版视图可能不太一致。

image.png

6. 发布应用并设置可见范围。以上信息确认无误后,在“版本管理与发布”tab页,发布应用;发布后,设置该应用对哪些用户可见。完成后即可以尝试用移动端钉钉访问表单填报。

image.png