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

news/2024/12/18 15:49:50/

题记

数智化办公专家、国家高新技术企业、
知识管理国家标准制定者、信创供应商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”]
  }
  }

字段1	字段2
1	ab
2	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>