1金蝶云苍穹·集成服务云API集成加速器金蝶云苍穹·集成平台服务部2022.10.292加群3提纲1.介绍2.API开发3.API配置4.API监控5.API任务6.API演示4介绍作为苍穹系统与外部第三方系统的对接桥梁，集成服务云既可以调用外部API，也可以暴露API供外部调用。数据集成方案转API集成对象转API服务流程转API值转换规则转API苍穹微服务登记外部系统API登记启动方案转API自定义API5调用外部接口能力集成服务云提供了一系列API接口调用相应基础设施，包括常用的HTTP调用、加解密脚本函数等。6常用HTTP脚本函数7常用加解密脚本函数8开放能力集成平台提供丰富的开放能力和解决方案，将集成资源封装成OpenAPI供外部系统调用9业务云调用集成API苍穹内部调用集成资源时，直接通过微服务接口调用即可。10微服务接口11提纲1.介绍2.API开发3.API配置4.API监控5.API任务6.API演示12提示：完成此项工作或具备完成此项工作的能力是使用WebAPI集成的必要条件API开发–WebAPI开发准备工作对接外部系统基本逻辑：登陆、调用，定时会话刷新、状态检查等使用自己熟悉的语言（例如：Java、C#）进行开发或者通过postman先测试调用正常：1、开发好外部系统的登录代码，测试通过；2、开发好外部系统的会话刷新代码，测试通过；3、开发好外部系统的API调用代码，测试通过；此项工作重点在于搞清楚该系统API调用的特点，某些系统的API参数或结果可能不具有统一风格，此处只应处理全部API调用中相同的部分或能按某种规则分类处理；4、开发好外部系统的是否在线的检查代码，测试通过。13API开发–自定义连接器登记与连接配置集成已经预置60余种连接类型。若需要登记新的自定义连接器，可参考以下文档，开发好该类型的连接配置表单布局及相关脚本：https://club.kdcloud.com/school/89389204685524480?productLineId=29&isKnowledge=2&islogin=truehttps://club.kdcloud.com/school/154510041754702080?productLineId=29&isKnowledge=214集成云提供了Restful接口的通用WebAPI连接器实现，但需要针对特定系统配置后才能使用。打开“集成管理”，通过菜单“连接管理–连接类型”打开连接类型列表。其中：企业微信，云之家，WebAPI-DEMO，京东，苏宁，西域，钉钉，WeLink属于WebAPI类连接器API开发–WebAPI连接器15如果第三方系统提供了Restful接口的API，可以通过配置自定义第三方系统的连接器，扩展集成云的连接能力。WebAPI的主要配置有4项：会话登录脚本（建立会话，获取会话信息）、会话刷新脚本（维持会话不失效）、API调用脚本（处理API调用细节及错误处理）、服务器状态测试脚步（检查服务器是否可以连通）。提示：配置表单字段建议使用“isc_database_link_webapi”，这是WebAPI类连接器的标准配置界面。API开发–WebAPI连接器16上面是云之家的会话登录脚本；返回结果中需要包含$refreshTime值指示下次调用会话刷新脚本的时间。会话登录脚本可以访问的内置变量如下：$protocal连接配置登记的HTTP协议，赋值通常是：http或https；$ip连接配置登记的服务器IP地址或域名；$port连接配置登记的Web服务端口，http的默认端口是80，https的默认端口是443；$user连接配置登记的用户名；$password连接配置登记的登录密码；$data_center账套（数据中心）$lang语言，当前取值为：zh_CN,zh_TW,en_US。API开发–WebAPI连接器（会话登录脚本）varurl=$protocal+"://"+$ip+":"+$port+"/gateway/oauth2/token/getAccessToken";varparam={"eid":$user,"secret":$password,"timestamp":LNOW,"scope":"resGroupSecret"};varsession=HttpInvoke(url,param).result.data;session.$refreshTime=L(NOW)+session.expireIn*1000-30000;//设置会话刷新时间returnsession;脚本中还可以访问的当前连接的配置信息：varnumber=this.number;//当前连接的编码varip=this.server_ip;//当前连接的IPvardata_center=this.data_center;//当前连接的账套varclient=this.attr2;//SAP连接的Clientvareid=this.user;//云之家企业ID更多属性参考连接配置的界面元数据，例如：isc_database_link_sapisc_database_link_yzj17会话刷新脚本可以访问的内置变量如下：$protocal连接配置登记的HTTP协议，赋值通常是：http或https；$ip连接配置登记的服务器IP地址或域名；$port连接配置登记的Web服务端口，http的默认端口是80，https的默认端口是443；$user连接配置登记的用户名；$password连接配置登记的登录密码；$data_center账套（数据中心）$lang语言，当前取值为：zh_CN,zh_TW,en_US$session会话信息，由会话登录脚本返回。API开发–WebAPI连接器（会话刷新脚本）varurl=$protocal+"://"+$ip+":"+$port+"/gateway/oauth2/token/refreshToken";varparam={"eid":$user,"refreshToken":$session.refreshToken,"timestamp":LNOW,"scope":"resGroupSecret"};varsession=HttpInvoke(url,param).result.data;session.$refreshTime=L(NOW)+session.expireIn*1000-30000;//设置会话刷新时间returnsession;脚本中还可以访问的当前连接的配置信息：varnumber=this.number;//当前连接的编码varip=this.server_ip;//当前连接的IPvardata_center=this.data_center;//当前连接的账套varclient=this.attr2;//SAP连接的Clientvareid=this.user;//云之家企业ID更多属性参考连接配置的界面元数据，例如：isc_database_link_sapisc_database_link_yzj18API开发–WebAPI连接器（API调用脚本）useString;varurl=$protocal+"://"+$ip+":"+$port+$service+"?accessToken="+$session.accessToken;varparam="eid="+$user+"&data="+URLEncode(FormatJson($params));varresult=ParseJson(HttpPost(url,param,"UTF-8").result);if(!result.success){throw(result.error+"\n错误号："+result.errorCode);}else{returnresult.data;}云之家API调用脚本可以访问的内置变量如下：$protocal连接配置登记的HTTP协议，赋值通常是：http或https；$ip连接配置登记的服务器IP地址或域名；$port连接配置登记的Web服务端口，http的默认端口是80，https的默认端口是443；$user连接配置登记的用户名；$password连接配置登记的登录密码；$data_center账套（数据中心）；$lang语言，当前取值为：zh_CN,zh_TW,en_US；$paramsAPI输入参数（Key/Valu结构）；$session会话信息，由会话登录脚本返回。脚本中还可以访问的当前连接的配置信息：varnumber=this.number;//当前连接的编码varip=this.server_ip;//当前连接的IPvardata_center=this.data_center;//当前连接的账套varclient=this.attr2;//SAP连接的Clientvareid=this.user;//云之家企业ID更多属性参考连接配置的界面元数据，例如：isc_database_link_sapisc_database_link_yzj19API开发–WebAPI连接器（服务器状态测试脚本）varurl=$protocal+"://"+$ip+":"+$port+"/gateway/oauth2/token/getAccessToken";returnHttpPost(url,null,"UTF-8");//该脚本执行不抛出异常，则集成平台认为被调用的系统可用服务器状态测试脚本可以访问的内置变量如下：$protocal连接配置登记的HTTP协议，赋值通常是：http或https；$ip连接配置登记的服务器IP地址或域名；$port连接配置登记的Web服务端口，http的默认端口是80，https的默认端口是443；$user连接配置登记的用户名；$password连接配置登记的登录密码；$data_center账套（数据中心）$lang语言，当前取值为：zh_CN,zh_TW,en_US。脚本中还可以访问的当前连接的配置信息：varnumber=this.number;//当前连接的编码varip=this.server_ip;//当前连接的IPvardata_center=this.data_center;//当前连接的账套varclient=this.attr2;//SAP连接的Clientvareid=this.user;//云之家企业ID更多属性参考连接配置的界面元数据，例如：isc_database_link_sapisc_database_link_yzj20连接类型开发完成后，再登记被集成系统的连接配置和数据源。菜单：连接管理–连接配置，点“新增”，在新增界面选择新开发的连接器类型。API开发–连接配置21API开发-连接器更多自定义连接器介绍请参考https://club.kdcloud.com/knowledge/specialDetail/136524013400082176?category=136538277556786944&id=15570445934224358422API开发-外部系统API登记https://club.kdcloud.com/school/84327409415001600外部系统API提供的API调用方式是通过集成云的连接器或者API调用脚本（WebApi连接器）解析并识别配置中的接口标志，调用对应的API。23API开发-自定义APIhttps://club.kdcloud.com/school/84658930810735104在自定义API中，用户可以通过编写API脚本，灵活定义数据处理的方式，降低了在多系统之间存数和取数的难度24调用外部系统方案决策：1、外部系统API：仅1次API调用且接口不需要适配2、自定义API：包含多次API调用，且接口需要适配3、服务编排：复杂编排逻辑或网络环境恶劣需要重试25集成资源转API供外部调用1、苍穹微服务2、集成对象转API3、数据集成方案转API4、启动方案转API5、值转换规则转API6、服务流程转API26API开发-苍穹微服务登记登记苍穹微服务，并在自定义API和服务流程等场景引入使用。https://club.kdcloud.com/school/14690888411476121627API开发-集成对象转APIhttps://club.kdcloud.com/article/18363228API开发-数据集成方案转APIhttps://club.kdcloud.com/article/1836151.从来源系统取数并转换为目标单数据输入：集成方案的参数值输出：转换后的目标单数据2.将源单数据转换为目标单数据输入：源单数据输出：转换后的目标单数据3.将源单数据转换后推送到目标系统输入：输入源单数据data（可以为列表）输出：各数据的执行结果id,type,errorMessage，如果一条数据异常，将抛出异常4.从来源系统取数推送到目标系统输入：源单过滤条件输出：各数据的执行结果id,type,errorMessage，如果一条数据异常，将抛出异常29API开发-启动方案转APIhttps://club.kdcloud.com/article/466321606197248001.从源系统查询数据同步到目标系统输入：启动方案参数输出：任务ID2.向将推送的源单数据同步到目标系统输入：集成方案源对象字段输出：任务ID3.根据任务ID查询任务执行状态输入：任务ID，查询类型,任务命令输出：任务的查询结果30API开发-值转换规则转APIhttps://club.kdcloud.com/school/8966874452781004831API开发-服务流程转APIhttps://club.kdcloud.com/school/121558918710471168无实例模式：服务流程转API增加“无流程实例模式”，以减少数据库存储占用，提高执行性能。勾选启用无实例模式后，流程实例列表不生成记录，提高执行性能并且不记录在数据库表。异步模式：服务流程转API增加异步模式，防止数据量较大时处理数据超时。异步模式默认关闭，不可与无实例模式同时打开。32提纲1.介绍2.API开发3.API配置4.API监控5.API任务6.API演示33常用API配置34提纲1.介绍2.API开发3.API配置4.API监控5.API任务6.API演示35API监控记录调用集成API的情况。36提纲1.介绍2.API开发3.API配置4.API监控5.API任务6.API演示37API任务当不希望通过配置数据结构以及集成方案的方式来完成转换和调用业务API，可以采用事件触发、定时或MQ队列中获取数据后直接通过脚本调整好参数这种方式调用业务API。https://club.kdcloud.com/knowledge/specialDetail/136524013400082176?category=136552886351283968&id=12198375914187468838提纲1.介绍2.API开发3.API配置4.API监控5.API任务6.API演示39API演示更多API集成介绍请参考https://club.kdcloud.com/knowledge/specialDetail/13652401340008217640API演示开发一个新的外部连接器基本流程：1、准备工作：参考外部系统的开放文档，先使用自己熟悉的语言（例如：Java、C#）或通过postman进行开发和测试2、新增连接配置的布局元数据3、新增连接类型，配置好布局元数据编码，配置登陆、会话刷新、调用、状态检查脚本等4、登记连接信息5、建立逻辑数据源6、登记外部系统API或自定义API7、测试41代码转换工具https://club.kdcloud.com/article/303891338322545664?productLineId=29&isKnowledge=242API演示金蝶云星辰连接器开发与测试43结束语更多集成云相关知识介绍请参考https://club.kdcloud.com/article/4531244Thanksterimakasih感謝谢谢ありがとうขอบคุณ
