外部表单链接

外部表单链接的新增

可批量新增

接口： /external-form-link/save POST JSON

请求参数

参数	类型	必须	默认值	主键	描述
externalFormTypeName	string	Y			外部表单类型名称
employeeId	string	Y			员工工号，与每刻平台一致，多个工号用逗号隔开
title	string	Y			外部表单标题
formCode	string	Y		Y	外部表单单据号，唯一，已存在则更新
link	string	Y			外部表单链接，可含有参数{employeeId}，将替换成员工工号
comment	string	Y			备注
effectiveTime	string	N			链接的有效截止日期，格式为'yyyy-MM-dd'

备注：

外部表单链接保存至每刻平台后，如果未传effectiveTime字段，则有效期为3个月。
formCode已存在则更新已有数据的externalFormTypeName，title，link，comment信息，对于employeeId则是增量更新
link字段需要以http://*或者*https://*开头（例如*https://www.maycur.com*）。link内容每刻不做校验，由第三方自己控制；link内容包含“{employeeId}”，每刻会将“{employeeId}”替换为当前登录账号的工号
失败情况：只返回失败部分，成功部分不返回，第三方根据code和errorData（"formCode": "errorMessage"）获取失败信息
如果第三方向每刻平台传参数{employeeId}，将替换成员工工号。举例：第三方传给每刻的link内容“https://www.maycur.com?employeeId={employeeId}”，每刻会将“{employeeId}”替换为当前登录账号的工号

示例：

请求数据

{
    "timestamp": 1467894006000,
    "data": [
        {
            "externalFormTypeName": "合同",
            "employeeId": "170020,170021",
            "title": "外部表单链接1",
            "formCode": "MK0001",
            "link": "https://www.maycur.com",
            "comment": "备注内容1",
            "effectiveTime":"2020-12-12"
        },
        {
            "externalFormTypeName": "计划书",
            "employeeId": "170020",
            "title": "外部表单链接2",
            "formCode": "MK0002",
            "link": "https://www.maycur.com",
            "comment": "备注内容2",
            "effectiveTime":"2020-11-12"
        }
    ]
}

返回数据（成功）

{
    "code": "ACK",
    "message": "",
    "data": {},
    "args": null,
    "linkDetail": false,
    "nonBizError": false
}

返回数据（失败）

{
    "code": "NACK",
    "message": null,
    "data": {
        "MK0001": "外部表单链接单据号已经存在"
    },
    "args": null,
    "linkDetail": false,
    "errorData": {
        "MK0001": "外部表单链接单据号已经存在"
    },
    "nonBizError": false
}

results matching ""

No results matching ""