集成服务云重要通知

栏目：云苍穹知识作者：金蝶来源：金蝶云社区发布：2024-09-23浏览：1

集成服务云重要通知

该文章专门用于集成服务云通知重要内容，所以请大家定期关注。

该帖子的访问地址会嵌入到集成服务云的首页，方便大家查看。

2024-08-17 集成重要通知

问题描述：调度周期超过7天或更长的定时启动方案、服务流程未如期执行，该问题只会在6.0版本及以上版本出现

原因分析：“集成服务云的后台日志清理任务”误删了“集成云任务监控”中的调度任务

解决方法：

一. 公有云用户

1. 通过服务流程“查询后台任务被删除的启动方案和服务流程”检查有哪些定时的启动方案和服务流程受到了影响

2. 通过步骤1获取资源编码，对这些资源进行禁用和启用

3. 重复步骤1，此时运行结果再无相关启动方案和服务流程

二. 私有云用户

1. 安装补丁EME.ISC.V6.0.15.0.10_0812（补丁可以找郭玲获取）

2. 通过服务流程“查询后台任务被删除的启动方案和服务流程”检查有哪些定时的启动方案和服务流程受到了影响

3. 通过步骤2获取资源编码，对这些资源进行禁用和启用

4. 重复步骤2，此时运行结果再无相关启动方案和服务流程

其他注意事项：

过程中有任何疑问可以云之家咨询郭玲

2024-08-16 集成重要通知

【关于Apache Tomcat信息泄露漏洞排查通知】

【集成影响范围】：使用数据库代理和SAP RFC代理的集成用户

【漏洞Apache Tomcat官方说明】：https://lists.apache.org/thread/h9bjqdd0odj6lhs2o96qgowcc6hb0cfz

漏洞级别: 0DAY

漏洞危害: 高危

问题版本: Apache Tomcat 9.0.0-M11-9.0.43 Apache Tomcat 8.5.7-8.5.63

【排查内容】:

1、排查Tomcat版本号:手动排查在Tomcat服务器目录，查看RELEASE-NOTE文件确认使用版本，外采系统可联系供应商告知版本号;

2、排查是否发布外网:排查Apache Tomcat业务应用互联网发布情况，第一时间关闭存在漏洞业务应用的互联网发布，并安排升级到最新版;

【解决方法】:

目前该漏洞已经在新版本中修复，受影响用户可升级到以下版本:

下载链接: https://tomcat.apache.org/index.html

Apache Tomcat >=9.0.44

Apache Tomcat >=8.5.64

请使用集成管理的数据库代理、SAP RFC代理的用户进行升级tomcat

【查看tomcat版本】：

1、cmd下进行：Y:\DBProxy-Jetty-Nginx\apache-tomcat-9.0.56\bin>catalina version

Using CATALINA_BASE: "Y:\DBProxy-Jetty-Nginx\apache-tomcat-9.0.56"

Using CATALINA_HOME: "Y:\DBProxy-Jetty-Nginx\apache-tomcat-9.0.56"

Using CATALINA_TMPDIR: "C:\Users\RD_songhua_shao\AppData\Local\Temp"

Using JRE_HOME: "C:\java\jdk1.8.0_162"

Using CLASSPATH: "Y:\DBProxy-Jetty-Nginx\apache-tomcat-9.0.56\bin\bootstrap.jar;Y:\DBProxy-Jetty-Nginx\apache-tomcat-9.0.56\bin\tomcat-juli.jar"

Using CATALINA_OPTS: ""

Server version: Apache Tomcat/9.0.56

Server built: Dec 2 2021 14:30:07 UTC

Server number: 9.0.56.0

OS Name: Windows 7

OS Version: 6.1

Architecture: amd64

JVM Version: 1.8.0_162-b12

JVM Vendor: Oracle Corporation

【其他注意事项】：

过程遇到任何疑问可以云之家联系邵松华进行协助

2024-03-22 集成重要通知

问题描述：客户(星空-苍穹)同步提示“值转换规则2369CCC：发票类型（星空数据源-预置当前苍穹）执行失败”

原因分析：客户属性中的字段“发票类型（ENUM枚举值）”废弃，新增了一个“发票类型（REF基础资料）”,导致原来的常量类型的值转换规则异常。

解决方法：修改数据集成方案将目标对象修改成REF类型的发票类型字段，同时将现有的常量值转换规则换成人工映射的值转换规则。

更详细的说明请参考：https://vip.kingdee.com/article/558940185829025280

2024-03-18 集成重要通知

问题描述：人员禁用同步（EAS-苍穹）异常。提示“Key (fusername)=( ) already exists”

解决方法：修改方案中的脚本“禁用同步释放人员许可”

更详细的说明请参考：https://vip.kingdee.com/article/557498366029261824

2024-01-31 集成重要通知

问题描述：脚本编写Date.format日期格式化“YYYY-MM-dd'”和“yyyy-MM-dd”的区别

return Date.format(Date.new('2023-12-31 00:00:00.0'), 'YYYY-MM-dd');

输出：2024-12-31

return Date.format(Date.new('2023-12-31 00:00:00.0'), 'yyyy-MM-dd');

输出：2023-12-31

原因分析：（更详细的说明：脚本编写Date.format日期格式化“YYYY-MM-dd'”和“yyyy-MM-dd”的区别）

本质上是JAVA中，日期格式化YYYY与yyyy区别。
“YYYY”表示的是Week year，就是这天所在的周所属的年。
小写yyyy表示的就是年份。
结论：请使用小写y来表示年份。

解决方法：请检查集成管理中使用的脚本日期格式是否符合大家的预期。

2023-07-14 集成重要通知

连接配置列表出现“智能标签提取服务”的内容，导致现有在用的连接连接没有许可

问题描述：

连接配置列表出现“智能标签提取服务”的内容，导致现有在用的连接连接没有许可，许可被“智能标签提取服务”连接配置占用。

原因分析：

星瀚某业务部门在2022年7月（BIZ_V5.0.023）补丁中，误预置了连接配置“智能标签提取服务”，导致连接配置的许可被占用，影响了现有在用的连接配置的许可。

解决方法：

1. 删除连接配置“智能标签提取服务”

2. 更新补丁EME.HRV5.0.023.007_0707

2023-07-03 集成重要通知

外部系统API登记列表启用或禁用提示“删除无“API服务”的“删除”权限，请联系管理员。”之解决方案

问题描述：

外部系统API登记列表点击启用或者禁用按钮提示“删除无“API服务”的“删除”权限，请联系管理员。”

原因分析：

集成服务云在2022年5月（V4.0.020）补丁中，基于安全和问题追溯的考虑，将集成平台API发布到开放平台的方式改成了调用开放平台的操作，所以需要用到开放平台API服务的删除权限。

解决方法：分配开放平台API服务删除操作的权限。

2023/04/04 集成重要通知

集成服务云1.0历史包下架，包含isc-iscb-rabbitmq-1.0.jar、isc-iscb-formplugin-1.0.jar、isc-iscb-execute-1.0.jar

isc-iscb-common-1.0.jar、isc-iscb-cache-1.0.jar、isc-iscb-base-1.0.jar、isc-ext-hr-1.0.jar、isc-ext-fdc-1.0.jar、

isc-ext-er-1.0.jar、isc-ext-base-1.0.jar、isc-eas-common-1.0.jar、isc-iscb-api-1.0.jar。

该调整后可能带来的影响：1.0版本不再支持

解决方案：请集成服务云所有用户停止使用1.0版本，并及时调整集成方案。

产品调整补丁发布时间：2023-04-03 V5.0.018(BIZ)

2023/11/28 集成重要通知

1、新增白名单模式，对于标准集成方案可直接运行。参考https://vip.kingdee.com/link/s/MkXGV

2、BUG修复：服务流程消息发送节点，当单个消息发送节点循环调用时，多次进入同一个消息通知节点，会将之前的通知人变量累加，导致消息发送给多个人。

2022/09/22集成重要通知

源系统id值为非长整型场景集成异常之解决方案（For input string:）

问题描述

集成服务云在2021年9月（V4.0.008）补丁中，对涉及主键等长整型字段做了类型校验，即传入的必须是长整型，否则会抛出异常。
问题异常提示

执行日志失败提示：字段（id）赋值（lfkAAAZI/B8/0Wlk）出错，原因：For input string: "lfkAAAZI/B8/0Wlk"，

Caused by: java.lang.NumberFormatException: For input string: "lfkAAAZI/B8/0Wlk"

at java.lang.NumberFormatException.forInputString(NumberFormatException.java:65)

at java.lang.Long.parseLong(Long.java:589)

at java.lang.Long.parseLong(Long.java:631)

at kd.isc.iscb.util.dt.D.l(D.java:53)

at kd.isc.iscb.util.dt.D.l(D.java:45)

at kd.isc.iscb.platform.core.util.setter.LongPropSetter.setObjValue(LongPropSetter.java:21)

at kd.isc.iscb.platform.core.util.setter.Setter.setObjValue(Setter.java:32)

at kd.isc.iscb.platform.core.connector.self.DoBizAction.setDynamicObjectValues(DoBizAction.java:630)

... 52 more

更详细的说明请参考：https://vip.kingdee.com/article/360800307678355200?productLineId=29&isKnowledge=2

2022/06/10集成重要通知

【（星空-苍穹）集成用户提醒】请（星空-苍穹）集成的用户关注，如果你使用了这个方案（编码：KD_Person(XK-CQ) 名称：预置_员工（星空-苍穹））进行人员同步，请在收到这个通知后第一时间根据本文的指导调整现有方案。

背景：方案“KD_Person(XK-CQ) 预置_员工（星空-苍穹）”中的字段映射“是否禁用（列表字段名称“用户禁用”）”的值转换规则值转换存在错误。如果用户更新补丁V5.0.002（预计发布时间：0615之后）后，会导致从星空同步至苍穹的人员“是否禁用（列表字段名称“用户禁用”）”变成禁用从而导致人员无法登陆苍穹系统。目前没有问题是因为字段“是否禁用”并没有真正启用，从补丁V5.0.002（预计发布时间：0615之后）之后这个字段开始生效。

可能带来的影响：更新补丁V5.0.002（预计发布时间：0615之后）之后，从星空同步至苍穹的新增加的人员无法登陆苍穹。历史数据（历史人员数据）基础会在补丁V5.0.002的脚本中统一处理，我们需要关注的是更新补丁后新增的人员数据。

更详细的说明请参考：https://vip.kingdee.com/article/323026334886789888?productLineId=29&isKnowledge=2

2021/10/13集成重要通知

[EASCloud861用户提醒]请EAS和苍穹集成的用户关注，如果您使用的EAS是EASCloud861版本，请近期不要安装EAS补丁PTM161822（10月18日已经发布）。

由于EAS在PTM161822补丁中对EAS用户密码的加密算法进行了改造（支持SHA-256和SM3），故苍穹集成服务云需要协同改造代码来适配EAS此次的改造。

苍穹集成服务云的补丁发布预计时间在10月28日，补丁号BIZ_V4.0.010，具体发布时间后续确定后再通知。

可能带来的问题：如果EAS环境只安装了EASCloud861的PTM161822补丁，没有同时安装苍穹集成服务云的补丁，会导致集成服务云EAS连接配置部署、测试和集成过程提示“密码错误!原因:Given final block not properly padded”。

解决方法：安装EAS补丁PTM161822之前，需要确保已经更新了集成服务云苍穹的补丁和EAS连接器。

备案：如果您是EASCloud861的用户，且使用了苍穹集成服务云，请联系郭玲备案，苍穹集成服务云的补丁发布时间在10月28日，补丁号BIZ_V4.0.010。

更详细的说明请参考：https://vip.kingdee.com/article/238589265897466880

2021/08/06集成重要通知

在近期的产品运营过程中，发现部分集成服务云用户在使用脚本SQL取数和服务流程获取上下文内容存在不合理的情况（SQL函数查询结果和服务流程上下文内容太大）。为了确保集成过程的稳定性，降低系统OOM的风险，集成服务云产品将对SQL语句的查询结果和服务流程上下文内容大小进行设置，最大值不能大于20M，涉及到的脚本函数有query_list, query_column和SELECT。

该调整后可能带来的影响：原SQL语句的查询结果和服务流程上下文内容大于20M的方案或者服务流程将可能运行失败，失败提示如下：

提示一：查询结果超过了“19999999”字节，此措施是为了限制查询结果集的大小以降低系统OOM的风险。建议解决办法：调整业务实现为分批处理避免一次查询太多数据，或联系管理员调整JVM系统参数 ISC_QUERY_MAX_SIZE 提高上限。

提示二：服务流程的上下文内容超过了上限“19999999字符”。建议解决办法：调整服务流程设计，减少流程变量中存放的内容；或联系管理员调整JVM系统参数 ISC_QUERY_MAX_SIZE（单位：字节）增加上限。

解决方案：请集成服务云所有用户检查现有数据集成方案和服务流程并逐一优化(方案优化过程中如果需要技术支持可以找集成服务云部同事)。

补充说明：20MB的数据经实测表明，可能占用200MB（0.2GB）内存，集成云同时运行的最大任务数可达48个，如果需要调整此上限，应该同步调整JVM堆内存的上限。

产品调整补丁发布时间：2021-09-25 V4.0.008(BIZ)

2021/07/21集成重要通知

[EAS862用户提醒]请EAS和苍穹集成的用户关注，如果您使用的EAS是862版本且需要使用https协议来进行集成，由于EAS在862版本对证书的验证更加严格，升级到EAS862后，如果苍穹端地址https颁发机构的证书不在EAS jdk的信任列表中，可能会出现集成管理中EAS连接配置部署异常，出现这个问题的概率极低，如有问题请找郭玲反馈，集成服务云将协调eas运维来解决。

提示如下：

kd.isc.iscb.util.except.IscBizException: EAS反调苍穹时报错，url:https://xxxxx/ierp,错误内容:sun.security.validator.ValidatorException: PKIX path building failed: sun.security.provider.certpath.SunCertPathBuilderException: unable to find valid certification path to requested target at kd.isc.connector.eas.Util.testCallbackIerp(Util.java:312)

at kd.isc.connector.eas.e.RemoteDeploy.exec(RemoteDeploy.java:46)

at kd.isc.connector.eas.e.RemoteDeploy.exec(RemoteDeploy.java:1)

atkd.isc.iscb.util.connector.server.AbstractCommandExecutor.exec(AbstractCommandExecutor.java:15)atkd.isc.iscb.util.connector.server.CommandDispatcher.execute(CommandDispatcher.java:146)atkd.isc.iscb.util.connector.server.CommandDispatcher.access$1(CommandDispatcher.java:141)atkd.isc.iscb.util.connector.server.CommandDispatcher$1.run(CommandDispatcher.java:121)atjava.util.concurrent.ThreadPoolExecutor.runWorker(ThreadPoolExecutor.java:1142)atjava.util.concurrent.ThreadPoolExecutor$Worker.run(ThreadPoolExecutor.java:617)at java.lang.Thread.run(Thread.java:745)

Caused by: javax.net.ssl.SSLHandshakeException: sun.security.validator.ValidatorException: PKIX path building failed: sun.security.provider.certpath.SunCertPathBuilderException: unable to find valid certification path to requested target

at sun.security.ssl.Alerts.getSSLException(Alerts.java:192)

at sun.security.ssl.SSLSocketImpl.fatal(SSLSocketImpl.java:1949)

at sun.security.ssl.Handshaker.fatalSE(Handshaker.java:302)

at sun.security.ssl.Handshaker.fatalSE(Handshaker.java:296)

atsun.security.ssl.ClientHandshaker.serverCertificate(ClientHandshaker.java:1509)atsun.security.ssl.ClientHandshaker.processMessage(ClientHandshaker.java:216)at sun.security.ssl.Handshaker.processLoop(Handshaker.java:979)

at sun.security.ssl.Handshaker.process_record(Handshaker.java:914)

at sun.security.ssl.SSLSocketImpl.readRecord(SSLSocketImpl.java:1062)

2021/07/19集成重要通知

【集成服务云权限改造提醒】为了进一步管控和规范集成过程中的操作，预防不规范的误操作的发生和降低风险，故对集成服务云目前的所有菜单和按钮进行了权限的梳理。更新补丁后会出现部分按钮没有权限操作的提示（V4.0.006发布时间2021年8月26日），为了减少补丁给用户带来的权限影响，建议用户在更新补丁前将日常使用集成管理的用户设置成全功能用户或者是通用角色中的（集成云管理员）。问题咨询人员：杨建辉、郭玲。

详细说明：https://club.kdcloud.com/article/202367788994620672

2021/07/08集成重要通知

【苍穹3.0许可升级4.0风险提醒】若在苍穹3.0购买集成云且是通过接口与第三方系统集成，升级4.0许可时，需要与集成云团队联系确认后，才可以升级。（若苍穹与EAS、星空、数据库集成的可忽略该消息）若不沟通升级，有极大风险因许可不足导致业务中断。请在升级前，务必提前沟通！我们也会逐个跟销售顾问联系，若没有联系到位的，请各实施团队也能通知到销售人员。接口联系人：江婉玲。

2021/07/06集成重要通知

【重大风险提醒】请已上线或正在上线的项目，检查所有方案的候选键，请在目标端的表上一定设置唯一索引，对性能提升优化效果极大。如果是组合候选键，设置多字段对应的唯一索引。（有条件源端也的候选键也建议设置唯一索引）。因为集成云所有的方案都是按照候选键来判断是否更新或者新增的，若没有设置索引，每次的候选键判断对数据库都是全表扫描，会对数据库带来极大的性能耗损。目前已经有多个项目组，因为没有对候选键设置索引，导致数据库压力过大，请一定引起重视！苍穹模板创建的表单，除了fid默认有唯一索引，其他字段的索引都是要去开发自行添加的，系统没有自动加索引。另外，公有云环境大数据（超过百万）同步一定通知公有云运维安排资源，不然同步性能会比较慢，严重时会引发系统缓慢甚至宕机，请务必知会到项目组每个人。

2021/06/29集成重要通知

■ 苍穹PG库适配（集成服务云SQL和脚本类型的值转换规则修改）

背景：PG 数据库需要声明字段类型

影响范围：系统为PG库，且参数是bigint为where过滤条件的值转换规则，SQL\脚本类型的值转换规则，源对象是苍穹。

现象：部分值转换规则在PG库转换异常“错误：运算符不存在：bigint =字符变化提示：没有运算符匹配给定的名称和参数类型。您可能需要添加显式类型转换。”

解决方法：https://vip.kingdee.com/article/197635238066408704

2021/05/31集成重要通知

■ EAS单据反写报错( EAS-苍穹) 同步，触发日志异常

背景：公有云网络从CDN切换到WAF后，部分集成服务云的用户出现，EAS单据反写报错( EAS-苍穹) 同步异常。

适用对象：（EAS-苍穹）的集成用户，苍穹公有云，苍穹是HTTPS访问。

现象：EAS单据反写报错( EAS-苍穹) 同步，触发日志异常。并非每个客户一定会有异常现象，如出现异常，可以联系我们进一步沟通。

解决方法：https://vip.kingdee.com/article/187122533018638848

2021/03/26集成重要通知

■ 费用报销单同步EAS报错“申请核销分录的费用类型不能为空”

原因分析：EAS新补丁增加了申请核销分录费用类型必录，之前的预置方案里并没有传这个字段

解决方法：https://vip.kingdee.com/article/163423768931538688

2021/03/23集成重要通知

■ 苍穹物料实体变更导致物料列表显示多个相同物料记录（多分类标准的场景）

原因分析：原来的方案只同步了EAS物料单据头的分类，没有同步分录的分类。因此需要修改物料同步数据集成方案中的字段映射关系。

异常表现：苍穹一个物料显示出多条相同记录

解决方法：https://vip.kingdee.com/article/161907886950520576

2021/02/08集成重要通知

■ 业务类别、费用项目同步异常，提示“请填写控制类型”

原因分析：目标端苍穹"费用项目"增加了必填字段“控制类型”，导致原有的方案同步不过去。

异常表现：保存 06: 请填写“控制类型”。kd.isc.iscb.util.except.IscBizException: 保存 06: 请填写“控制类型”。

解决方法：https://vip.kingdee.com/article/146555817049558528

2020/12/10集成重要通知

■（EAS-苍穹）方向附件同步，超过4m的附件在苍穹端打开时部分附件页面无法正常查看。

原因分析：分块存储附件逻辑Bug

异常表现：超过4m的附件在苍穹端打开时部分附件页面无法正常查看

解决方法：更新EAS的SP包“isc-iscb-connector-eas.jar”(\eas\server\lib\sp)

获取路径 : https://vip.kingdee.com/article/124814620421712896

部署说明：

1. 停止EAS服务器

2. 备份包 isc-iscb-connector-eas (\eas\server\lib\sp)

3. 获取包后替换同名包isc-iscb-connector-eas

4. 重启EAS服务器

注意事项：

用到附件集成的才需要关注，并且是EAS-苍穹同步方向且是4m以上的附件。
测试通过没有问题后再更新正式。
EAS的sp包需要匹配苍穹版本V2.0.039（BIZ），如果苍穹版本不是039的，请找郭玲单独获取EAS的class包RetrieveAttachment.class。
附件补偿同步方案，请参考文档 https://club.kdcloud.com/article/48078516092789760第6部分，EAS-苍穹同步方向。

我们对此给您带来的不便深表歉意。

2020/11/13集成重要通知

■费用报销单相关单据反写异常

背景：更新V2.0.039后部分单据反写异常

原因分析：部分从EAS同步数据到苍穹的方案将EAS的单据ID直接赋值给了苍穹的单据ID，在使用ID查询单据时，由于MYSQL对数据类型检查不严格，不会发生异常，只是找不到单据，而在后续根据候选键查询单据时可以正常找到单据，掩盖了错误的ID赋值问题（虽然不会报错，但在数据表中记录很多时会严重影响系统性能）。在V2.0.039补丁中我们对单据ID进行了类型校验，因此赋予错误ID值的方案不能正常执行了。

我们对此给您带来的不便深表歉意。

异常日志：java.lang.IllegalArgumentException: 无法将属性id的值lDbG6/GASu22SRpwBNYDW0pE9J8=转换为class kd.bos.entity.property.LongProp类型!

解决方法：https://vip.kingdee.com/article/115027513272609024

2020/10/20集成重要通知

■人员初始化异常解决方法

背景：人员表之前的设计字段长度不够，ID生成增长超位数导致人员初始化异常。

异常：Data too long for column 'FID' at row 1

解决方法：https://vip.kingdee.com/questions/106400321365901056/answers/106400321382678272

2020/10/20集成重要通知

■成本中心初始化方案调整

背景：业务方调整了成本中心，新增加了一个类型字段"showorgduty",导致原有的成本中心初始化异常。

方案配置调整方法：https://vip.kingdee.com/questions/106322130144340224/answers/106322130161117440

2020/7/30集成重要通知

■差旅报销单提交同步方案调整

由于产品迭代，补丁（V2.0.032）开始，交通工具支持多选，会导致差旅报销单集成方案中原来取交通工具的字段取不到值，同步到eas时会报“交通工具不能为空！”。请使用了差旅报销单提交同步方案的小伙伴参考这个帖子。https://vip.kingdee.com/questions/74496191223895552/answers/74496191676782848

2020/7/30集成重要通知

■客户分类、供应商分类、物料分类同步数据集成方案调整

https://club.kdcloud.com/article/76601456031248384

苍穹业务补丁号：V2.0.033

背景：客户、物料、供应商的业务开发部门调整了物料分类、客户分类、供应商分类基础资料，新增了一个必填字段“创建组织”，所以需要同步调整数据集成方案。

2020/7/24集成重要通知

更新补丁V2.0.032（BIZ）后，部分环境出现数据集成方案打开异常的问题

调用堆栈：

java.lang.NullPointerExceptionat kd.isc.iscb.formplugin.dc.tree.AbstractTemplateTreePlugin.initTree(AbstractTemplateTreePlugin.java:230)atkd.isc.iscb.formplugin.dc.tree.AbstractTemplateTreePlugin.afterCreateNewData(AbstractTemplateTreePlugin.java:70)

原因分析：缓存里面的参数没命中导致数据集成方案的左树没有加载出来

临时解决方法：配置工具-系统参数，保存一下系统参数