单体环境集成消息及待办

孙新

一.消息代理
  1.什么情况下需要部署消息代理
   如果学校没有消息中心，又需要发送短信，微信等消息，则需要部署消息代理
  2.如何部署消息代理
   ①文件说明（如果需要部署，请联系小助手）
      共包含三个文件message_pocket_boot-0.0.1.jar，application.yml，start.sh
      message_pocket_boot-0.0.1.jar 运行jar包，依赖jdk1.7，才能运行
      application.yml 配置文件，配置哪些类型消息走云端代理
      start.sh 运行jar包脚本，如果配置的JAVA_HOME不是jdk1.7版本，则需要修改该脚本
   ②部署步骤
      step1.如果服务器未安装jdk，或者jdk版本低于1.7，请先安装jdk
      step2.将上述三个文件放到同一目录下，修改start.sh脚本，在 nohup -jar -Xms256m -Xmx512m中，加入安装的jdk的路径，例如nohup /opt/jdk1.7.0_80/jre/bin/java -jar -Xms256m -Xmx512m ，如果环境变量中配置的jdk已是1.7，则无需修改
      step3.修改application.yml配置文件。
        如果学校有云端消息总线，请配置cloud-msg-addr地址；如果没有，则和1016后配置的地址保持一致
        1016 消息地址：例如 http://172.16.6.136:9081/rsfwdt/ ... essage/createMsg.do，配置成部署改jar包的服务器地址
                 send-type 哪些消息类型，走上述配置的url；其余消息类型，会走cloud-msg-addr配置的地址。
      step4.运行start.sh脚本，会在同一目录下生成message_pocket_boot.out文件，该文件是服务器日志文件，可查看消息日志。
  3.如何切换到消息代理
    在T_RS_XT_PROP表中，存在code='SMP_MP_CONFIG'的消息总线配置，将配置中的uri，改为部署的消息代理服务器地址，例如http://172.16.7.78:8080/mp/restful/message/send
        
二.单体环境待办
  1.什么是单体待办
    与amp平台相对应的，展示在单体环境应用首页的待办。    待办消息存放在T_EMAP_HOME_MSG表中，MSG_TYPE为'T'。其中STATE='W'，表示待办未消除，STATE='F'，表示待办已消。
  2.单体环境待办集成配置
    依赖ggglmk4.0.36及以上。    部署emaphome
  3.哪些应用会发送单体待办
    ①必须是单体环境(emaproperties中，funauthapp.authentication_mode=1)
    ②单体环境，默认发送单体待办到应用首页。如果T_RS_XT_APP表中，TODO_TYPE配置为2' 的应用，则还会向平台发送一份待办信息。    ③ggglmk 4.0.42版本，增加全局配置，在emap.properties中，如果配置了SEND_ALL_TODO_TO_AMP=1，会将所有待办转发一份到amp。
注 : 1. ggglmk 4.1.0版本之前，T_EMAP_HOME_MSG表中的BIZ_ID是appName+taskId构成，消待办时，根据appName和taskId全部匹配才消除待办。存在如果pc端发起的代码，移动端消待办时，如果传递的appName是移动端应用名，则无法消除待办。
      2. ggglmk 4.1.0版本之后，单体消待办接口根据只根据taskId消待办。      
      3. ggglmk 4.1.6之后，移动端和pc端如果配置了映射关系（t_rs_xt_app_rel），则会发送两条待办，消待办时，也会根据映射关系全部消掉。
      4. ggglmk 4.1.7之后，非单体环境，也会向T_EMAP_HOME_MSG表中，插入待办数据。
      5. 发送待办时，如果推送平台或者单体待办，一旦其中任一个待办发送失败，则全部失败。

mengbin

待办的使用配置要更新下，新版本不再使用emaptaskcenter转发待办