华为云用户手册

  • 异常处理 当数据源类型选择ROMA Connect时,配置完数据接入后,MQS平台收不到消息,业务设置的EventTrigger没有拉起服务编排。 问题现象:ROMA Connect消息轨迹是灰色的,可能是MQS服务地址配置错误或没有配置。 解决方法:检查iotgateway容器的“roma-server”参数是否配置。若没有配置,请配置该参数或联系运维添加正确的“roma-server”地址(端口为“9776”),确认网络正常以及MQS服务器正常,兼容客户端版本。 问题现象:ROMA Connect消息轨迹是红色的,可能是MQS的source定义错误。 解决方法:在ROMA Connect平台,查看应用ID和对应的密钥是否一致,查看该应用是否订阅了主题。配置错误时,会导致鉴权失败。 问题现象:ROMA Connect消息轨迹是绿色的, 表示MQS接收成功,并成功发送到Kafka,华为云Astro轻应用也收到了对应的消息,但是可能没成功拉起服务编排。 解决方法:查看iotgateway的“flume.log”日志,确认MQS是否接收成功。通过“kafka-console-cumer”确认消息是否转换成功,通过华为云Astro轻应用的日志跟踪功能或华为云Astro轻应用后台日志确认(日志关键字为“OnEvent”)平台是否收到事件。如果没有对应的服务编排或事件日志,可以确定服务编排未拉起,请联系华为工程师解决。
  • 如何使用脚本图元 在基本中,拖拽“脚本”图元到右侧画布中。 选中画布中的脚本图元,单击,设置基本信息。 表1 基本信息参数说明 参数 说明 标签 设置图元的标签,用于在服务编排设计页面展示。系统会自动填入该值,格式为Script序号,序号从“0”开始,表示同类型图元序号。 名称 设置图元的名称,名称为图元在服务编排中的标识,请确保在当前服务编排中唯一。命名要求如下: 长度范围为1~80个字符。 必须以英文字母开头,由英文字母,数字或单下划线组成,且不能以下划线结尾。 描述 请根据实际需求,在输入框中输入图元的描述信息。 取值范围:1~255个字符。 单击,选择脚本、设置输入参数和输出参数。 图1 配置脚本 表2 脚本图元配置参数说明 参数 说明 脚本 调用的脚本名称,只有在启用状态下的脚本才能被服务编排调用。 输入参数/目标 脚本的输入参数名称。单击“新增行”,在下拉框中选择脚本输入参数的名称。 输入参数/源 服务编排中的变量,为目标赋值。可直接填写,也可以拖入全局上下文变量,将服务编排中的变量赋值给脚本中的输入参数。 输出参数/源 脚本的输出参数名称。单击“新增行”,在下拉框中选择脚本输出参数的名称。 输出参数/目标 服务编排中的变量,脚本中的输出参数赋值给服务编排中的变量。拖入全局上下文变量,将脚本的输出参数赋值给服务编排中的变量。
  • 前提条件 请联系运维,开启事件流License权限。开启后,才可新建、查看并管理事件流。 已创建并启用温度监测事件“temperature”,该事件中自定义参数为文本类型“position”和数字类型“temperature”,分别表示位置和温度,具体操作步骤请参考如何自定义事件。 已创建并启用高温报警事件“fire_alarm”,该事件中自定义参数为文本类型“positionalarm”和数字类型“temperaturealarm”,分别表示高温报警位置和温度,具体操作步骤请参考如何自定义事件。
  • 背景信息 首先,您需要理解以下概念: kafka:是由Apache开发的一个开源流处理平台,是分布式发布、订阅消息系统。kafka主要用于处理活跃的流数据,一般kafka部署为集群模式。 Topic:用来区分kafka集群中,不同类型消息的主题。例如,应用程序A订阅了Topic1,应用程序B订阅了Topic2而没有订阅Topic1,那么发送到Topic1中的数据将只能被应用程序A读到,而不会被应用程序B读到。 spark streaming:大规模流式数据处理工具,第三方工具。
  • 操作步骤 参考登录经典应用设计器中操作,登录经典版应用设计器。 将鼠标放在应用的某个文件夹上(如Logic),单击“+”,选择“事件流”。 开启事件流License权限后,才会有新建事件流的入口。 单击“新建”,进入“事件流”页面。 在“事件流”页面右侧,单击“设置”,进行数据配置。 图2 设置页面 窗口长度:事件流处理的数据采集时间间隔,单位为分钟。建议时间间隔不要配置过小,否则系统频繁的建表和执行SQL语句,会影响系统性能。例如:配置为“1”表示spark streaming每隔1分钟去kafka获取事件数据。 在“事件流”页面右侧,单击“图元”,拖拽“输入源”中Kafka图元至左侧画布区域,并配置基本信息,单击“保存”。 输入源中Kafka图标表示数据来自Kafka。 图3 数据来源Kafka基本信息页面 标签:新建数据源Kafka的标签名,用于在界面展示。 名称:新建数据源Kafka的名称,系统自动生成。 事件:需要订阅的事件。例如,配置为温度监测事件“temperature”。 从外部接收:是否从外部Kafka接收事件。 关闭该开关,从与AstroZero相连的Kafka接收事件。 打开该开关,从外部Kafka接收事件。本示例中关闭该开关,使用与AstroZero相连的Kafka。 Kafka集群地址:数据源Kafka的集群地址。多个节点服务器地址可用“,”间隔,格式为“Kafka节点1的ip:节点1端口号,Kafka节点2的ip:节点2端口号,...”。 获取Kafka的IP和端口号方法:登录每台Kafka节点服务器,查看“${KAFKA_HOME}/config”目录下,“server.properties”中“listeners”的取值。 订阅主题:获取的事件数据来源,即来自于kafka集群的哪个Topic。 从“图元”中,拖拽“投影”图元至左侧画布区域数据源Kafka下方,并在弹出的“添加投影器”页面配置基本信息,单击“保存”。 图4 “添加投影器”页面 标签:新建投影的标签名,用于在界面展示。 名称:新建投影的名称,系统自动生成。 输入字段:订阅事件的所有事件参数。选择所需的参数,单击,选中的参数会出现在“输出字段”中。 输出字段:从订阅事件的事件参数进行筛选后,用到的事件参数。 从“图元”中,拖拽“过滤”图元至左侧画布区域投影下方,并在弹出的“添加过滤器”页面配置基本信息和过滤条件,单击“保存”。 图5 设置过滤条件 标签:新建过滤的标签名,用于在界面展示。 名称:新建过滤的名称,系统自动生成。 条件设置:设置过滤条件。例如,图中的配置表示提取温度大于60度的事件。 字段:上一步筛选后的事件参数。 比较符:操作符,直接在下拉框中选择。 值:字段值。 (可选)从“图元”页面中,拖拽“分组”图元至左侧画布区域过滤器下方,并在弹出的“添加分组器”页面配置基本信息和分组条件,单击“保存”。 图6 “添加分组器”页面配置 标签:新建分组的标签名,用于在界面展示。 名称:新建分组的名称,系统自动生成。 分组设置:设置分组条件。例如,图中配置表示按照相同位置的大于60度的温度取温度平均值。 在“图元”页面右侧,拖拽输出源中的Kafka图元至左侧画布区域最下方,设置spark streaming输出事件和输出事件数据的接收方,单击“保存”。 可以拖拽多个Sink中的Kafka图元,设置多个事件接收方。 图7 数据接收方配置 标签:数据接收方Kafka的标签名,用于在界面展示。 名称:数据接收方Kafka的名称,系统自动生成。 事件:spark streaming输出的事件。本示例此处配置为高温报警事件“fire_alarm”。温度监测事件“temperature”中的“position”,对应高温报警事件“fire_alarm”中的“positionalarm”。温度监测事件的“temperature”,对应高温报警事件“fire_alarm”中的“temperaturealarm”。 发送到外部:是否发送到外部Kafka。若关闭该开关,表示发送到与AstroZero相连的Kafka。若打开该开关,表示发送到外部Kafka,需要配置“Kafka集群地址”和“订阅主题”。本示例中关闭该开关,使用与华为云Astro轻应用相连的Kafka。 Kafka集群地址:接收事件的Kafka集群地址,例如10.136.14.56:9092。 多个节点服务器地址可用“,”间隔,格式为“Kafka节点1的ip:节点1端口号,Kafka节点2的ip:节点2端口号,...”。 获取Kafka的IP和端口号方法:登录每台Kafka节点服务器,查看“${KAFKA_HOME}/config”目录下,“server.properties”中“listeners”的取值。 接收事件的kafka集群,不需要一定配置为和AstroZero相连。 订阅主题:接收事件数据的kafka Topic,例如__BINGO_PROD_SYS_TOPIC。 事件属性/属性、值:配置输出事件与接收事件中,已定义参数的对应关系。 单击页面右上方保存按钮,设置“事件流”基本参数。 图8 该“事件流”基本参数页面 标签:新建事件流的标签名,用于在界面展示。 名称:新建事件流的名称,系统自动生成。 描述:新建事件流的描述信息。 单击页面上方的,启用事件流。
  • 结果验证 创建一个服务编排“fire_alarm”,创建后启用该服务编排,实现当kafka中出现高温报警事件时,AstroZero需要接收该事件,再向第三方系统发送该告警邮件。 鼠标放在应用下的Logic文件夹上,单击“+”,选择“服务编排”。 选择“创建一个新的服务编排”,设置标签和名称为“fire_alarm”,单击“添加”。 在服务编排设计页面左侧,拖拽“逻辑”下的“等待”图元至画布中。 单击,在“可编辑的事件”中,单击“新增”,新增“event0”分支。 配置该分支事件为高温报警事件,当系统中出现该事件时,会执行该分支。 图9 配置等待图元 拖拽“基本”下的“发送邮件”图元至画布中。 单击,设置发送邮件参数。 配置高温报警邮件的主题和内容,地址填入第三方系统的邮件接收地址。 图10 配置发送邮件图元 直接编辑:手动设置邮件信息。 基于模板:基于同一账号或基线中已有的邮件模板,设置邮件主题和内容,方便用户增加效率。 模板:选择“基于模板”时,需要选择邮件模板。 主题:设置邮件标题。 选中“直接编辑”时,需要配置邮件标题。 选中“基于模板”时,该参数配置区域置灰。 内容:设置邮件内容。 选中“直接编辑”时,需要配置邮件内容。 选中“基于模板”时,该参数配置区域置灰。 自定义变量:选中“基于模板”时,需要配置模板中的参数。在“值”中,直接输入参数取值或者从全局上下文拖拽变量。 地址:接收人的邮箱地址。 字符串:直接输入分号分隔的字符串或从全局上下文拖拽变量。 集合:从全局上下文拖拽集合变量。 抄送:抄送人员的邮箱地址,直接输入分号分隔的字符串或者从全局上下文拖拽变量。 密送:密送发送人员的邮箱地址,直接输入分号分隔的字符串或者从全局上下文拖拽变量。 按照下图连接所有图元,等待图元和发送邮件图元之间选择“event0”分支。 图11 连接所有图元 单击页面上方的,保存服务编排。 保存成功后,单击,启用服务编排。 创建一个服务编排“send_fire_event”,将温度监测事件“temperature”中位置参数“position”赋值为仓储公司某区域,温度“temperature”赋值为70度,启用该Flow,用于模拟事件发送。 鼠标放在应用下的Logic文件夹上,单击“+”,选择“服务编排”。 选择“创建一个新的服务编排”,设置标签和名称为“send_fire_event”,单击“添加”。 在服务编排编辑器页面左侧,拖拽“基本”下的“发送事件”图元至画布中。 单击,设置发送事件参数。 图12 配置发送事件图元 事件:选择待发送的事件。 分区字段:从事件中选择一个自定义参数用作Kafka的分区字段,则根据该字段值进行路由,相同的值将路由到同一个Kafka分区。如果不指定,则默认随机路由到不同Kafka分区,从而提升并发处理性能。 发送到外部:系统内部有配置与AstroZero相连Kafka的固定Topic“__BINGO_SYS_TOPIC”。若不勾选“发送到外部”,表示将事件数据发到默认的Topic上。若勾选“发送到外部”,则表示将事件数据发送到与AstroZero相连Kafka的其他Topic上。 延迟到事务结束(提交或回滚)后才发送:是否延迟到该服务编排事务结束后,才发送事件。 主题:勾选“发送到外部”时,才显示该参数,表示非系统配置的默认Topic。 目标/源:配置事件数据。 本示例中,“目标”请从下拉框中选择事件的自定义参数“temperature”和“position”,在“源”中给目标赋值。 按照下图连接所有图元。 图13 连接图元 单击页面上方的,保存服务编排。 保存成功后,单击,启用服务编排。 在“事件流”列表页面,单击该事件流程所在行的,运行该事件流程。 单击服务编排“send_fire_event”编辑器上方的,执行服务编排。 不用输入任何输入参数,直接单击“运行”。 参考上一步,执行服务编排“fire_alarm”。 不用输入任何输入参数,单击“运行”。 打开第三方系统邮箱,成功收到高温警报邮件,验证成功。
  • 如何使用循环图元 例如,当前有数组变量“TestList1”,“TestList2”,要求把“TestList1”中的元素逐个加到数组“TestList2”的后面。 创建数组变量“TestList1”、“TestList2”和普通变量“test_var”。 在服务编排编辑器页面右侧,选择。 在全局上下文页面,单击“变量”后的加号。 图1 创建变量 单击新增变量后的“...”,选择“设置”。 设置数组变量“TestList1”,数据类型为文本。 图2 数组变量“TestList1” 参考上述步骤设置数组变量“TestList2”和普通变量“test_var”,普通变量不用勾选“是否为数组”。 图3 数组变量“TestList2” 图4 普通变量“test_var” 在逻辑中,拖拽“循环”图元到画布中。 选中循环图元,单击,设置基本信息。 图5 设置基本信息 表1 基本信息参数说明 参数 说明 标签 设置图元的标签,用于在服务编排设计页面展示。系统会自动填入该值,格式为Loop序号,序号从“0”开始,表示同类型图元序号。 名称 设置图元的名称,名称为图元在服务编排中的标识,请确保在当前服务编排中唯一。命名要求如下: 长度范围为1~80个字符。 必须以英文字母开头,由英文字母,数字或单下划线组成,且不能以下划线结尾。 描述 请根据实际需求,在输入框中输入图元的描述信息。 取值范围:1~255个字符。 单击,在“循环”页面进行配置。 图6 配置循环图元 表2 循环图元配置参数说明 参数 说明 数组 进行循环的具体数组,可从全局上下文中拖拽或输入集合变量。 本示例从全局上下文拖拽数组变量“TestList1”,表示对数组“TestList1”进行循环。 元素 将每次循环取出来的元素,赋值给该变量,可从全局上下文中拖拽或者输入变量。 本示例请从全局上下文拖拽普通变量“test_var”,表示将每次循环取出来的元素赋值给变量“test_var”。 排序 循环取出的顺序,可选择升序或者降序从数组中依次取出。 进行赋值操作,将“test_var”的值加到数组“TestList2”后面。 在逻辑中,拖拽“赋值”图元到循环图元后。 图7 拖拽赋值图元 单击,设置“标签”和“名称”为“AddToList2”。 如下图所示,设置页面参数,从全局上下文拖拽数组变量“TestList2”到变量中,从全局上下文拖拽普通变量“test_var”到值中。将“test_var”的值加到数组“TestList2”后面。 图8 添加Assignment定义 将循环和赋值连线,在连线类型选择“下一个取值”。 图9 添加连线 清空“test_var”并闭环。 在逻辑中,拖拽“赋值”图元至画布中。 单击,设置“标签”和“名称”为“testvar_Tonull”。 单击,设置页面参数。 从全局上下文拖拽普通变量“test_var”到变量中,从全局上下文拖拽全局常量“$GlobalConstant.Null”到值中。清空“test_var”。 图10 清空test_var页面 在服务编排编辑器页面右侧,选择,按照下图从全局上下文页面中拖拽参数到相应的入参和出参区域,设置服务编排的入参和出参。 图11 设置服务编排的入参和出参 按照下图连线,单击页面上方的,保存服务编排。 图12 连接图元 单击,在“输入参数”中输入参数后,运行服务编排。 在“输入参数”中,输入如下参数: { "TestList1": [ "1", "2", "3" ] } 检查输出页签的结果是否符合预期。 { "interviewId": "002N000000YfbbgBStmq", "outputs": { "TestList2": [ "1", "2", "3" ] } }
  • 如何使用等待图元 在逻辑中,拖拽“等待”图元至画布中。 选中等待图元,单击,设置基本信息。 表1 基本信息参数说明 参数 说明 标签 设置图元的标签,用于在服务编排设计页面展示。系统会自动填入该值,格式为Wait序号,序号从“0”开始,表示同类型图元序号。 名称 设置图元的名称,名称为图元在服务编排中的标识,请确保在当前服务编排中唯一。命名要求如下: 长度范围为1~80个字符。 必须以英文字母开头,由英文字母,数字或单下划线组成,且不能以下划线结尾。 描述 请根据实际需求,在输入框中输入图元的描述信息。 取值范围:1~255个字符。 单击,在“等待”页面进行配置。 图1 Wait配置及Pass分支条件配置 图2 Unpass分支条件配置 图3 Timeout分支条件配置 表2 条件分支配置参数说明 参数 说明 可编辑的事件 所有的判断条件。 可通过单击“新增”,来增加判断条件分支。 默认:默认输出,当其他所有条件均不满足情况下,进入该分支。 例如,新增如下三个判断条件: Pass:应聘者被录用。应聘通过时,Boolean类型参数“result”赋值为全局常量“{!$GlobalConstant.True}”,表示结果为真,即应聘通过。 Unpass:应聘者没有被录用。应聘失败时,Boolean类型参数“result”赋值为全局常量“{!$GlobalConstant.False}”,表示结果为假,即应聘拒绝。 Timeout:超时事件。基于该服务编排执行时间,超时30分钟未返回是否录用。 事件/时间 当订阅的是自定义事件时,需要选择“事件”。 当订阅的是系统预置的标准事件“Absolute Time Alert”,即定时器发送的系统事件时,需要选择“时间”。 本示例中,需要配置如下: Pass:请选择“事件”。 Unpass:请选择“事件”。 Timeout:请选择“时间”。 事件 请选择需要订阅的事件,当订阅的是自定义事件时,该参数才会显示。 事件条件 该分支的条件。单击“新增行”,可进行添加。当订阅的是自定义事件时,该参数才会显示。 分支条件中的字段,为创建该事件时设置的自定义参数,值可从右侧全局上下文中选择拖入。 定义需要满足的其他条件 勾选“定义需要满足的其他条件”后,可根据事件变量外的其他变量设置追加条件。 可视 勾选“定义需要满足的其他条件”后,该参数才会显示。当选择“可视”时,可配置追加条件的判断条件。单击“新增”,可新增判断条件。条件显示为“资源”、“比较符”、“值”。 默认选择“可视”。 公式 勾选“定义需要满足的其他条件”后,该参数才会显示。可采用公式设置追加条件。 选择连接条件 当选择“可视”并设置多条判断条件时,需要设置选择连接条件“或”或者“且”。 或:表示满足多条判断条件的其中一条,便可进入该分支。 且:表示必须同时满足多条判断条件,才可进入该分支。 输出 如果需要在服务编排中,使用事件的参数,将其参数赋值到事件变量中方便服务编排引用。 当订阅的是自定义事件时,该参数才会显示。 默认不需要。 基准时间 当订阅的是系统预置的定时器发送事件时,该参数才会显示。 可从全局上下文拖拽日期/时间类型变量,也可设置为某个具体时间,或者设置为本服务编排执行时间。 例如,在本节中设置为本服务编排执行时间,即{!$Flow.CurrentDateTime}。 偏移时间 偏移时间,例如“30”。当订阅的是系统预置的定时器发送事件时,该参数才会显示。
  • 如何使用记录删除图元 在基本中,拖拽“记录删除”图元至画布中。 选中记录删除图元,单击,设置基本信息。 表1 基本信息参数说明 参数 说明 标签 设置图元的标签,用于在服务编排设计页面展示。系统会自动填入该值,格式为RecordDelete序号,序号从“0”开始,表示同类型图元序号。 名称 设置图元的名称,名称为图元在服务编排中的标识,请确保在当前服务编排中唯一。命名要求如下: 长度范围为1~80个字符。 必须以英文字母开头,由英文字母,数字或单下划线组成,且不能以下划线结尾。 描述 请根据实际需求,在输入框中输入图元的描述信息。 取值范围:1~255个字符。 使用快速删除模式 是否启用快速删除模式。 如果勾选该参数,表示为快速模式。 根据对象变量中的记录ID,删除对应的记录。当配置的对象变量为数组时,则从数据库中删除对象变量数组中的包含的所有记录(按照记录ID进行删除)。 不勾选,表示为普通模式。 按照条件删除指定对象中的记录,需要配置待删除记录对应的对象名,删除条件。 默认不勾选。 单击,在“记录删除”页面进行配置。 如果上一步勾选“使用快速删除模式”,则需要指定一个预先定义的对象变量或者对象变量数组,并将该对象变量或对象变量数组拖拽到“变量”输入框中,使用该对象变量或对象变量数组的记录ID删除对应的对象记录。如图1,使用“accountDelete”对象变量的记录ID删除对象记录。 图1 快速删除模式 表2 快速删除模式参数说明 参数 说明 对象 预先定义的对象变量,使用该对象变量或对象变量数组中的记录ID删除对象记录。 从全局上下文拖拽或直接输入对象变量/对象变量数组。 当前流程出现错误时回滚 当前服务编排出现错误时,回滚到上一个流程。 默认为勾选。如果无特殊要求,请不要更改设置。 如果上一步未勾选“使用快速删除模式”,则需要指定对象并在条件中设置指定对象部分字段的值,根据条件删除符合条件的对象记录。如图2所示,删除“Account”对象“name”为“Lily”的记录。 图2 普通删除模式 表3 普通删除模式参数说明 参数 说明 对象 指定具体的对象,直接在下拉框中选择。 当前流程出现错误时回滚 当前服务编排出现错误时,回滚到上一个流程。 默认为勾选。如果无特殊要求,请不要更改设置。 条件 选中对象后,该条件区域“字段”列会出现该对象的字段。单击“新增行”,可设置删除数据的条件。 在“字段”中选择要进行判断的对象字段,在“比较符”中选择相应的比较符,“值”则可从全局上下文拖拽变量或者直接输入“{!变量名}”。
  • 如何使用发送邮件图元 在基本中,拖拽“发送邮件”图元至画布中。 选中发送邮件图元,单击,设置基本信息。 表1 基本信息参数说明 参数 说明 标签 设置图元的标签,用于在服务编排设计页面展示。系统会自动填入该值,格式为Email序号,序号从“0”开始,表示同类型图元序号。 名称 设置图元的名称,名称为图元在服务编排中的标识,请确保在当前服务编排中唯一。命名要求如下: 长度范围为1~80个字符。 必须以英文字母开头,由英文字母,数字和单下划线组成,且不能以下划线结尾。 描述 请根据实际需求,在输入框中输入图元的描述信息。 取值范围:1~255个字符。 单击,在“发送邮件”页面进行配置。 图1 配置直接编辑邮件 图2 配置基于模板邮件 表2 发送邮件图元配置参数说明 参数 说明 直接编辑 手动设置邮件信息。 基于模板 基于同一租户或基线里已有的邮件模板,设置邮件主题和内容。 模板 当选中“基于模板”时,需要选择邮件模板。如何新建邮件模板,请参见邮件模板。 主题 邮件标题。 当选中“直接编辑”时,需要配置邮件标题。 当选中“基于模板”时,该参数配置区域置灰。 内容 邮件内容。 当选中“直接编辑”时,需要配置邮件内容。 当选中“基于模板”时,该参数配置区域置灰。 自定义变量 当选中“基于模板”时,需要配置模板中的参数,在“值”中进行赋值。 地址 接收人的邮箱地址。 文本:直接输入邮箱地址,多个地址请用分号分隔,或者从全局上下文拖拽变量代表一个接收人的邮箱地址。 集合:表示可以从全局上下文拖拽集合变量,集合变量即数组型变量,表示多个接收人的邮箱地址。在定义变量时勾选“是否为数组”,则该变量被定义为集合变量。 抄送 抄送人员的邮箱地址,直接输入分号分隔的字符串或者从全局上下文拖拽变量。 密送 秘密发送人员的邮箱地址,直接输入分号分隔的字符串或者从全局上下文拖拽变量。 是否同步发送 是否开启同步发送功能。
  • 如何使用跳出循环图元 在逻辑中,拖拽“跳出循环”图元至画布中。 选中跳出循环图元,单击,设置基本信息。 表1 基本信息参数说明 参数 说明 标签 设置图元的标签,用于在服务编排设计页面展示。系统会自动填入该值,格式为Break序号,序号从“0”开始,表示同类型图元序号。 名称 设置图元的名称,名称为图元在服务编排中的标识,请确保在当前服务编排中唯一。命名要求如下: 长度范围为1~80个字符。 必须以英文字母开头,由英文字母,数字或单下划线组成,且不能以下划线结尾。 描述 请根据实际需求,在输入框中输入图元的描述信息。 取值范围:1~255个字符。 单击,在“跳出循环”页面的“循环”下拉框中,选择当前服务编排中需要中断的循环。 图1 配置跳出循环图元
  • 如何使用发送事件图元 在基本中,拖拽“发送事件”图元至画布中。 选中发送事件图元,单击,设置基本信息。 表1 基本信息参数说明 参数 说明 标签 设置图元的标签,用于在服务编排设计页面展示。系统会自动填入该值,格式为Event序号,序号从“0”开始,表示同类型图元序号。 名称 设置图元的名称,名称为图元在服务编排中的标识,请确保在当前服务编排中唯一。命名要求如下: 长度范围为1~80个字符。 必须以英文字母开头,由英文字母,数字或单下划线组成,且不能以下划线结尾。 描述 请根据实际需求,在输入框中输入图元的描述信息。 取值范围:1~255个字符。 单击,在“发送事件”页面进行配置。 图1 配置发送事件图元 表2 发送事件图元配置参数说明 参数 说明 事件 选择待发送的事件,直接在下拉框中选择。 分区字段 从事件中选择一个自定义参数用作Kafka的分区字段,则根据该字段值进行路由,相同的值将路由到同一个Kafka分区;如果不指定,则默认随机路由到不同Kafka分区,从而提升并发处理性能。 须知: 建议选择有区分度的关键字段,该字段必须是事件的自定义字段。 发送到外部 系统内部有配置与华为云Astro轻应用相连Kafka的固定Topic“__BINGO_SYS_TOPIC”。 如果不勾选“发送到外部”,表示将事件数据发到默认的Topic上。 如果勾选“发送到外部”,表示将事件数据发送到与华为云Astro轻应用相连Kafka的其他Topic上,此时需要配置其他的Topic。 默认不勾选。 延迟到事务结束(提交或回滚)后才发送 是否延迟到该服务编排事务结束后,才发送事件。 默认不勾选,表示流程执行到该图元时立即发送事件。 主题 当勾选“发送到外部”时,该参数才会显示,表示非系统配置的默认Topic。 需要从与华为云Astro轻应用相连Kafka处,获取其他主题Topic。 目标/源 配置事件数据,为该事件自定义参数赋值,将“源”取值赋值到“目标”中。单击“新增行”,可添加并进行赋值。 目标:从下拉框中,选择事件的自定义参数。 源:从全局上下文拖拽变量或直接输入“{!变量名}”,给目标赋值。
  • 结果验证 通过服务编排订阅“EmployResultNotify”事件后,招聘经理需要给出招聘结果,即给“Result”赋值后,人事部经理才会收到招聘者是否被录用的邮件通知。即需要设置发送事件,订阅者才可以接收事件。 本章节通过单独创建一个服务编排,来给应聘者Lily的应聘结果“Result”赋值,模拟事件发送。 参考创建服务编排中操作,创建一个服务编排。 图8 新建服务编排SendEvent 在服务编排设计页面左侧,选择“基本”,拖拽“发送事件”图元至画布中。 Send Event为系统提供的,发送事件接口。 图9 拖拽发送事件图元至画布中 配置发送事件图元。 以应聘者Lily被成功录用为例,在“全局上下文”中,单击“变量”后的加号,新增变量,设置发送事件参数。 单击,进入全局上下文页面,新建一个变量variable0。 图10 新增一个变量 选中发送事件图元,单击,设置基本信息。 图11 设置发送事件基本信息 单击,设置发送事件。 图12 发送事件配置页面 表3 发送事件参数说明 参数 说明 事件 选择待发送的事件,本示例选择创建华为云Astro轻应用自定义事件中创建的事件。 分区字段 从事件中,选择一个自定义参数,用作Kafka的分区字段。设置后,会根据该字段值进行路由,相同的值将路由到同一个Kafka分区。如果不指定,则默认随机路由到不同Kafka分区,从而提升并发处理性能。 发送到外部 系统内部有配置与华为云Astro轻应用相连Kafka的固定Topic(__BINGO_SYS_TOPIC)。 不勾选,表示将事件数据发到默认的Topic上。 勾选,表示将事件数据发送到与华为云Astro轻应用相连Kafka的其他Topic上。 默认为不勾选。 延迟到事务结束(提交或回滚)后才发送 是否延迟到该服务编排事务结束后,才发送事件。 默认为不勾选。 目标/源 该事件自定义的参数取值,请单击“新增行”,进行添加并赋值。 连接开始和发送邮件图元。 图13 连接图元 在服务编排设计页面上方,单击,保存服务编排。 保存成功后,单击,运行服务编排。 设置输入参数,单击“运行”,运行后,才能发送该事件。 邮件接收者,收到邮件,验证成功。 图14 发送事件
  • 通过服务编排订阅事件 参考创建服务编排中操作,新建一个服务编排。 图1 添加服务编排 表1 新建服务编排参数说明 参数 说明 标签 新建服务编排的标签名,用于在页面展示。 取值范围:1~64个字符。 示例:EmployResultNotifySubscription。 名称 名称为服务编排在系统中的唯一标识,创建后不可修改。要求如下: 长度不能超过64个字符,包括前缀命名空间的长度。 名称前的内容为命名空间,在华为云Astro轻应用中为了避免不同租户间数据的重名,租户在首次创建应用时需要先定义一个命名空间。一个租户只能创建一个命名空间,创建后不支持修改。 名称必须以英文字母开头,只能由英文字母、数字或单下划线组成,且不能以下划线结尾。 示例:EmployResultNotifySubscription。 类型 请在下拉列表中,选择新建服务编排的类型。取值如下: Autolaunched Flow:自启动服务编排,即在接口调用后,会立即执行服务编排中定义的逻辑。 Event Trigger:事件触发的服务编排,在事件触发时,才会开始执行服务编排中定义的逻辑。 示例:Event Trigger。 事件 选择在服务编排中订阅的事件,即创建华为云Astro轻应用自定义事件中创建的事件,请确保事件已启用。 描述 请根据需要,在文本框中输入该服务编排的描述信息。 取值范围:1~255个字符。 在服务编排设计页面左侧,选择“逻辑”,拖拽“决策”图元至画布中。 该图元类似“if”语句的判断,用于在服务编排流程中创建判断条件,根据判断结果连线其他图元,决定后续执行何种操作。本示例需要设置应聘者被成功录用、应聘者没被录用和其他三个判断分支。 图2 拖拽决策图元至画布中 选中决策图元,单击,设置分支条件参数。 图3 pass分支条件配置 图4 unpass分支条件配置 可编辑的结果,即所有的判断条件。系统已预置默认条件,即当其他所有条件均不满足情况下,进入该分支。 本示例,需要新增如下两个判断条件: Pass:应聘者被录用。应聘通过时,事件中自定义的布尔类型参数“Result”赋值为全局常量“{!$GlobalConstant.True}”,表示结果为真,即应聘通过。 Unpass:应聘者没有被录用。应聘失败时,事件中自定义的布尔类型参数“Result”赋值为全局常量“{!$GlobalConstant.False}”,表示结果为假,即应聘失败。 在服务编排设计页面左侧,选择“基本”,拖拽“发送邮件”图元至画布中。 发送邮件是发送邮件的接口。本示例中,需要根据录用结果,发送不同的邮件给人事部。 录用成功,需要邮件通知人事部办理入职。 录用不成功,需要邮件通知人事部告知应聘者应聘失败。 事件超时(默认分支),需要邮件通知招聘经理,看其是否给出招聘结果。 如下图所示,以应聘者被成功录用为例,设置发送邮件参数。 选中发送邮件图元,单击,设置基本信息。 图5 设置邮件发送基本信息 单击,设置邮件发送参数。 图6 配置邮件发送参数 表2 邮件发送参数说明 参数 说明 邮件配置 可选择“直接编辑”手动设置邮件信息或“基于模板”选择邮件模板。 示例:直接编辑。 主题 请根据需要,在输入框中输入邮件的标题。 示例:Interview Result。 内容 设置邮件的内容,需要使用事件变量“命名空间_EmployResultNotify__e”,请直接从变量中拖入。 地址 接收人的邮箱地址。 文本:表示直接输入。 集合:表示可以拖入一个集合变量。 示例:文本,即直接输入邮件接收人的地址。 参考5中操作,设置应聘者录用失败和超时邮件发送。 如图7所示,连接所有元素。 图7 连接并设置起始元素 在服务编排设计页面上方,单击,保存服务编排。 保存成功后,单击,启用服务编排。 启用后,当有“EmployResultNotify”事件触发时,即会执行服务编排中定义的逻辑。
  • 创建私有结构体 服务编排中如果涉及复杂的结构体参数,可以先创建全局或私有结构体,并用作参数类型。创建全局结构体和私有结构体后,再参考创建对象变量/结构体变量/事件变量中操作,创建全局结构体变量和私有结构体变量,作为服务编排的参数类型。 在服务编排设计器右侧,选择,在私有结构体页面单击“新增”。 该“私有结构体”页面有两个“新增”按钮,单击上面的“新增”按钮,是通过设置页面参数新建私有结构体。单击下面的“新增”按钮,是通过输入JSON Schema类型的数据源码定义私有结构体。 图12 添加私有结构体类型 (如果上一步单击“私有结构体”页面上方的“新增”按钮,请执行该步骤)设置页面参数。 在“基本信息”中,输入结构体名字、描述信息。 在“结构体成员”中,设置自定义成员变量,包括设置成员变量的名称、数据类型、是否必填、是否是集合和描述信息等。单击“新增”,可增加成员变量,支持设置全局结构体或私有结构体成员变量。当私有结构体的成员变量包含结构体类型时,您需要提前定义成员结构体。例如,下图中成员变量“hobby”为私有结构体类型,需要提前创建“create”私有结构体。 图13 配置私有结构体 (如果上一步单击“私有结构体”页面下方的“新增”按钮,请执行该步骤)在“创建JSON Schema”页面中,定义结构体名称,在“JSON源码”中输入数据源码,单击,系统会进行校验,转换成服务编排中的结构体类型,单击“保存”。 图14 创建JSON Schema 数据源码示例如下: { "name": "xiaoming", "age": 18, "father": { "name": "daliu", "gender":"male" }, "brother": { "name": "xiaolei", "gender":"male" } } 创建成功后,页面显示如下。 图15 创建成功 该方式创建的结构体中,包含成员结构体时,成员结构体具体定义不会在界面显示,且其他结构体不可引用。 JSON结构体支持嵌套,例如上述创建的“family”结构体,在“JSON Schema结构体”区域再次单击“新增”,新增“company”结构体,里面“ceo”嵌套引用“family”结构体,如下图所示,在定义结构体输入值时,您可以输入“$”符号,选择当前服务编排中的其它结构体进行嵌套引用。 图16 引用其他结构体
  • 创建服务编排 参考登录华为云Astro轻应用应用设计器中操作,登录应用设计器。 在左侧导航栏中,选择“逻辑”。 (可选)单击编排后的,为服务编排添加目录。 服务编排默认存放在根目录下,在创建服务编排前,您可以先创建服务编排存放的目录,也可以在服务编排创建后将其拖拽到指定目录。 将鼠标放在已创建的服务编排目录上,单击,进入“添加服务编排”页面。 如果未创建服务编排目录,请直接单击编排后的,进入添加服务编排页面。 设置参数,单击“添加”。 图1 创建服务编排 表1 添加服务编排参数说明 参数 说明 标签 新建服务编排的标签名,用于在界面展示,创建后可修改。 取值范围:1~64个字符。 名称 服务编排在系统中的唯一标识,创建后不支持修改。系统会自动在名称前添加“{命名空间}__”,当其他功能调用服务编排时,调用的是服务编排的名称,而不是标签。 命名要求如下: 长度不能超过64个字符,包括前缀命名空间的长度。 名称前的内容为命名空间,在华为云Astro轻应用中为了避免不同租户间数据的重名,租户在首次创建应用时需要先定义一个命名空间。一个租户只能创建一个命名空间,创建后不支持修改。 名称必须以英文字母开头,只能由英文字母、数字或单下划线组成,且不能以下划线结尾。 类型 在下拉框中,选择服务编排的类型。 Autolaunched Flow:自启动Flow,在接口调用后会立即执行服务编排模型定义的逻辑。 Event Trigger:事件触发的服务编排,在事件触发时才会开始执行服务编排模型定义的逻辑。当选择该类型时,您需要配置具体的事件以及条件规则。 默认值:Autolaunched Flow。 描述 请根据实际需求,输入服务编排的描述信息,建议设置为服务编排的功能介绍。 取值范围:1~255个字符。 创建变量。 在服务编排设计器中,单击,进入全局上下文页面。 单击“变量”后的,创建表2中的变量。 图2 创建变量 表2 变量说明 变量名 类型 变量说明 userName 文本 传入的用户名 message 文本 欢迎信息 在全局上下文中,除了创建基本类型的变量,还可以创建常量、创建公式变量、创建私有结构体和创建对象变量/结构体变量/事件变量。 单击,配置服务编排的输入输出参数。 图3 配置输入输出参数 将“逻辑”中的“赋值”图元,拖拽到画布中。 赋值图元可以实现对全局上下文中变量等参数进行赋值,其他图元的详细介绍,请参见为华为云Astro轻应用服务编排设置图元。 图4 拖拽赋值图元到画布 配置图元。 选择赋值图元,单击。 在“赋值”页面中,单击“新增行”,参照下图将创建的变量拖拽到相应的位置。 将“"Hello,"”赋值给message变量,并将userName变量拼接到message变量中,赋值语句将从上往下依次执行。 图5 配置赋值图元 连接图元指定逻辑关系,即从开始图元连向赋值图元,表示服务编排开始执行后,执行赋值图元的赋值语句。 图6 连接图元 单击页面上方的,保存服务编排。 单击,进入服务编排调试页面。 在输入参数中,输入如下内容,并单击“运行”。 { "userName": "Flow" } 运行结果如下,输出“Hello,Flow”。 图7 运行结果 单击页面上方的,启用服务编排。 服务编排启用后,才可以在脚本、工作流等操作中引用。 调试已创建的服务编排。 在应用设计器左侧导航栏中,选择“集成”。 单击开放接口后的“+”,新建一个helloFlow开放接口,单击“保存”。 图8 新建开放接口helloFlow 接口创建后,在开放接口中,将鼠标放在已创建的接口上,单击,选择“查看”。 在预览页面,单击接口后的。 单击“测试一下”,输入示例模型,单击“执行”。 图9 测试接口 执行成功后,可查看到API的测试结果。 [ "resCode": "0", "resMsg": "成功", "result": [{ "message": "Hello, Flow" }] ]
  • 创建常量 编排服务流程或交互时,不会改变的值或参数,通常定义为常量,例如服务标识、访问地址和错误码等。 在服务编排设计器右侧,选择。 在全局上下文页面,单击“常量”后的。 单击新增常量后的“...”,选择“设置”。 设置页面参数,单击“保存”。 图10 配置常量 表3 常量参数说明 参数 说明 名称 新建常量的名称,名称是变量在流程中引用的唯一标识。修改变量名不会改变图元中的引用,但是会导致流程不可用。 数据类型 常量的数据类型,直接在下拉框中选择即可,默认为“文本”类型。 值 新建常量的取值,字符串常量输入需要用双引号括起来,例如“"abc"”。 描述 根据实际需求,输入变量的描述信息。 外部使用 如果勾选该选项,表示该变量为外部使用变量,编译时不校验其是否被使用。 默认为不勾选。
  • 创建对象变量/结构体变量/事件变量 对象变量用于在服务编排中引用或操作特定的对象实例,用于较简单的业务流程中。结构体变量允许将多个不同类型的数据项进行组合,通常用于较复杂的业务流程中。事件变量用于表示系统或业务流程中发生的事件,事件可以是系统内部产生的,也可以是外部触发的。 在服务编排设计器右侧,选择。 在全局上下文页面,单击“对象变量”后的。 设置页面参数,以创建对象变量为例进行介绍。 图17 配置对象变量 表5 对象变量参数说明 参数 说明 名称 输入新建对象变量的名称,名称是变量在流程中引用的唯一标识。修改变量名不会改变图元中的引用,但是会导致流程不可用。 对象 请直接在下拉框中,选择具体的对象。选择“对象”类型时,该参数才会显示。 全局结构体 请直接在下拉框中,选择具体的全局结构体。选择“全局结构体”类型时,该参数才会显示。 私有结构体 请直接在下拉框中,选择具体的私有结构体。选择“私有结构体”类型时,该参数才会显示。 事件 请直接在下拉框中,选择具体的事件。选择“事件”类型时,成员变量为事件的自定义字段,不包括系统预置的标准字段。选择“事件”类型时,该参数才会显示。 默认值 请直接输入变量的默认值或从下拉框中选择。 描述 请根据实际需求,输入变量的描述信息。 取值范围:1~255个字符。 是否为数组 是否为数组变量,即集合变量。 默认为不勾选。 外部使用 勾选该选项,表示该变量为外部使用变量,编译时不校验其是否被使用。 默认为不勾选。
  • 创建公式变量 在服务编排中,公式变量主要用于变量赋值、表达式计算、参数传递等。 在服务编排设计器右侧,选择。 在全局上下文页面,单击“公式”后的。 设置页面参数,单击“保存”。 图11 配置公式变量 表4 公式变量参数说明 参数 说明 名称 输入新建公式变量的名称。 数据类型 公式变量的数据类型,直接在下拉框中选择即可,默认为“文本”类型。 描述 根据实际需求,输入公式变量的描述信息。 外部使用 勾选该选项,表示该变量为外部使用变量,编译时不校验其是否被使用。 默认为不勾选。 表达式 设置新增变量的表达式。如果表达式中需要运用公式,可根据需要双击“公式”区域中系统预置的公式,该公式会显示在右侧“表达式”区域中。当表达式中需要有变量参数时,可从变量区域中直接选择变量拖入到表达式中。
  • 如何使用记录创建图元 在基本中,拖拽“记录创建”图元至画布中。 选中记录创建图元,单击,设置基本信息。 表1 基本信息参数说明 参数 说明 标签 设置图元的标签,用于在服务编排设计页面展示。系统会自动填入该值,格式为RecordCreate序号,序号从“0”开始,表示同类型图元序号。 名称 设置图元的名称,名称为图元在服务编排中的标识,请确保在当前服务编排中唯一。命名要求如下: 长度范围为1~80个字符。 必须以英文字母开头,由英文字母,数字或单下划线组成,且不能以下划线结尾。 描述 请根据实际需求,在输入框中输入图元的描述信息。 取值范围:1~255个字符。 使用快速创建模式 是否启用快速创建模式。 如果勾选该参数,表示为快速模式。该模式可以创建一条或者多条记录,仅需要配置对象的对象变量(与对象关联的变量)或对象变量数组。该图元负责将对象变量或对象变量数组的值写入数据库。当对象变量为数组时,则实现创建多条记录。创建成功后,返回的记录ID自动保存在对象变量中。创建记录的各个字段的值为对象变量中的值,因此一般需要在创建记录之前先给对象变量进行赋值。 不勾选,表示为普通模式。该模式下每次执行到该图元仅创建一条记录,需要配置要创建记录的对象名,对象中字段的值,返回的记录ID保存到变量名中。 默认为不勾选。 单击,在“记录创建”页面进行配置。 如果上一步勾选“使用快速创建模式”,则需要指定一个预先定义的对象变量或者对象变量数组,并将该对象变量或对象变量数组拖拽到“变量”输入框中,使用该对象变量或对象变量数组的值创建新记录。如下图所示,使用“accountCreate”对象变量的值创建新记录。 图1 快速创建模式 表2 快速创建模式参数说明 参数 说明 变量 预先定义的对象变量或对象变量数组,使用该对象变量或者对象变量数组的值创建新记录。 从全局上下文拖拽或直接输入对象变量/对象变量数组。 当前流程出现错误时回滚 勾选表示在服务编排中,当后续图元失败的情况下,就可以回滚到上一个流程。 不勾选,在服务编排中,当出现后边图元失败的情况下,对象记录操作的图元就不回滚。 默认为勾选。无特殊要求,请不要更改设置。 如果上一步未勾选“使用快速创建模式”,则需要指定对象并为对象的字段赋值来创建记录。如图2所示,为“Account”对象新增“name”为“Lily”的数据记录,在变量“var_record_id”中保存新建的记录ID。 图2 普通创建模式 表3 普通创建模式参数说明 参数 说明 对象 请在下拉框中,选择具体的对象。这里只能使用当前项目中的,依赖BO中公开的以及全局的对象。 当前流程出现错误时回滚 当前服务编排出现错误时,回滚到上一个流程。 默认为勾选。无特殊要求,请不要更改设置。 赋值 选中对象后,该赋值区域“目标”列会出现该对象的字段。如果需要给多个字段赋值,则单击“新增行”,定义其他字段的值。 在“目标”中选择需要赋值的对象字段,“源”则可从全局上下文拖拽变量或者直接输入“{!变量名}”。 变量 将创建的记录ID分配到该变量中,以便在服务编排中引用。 从全局上下文拖拽或直接输入文本类型变量。
  • 如何使用记录更新图元 在基本中,拖拽“记录更新”图元至画布中。 选中记录更新图元,单击,设置基本信息。 表1 基本信息参数说明 参数 说明 标签 设置图元的标签,用于在服务编排设计页面展示。系统会自动填入该值,格式为RecordUpdate序号,序号从“0”开始,表示同类型图元序号。 名称 设置图元的名称,名称为图元在服务编排中的标识,请确保在当前服务编排中唯一。命名要求如下: 长度范围为1~80个字符。 必须以英文字母开头,由英文字母,数字或单下划线组成,且不能以下划线结尾。 描述 请根据实际需求,在输入框中输入图元的描述信息。 取值范围:1~255个字符。 使用快速更新模式 是否启用快速更新模式。 如果勾选该参数,表示为快速模式。 根据对象变量中的记录ID,将对象变量更新到数据库中。更新的值,来源于对象变量中的值。如果对象变量为数组,则根据对象变量中的记录ID,批量将对象变量数组更新到数据库中。 不勾选,表示为普通模式。 根据条件更新对象记录,需要配置修改记录对应的对象名,更新条件,更新的各个字段的值。 默认不勾选。 单击,在“记录更新”页面进行配置。 如果上一步勾选“使用快速更新模式”,则需要指定一个预先定义的对象变量或者对象变量数组,并将该对象变量或对象变量数组拖拽到“变量”输入框中。即可根据对象变量中的记录ID,将对象变量更新到数据库中,更新的值来源于对象变量中的值。如下图所示,根据对象变量“Accountupdate”中的记录ID将对象变量中的值更新到数据库中。 图1 快速更新模式 表2 快速更新模式参数说明 参数 说明 变量 预先定义的对象变量或者对象变量数组。 根据对象变量中的记录ID,将对象变量更新到数据库中。更新的值来源于对象变量中的值。如果变量为对象数组,则根据对象变量中的记录ID,批量将对象变量数组更新到数据库中。 从全局上下文拖拽或直接输入对象变量/对象变量数组。 当前流程出现错误时回滚 当前流程出现错误时回滚到上一个流程。 默认为勾选。如果无特殊要求,请不要更改设置。 如果上一步未勾选“使用快速更新模式”,则需要指定对象并在条件中,设置指定对象部分字段的值。在赋值中,设置需要更新的目标字段及更新值,最后根据条件查找符合条件的对象记录,并将赋值中的值更新到数据库中。如图2所示,更新“Account”对象“name”为“Lily”的记录,将变量“var_record_id”值更新到“id”字段。 图2 普通更新模式 表3 普通更新模式参数说明 参数 说明 对象 更新的具体对象名,直接在下拉框中选择。 当前流程出现错误时回滚 当前流程出现错误时,回滚到上一个流程。 默认为勾选。如果无特殊要求,请不要更改设置。 条件 选中对象后,该条件区域“字段”列会出现该对象的字段。单击“新增行”,可设置更新数据的条件。 在“字段名称”中选择要进行判断的对象字段。 在“比较符”中选择相应的比较符。 “字段值”则可从全局上下文拖拽变量或者直接输入“{!变量名}”。 赋值 选中对象后,该赋值区域“字段名称”列会出现该对象的字段。如果需要给多个字段赋值,则单击“新增行”,定义其他字段的值。 在“字段名称”中选择需要赋值的对象字段。 在“操作符”中选择相应的操作符。 “字段值”则可从全局上下文拖拽变量或者直接输入“{!变量名}”。 保留所有空值赋值 在进行数据更新时,不自动忽略或删除数据中的空值,而是将其作为有效数据的一部分进行保留。
  • 如何使用BO图元 在BO中,拖拽所需的BO图元至画布中。 选中BO图元,单击,设置基本信息。 表1 基本信息参数说明 参数 说明 标签 设置图元的标签,用于在服务编排设计页面展示。系统会自动填入该值,格式为BO名序号,序号从“0”开始,表示同类型图元序号。 名称 设置图元的名称,名称为图元在服务编排中的标识,请确保在当前服务编排中唯一。命名要求如下: 长度范围为1~80个字符。 必须以英文字母开头,由英文字母,数字或单下划线组成,且不能以下划线结尾。 描述 根据实际需求,输入图元的描述信息。 取值范围:1~255个字符。 单击,在“BO”页面进行配置。 图1 配置BO图元 表2 BO图元配置参数说明 参数 说明 服务版本 BO中自定义API的版本号。 API类型 根据实际需求,选择REST或SDK。 操作方法 BO中已自定义好的API接口,该API接口类型必须是“服务编排”,才可在服务编排中调用。 入参/目标 当选择具体操作方法(API)后,API的输入参数将会显示在入参的目标列。 入参/源 服务编排中的变量,需要和目标的参数类型保持一致。该源会将服务编排中的变量,赋值给调用API的输入参数。 出参/源 当选择具体操作方法(API)后,API的输入参数将会显示在出参的源列。 出参/目标 服务编排中的变量,需要和输出参数的类型保持一致。API中的输出参数赋值给服务编排中的变量,供服务编排使用。
  • 如何使用发送事件图元 在基本中,拖拽“发送事件”图元至画布中。 选中发送事件图元,单击,设置基本信息。 表1 基本信息参数说明 参数 参数说明 标签 图元的标签,用于在页面显示。系统会自动填入该值,格式为Event序号,序号从“0”开始,表示同类型图元序号。 名称 该图元的标识,请确保在当前服务编排中唯一。 描述 该图元的描述信息。 单击,在“发送事件”页面进行配置。 图1 配置发送事件图元 表2 发送事件图元配置参数说明 参数 参数说明 事件 选择待发送的事件。 分区字段 从事件中选择一个自定义参数用作Kafka的分区字段,则根据该字段值进行路由,相同的值将路由到同一个Kafka分区;如果不指定,则默认随机路由到不同Kafka分区,从而提升并发处理性能。 须知: 建议选择有区分度的关键字段,该字段必须是事件的自定义字段。 发送到外部 系统内部有配置与AstroZero相连Kafka的固定Topic“__BINGO_SYS_TOPIC”。 若不勾选“发送到外部”,表示将事件数据发到默认的Topic上。 若勾选“发送到外部”,表示将事件数据发送到与AstroZero相连Kafka的其他Topic上,此时需要配置其他的Topic。 默认不勾选。 延迟到事务结束(提交或回滚)后才发送 是否延迟到该服务编排事务结束后,才发送事件。 默认不勾选,表示流程执行到该图元时立即发送事件。 主题 当勾选“发送到外部”时,该参数才会显示,表示非系统配置的默认Topic。 需要从与AstroZero相连Kafka处,获取其他主题Topic。 目标/源 配置事件数据,为该事件自定义参数赋值,将“源”取值赋值到“目标”中。单击“新增行”,可添加并进行赋值。 目标:从下拉框中,选择事件的自定义参数。 源:从全局上下文拖拽变量或直接输入“{!变量名}”,给目标赋值。
  • 卡片 卡片是指包裹图表组件的外层架构,可以理解为组件由卡片中基础元素(卡片标题、图表、卡片背景、卡片边框)和图表元素构成。 图3 基本漏斗图卡片 卡片装饰:卡片装饰设置,可根据自身的业务需求选择不同的卡片样式。单击“清除样式”,可清除已设置的装饰样式。 背景 背景色:设置组件卡片的背景颜色。 边框:组件卡片的边框设置,支持无边框、全边框和角边框三种样式。设置为全边框和角边框时,支持设置组件外圈边框的线型、圆角等。 样式:选择图片时,图片显示的样式,支持普通、居中、拉伸和平铺四种样式。 选择图片:使用本地的图片作为组件背景,支持新增目录和子目录,便于对图片进行分类管理。推荐使用JPG、JPEG、PNG或GIF格式的图片,且每张图片不能超过50MB。 特效:组件是否高亮显示,支持默认展示和跳转到页面时展示。 边距:组件中图表距离整个组件四边(上、下、左、右,如图2)的距离,默认为0,即铺满整个组件。
  • 图形 图形是指组件中,实现 数据可视化 的具体图形表达元素,例如饼图的扇区、柱状图的柱子、折线图的线条、拐点等。 图5 基本漏斗图图形 颜色:设置图表中,图形的颜色。 统一配置 数据块高度(%):设置漏斗图的高度比。 标签字体:设置数据块中标签的字体、颜色、大小。 数据系列 系列名称:原始数据中默认的系列名称,可通过设置“显示名称”,进行修改。 显示名称:自定义图表中系列的显示名称。 数据块颜色:数据块的颜色。 标签字体:设置标签的字体、文字大小、文字颜色等。
  • 图例 图例是指在多维度可视化图形表达中,用以区分不同维度可视化图形的提示标识。 图6 基本漏斗图图例 显示图例:是否展示图例。图例文字内容来源于数据模型下“label”的值。 图例标记:设置图例小图标形状。 图例宽高:设置图例的宽度和高度。 图例间隔:设置图例之间的间隔。 字体:设置图例的字体、颜色和大小等。 图例位置(左):图例的位置。 对齐方式:设置图例的对齐方式,如左对齐、居中或右对齐。 上间距:图例到漏斗图组件顶部距离占组件高度。 图例类型:存在很多图例,导致图表中无法全部显示,此时可设置图例类型,即通过滚动翻页还是普通换行来查看图例。 翻页按钮:翻页按钮的颜色。 翻页按钮不激活:翻页按钮不激活时的颜色。 自定义图例显示:是否开启自定义图例显示设置。开启后,可调整图例名称显示字符长度。默认关闭,即显示图例所有字符。
  • 购买实例 进入购买华为云Astro大屏应用实例页面。 选择购买的实例版本和购买时长,单击“立即购买”。 购买实例时,支持同时购买页面扩容包,也可以在实例购买后,对页面进行扩容。页面扩容包计费规则,请参见计费项。 图1 购买实例(基础版) 图2 购买实例(专业版) 图3 购买实例(企业版) 选择支付方式,单击“去在线支付”,完成订单支付。 图4 确认付款 订单支付成功后,单击“返回Astro轻应用控制台”。 在华为云Astro大屏应用控制台中,可以查看华为云Astro大屏应用的安装状态。当“实例状态”变为“运行中”时,说明实例已安装好,可以正常使用。 图5 华为云Astro大屏应用控制台
  • 图例 图例是指在多维度可视化图形表达中,用以区分不同维度可视化图形的提示标识。 图7 轮播饼图图例 统一配置 图例:是否显示图例,如工程管理、环境管理。图例文字内容来源于数据模型下“s”的取值。 水平对齐方式:设置图例的水平对齐方式,支持左对齐、居中、右对齐和按照百分比设置。 垂直对齐方式:设置图例的垂直对齐方式,支持顶部对齐、居中、底部对齐和按照百分比设置。 排列方向:设置图例的排列方向,支持水平和垂直两种方式。 类型:存在很多图例,导致图表中无法全部显示,此时可设置图例类型,即通过滚动翻页还是普通换行来查看图例。设置为“滚动翻页”时,支持设置翻页箭头的宽高、图标默认颜色、图标选中颜色和页码字体。 图例总宽高:设置图例项的宽度和高度,单位为“%”。 图例项宽度:设置图例的宽度,支持自动和自定义。 图例间隔:设置图例项之间的间隔。 图例标记 图例标记:设置图例前图标的形状。 标记宽高:设置图例前图标的宽度和高度。 图例系列名 字体:设置图例的字体、颜色和大小。 图例字符:设置图例显示的字符数,支持全显和省略。设置为“省略”时,支持设置图例显示的文字数量。 数据值:图例中是否显示数值。设置为“显示”时,可设置如下参数。 字体:设置图例中数值的字体、大小和颜色等。 数值左间距:设置系列名和数据之间的间距。 前缀:数值前是否显示前缀。 前缀内容:设置前缀的显示内容。 前缀字体:设置前缀的字体、大小和颜色等。 前缀右间距:设置前缀和数值之间的间距。 后缀:数值后是否显示后缀。 后缀内容:设置后缀的显示内容。 后缀字体:设置后缀的字体、大小和颜色等。 后缀左间距:设置后缀和数值之间的间距。 百分比:是否显示百分比。设置为“显示”时,支持设置如下参数。 数字字体:设置百分比中数值的字体、大小和颜色等。 百分号字体:设置百分比中百分号的字体、大小和颜色等。 百分号左间距:设置数值和百分比之间的间距。
  • 图形 图形是指组件中,实现数据可视化的具体图形表达元素,例如饼图的扇区、柱状图的柱子、折线图的线条、拐点等。 图6 轮播饼图图形 颜色:设置图表中,图形的颜色。 统一配置 数据系列:是否显示该系列数据。如果不选中,会隐藏该组件中对应的系列数据。 南丁格尔图:是否使用南丁格尔图。 内半径:设置饼图内半径的值,单位%。 外半径:设置饼图外半径的值,单位%。 圆心横坐标:设置饼图圆心横坐标的值,单位%。 圆心纵坐标:设置饼图圆心纵坐标的值,单位%。 排布顺序:扇区可按顺时针或逆时针排布。 起始角度:扇区起始角度。 最小角度:扇区最小角度。 鼠标悬停:鼠标放在扇区时,该扇区是否放大显示。 所有标签设置:图表的各个数据系列上,是否显示标签。 所有标签悬浮设置:鼠标悬浮在对应数据系列上时,标签是否显示。 标签位置:标签显示位置,如内部、外部或中间。 标签视觉引导线是否展现:标签前是否显示视觉引导线。 引导线长度:设置视觉引导线的长度。 标签内容:设置标签显示的内容,如系列名、数据值和百分比。 标签文字:设置标签的字体、大小和颜色等。 描边:轮播饼图间系列和整体范围的描边样式。 设置背景:设置为“是”时,可自定义饼图的背景颜色。 数据系列 系列名称:原始数据中默认的系列名称,可通过设置“显示名称”,进行修改。 显示名称:图表中实际显示的系列名称。 下标:数据系列所在的位置。 初始选中:数据项初始是否被选中。 颜色样式:数据系列的颜色样式,支持以下几种。 单色:可设置正常颜色和高亮下颜色。 渐变色:可设置渐变样式、渐变方向、起始颜色和结束颜色。 纹理:通过上传纹理图片,自定义数据系列的颜色样式。 普通标签:未选中数据系列时,标签的样式。 系列名是否展示:标签中系列名是否显示,如工程管理。 数据值是否展示:标签中数据值是否显示,如工程管理对应的数据值“635”。 百分比是否展示:标签中百分比是否显示,如工程管理对应的百分比“67.2”%。 普通标签字体:设置标签内容的字体、颜色和大小等。 高亮标签:选中数据系列时,标签的样式。 系列名是否展示:标签中系列名是否显示,如工程管理。 数据值是否展示:标签中数据值是否显示,如工程管理对应的数据值635。 百分比是否展示:标签中百分比是否显示,如工程管理对应的百分比67.2%。 高亮标签字体:设置标签内容的字体、颜色和大小等。
  • 指标 指标是指可视化组件中,对除可视化图形之外的具体补充,即主要以文字和数字的表现形式,为可视化组件提供具体数值的参考。 图9 轮播饼图指标 显示指标:是否显示组件的指标。设置为显示时,可自定义指标的内容和样式等。 标题内容:自定义指标的显示内容。 标题字体:设置指标标题的字体、大小和颜色等。 自动求和:指标是否自动求和。 数值内容:“自动求和”设置为“否”时,需要输入数据指标数值。 数值字体:设置数值的字体、大小和颜色等。
共100000条
提示

您即将访问非华为云网站,请注意账号财产安全