更新时间:2024-07-24 GMT+08:00
分享

通用清单模板卡片配置

前提条件

已按IPDCenter外部集成开发规范完成认证逻辑。

适用场景

通用清单卡片适用于展示表格分页数据,可以通过配置表格的表头、数据源来快速自定义不同的表格。支持配置单个表格,也支持配置多个表格,多个表格以tab页签切换的方式展示在卡片中。

通用清单卡片类似如图1所示,卡片中展示三个表格,您可以单击页签名称切换查看相应的表格信息。

图1 通用清单卡片模板预览效果

配置模板卡片的配置文件

  1. 打开文本编辑工具,新建一个文件。

    您也可以在开发工具新建一个文件作为配置文件。

  2. 在文件中填写配置文件信息,配置文件的参数配置说明请参见通用清单卡片配置文件参数配置说明

    配置文件格式如下:
    {
      "tableList": [
        {
          "tableName": "表格1",
          "columns": [
            {
              "title": "title1",
              "field": "field1"
            },
            {
              "title": "title2",
              "field": "field2",
              "type": "link",
              "jumpUrl": "${detailPageUrl}"
            },
            {
              "title": "title3",
              "field": "field3",
              "type": "date",
              "format": "yyyy-MM-dd HH:mm:ss"
            }
          ],
          "queryDataType": "api",
          "apiConfig": {
            "url": "url",
            "method": "GET",
            "headers": {
              "authorizationKey": "",
              "applyId": ""
            },
            "body": {},
            "pageNoField": "pageNo",
            "pageSizeField": "pageSize",
            "dataBody": "resp.data.data",
            "totalBody": "resp.data.totalCount"
          }
        }
      ]
    }

  3. 将配置文件保存在本地,文件需要保存为json格式。

通用清单卡片配置文件参数配置说明

表1 配置项

名称

类型

默认值

说明

tableList

tableConfig[]

[]

表格项的配置信息,支持配置多个表格项。

表格项超过1个时,各个表格以tab页签方式组合,可以切换查看每个表格。最多支持配置5个表格项,表格项中的具体配置请参考表2

表2 表格项配置

名称

类型

默认值

说明

tableName

string

--

表格名称,展示为tab页签的标题。

当表格项个数为1个时不展示。

columns

columnConfig

--

表格列的配置信息,具体配置请参考表3

queryDataType

string

--

获取表格数据源的方式,当前仅支持配置为“api”

apiConfig

apiConfig

--

数据源接口的配置,具体配置请参考表4

表3 表格列配置

名称

类型

默认值

说明

title

string

--

列标题,展示为表格中各列的参数名称。

field

string

--

列的key值,用于映射数据源中的字段。

type

string

--

数据处理方式,包括如下选项:

  • link:链接方式,配置此种方式时,需要配置“jumpUrl”参数。
  • date:日期方式,配置此种方式时,需要配置“format”参数。

jumpUrl

string

--

跳转链接,只在“ type”配置为“link”时有效。

若使用${fieldName},则取表格数据中的fieldName字段的值替换${fieldName}生成跳转链接。

format

string

'yyyy-MM-dd HH:mm:ss'

时间转换格式,只在 “type”配置为“date”'时列有效。

日期格式配置规则如下:

  • y:四位数的年份
  • yyy:四位数的年份
  • yyyy:四位数的年份
  • yy:两位数年份
  • M: 不带前导0的月份(例如:1-12)
  • MM:带前导0的月份(例如:01-12)
  • MMM:月份的缩写(例如:Jan、Feb)
  • d:不带前导0的日期(例如:1-31)
  • dd:带前导0的日期(例如:01-31)
  • h:12 小时制的小时,不带前导零(例如:1-12)
  • hh:12小时制的小时,带前导零(例如:01-12)
  • H:24 小时制的小时,不带前导零(例如:0-23)
  • HH:24小时制的小时,带前导零(例如:00-23)
  • m:不带前导0的分钟(例如:0-59)
  • mm:带前导0的分钟(例如:00-59)
  • s:不带前导0的秒钟(例如:0-59)
  • ss:带前导0的秒钟(例如:00-59)
  • SSS:毫秒(例如:000-999)
表4 数据源接口配置

名称

类型

默认值

说明

url

string

''

接口的URL地址。

method

string

'GET'

接口的请求方式,包括如下选项:

  • GET
  • POST
  • DELETE
  • PUT

headers

Object

{}

接口请求头配置,支持HTTP标头配置项,同时支持机机认证逻辑。如果配置为机机认证,需要配置机机认证信息,具体配置请参考表5

body

Object

{}

接口参数。

pageNoField

string

'pageNo'

接口分页参数中页码对应的名称。

pageSizeField

string

'pageSize'

接口分页参数中分页条数对应的名称。

dataBody

string

''

接口响应返回值中表格数据链式路径。

totalBody

string

''

接口响应返回值中表格总条数链式路径。

表5 机机认证配置

名称

类型

默认值

说明

applyId

string

--

接入机机认证机制的第三方接口对应的应用ID,用于获取token。

authorizationKey

string

--

接入机机认证机制的第三方接口自定义的请求头字段,用于携带token。

相关文档