- 最新动态
- 功能总览
- 产品介绍
- 计费说明
- 快速入门
-
用户指南(低代码)
- AstroZero低代码使用流程
- 授权用户使用AstroZero并购买实例
- 添加AstroZero开发者用户
- 使用AstroZero创建应用
-
使用AstroZero开发应用后端
- 应用后端开发概述
- 对象
- 事件
- 脚本
-
服务编排
- AstroZero服务编排概述
- 创建空白AstroZero服务编排
- 定制已有AstroZero服务编排
-
为AstroZero服务编排设置图元
- 为AstroZero服务编排添加子服务编排图元
- 为AstroZero服务编排添加脚本图元
- 为AstroZero服务编排添加记录创建图元
- 为AstroZero服务编排添加记录删除图元
- 为AstroZero服务编排添加记录查询图元
- 为AstroZero服务编排添加记录更新图元
- 为AstroZero服务编排添加发送邮件图元
- 为AstroZero服务编排添加发送事件图元
- 为AstroZero服务编排添加赋值图元
- 为AstroZero服务编排添加循环图元
- 为AstroZero服务编排添加跳出循环图元
- 为AstroZero服务编排添加决策图元
- 为AstroZero服务编排添加等待图元
- 为AstroZero服务编排添加BO图元
- 为AstroZero服务编排添加连接器图元
- 为AstroZero服务编排添加生成文档图元
- 管理AstroZero服务编排
- 自定义AstroZero服务编排的URL
- 触发器
- 工作流
- 定时任务
-
使用AstroZero开发应用前端
- 应用前端开发概述
-
标准页面
- AstroZero标准页面概述
- 创建空白AstroZero标准页面
- 使用模板创建AstroZero标准页面
- 为AstroZero标准页面添加组件
-
设置AstroZero标准页面组件属性
- 设置AstroZero标准页面容器组件属性
- 设置AstroZero标准页面表单组件属性
- 设置AstroZero标准页面表格组件属性
- 设置AstroZero标准页面分栏组件属性
- 设置AstroZero标准页面栅格容器组件属性
- 设置AstroZero标准页面列表视图组件属性
- 设置AstroZero标准页面表格(新)组件属性
- 设置AstroZero标准页面图片组件属性
- 设置AstroZero标准页面二维码组件属性
- 设置AstroZero标准页面分页组件属性
- 设置AstroZero标准页面模态框组件
- 设置AstroZero标准页面输入框组件属性
- 设置AstroZero标准页面下拉框组件属性
- 设置AstroZero标准页面按钮组件属性
- 设置AstroZero标准页面上传组件属性
- 设置AstroZero标准页面面包屑组件属性
- 设置AstroZero标准页面视频播放组件属性
- 添加事件实现AstroZero组件间交互
- 添加库扩展AstroZero标准页面功能
- 查看AstroZero标准页面性能
- 调测AstroZero标准页面
- 将AstroZero标准页面保存为模板
- 管理AstroZero标准页面
-
高级页面
- AstroZero高级页面概述
- 创建AstroZero高级页面
- 为AstroZero高级页面添加组件
-
设置AstroZero高级页面预置组件属性
- 设置AstroZero高级页面轮播组件属性
- 设置AstroZero高级页面图片组件属性
- 设置AstroZero高级页面文本编辑组件属性
- 设置AstroZero高级页面自定义背景框组件属性
- 设置AstroZero高级页面基本柱图组件属性
- 设置AstroZero高级页面基本折线图组件属性
- 设置AstroZero高级页面基本饼图组件属性
- 设置AstroZero高级页面水位图组件属性
- 设置AstroZero高级页面散点图组件属性
- 设置AstroZero高级页面雷达图组件属性
- 设置AstroZero高级页面仪表盘组件属性
- 设置AstroZero高级页面翻牌器组件属性
- 设置AstroZero高级页面路由导航和路由视图组件属性
- 为AstroZero高级页面添加自定义组件
- 为AstroZero高级页面组件绑定数据
- 添加事件或宏实现AstroZero高级页面组件交互
- 调测AstroZero高级页面
- 查看AstroZero高级页面性能
- 管理AstroZero高级页面
- 报表
- 使用AstroZero进行应用集成开发
- 使用AstroZero对应用进行个性化设置
- 发布并部署AstroZero开发的应用
- 管理AstroZero中已安装的应用
- AstroZero低代码平台管理中心
-
经典版开发指导
- 经典版入门必读
- 应用
- 对象
- 标准页面
- 高级页面
- 服务编排
- 脚本开发
- BPM服务编排
- API接口
- 集成开发
- 消息事件
- 触发器
- 报表和仪表板
- CICD持续集成与交付
- 服务组件(BO)
- 调测能力
- 工程能力
- 原生服务
- 其他功能
- 管理中心
- 白名单特性
- 用户指南(零代码)
- 最佳实践
- API参考
-
常见问题
- 高频常见问题
- 产品咨询类
-
应用后端开发
- 如何区分不同账户间的数据库对象?
- 在AstroZero对象中删除字段后重新创建时,引用的地方报错
- 如何刷新AstroZero对象的页面布局?
- 如何彻底删除AstroZero应用目录树中的数据?
- AstroZero自定义对象预置的owner字段,用于记录什么用户?
- AstroZero脚本支持使用哪些语言和库?
- 在AstroZero脚本中执行sql语句时,可以不用@useObject修饰数据对象吗?
- 在AstroZero脚本中,如何返回zip压缩文件内容?
- 如何通过AstroZero脚本,导出xls文件让用户下载?
- AstroZero脚本中是否支持multipart/form-data请求?
- AstroZero服务编排中涉及数据操作的脚本图元,在其他图元操作失败的情况下,是否可以回滚?
- 事件触发的AstroZero服务编排,发送事件后,服务编排没有运行?
- 在AstroZero服务编排或工作流中,引用的资源无法编辑
- 如何实现一个资源被多个AstroZero应用的服务编排调用?
- 在AstroZero服务编排中,支持跨应用引用资源吗?
- 在AstroZero服务编排、工作流或脚本中,邮件发送功能不可用?
- AstroZero开发者如何使用自己的邮箱发送邮件?
-
应用前端开发
- 在AstroZero标准页面中,如何调用服务编排或脚本?
- 在AstroZero标准页面组件较多时,如何快速选中组件?
- 表格字段太多,导致AstroZero标准页面无法完整显示,该如何处理?
- 在AstroZero标准页面中,如何实现有子表的表格?
- 在AstroZero标准页面中,如何实现下拉框选项值的筛选功能?
- 在AstroZero标准页面中,如何实现移动端上拉异步加载数据功能?
- 如何查看AstroZero标准页面的URL格式?
- 在AstroZero标准页面弹窗的onOk事件中,不想关闭弹窗该怎么处理?
- 在AstroZero中编排高级页面时,如何实现不加载组件库资源?
- 在AstroZero中自定义高级页面组件(widget)时,修改了JS文件,修改部分不生效?
- 在AstroZero组件库中,部分组件在组件详情页看不到更新和编辑入口
- 在AstroZero高级页面中,如何进行统一的HTTP状态拦截?
- 配置高级页面组件桥接器实例属性时,如何设置下拉框中的选项值?
- 在AstroZero高级页面中,如何实现所有组件都加载完成后,再执行某段逻辑?
- 在AstroZero中,如何实现多人协作开发?
- 在AstroZero运行环境中,如何实现游客访问标准页面?
- 应用发布与部署
- Astro轻应用平台管理中心
- 视频帮助
- 文档下载
- 通用参考
链接复制成功!
对接华为云ROMA Connect
背景信息
应用与数据集成平台(ROMA Connect)是一个全栈式的服务平台,聚焦应用和数据连接,提供数据(跨机房、跨数据中心、跨云的数据)、服务API(将数据和后端服务以API形式开放)、消息(为企业提供跨网络访问的安全、标准化消息通道)和设备信息(使用MQTT标准协议连接设备,帮助企业快速、简单地实现设备云端管理)集成能力,帮助企业快速联接云上云下,消除数字鸿沟,实现数字化转型。
AstroZero通过连接器和ROMA Connect对接后,可调用ROMA Connect的API,从而集成服务。
AstroZero提供了默认对接的ROMA Connect服务器,也支持对接通过华为云开通的自有ROMA Connect实例控制台,即参考配置ROMA Connect中操作,在AstroZero管理中心配置对接信息,并请从华为云控制台登录自有ROMA Connect实例。
前提条件
本章节以AstroZero对接自有ROMA Connect为例进行说明,默认对接的ROMA Connect服务器配置类似。
- 已在ROMA Connect平台上完成应用创建(创建时,应用的“Key”字符长度必须小于60,否则后续向AstroZero同步时会失败)、函数API创建、API分组创建、API创建、调试、发布和授权操作。关于ROMA Connect的具体操作,请参见使用ROMA Connect集成服务与配置API授权。
如图1所示,已在ROMA Connect平台创建“人员管理”应用。如图2所示,已发布“获取人员信息”API,且该API已授权给“人员管理”应用。
- 已在ROMA Connect平台上,设置“app_secret”和“app_route”值为“on”。
修改方法:在ROMA Connect实例控制台的“实例信息”页面,选择“配置参数”。修改“app_secret”和“app_route”的“参数运行值”为“on”。
在AstroZero上调用ROMA Connect的API
在ROMA Connect上创建的应用和发布的API,可以直接同步到AstroZero。通过AstroZero的ROMA Connect类型连接器,可在服务编排或脚本中调用ROMA Connect的API。
- 查看ROMA Connect侧创建的应用Key值是否带有前缀,如果带有前缀,则需要在AstroZero新建系统参数。
- 在ROMA Connect实例控制台左侧的导航栏中,选择“集成应用”,单击应用名,即图4中应用名“人员管理”,进入概览页面查看Key值。
- 新建系统参数。
- 登录AstroZero经典版环境配置。
- 在左侧导航栏中,选择“系统管理 > 系统参数”。
- 单击“新建”,创建系统参数“roma_app_prefix”,配置参数值为此前缀取值“test__”,AstroZero在后续同步API和调用API时会主动拼上此前缀。
图3 创建系统参数
- 在连接器中同步ROMA Connect应用和API,并查看具体API。
- 参考创建连接器入口中操作,进入创建连接器页面。
- 在左侧列表中,选择“HTTP > ROMA连接器”。
- 单击“同步应用”,将ROMA Connect平台上注册的应用直接同步到平台。
同步后,可在ROMA Connect连接器列表中,查看到“人员管理”应用。
图5 查看人员管理应用说明:
ROMA Connect连接器中的应用,可以由ROMA Connect同步而来,也可以通过安装包导入。通过安装包导入的ROMA Connect连接器中的应用,在ROMA Connect平台并不存在。需要将ROMA Connect资产导入到ROMA Connect平台,用户才可正常使用ROMA Connect连接器。
- 单击“人员管理”对应的连接器名称,在右侧“API接口”页签单击“同步API”,将ROMA Connect平台上发布并授权的API直接同步到平台。
同步后,在“API接口”页签中,可查看到“获取人员信息”API。
图6 获取人员信息API - 单击API名称,可查看API具体信息,包括基本信息、消息头入参、输入和输出参数。
说明:
如果ROMA Connect平台上该API有更新,请在ROMA Connect平台重新发布并授权API,然后在平台重新同步应用和API。
图7 查看API具体信息API参数说明,如表1所示。
表1 API参数说明 参数类别
参数名称
说明
消息头入参
X-HW-APPKEY
X-HW-APPKEY:ROMA应用的请求密钥,用于私钥认证。
- 登录ROMA Connect实例控制台。
- 在左侧导航栏中,选择“集成应用”。
- 单击应用名,即2.c中应用名“人员管理”,进入概览页面。
- 单击Secret右侧的
,即可查看Secret信息。
X-HW-ID
ROMA应用的Key值。
- 登录ROMA Connect实例控制台。
- 在左侧导航栏中,选择“集成应用”。
- 单击应用名,即2.c中应用名“人员管理”,进入概览页面。
- 在概览页,查看Key值。
Accept
接收类型,默认值“application/json”。
输入参数
userID
用户ID,为自定义输入参数。
输出参数
retCode
结果码。
retJSON
接收JSON格式化的ROMA Connect返回数据。
$out
接收非格式化的ROMA Connect返回数据。
须知:对于POST请求类型,输入参数会有“$body”,通过此入参传递body结构体。可使用出参“$out”接收非格式化的ROMA Connect返回数据,$out为结构体类型。
如果业务需要在API中,增加其他消息头入参或输入参数,需要在ROMA Connect的API管理侧重新编辑API,定义好入参,重新发布并授权API,然后在AstroZero重新同步该API。
图8 ROMA Connect的API管理侧编辑API图9 添加入参
在服务编排中调用ROMA Connect的API
- 参考如何开发服务编排中操作,创建一个服务编排。
- 在服务编排设计页面左侧,选择“连接器 > ROMA”,拖拽“人员管理”(连接器名称为ROMA应用名称)图元至画布中。
图10 拖拽连接器图元到画布中
- 参考表1,设置变量和服务编排的输入输出参数。
- 选中开始图元,在服务编排设计页面右侧,选择
。
- 在私有结构体页面,单击“新增”。
- 新增一个空的私有结构体“retJson”,不用设置结构体成员。
图12 新建私有结构体
- 在服务编排设计页面右侧,选择
。
- 在全局上下文页面,单击“对象变量”后的加号。
图13 添加对象变量
- 选择“私有结构体”,设置页面参数,名称为“retJson”,结构体选择已创建的私有结构体“retJson”。
图14 配置私有结构体变量
- 参照上述操作,新增“out”私有结构体变量,结构体选择创建的私有结构体“out”。
图15 对象out对象变量
- 在服务编排设计页面右侧,选择
。
- 在全局上下文页面,单击“变量”后的加号,新增图17中两个变量。
图16 创建变量
- 单击工作区域开始图元或空白区域,在服务编排设计页面右侧,选择
,设置该服务编排的入参和出参。
图18 设置服务编排的入参和出参 - 参考配置系统参数中操作,新建系统参数“appkey”,值填写为ROMA应用的请求密钥。
由于“X-HW-APPKEY”为ROMA应用的请求密钥,可能发生变化,您可以新建系统参数,加密存储此入参,并通过公式引用。当请求密钥变化时,修改系统参数即可。
图19 新建系统参数appkey - 在服务编排设计页面右侧,选择
。
- 在全局上下文页面,单击“公式”后的加号,新建公式变量“appkey”,表达式为“SYSPARAMETER("appkey")”。
图20 新建公式变量
- 选中开始图元,在服务编排设计页面右侧,选择
- 在“连接器”页面进行配置,“动作”选择具体调用的API,例如“获取人员信息”,根据表1配置入参和出参,并连接图元。
图21 设置动作连接图元
- 动作:具体调用的API,API选项由2.d同步而来。
- 输入参数:调用API的输入参数。
- 输出参数:调用API的输出参数。
- 单击服务编排页面上方的
,保存服务编排。
- 保存成功后,单击编辑器页面上方的
,执行服务编排。
- 设置如下输入参数,单击“运行”。
输入参数样例如下:
{ "userid": "001" }
若显示如下信息,表示成功调用ROMA Connect的API。
{ "interviewId": "002N000000cOeh5XCDrc", "outputs": { "out": { "retCode": "0", "retJSON": { "result": { "employ_name": "zhangsan", "employ_no": "00xxxxxx" } } }, "retCode": "0", "retJson": { "result": { "employ_name": "zhangsan", "employ_no": "00xxxxxx" } } } }