企业内部开发 服务端API OA 汇报 获取汇报记录详情
获取汇报记录详情

企业可通过access_token调用本接口,根据汇报记录单号查询企业微信“汇报应用”的汇报详情。

 

请求方式:POST(HTTPS)

请求地址:https://qyapi.weixin.qq.com/cgi-bin/oa/journal/get_record_detail?access_token=ACCESS_TOKEN

请求示例

{
    "journaluuid": "41eJejN57EJNzr8HrZfmKyCN7xwKw1qRxCZUxCVuo9fsWVMSKac6nk4q8rARTDaVNdx"
}

参数说明:

参数必须类型说明
access_tokenstring调用接口凭证
journaluuidstring-
不多于256字节

 

权限说明: (无特殊权限)

返回结果:

{
    "errcode": 0,
    "errmsg": "ok",
    "info": {
        "journal_uuid": "41eJejN57EJNzr8HrZfmKyJZ6E3W9NQbr94x6QEA6MwvK2sVqFQNWy4BaF4Ptyzk26",
        "template_name": "今日工作汇报",
        "report_time": 1606365591,
        "submitter": {
            "userid": "LiQiJun"
        },
        "receivers": [
            {
                "userid": "LiQiJun"
            }
        ],
        "readed_receivers": [
            {
                "userid": "LiQiJun"
            }
        ],
        "apply_data": {
            "contents": [
                {
                    "control": "Text",
                    "id": "Text-1606365477123",
                    "title": [
                        {
                            "text": "工作内容",
                            "lang": "zh_CN"
                        }
                    ],
                    "value": {
                        "text": "今日暂无工作",
                        "tips": [],
                        "members": [],
                        "departments": [],
                        "files": [],
                        "children": [],
                        "stat_field": [],
                        "sum_field": [],
                        "related_approval": [],
                        "students": [],
                        "classes": []
                    }
                }
            ]
        },
        "comments": [
            {
                "commentid": 6899287783354824502,
                "tocommentid": 0,
                "comment_userinfo": {
                    "userid": "LiYiBo"
                },
                "content": "加油",
                "comment_time": 1606365615
            }
        ]
    }
}

参数说明:

参数类型说明
errcodeint32返回码
errmsgstring错误码描述
infoobj汇报详情
info.journal_uuidstring汇报记录id
info.template_namestring汇报表单名称
info.template_idstring汇报表单id
info.report_timeint32汇报时间
info.submitterobj汇报提交者
info.submitter.useridstring汇报用户id
info.receiversobj[]汇报接收对象
info.receivers.useridstring接收用户id
info.readed_receiversobj[]已读用户
info.readed_receivers.useridstring已读用户id
info.apply_dataobj表单数据
info.apply_data.contentsobj[]表单字段列表
info.apply_data.contents.controlstring控件类型:Text-文本;Textarea-多行文本;Number-数字;Money-金额;Date-日期/日期+时间;Selector-单选/多选;;Contact-成员/部门;Tips-说明文字;File-附件;Table-明细;DateRange-时长
info.apply_data.contents.idstring控件id
info.apply_data.contents.titleobj控件名称 ,若配置了多语言则会包含中英文的控件名称
info.apply_data.contents.valueobj控件值 ,包含了申请人在各种类型控件中输入的值,不同控件有不同的值,具体说明详见附录
info.sys_journal_datastring“汇报”模板数据,内容为富文本。“汇报”模板是一个特殊模板其表单不在apply_data中返回
info.commentsobj[]评论
info.comments.commentiduint64评论id
info.comments.tocommentiduint64评论回复id
info.comments.comment_userinfoobj评论用户
info.comments.comment_userinfo.useridstring评论用户id
info.comments.contentstring评论内容
info.comments.comment_timeuint32评论时间

附录:各控件apply_data/contents/value参数介绍

附1 文本/多行文本控件(control参数为Text或Textarea)

{
    "text": "文本填写的内容"
}
参数说明
text文本内容,即申请人在此控件填写的文本内容

附2 数字控件(control参数为Number)

{
    "new_number": "700"
}
参数说明
new_number数字内容,即申请人在此控件填写的数字内容

附3 金额控件(control参数为Money)

{
    "new_money": "700"
}
参数说明
new_money金额内容,即申请人在此控件填写的金额内容

附4 日期/日期+时间控件(control参数为Date)

{
    "date": {
        "type": "day",
        "s_timestamp": "1569859200"
    }
}
参数说明
date日期/日期+时间内容,即申请人在此控件选择的 日期/日期+时间内容
└ type时间展示类型:day-日期;hour-日期+时间
└ s_timestamp时间戳,字符串类型

附5 单选/多选控件(control参数为Selector)

{
    "selector": {
        "type": "multi",
        "options": [
            {
                "key": "option-15111111111",
                "value": [
                    {
                        "text": "选项1",
                        "lang": "zh_CN"
                    }
                ]
            },
            {
                "key": "option-15222222222",
                "value": [
                    {
                        "text": "选项2",
                        "lang": "zh_CN"
                    }
                ]
            }
        ]
    }
}
参数说明
selector选择内容,即申请人在此控件选择的选项内容
└ type选择类型:single-单选;multi-多选
└ options申请人所选择的选项,多选情况下可能有多个(仅包含申请人所选择的选项,并非所有选项,若需要了解所有选项,需使用“获取审批模板详情”接口)
└ └ key选项key,选项的唯一id,可通过“获取审批模板详情”接口获得
└ └ value选项值,若配置了多语言则会包含中英文的选项值

 

附6 成员控件(control参数为Contact,且value参数为members)

{
    "members": [
        {
            "userid": "WuJunJie",
            "name": "Jackie"
        },
		{
            "userid": "WangXiaoMing"
			"name": "Tom"
        }
    ]
}
参数说明
members成员内容,即申请人在此控件选择的成员,多选模式下可能有多个
└ userid成员的userid
└ name成员名

 

附7 部门控件(control参数为Contact,且value参数为departments)

{
    "departments": [
        {
            "openapi_id": "2",
            "name": "销售部",
        },
        {
            "openapi_id": "3",
            "name": "生产部",
        }
    ]
}
参数说明
departments部门内容,即申请人在此控件选择的部门,多选模式下可能有多个
└ openapi_id部门id
└ name部门名

附8 说明文字控件(control参数为Tips)
此控件不显示在审批详情中,故value为空

附9 附件控件(control参数为File)

{
    "files": [
        {
            "file_id": "WWCISP_v2z8qZENw2qwSiNroVKykbxxMXvmI1lELzG-fo25Y9n1duozezKEu6zSIvOHPCd9_8s934AJncRz5f9G4E_nCQonUHLdiAnCLjfZQQwVaiG7krKzyGB1MpYa9ZVkk0gQ7P8HvO_SOdwzLwpyUZ3Tm2ApyoO_78nTM-iEkf_TILqXuYxKd7ByYL34wMA9Czf6Iy151tHbcYNvbNZZHTnL4UMQdohJ_MPYA2Wz00IebZb3_UuIk5MdJSH_IKlZn9Ms5"
        },
        {
            "file_id": "WWCISP_gZ3BMg5hwI1Adi16NwzJgpi9zp6QQjMdYcuemVWBeHnmMK3QJOYiIIkHvRIh0ysZcAo6gJp069o5tx7qxVzin1Q9LKswff624E1qCCmt088ISBVPScoqEiG4YTI_Kltrqn7b0wvMTudd9lIE3ywgHatPRWKxsHNsSxEY_FuaFWlGHzxcYKNq_LIfVBXZGji-C5bXp23MwpTcCXYfWPfSEpEeXW5c5sQscY_MeW5uc0gITpeFKFXARXmKC62_u7Ln"
        }
    ]
}
参数说明
files文件内容,即申请人在此控件上传的文件内容,可能有多个
└ file_id文件的media_id,具体使用请参考:文档-获取临时素材

附10 明细控件(control参数为Table)

{
    "children": [
        {
            "list": [
                {
                    "control": "Text",
                    "id": "Text-15111111111",
                    "title": [
                        {
                            "text": "明细内文本控件",
                            "lang": "zh_CN"
                        }
                    ],
                    "value": {
                        "text": "明细文本"
                    }
                }
            ]
        }
    ]
}
参数说明
children明细内容,一个明细控件可能包含多个子明细
└ list子明细列表,包含了申请人在子明细的所有子控件中填写的内容,子控件的数据接口同一般控件

 

附11 时长组件(control参数为DateRange)

{
    "date_range": {
		"type": "halfday",
        "new_begin": 1570550400,
        "new_end": 1570593600,
        "new_duration": 86400
    }
}
参数说明
date_range时长组件
└ type时间展示类型:halfday-日期;hour-日期+时间
└ new_begin开始时间,unix时间戳
└ new_end结束时间,unix时间戳
└ new_duration时长范围, 单位秒

附12 位置控件(control参数为Location)

{
    "location": {
		"latitude": "30.547239",
		"longitude": "104.063291",
		"title": "腾讯科技(成都)有限公司(腾讯成都大厦)",
		"address": "四川省成都市武侯区天府三街198号腾讯成都大厦A座",
		"time": 1605690460
	}
}
参数说明
latitude纬度,精确到6位小数
longitude经度,精确到6位小数
title地点标题
address地点详情地址
time选择地点的时间

 

附13 公式控件(control参数为Formula)

{
   "formula": {
		"value": "5.0"
	}
}
参数说明
value公式的值

 

附14 学生控件(control参数为SchoolContact,且value参数为students)

{
    "students": [
        {
            "name": "Jackie"
        },
		{
			"name": "Tom"
        }
    ]
}
参数说明
students学生内容,即申请人在此控件选择的 学生,多选模式下可能有多个
└ name学生名

 

附15 班级控件(control参数为SchoolContact,且value参数为classes)

{
    "classes": [
        {
            "name": "1班",
        },
        {
            "name": "2班",
        }
    ]
}
参数说明
classes班级内容,即申请人在此控件选择的班级,多选模式下可能有多个
└ name班级名

错误说明

错误码说明
301065无汇报应用数据拉取权限
301066请求参数错误
301067接口内部失败
上一篇
批量获取汇报记录单号
下一篇
获取汇报统计数据