苍穹微服务登记
变更记录
| 产品版本 | 更新内容 | 更新日期 |
| V6.0.002 | 增加启用启动方和禁用启动方案的微服务接口 | 2023年10月20日 |
| V7.0.1 | 更新菜单路径 | 2024年8月 |
1 简介
1.1 功能介绍
当前集成云支持定义苍穹微服务，并在自定义API和服务流程等场景引入使用。
1.2 应用场景
苍穹微服务目前支持输入参数为：String, Boolean, Long, Integer, Timestamp, Double, BigDecimal, List（列表）, Map（结构）, Object[]（数组，只支持通用型，具体类型的数组暂不支持）的微服务。其他类型不支持。
注意：在微服务调用时，务必提供准确的数据类型。
1.3 系统路径
【集成管理】→【API集成】→【API登记】→【苍穹微服务登记】
1.4 字段/按钮说明
字段说明
| 字段名称 | 详细解释 |
| 编码 | 微服务编码 |
| 名称 | 微服务名称 |
| 分类 | 所属自定义分类 |
| 编码 | 微服务编码 |
| 不发布到开放平台 | 选择是否发布到开放平台 |
| 记录API调用日志 | 选择是否记录调用日志 |
| 需要授权 | 选择是否需要 |
| 禁止记录追溯信息 | 选择是否禁止记录追溯信息 |
| 校验参数格式 | 调用时校验输入参数格式 |
| API参数摘要模板 | 用于提取API输入参数中的关键内容 |
| API结果摘要模板 | 用于提取API输出结果中的关键内容 |
| 使用状态 | API启用\禁用状态 |
| 备注 | 自定义备注 |
按钮说明
| 按钮名称 | 详细解释 |
| 保存 | 保存API |
| 修改 | 修改API |
| 启用\禁用 | 控制启用\禁用 |
| 测试 | 输入集成测试密码测试，公有云仅可通过postman调用进行测试 |
| 生成PDF/WORD | 支持生成PDF或WORD文档 |
| 日志 | 若开启记录API调用日志，则会记录调用信息 |
| 历史版本 | 支持查看该API历史版本 |
| 批量登记 | 支持批量登记二开的微服务 |
| 导入集成云微服务 | 批量导入集成服务云内置的微服务 |
2 主要操作
2.1 微服务定义
接口信息
平台：cloudId默认为bos
业务：cloudId根据实际情况填写
二开微服务：cloudId为ServiceFactory类限定前缀；
如：服务工厂类全名为EnterpriseID.mservice.test.ServiceFactory，则cloudId为EnterpriseID.mservice.test
参数类型
目前支持输入参数为【String, Boolean, Long, Integer, Timestamp, Double, BigDecimal, List（列表）, Map（结构）, Set（集合）Object[]（数组，只支持通用型，具体类型的数组暂不支持）的微服务】，其他类型不支持。
在微服务调用时，务必提供准确的数据类型。
微服务类别：包含3类，平台、业务、二开；
云ID或工厂类前缀：
应用ID: appId，根据实际情况填写；
服务名称：服务工厂类注册的微服务名称；
方法名：微服务方法名。
2.2 批量登记微服务
1）批量登记二开的微服务
点击'新增'下拉按钮中的“批量登记”按钮，填写二开的应用ID和工厂类全路径名，点击“确定”按钮，即可同步该工厂类下定义的所有微服务。
2）点击'新增'下拉按钮中的‘导入集成云微服务’可以导入集成云已经预置好的微服务接口。
2.3 微服务列表（仅供测试）
平台的微服务（bos）
cloudId | appId | serviceName | 接口说明 | 接口全名 |
bos | bos | MetadataService | 获取元数据运行期版本 | public String getRuntimeMetadataVersion(String number) |
bos | bos | MetadataService | 获取应用信息 | public String loadAppInfo(String number) |
bos | devportal | BizAppService | 获取所有应用信息 | public String getAllAppInfo() |
bos | bos | ApiService
| 检验APP | public Boolean checkAppByAppNumber(String appNumber) |
业务微服务（biz）以集成为例
| cloudId | appId | serviceName | 接口全名 |
isc | iscb | ISCDataCopyService | Map<String, Object> execute(String trigger_number, Map<String, Object> params, Map<String, Object> callback); |
无参数执行启动方案 | Map<String, Object> execute(String trigger_number, Map<String, Object> callback); | ||
根据编码获取执行状态 | Map<String, Object> getExecutionState(String execution_number); | ||
批量获取执行状态 | List<Map<String, Object>> getExecutionStateList(List<String> executions); | ||
同步接口，通过方案number和过滤参数查询源数据 | Map<String, Object> pull(String trigger_number, Map<String, Object> filter_params); | ||
查找目标单ID | Map<String, Object> lookupTargetOid(String src_oid, String src_cn_number, String src_table, String target_cn_number, | ||
查找单据的最后集成日志ID | Map<String, Object> findLastLog(String cn_number, String table_name, String oid); | ||
根据执行id查询日志 | Map<String, Object> queryExecutionLogs(String executionId, int limit); | ||
根据日志id重试 | Map<String, Object> retryLog(String logId); | ||
根据值转换规则编码及原始值查找转换后结果 | Map<String, Object> findMappingValue(String ruleNumber, String value, int extendType); | ||
同步接口，通过方案number和过滤参数同步执行启动方案 | Map<String, Object> syncExecute(String trigger_number, Map<String, Object> filter_params); | ||
通过方案编码获取连接信息 | DynamicObject getConnInfoByTriggerNumber(String trigger_number, boolean isSrc); | ||
连接器配置-测试 | Map<String, Object> testConnection(String number); | ||
执行结果重做 | Map<String, Object> redoExecution(long id); | ||
执行结果撤 |
苍穹微服务登记
声明：除非特别标注，否则均为本站原创文章，转载时请以链接形式注明文章出处。如若本站内容侵犯了原著者的合法权益，可联系本站删除。
