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