概述

本文档用于指导如何排查在星空对接苍穹过程中，付款单审核后没有反写苍穹的问题。反写的执行结果可以在星空的“上机操作日志”中查看。

注意，本文档仅为从星空方面进行问题排查的指南。

前序步骤

为了使是付款单反写苍穹插件正常运作，需要按照下列的步骤进行部署和配置。若已启用反写插件或添加了反写配置方案则可跳过本节。

1.启用付款单的反写插件

请依照下列顺序启用付款单反写插件，若已启用反写插件则跳过本节。

1）打开BOSIDE。

2）找到付款单单据。

Figure 1步骤2示意图

3）鼠标点击右键，点击拓展。（若已有拓展则跳过）

Figure 2步骤3示意图

4）待出现付款单的设计界面后，在右下角“属性”中找到“操作列表”并点击“...”符号的按钮。或是使用批量编辑字段属性，弹出属性界面后找到“操作列表”并点击“...”符号的按钮。

5）弹出操作列表后，找到对应的操作。此处以“审核”为例，选中“审核”操作，点击“编辑”按钮。

Figure 3步骤4示意图

Figure 4步骤5示意图

6）在操作编辑界面中，点击“其他控制”，接着点击服务插件的“…”按钮。

Figure 5步骤6示意图

7）找到反写插件PayBillWriteBackCangQiong，将启用的复选框勾上，点击确定即可。本节完。

Figure 6步骤7示意图

2.添加苍穹反写方案

请依照下列顺序配置付款单反写方案，若已添加反写方案可跳过本节。

1）打开并登陆星空，在搜索栏输入“集成平台设置”，并点击集成平台设置。

Figure 7步骤1 示意图

2）点击新增。

3）填写集成平台并保存。

接下来会下方示例图为例具体介绍各个参数的由来。除下述表格注明的名称外，其他可按需要自行填写。

Figure 8集成平台设置示例图

Table 1集成平台配置参数由来表1

Figure 9获取苍穹的appid和appSecret

Table 2集成平台配置参数由来表2

方案编码可以使用下表的默认配置。

Table 3反写方案默认配置表

本节完。

3.测试配置是否可用

本节需要使用测试工具PostMan，请先在各大搜索网站中搜索“PostMan”下载并安装。本节将以Figure 8集成平台设置示例图 的数据作为例子进行演示。总体业务流程为，通过苍穹的api获取appToken，再将AppToken与其他参数一起调用api获取OpenApiToken。若能获得OpenApiToken则表头的数据是正确的

3.1获取苍穹 appToken

苍穹获取AppToken的api的地址为https://OOXX.kdcloud.com/api/getAppToken.do。动词为Post。

请求体为

{

    "appId": "Cloud",//第三方AppId

    "appSecuret": "",//第三方App密码

    "tenantid": "tenant_devother_dev",//租户ID

    "accountId": "201912130021211252",//数据中心ID

    "language": "zh_CN"//语言字串

}

结果Json中的app_token 即为我们需要的appToken

Figure 10获取AppToken示意图

3.2 获取苍穹OpenApiToken

苍穹获取AppToken的api的地址为https://OOXX.kdcloud.com//api/login.do。动词为Post。

请求体为

{

    "user": "13480633400",//用户ID

    "apptoken": "e8bd475e-a216-4730-baaa-2f6c959bf6ef",//3.1获得的appToken

    "tenantid": "tenant_devother_dev",//租户ID

    "accountId": "201912130021211252",//数据中心ID

    "language": "zh_CN",//语言字串

    "usertype": "Mobile"//用户类型

}

结果Json中的access_token 即为我们需要的OpenApiToken

Figure 11获取苍穹OpenApiToken示意图

问题集合

1、未知错误:java.lang.NegativeArraySizeException

请检查星空的集成平台设置中的IP是否正确。一般类似https://OOXX.kdcloud.com/。特殊需要注意的是https的协议。

2、方案编码列表为空

请检查星空的集成平台设置是否填写了方案列表。通常为Table 3反写方案默认配置表 的数据。

3、反写方案编码列表为空

请检查星空的集成平台设置是否填写了方案列表。通常为Table 3反写方案默认配置表 的数据。

4、无可反写的单据编号

请确认数据集成方案中是否有FSOURCEBILLKEY 字段，且字段是否赋值为7。

5、PostMan请求后返回“没有得到数据中心数据”

请与苍穹的工作人员联系

6、PostMan请求后返回“第三方appId或appSecuret不能为空”

请检查请求体appId和appSecuret是否正确，注意大小写。

7、PostMan请求后返回“Acton不存在”

请确认集成平台设置中的访问IP地址是否正确，是否能在浏览器中打开。