@myyzs 2018-02-08T04:48:37.000000Z 字数 3302 阅读 78

待办中心文档

当前整体功能要考虑灰度的问题

DELETE FROM p_gatedlaunch WHERE tenant_id = 'dev_fangl' AND utype='todo-center';
INSERT INTO p_gatedlaunch(tenant_id, utype) VALUES('dev_fangl', 'todo-center');

创建应用

sql语句先删除后插入

DELETE FROM p_apps WHERE app_code ='10001';
INSERT INTO p_apps
(app_name,app_code,app_key,openurl,app_type,app_logo_url,app_memo,suite_id,wx_app_id,create_time,enable_visual_range_ctrl,show_in_appcenter,enable_auth_ctrl,show_in_yzs_app)
VALUES
(
'待办中心', 
'10001', 
'mysoft59b203ab5d4e6', 
'https://qy-qa.fdccloud.com/todo-center/$TENANT_ID$/home/site/index', 
'0', 
'https://static-qa.fdccloud.com/images/todo_center/icon.png', 
'流程待办中心', 
'1',
'0', 
NOW(),  
'0', 
'0', 
'0', 
'1'
);

三个消息推送接口支持往待办中心推送消息

涉及到的接口
1、/api/message/send（移动审批、管理简讯）
2、/api/open/send-message(企业内部自建应用)
3、/api/open1/send-message（明源内部APP）

p_message表需要新增字段

新增字段
biz_type 消息的业务类型，0待审1待阅
todo 是否已办 0未办，1已办，默认未办
from_app_code 消息原始来源哪个应用，只对10001的消息才有实际意义

租户库p_message

CALL AddColumnIfNotExists('p_message','biz_type','int',''); 
CALL AddColumnIfNotExists('p_message','todo','int',' DEFAULT 0');
CALL AddColumnIfNotExists('p_message','from_app_code','varchar(50)','');

如果要往待办中心推送消息，在extra节点里面新增

"extra":｛    
    "to_app_code":"10001"，   
    "biz_type":0    
｝

移动审批（3022）往待办中心（10001）里面推送了一条消息，p_message表里面的app_code为10001，fromm_app_code为3022,wzs_user_appmsg表中的app_code为10001。

测试建议：
1、移动审批同时挂到云助手和微信，并且移动审批往待办中心发消息，云助手在待办中心有消息，微信在移动审批有消息。
2、IOS推送时的桌面角标是否正常
3、新老逻辑不受影响

获取工作台应用的接口改造

根据是否开了灰度，来确定是否要在工作台展示

[前端Ajax接口] 获取待办中心消息列表

/home/message/get-msg-list

get参数

 "query_id": "",//为空表示从头查询，有值则从当前消息msg_id查询，但不包含该条消息
 "query_count": 20,//默认分页数量为20
 "query_direct": 0,//0:向后查询(较旧的消息)1:向前查询（较新的消息）默认0
 "biz_type": 0,//业务类型 0待审,1待阅 不传则都查
 "todo": 0，//是否已办，0未办，1已办，不传则都查

返回值

{
    "isSuccess": 1,
    "message": "sucess",
    "hasMore": "false",//是否还有更多的数据，数据翻页时使用
    "badgeCount":1 ,//角标数字
    "result": [
        {
            "msg_id": "001",
            "biz_id": "123",
            "app_code": "3022",
            "app_name": "移动审批",
            "app_logo_url": "http://x/mWorkflow_640.png",
            "biz_type": 0,
            "todo": 0,
            "readed":1,
            "author": "发起人姓名",
            "author_avator": "发起人头像",
            "title": "待办提醒",
            "content": "您有一条新的待办消息",
            "url": "http://m.fdccloud.com",
            "picurl": "图文类消息的图片地址",
            "msg_time": "2017-10-09 14:13:21",
            "mark": [
                {
                    "bgcolor": "FF0000",
                    "text": "急"
                },
                {
                    "bgcolor": "FFFF00",
                    "text": "超"
                }
            ]
        }
    ]
}

[前端Ajax接口] 获取角标

/home/message/get-badge

post参数

无

返回值

{
    "isSuccess": 1,
    "message": "sucess",
    "result": {
        "DS": "2",//待审个数
        "DY": "1"//待阅个数
    }
}

[前端Ajax接口] 刷新消息状态

/home/message/update-msg-status

每次调用这个接口默认将readed设置成1

get参数

 "msg_id": "",//要刷新的消息id
 "todo": 1，//是否已办，1已办。如果不传或者todo不等于1不刷新此字段

返回值

{
    "isSuccess": 1,
    "message": "sucess"
}

更新消息状态接口实现

此内容待定，涉及到代码的存放和结构的调整发送消息的改造
https://qy-ci.fdccloud.com/api/todo-center/update-msg-status?access_token=xxx

当更新了消息状态之后，需要同步更新p_message表中的状态和wzs_user_appmsg中的new_msg_count的值

post参数

{
    "tenant_id": "@tenant_id",
    "app_code":"@app_code",//原始应用code，比如3022往待办中心推，则app_code传3022
    "msg": [
        {
            "openid": "openid",
            "biz_id": "",//业务ID
            "todo": 1//是否已办
        }
    ]
}

返回值

{
    "success": 1,
    "data": {
        "code": 1,
        "message": "ok"
    }
}

上线前的历史数据处理

需求如下：
1、将现有的移动审批待办移到待办中心
2、待办中心历史数据角标的处理
3、历史数据处理后，消息列表应该不显示移动审批，除非后来又给3022发了新的消息

涉及到表有p_message、wzs_user_appmsg

消息推送范例

{
"tenantid": "my56a9c966df069",
"touser": "wzs59b666439a71e761515576",
"appcode": "3022",
"msgtype": "oa",
"extra":
{
"to_app_code":"10001"，
"biz_type":0
},
"mark": [
{
"bgcolor": "FF0000",
"text": "急"
},
{
"bgcolor": "FFFF00",
"text": "超"
}
],
"oa": {
"message_url": "http://open-doc.fdccloud.com",
"body": {
"title": "测试消息01",
"content": "这是一条优美的测试消息",
"author": "李四",
"author_avator": "http://7kts15.com1.z0.glb.clouddn.com/uploads/user/avatar/3570/blue.png"
}
}
}