通用外部链接卡片配置
前提条件
已按IPDCenter外部集成开发规范完成认证逻辑。
适用场景
通用外部链接卡片适用于展示项目页面，可以通过配置不同的项目URL地址来展示不同的页面。如果需要展示多个项目页面，您可以通过配置一组项目的数据源来实现，展示时通过选择项目查看所选项目页面。
通用外部链接卡片展示效果如图1所示。
配置模板卡片的配置文件
- 打开文本编辑工具，新建一个文件。
您也可以在开发工具新建一个文件作为配置文件。
- 在文件中填写配置文件信息，配置文件的参数配置说明请参见通用外部链接卡片配置文件参数配置说明。
配置文件格式如下：
{ "label": "标签名称", "labelField": "${labelField1}", "isShowForm": true, "queryDataType": "api", "apiConfig": { "url": "http://xxx.com", "method": "GET", "headers": { "authorizationKey": "X-Pdm-Isc-Common-Token", "applyId": "1" }, "body": { "params1": "value1" }, "dataBody": "resp.data.data" }, "iframeUrl": "${iframeUrl}" } - 将配置文件保存在本地，文件需要保存为json格式。
通用外部链接卡片配置文件参数配置说明
名称 |
类型 |
默认值 |
说明 |
|---|---|---|---|
iframeUrl |
string |
'' |
用于配置待展示页面的完整URL地址。支持直接配置为完整的URL地址，也支持配置为数据映射来获取数据链中的某个变量。 如配置为${iframeUrl}，则会获取apiConfig配置的数据源接口的返回值中“ifreamUrl”的值。 |
isShowForm |
Boolean |
false |
是否展示表单下拉框，包括如下选项：
不配置或者配置值为“false”时，数据源下拉框不展示。 |
label |
string |
'' |
下拉框前显示的标签名称。 |
labelField |
string |
'${label}' |
下拉框选项中显示的内容，必须使用数据映射方式进行自定义配置。 如配置为“${labelField1}”，界面中展示时会从接口返回值中取“labelField1”字段的值进行替换。不配置时会默认获取数据源中“label”字段的值。 |
apiConfig |
apiConfig |
-- |
用于配置数据源接口，具体配置请参考表2。 |
名称 |
类型 |
默认值 |
说明 |
|---|---|---|---|
url |
string |
'' |
接口地址。 |
method |
string |
'GET' |
接口请求方式，包括如下选项：
|
headers |
Object |
{} |
接口请求头配置，支持HTTP 标头配置项，同时支持机机认证逻辑。 如果配置为机机认证，需要配置机机认证信息，具体配置请参考表3。 |
body |
Object |
{} |
接口参数。 |
dataBody |
string |
'' |
接口响应返回值中表格数据链式路径。 |
