我们来对接蓝凌OA --报文格式

题记

• 数智化办公专家、国家高新技术企业、
• 知识管理国家标准制定者、信创供应商10强
• …
• 等等，这些和咱们有关系吗！！
• 不好意思，走错片场了，刚和项目经理在甲方那边吹牛B
• 想想刚刚的大饼，看看支付宝余额，囊中羞涩，写博文以记之
• 接下来看报文格式

报文格式

• 蓝凌OA不同版本，或相同版本可以配置不同所需报文格式，这里以接触到的为例子

• 结构概览

  	<arg0><attachmentForms> ** </attachmentForms><attachmentForms> ** </attachmentForms><docCreator>{"PersonNo":"账号"}</docCreator><docSubject>标题</docSubject><fdKeyword>["关键字1", "关键字2"]</fdKeyword><fdTemplateId>模板id</fdTemplateId><formValues>{"key1":"v1"} </formValues></arg0>
  

  • <attachmentForms>包含一个附件
  • <docCreator>登录账号（免密）
  • <formValues>包含主要数据信息

• 附件结构

  	<attachmentForms><fdKey>fd_3a33abd499e5de</fdKey><fdFileName>test1.pdf</fdFileName><fdAttachment>xxxx</fdAttachment></attachmentForms>
  

  • <fdKey>oa接受字段
  • <fdAttachment>附件流

• 明细列结构

  	<formValues>{"fd_676703b7c93b74x": "CN","fd_676730cabd113c0": "AR1B","fd_67670cc9cf372a": "0001",<!-- 明细-->"fd_6767cd1ecedd0a": {"fd_6767cd1ecedd0a.fd_6767d1b6d397ee": ["FVGN00"],"fd_6767cd1ecedd0a.fd_6767d1c28f6910": ["2800"]},"fd_676743e274be50": "2"} </formValues>
  

  • 明细作为一个字段放在<formValues>中
  • 是一个json对象，不是数组
  • 基于列的形式构建数据
    • 即按照列将数据维护在一起
      {“字段1”:[1,2],“字段2”:[“ab”,“ju”]}

      字段1	字段2
      1	ab
      2	ju

  • 而且列表字段需要带上明细字段前缀
    {
    “fd_6767cd1ecedd0a”:
    {
    “fd_6767cd1ecedd0a.字段1”:[1,2],
    “fd_6767cd1ecedd0a.字段2”:[“ab”,“ju”]
    }
    }

后记

• 整体xml报文

  <?xml version="1.0" ?>
  <S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/">
  <S:Body>
  <ns2:addReview xmlns:ns2="http://webservice.review.km.kmss.landray.com/">
  <arg0>
  <attachmentForms>
  <fdKey>fd_7788abd499e5de</fdKey>
  <fdFileName>test1.pdf</fdFileName>
  <fdAttachment>UIUJJ**ABgAIAAAAIQB/2XZSkQEAADYGAAATAAgCW0******M+iAAAAAA==</fdAttachment>
  </attachmentForms>
  <docCreator>{"PersonNo": "TTU"}</docCreator>
  <docSubject>采购申请</docSubject>
  <fdKeyword>["物料", "人员"]</fdKeyword>
  <fdTemplateId>191b0a8638aa3d5d46ae4343434de</fdTemplateId>
  <formValues>{"fd_7788b58110ac42":"WSC"}</formValues>
  </arg0>
  </ns2:addReview>
  </S:Body>
  </S:Envelope>
  

• 主要是附件和明细结构
• 在细分领域业务内，对接三方系统，总会遇到老相识
• 记之，提高效率，打怪升级