# 一、功能介绍

通过指定表单唯一字段键值的方式，打卡对应数据的卡片页面。

最初用于同步替换E9功能：人力资源自定义链接关联建模卡片数据，现支持一般场景下的eb卡片链接中转。

# 二、传值方式

## 2.1 常见配置

通过字段bh和值“WPFL0006”在表单id为790640979003211777的表中找到对应数据，则直接跳转到对应页面，否则无该数据，不进行跳转，显示no data。

```javascript
/sp/ebdfpage/formmode/view/convertPage?objId=790640979003211777&pkfield=bh&pkvalue=WPFL0006
```

## 2.2 参数解释

1. objId：需要跳转的目标表单ID
2. pkfield：字段名
3. pkvalue：字段值，支持三种方式：
  
  1. **固定值**：比如WPFL0006这种固定值参数。
  2. **$fieldName$**：一般场景传参，通过字段名获取eb表单值。
  3. **#{id}**：目前仅见于人力资源对接场景使用。

## 2.3 明细表支持（目前只支持物理表）

明细类型数据跳转对应页面,目前只支持pkfield=id的场景，需要增加参数**detailtable=明细表名。**

```javascript
/sp/ebdfpage/formmode/view/convertPage？objId=790640979003211777&pkfield=id&pkvalue=10001&detailtable=uf_bd20529_mxb1
```

## 2.4 更多示例

```javascript
单页跳转pc端：
/sp/ebdfpage/formmode/view/convertPage?objId=787963822673854465&pkfield=field_787963878508429313&pkvalue=787963921458102281

单页跳转移动端：
/mobile/ebdfpage/formmode/view/convertPage?objId=787963822673854465&pkfield=field_787963878508429313&pkvalue=787963921458102281
```

## 2.5 其他事项

- 注1：通过唯一字段确定数据（字段拼接pkfield=xxx&pkvalue=xxx）
- 注2：如果是以E9方法一实现，&billid={#id}&pkfield=xm 方式转换为 &pkfield=xm&pkvalue={#id}
- 注3: 如果是明细表需要增加**&detailtable=明细表数据库表名**,目前只支持物理表
- E9文档链接：
  
  [https://www.e-cology.com.cn/spa/cube/index.html#/main/cube/card?type=0&modeId=470&formId=-967&billid=267&opentype=0&customid=694&viewfrom=fromsearchlist&\_key=9xmr1e](https://www.e-cology.com.cn/spa/cube/index.html#/main/cube/card?type=0&modeId=470&formId=-967&billid=267&opentype=0&customid=694&viewfrom=fromsearchlist&_key=9xmr1e)
  
  [图片附件未整合: ../_assets/798066401874665472/001-528b5de8d8.png]

# 三、接口请求（开发部分看）

请求URL

- /api/ebuilder/form/data/getTransitInfo

请求方式

POST

请求参数

| 参数名 | 参数类型 | 是否必填 | 参数说明 |
| --- | --- | --- | --- |
| objId | String | 是 | 表单id |
| datas | Object | 否 | 唯一字段，以键值对的形式传递 |
| detailtable | String | 否 | 数据库明细表,表名 示例:uf\_xxxx\_mx |

请求示例

```json
// 共享表
{
    "objId":"738377454616141825",
    "datas": [
        {
            "key": "field_7835511690084312456",
            "value": "测试3"
        }
    ]
}
```

```json
// 物理表
{
    "objId":"790640979003211777",
	"detailtable":"uf_bd20529_mxb1", // 如果不是明细表,不需要传递
    "datas": [
        {
            "key": "dxwb_5vh7rd",
            "value": "测试2"
        }
    ]
}
```

datas参数说明

| 参数名 | 参数类型 | 是否必填 | 参数说明 |
| --- | --- | --- | --- |
| key | String | 是 | 共享表支持                                                        （1）："field\_字段id"格式                                                 示例：field\_7835511690084312456；                     （2）：字段key（图1）                                                  物理表支持                                                                   （1）：字段key，示例：dxwb\_5vh7rd |
| value | String | 是 | key对应字段的字段值 |

[图片附件未整合: ../_assets/798066401874665472/002-8310d0429f.png]

                                                                       （图1）

正常返回示例

```
{
    "code": 200,
    "msg": "接口返回成功",
    "status": true,
    "data": {
        "dataId": "790642258911854593",
        "objId": "790640979003211777"
    }
}
```

异常或未查询查询到数据返回示例

```
{
    "code": 200,
    "msg": "接口返回成功",
    "status": true,
    "data": {
        "objId": "790640979003211777"
    }
}
```

返回参数说明

| 参数名 | 参数类型 | 参数说明 |
| --- | --- | --- |
| dataId | String | 数据id |

####
